All ActiveX interfaces include a PEactions property. This feature allows calling ProEssentials DLL calls via a property based interface when and if it's desired. The most important thing to remember about PEactions is that it's used to undo the zoom state, and reinitialize the chart after setting properties,
PEactions = UNDO_ZOOM '(19) Undo Zoom
PEactions = REINITIALIZE_RESETIMAGE '(0) Calls PEreinitialize, PEresetimage,
Using PEactions to call DLL functions is optional and VB has means of calling the ProEssentials DLL directly. The OCX interface also has methods for most the ProEssentials DLL calls.
Related to PEactions are PEnarg1, PEnarg2, and PEstrarg1 which provide for function arguments where needed. For those PEactions that call ProEssentials functions requiring arguments, use:
PEnarg1 to set the width argument
PEnarg2 to set the height argument
PEstrarg1 to set the path\filename argument
*Note: Be sure to initialize these argument type properties before setting the PEactions property.
Setting
|
Description
|
PEactions =REINITIALIZE_RESETIMAGE(0)
|
Calls PEreinitialize, PEresetimage, and InvalidateRect Set this anytime an object's properties are manipulated and you want to immediately see your changes. This is usually the last property you set.
|
REINITIALIZE(1)
|
Calls PEreinitialize Set this anytime you want to initialize an object without rebuilding the image. This is useful to let ProEssentials determine the range of axes and then you can look at (for example) ManualMinY and ManualMaxY to learn the axis extents and add annotations or do other processing related to these extents.
|
RESET_IMAGE(2)
|
Calls PEresetimage Set this anytime you want to only update the image. Do this after changing XData or YData and the axes won't need to be re-scaled. This action is commonly used in the sequence: PEactions = REINITIALIZE_QUICK(17), PEactions = RESET_IMAGE(2) PEactions = INVALIDATE_RECT(3)
|
INVALIDATE_RECT(3)
|
Calls the Windows InvalidateRect function to cause a redraw. Generally called after a PEactions = RESET_IMAGE(2).
|
LAUNCH_MAXIMIZE(4)
|
Calls PElaunchmaximize
|
LAUNCH_CUSTOMIZE_DIALOG(5)
|
Calls PElaunchcustomize
|
LAUNCH_EXPORT_DIALOG(6)
|
Calls PElaunchexport
|
LAUNCH_TEXT_EXPORT_DIALOG(7)
|
Calls PElaunchtextexport, use PEnarg1 to represent bToFile 0=false, 1=true
|
LAUNCH_PRINT_DIALOG(8)
|
Calls PElaunchprintdialog
|
LAUNCH_POPUP_MENU(11)
|
Calls PElaunchpopupmenu
|
COPY_META_TO_CLIPBOARD(12)
|
Calls PEcopymetatoclipboard
|
COPY_META_TO_FILE(13)
|
Calls PEcopymetatofile
|
COPY_BMP_TO_CLIPBOARD(14)
|
Calls PEcopybitmaptoclipboard
|
COPY_BMP_TO_FILE(15)
|
Calls PEcopybitmaptofile
|
REINITIALIZE_QUICK(17)
|
Calls PEreinitializecustoms
|
PRINT_GRAPH(18)
|
Calls PEprintgraph
|
UNDO_ZOOM(19)
|
Undo Zoom
|
REVERT_TO_DEFAULTS(20)
|
Calls PEreset
|
COPY_PNG_TO_FILE(22)
|
Calls PEcopyjpegtofile
|
COPY_PNG_TO_CLIPBOARD(23)
|
Calls PEcopypngtoclipboard
|
COPY_PNG_TO_FILE(24)
|
Calls PEcopypngtofile
|
|