PEvgetEx

INT PEvgetEx (hObject, nProperty, nStartingCell, nCellCount, lpvDestination)

This function gets partial object property arrays by copying the data selected by hObject, nProperty, nStartingCell, and nCellCount into the memory location pointed to by lpvDestination.

This function is similar to PEvget, however, this function can retrieve sections of the property array rather than having to get the entire property array. This function was specifically added so data arrays such as XData, YData, and ZData could be retrieved in chunks.

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 destination buffer pointed to by lpvDestination is large enough to hold data.

PEvget can be used to get an entire array.

PEvgetcell can be used to get individual array elements.

PEvgetcellEx can be used to simplify getting two dimensional property array elements.

See Also: PEvsetcell, PEvsetcellEx, PEvset, and PEvsetEx.