Visit Gigasoft's Web Site
 ProEssentials v9 Help

PEvsetcell

BOOL PEvsetcell (hObject, nProperty, nCell, lpvData)

 

HWND 

hObject

The handle returned from PEcreate.

UINT 

nProperty

Identifies which property is set.

UINT 

nCell

Identifies the cell (element) of the array.

VOID* 

lpvData

Pointer to data which will be copied.

 

This function sets individual elements of property arrays by copying the data pointed to by lpvData into the property array element located by hObject, nProperty, and nCell. This function is designed to be used with properties which start with PEP_fa, PEP_sza, PEP_na, and PEP_dwa.

 

Returns

NonZero if the function was successful, otherwise Zero.

 

Comments

Setting nCell to -1 allows a special case where lpvData points to a variable that has been initialzied to the desired new size of the property array. This allows a property array to be resized, usually to a smaller value.


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

 

PEvset can be used to set an entire array.

 

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

 

When working with string data, (PEP_sza properties) PEvsetcellA and/or PEvsetcellW may be called to work specifically with short-char or wide-char data. Else the presence of the UNICODE pragma will control which function is automatically called.

 

Refer to the Appendix B Property Reference to view possible property codes.

 

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