DTWAIN_ArrayResize

Top  Previous  Next

The DTWAIN_ArrayResize changes the number of elements in a DTWAIN_ARRAY.

 

DTWAIN_BOOL DTWAIN_ArrayResize (

DTWAIN_ARRAY

Array

LONG

NewSize );

 

Parameters

Array

DTWAIN_ARRAY that will be resized.

 

NewSize

The number of elements that Array will hold.

 

 

Return Values

If the function succeeds, TRUE is returned.  If the function fails FALSE is returned.

 

Comments

The DTWAIN_ArrayResize removes or inserts new elements in a DTWAIN_ARRAY Array so that the new size is equal to NewSize.  If NewSize is less than the current size, elements from the end of the array are removed until the array's size is equal to NewSize.  If NewSize is greater than the current size of the array, elements are added to the end of the array.

 

NewSize must be 0 or greate.  A value of 0 clears the entire array.

 

TWAIN State Transitions

None.

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

 

See Also

Adding, Setting, and Inserting elements in a DTWAIN_ARRAY