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 for case JaggedData = False and data arrays such as XData, YData, and ZData could be set in chunks. For example, one subset or partial subset worth of data can be passed rather than having to pass all data.

If JaggedData = True, use this function to pass one subset's amount of data (nStartingCell sets subset index) and establish this subset to have nCellCount quantity of data. Setting the number of Points for this Subset. lpvMemSet must be NULL

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.