SPBM_SETARRAY

This message causes the component to set or reset the array of data.

Syntax

param1
PSZ pStrl;   /* Pointer to the new array of values. */

param2
USHORT usItems; /* Number of items in the array. */

Parameters

pStrl (PSZ) - input

Pointer to the new array of values.

usItems (USHORT) - input

Number of items in the array.

Returns

rc (BOOL) - return

Success indicator.

TRUE: Successful completion.

FALSE: Error occurred.

Remarks

The application sends this message to the component to set or reset the array of data. The component tries to leave the current value unchanged. However, if the current value is out of range for the new array, it is moved to the closest extreme. Thus, if the current value is less than 0, it is moved to 0. If the current value is greater than the previous value, it is set to the previous value. If the data exceeds 64KB, or if param1 or param2 equal 0, FALSE is returned.

Default Processing

The default window procedure does not expect to receive this message and takes no action other than to return FALSE.