Common Question 6

How do I initialize and then later make adjustments?

When writing code to display a graph, after setting various properties and passing your data, the last thing you do is tell ProEssentials to reinitialize itself and rebuild its image.

• Within .NET, this is done by calling the PeFunction.ReinitializeResetImage and Refresh methods.

• Within VBA/Delphi, set the PEactions property equal to REINITIALIZE_RESETIMAGE (0). (VCL enum 0 = xReinitAndReset).

• Within the DLL, call PEreinitialize, PEresetimage, and the Windows InvalidateRect function.

After you have called ReinitializeResetImage, then any time you further adjust properties, you will again have to reinitialize the object to the newly adjusted properties. This re-initialization can be in two forms, Complete, or Partial.

Complete Initialization

If you are adjusting Subsets, Points, or giving new data (YData, XData) which needs to be re-autoscaled, you need to do a full reinitialization as described above.

Partial Initialization

If you are not setting Subsets, Points, or passing new data, you can perform a partial initialization with PeFunction.PartialReinitialize.  Within the ActiveX, VCL, or DLL, call  PEreintializecustoms, PEresetimage, and the Windows InvalidateRect function.

IMPORTANT TIP:

Try to structure your code so that you perform as few re-initializations as possible. 

You can call Reinitialize by itself without the combined ResetImage.  This is useful to have ProEssentials determine your axis ranges that you can read with ManualMinY ManualMaxY if ManualScaleControlY = Auto.   This helps if you need to set annotations based on how data is auto scaled.  After adding / adjusting annotations, you can then call ResetImage.