PEreinitialize

BOOL PEreinitialize (hObject)

This function resets the object to new properties and data. It initializes all internal variables in preparation to generate a new image with PEresetimage.

If axis scales are being automatically configured (for example, ManualScaleControlY = PEMSC_NONE) then this function will determine the axis range and store the results in ManualMinY, and ManualMaxY properties. This is useful if you want to interogate ManualMinY and ManualMaxY and then modify these extents and/or add annotations which correspond to their values. All without having to waste processor time building an unnecessary image.

Returns

NonZero if the function was successful, otherwise Zero.

Comments

After setting initial properties or calling PEload, this function should be called. Any time you adjust the Subsets, Points, XData, YData, or ZData properties, you should call this function to complete the object's transformation.

You normally call this function in the sequence:

PEreinitialize

PEresetimage

InvalidateRect // Windows API call

Do not call both PEreinitializecustoms and PEreinitialize, one or the other.

.NET developers, see PeFuction.Reinitialize

Ocx|Vcl developers, see the PEactions property.

Within Visual Basic, you can call this function as follows...

Pego1.PEactions = 0

'Which calls PEreinitialize, PEresetimage, and InvalidateRect

or

Pego1.PEactions = 1 'Which just calls PEreinitialize

In Delphi, use...

PEGraph1.PEactions := gReinitAndReset;

{Which calls PEreinitialize, PEresetimage, and InvalidateRect}

or

PEGraph1.PEactions := gReinitialize; {Calls PEreinitialize}