TwainGetAvailableCapValuesNumeric Method

See Also     Examples     Applies To

Sets into an array the available values (as numeric) for the selected TWAIN capability which can be used with it by the opened source in its current configuration.
This function should be used to determine what are the supported value which can be used with the TwainSetCapCurrentNumeric() function.

Syntax

object.TwainGetAvailableCapValuesNumeric (nCap, *arValues())

The TwainGetAvailableCapValuesNumeric syntax has these parts:

Part Description
object Required. An object expression that evaluates to an object in the Applies To list.
nCap Required. Long A TWAIN capability constant.
*arValues() Required. Output 1D (0 based) Double Array. The available values wich can be set for the specified capability.

Returns

Long. If Success, non zéro: Number of values available for the selected TWAIN capability. Else 0 if fail -> Use TwainGetLastResultCode() and TwainGetLastConditionCode() functions for diagnosing the error.

Remarks

Before using this function check that the TWAIN state is >= 4 (TWAIN_SOURCE_OPEN)
To get the TWAIN state, use the TwainGetState() function.

This fuction can be used to set the folowing types of capabilities: TWTY_INT8, TWTY_INT16, TWTY_INT32, TWTY_UINT8, TWTY_UINT16, TWTY_UINT32, TWTY_BOOL.
You can determine the type of each TWAIN capability using the TwainGetCapItemType function or looking the twain references from http://www.twain.org'@category TWAIN Functions

Category

TWAIN Functions

Visual Basic Sample

List all supported X resolution of the default source


Dim nCpt As Long
Dim arCapValues() As Double

Object.TwainOpenDefaultSource
For nCpt = 0 To Object.TwainGetAvailableCapValuesNumeric(ICAP_XRESOLUTION, arCapValues) - 1
    MsgBox "Supported value no: " + str(nCpt + 1) + " are: " + str(arCapValues(nCpt))
Next nCpt

Object.TwainCloseSource






© Copyright 2008 GdPicture All rights reserved.
Documentation MAP.