Visit Gigasoft's Web Site
 ProEssentials v9 Help

PEstorepartial

BOOL PEstorepartial (hObject, lphGlobal, lpdwSize)

 

HWND 

hObject

The handle returned from PEcreate.

HGLOBAL* 

lphGlobal

Handle to destination global object.

DWORD* 

lpdwSize

Size of information transferred.

 

This function stores the objects data (except data property arrays) in a binary form for later retrieval. This is useful if you just want to store the chart's visual characteristics rather than all its data.

 

Parameter

Description

lphGlobal

Pointer to a global memory handle. If the function is successful, lphGlobal will point to a handle of a global memory object which was created by the ProEssentials DLL. The calling program is responsible for destroying this global memory object when finished with the data.

lpdwSize

Pointer to a DWORD. If the function is successful, lpdwSize will point to a DWORD which holds the number of bytes transferred into the global memory object.

 

Returns

NonZero if the function was successful, otherwise Zero.

 

Comments

This function does not store the objects data held in the following properties: XData, YData, ZData, XDataII, YDataII, PointLabels, SubsetLabels, DataPointLabels, and PointColors. This function is used to store the objects attributes only.

 

To reload the information use PEloadpartial to transfer the information into an object of the same type.

 

See Also: PEload, PEloadpartial, PEstore, PEloadfromfile, and PEsavetofile.

 

For more information on this property and example code of its use, see the Serialization section in Chapter 5 in the ProEssentials users guide.