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.


Gigasoft Home \| News \| Contact Us \| Purchase a new License or Upgrade Product/Patches \| Resource Files Online Documentation
©2022 Gigasoft, Inc. \| All rights reserved. Gigasoft is a registered trademark, and ProEssentials a trademark of Gigasoft, Inc.