DTWAIN_FrameCreateString

DTWAIN_FrameCreateStringA

DTWAIN_FrameCreateStringW

Top  Previous  Next

The DTWAIN_FrameCreateString creates a DTWAIN_FRAME.

 

DTWAIN_FRAME DTWAIN_FrameCreate (

LPCTSTR

Left,

LPCTSTR

Top,

LPCTSTR

Right,

LPCTSTR

Bottom );

 

Parameters

Left

Left (x) value of the DTWAIN_FRAME.

 

Top

Top (y) value of DTWAIN_FRAME.

 

Right

Right (x) value of DTWAIN_FRAME

 

Bottom

Bottom (y) value of DTWAIN_FRAME

 

Return Values

If the function succeeds, a new DTWAIN_FRAME is returned.  Otherwise, NULL is returned.


Character specific version

ANSI version:

DTWAIN_FrameCreateStringA

Unicode version:

DTWAIN_FrameCreateStringW

 

Comments

The DTWAIN_FrameCreateString function does exactly the same as the DTWAIN_FrameCreate function, with the exception that the arguments are strings that represent floating point numbers instead of actual DTWAIN_FLOAT parameters.  Internally, the strings are converted to DTWAIN_FLOAT types and stored in the DTWAIN_FRAME.


This function can be used by computer languages that do not properly handle 64-bit IEEE floating point values, thus calling DTWAIN_FrameCreateString will work correctly for these languages..  


Note: The string values can be any floating point string that the 'C' language considers a valid floating point string.


Example:


      DTWAIN_FRAME frame = DTWAIN_FrameCreateStringA("10.0", "20.0", "40.0", "100.0");

      // This is the same as:

      // DTWAIN_FRAME frame = DTWAIN_FrameCreate(10.0, 20.0, 40.0, 100.0);

     

TWAIN State Transitions

None.

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

 

See Also

DTWAIN_FRAME Functions