GdPictureImaging.TwainSetCapCurrentString Method

Changes the current value of a TWAIN capability.

public Boolean TwainSetCapCurrentString(
    TwainCapabilities Cap, 
    TwainItemTypes ItemType, 
    String NewValue
);

Visual Basic

Public Function TwainSetCapCurrentString(
    ByVal Cap As TwainCapabilities, 
    ByVal ItemType As TwainItemTypes, 
    ByVal NewValue As String
) As Boolean

Parameters

Parameters	Description
Cap	A member of the TwainCapabilities enumeration.
ItemType	A member of the TwainItemTypes enumeration. You can determine the type of each TWAIN capability using the TwainGetCapItemType function or looking the twain references from http://www.twain.org
NewValue	New value to set to the selected TWAIN capability.

Returns

True if success, else False -> 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 function can be used to set the following types of capabilities: TWTY_STR32, TWTY_STR64, TWTY_STR128, TWTY_STR255.

Example

To set the ORDERED halftone mode

Copy Code

bSuccess = oGdPictureImaging.TwainSetCapCurrentString(TwainCapabilities.ICAP_HALFTONES, oGdPictureImaging.TwainGetCapItemType(TwainCapabilities.ICAP_HALFTONES), "ORDERED")