PEvset

BOOL PEvset (hObject, nProperty, lpvData, nItems)

This function sets object property arrays and properties of non-simple data type (including float, double, and structures such as RECT and POINT) by copying the data pointed to by lpvData into the object property located by hObject and nProperty. This function is designed to be used with properties which start with PEP_fa, PEP_na, PEP_dwa, PEP_f, PEP_pt, PEP_struct, and PEP_rect. PEP_sza properties are best set with PEvsetcell.

Returns

NonZero if the function was successful, otherwise Zero.

Comments

When nItems is equal to zero and nProperty represents a property array, this function will remove all elements of the property array.

When dealing with property arrays, this function sets the entire array with one call. This is the fastest method to pass large data arrays such as XData, YData, and ZData.

The use of PEvset in .NET is disussed in Chapter 2.

The use of PEvset in Visual Basic is discussed in Chapter 3.

The example projects also discuss using this function.

Within the demo, see examples 018, 123, and 400.

PEvsetEx can be used to set partial data within an array.

PEvsetcell can be used to set individual array elements.

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

When used with SubsetLabels and PointLabels, the tab delimited string information pointed to by lpvData will be corrupted during the de-tokenization process. Do not pass tab delimited string array information which has static scope. We do not recommend using PEvset with string arrays, PEvsetcell (or using the visual interfaces) is actually faster if you pass the last index first.

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