DTWAIN_SetAcquireArea2String

The DTWAIN_SetAcquireArea2String function sets or resets the current image acquisition area.

DTWAIN_BOOL DTWAIN_SetAcquireArea2 (

DTWAIN_SOURCE	Source,
LPCTSTR	left,
LPCTSTR	top,
LPCTSTR	right,
LPCTSTR	bottom,
LONG	Unit,
LONG	Flags );

Parameters

Source

An open TWAIN Source.

left

Indicates upper left of rectangle to acquire.

top

Indicates top of rectangle to acquire.

right

Indicates right of rectangle to acquire.

bottom

Indicates bottom of rectangle to acquire.

Unit

Unit of measure used to describe left, top, right, and bottom of rectangle

Flags

Optional flags. Currently only TRUE or FALSE is supported.

Return Values

The return value is TRUE if successful. Otherwise FALSE is returned.

Comments

The DTWAIN_SetAcquireArea2String function works exactly the same way as DTWAIN_SetAcquireArea2, with the exception of the LPCTSTR parameters, which are strings that denote the values to use.

For example:

DTWAIN_SetAcquireArea2String( Source, "0.0", "0.0", "10.0", "10.0", DTWAIN_INCHES, TRUE)

TWAIN State Transitions

The Source must be in State 4. or higher (depending on the capability).

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN Source Selection Function