View source for SPBM SETARRAY

{{DISPLAYTITLE:SPBM_SETARRAY}}
This message causes the component to set or reset the array of data.

==Syntax==
<pre>
param1
PSZ pStrl;   /* Pointer to the new array of values. */

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

==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.

[[Category:Messages]]