Visit Gigasoft's Web Site
ProEssentials v8 Help

Chapter 3: PEactions Property

 

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