Visit Gigasoft's Web Site
 ProEssentials v9 Help


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




The handle returned from PEcreate.



Identifies which property is set.



Index of starting item to set.



Number of items to set.



Pointer to data which will be copied.



Pointer to data to duplicate.


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.



NonZero if the function was successful, otherwise Zero.



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.