PEvsetEx

BOOL PEvsetEx (hObject, nProperty, nStartingCell, nCellCount, lpvData, lpvMemSet)

This function sets object property arrays by copying the data pointed to by lpvData into the object property array elements located by hObject, nProperty, nStartingCell, and nCellCount.

This function is similar to PEvset, however, this function can set a partial section of a property array instead of having to set the entire array. This function was specifically added so data arrays such as XData, YData, and ZData could be set in chunks. For example, one subset's worth of data can be passed rather than having to pass all subset data.

This function has another purpose in that it can initialize property array elements with a given data value. This is useful if changing a null data value like NullDataValue and need to initialize all items of an array to this new null data value. To use this feature, lpvData must be set to NULL and lpvMemSet must point to the data that is to be duplicated.

Returns

NonZero if the function was successful, otherwise Zero.

Comments

Note that this function requires an understanding of how ProEssentials stores data in memory. Refer to SubsetByPoint for more information. It is important that the source buffer pointed to by lpvData is correctly sized and initialized.

Within the demo, see example 102.

PEvset can be used to set an entire array.

PEvsetcell can be used to set individual array elements.

PEvsetcellEx can be used to simplify setting two dimensional property arrays.

See Also: PEvgetcell, PEvgetcellEx, PEvget, and PEvgetEx.