Object PmaPanel (User graphics)

The object represents an application window with a panel, where it is possible to visualize the data of the PROMOTIC system. The content itself of the graphic panel is created by means of the graphics editor from Pmg objects that can bind to the application data by data bindings.

In the PmaPanel object, multiple PmaPanel objects can be planted (it is meaningful if these additional objects are acting as auxiliary windows opened only from the window of this object).
This object can be created in objects: PmaRoot, PmaFolder, PmaPrototype, PmaPanel. Multiple objects of this type can be created in such objects.

The PmaPanel object is suitable for creating windows, with content that is periodicaly updated (for example displaying current data). For windows containing large ammounts of figures without the need of quick updating (e.g. daily reporting ..) the PmaReport object can be used. Some simpler window can be created by using the special methods, see Pm visualization methods.

The PmaPanel object can also automatically generate its graphic data into dynamic HTML pages and offer these pages to Web clients - see chapter Web panels. Offering Web pages can be enabled on the "PmaPanel > Web server" tab.
The client requiring data from this Web component is of the PmWebClient type from the licence point of view.

The panel window can be displayed in the workspace (in the PmaWorkspace object), opened in an independent window, it can also act as modal window, or it can be displayed in the Pmg object (in the PmgFrame object) in another panel.
The window can be opened by default by the Pm.CreateView method. This method can be called for example in the panel button and it is functional for both local and Web applications (i.e. when the method is called for example in the Web panel button).

The PmaPanel object exists constantly, while the panel window (with graphic content) in local application may or may not be open (exist).
If the "Enable multiple opening of local panel" configurator is checked, then even multiple panel windows of the same PmaPanel object may be open simultaneously.

If the "Level of integration of the panel viewer and the local application" configurator is set to client - LIMITED access from scripts to the PmaPanel object and Pm object (recommended setting), then the panel window itself is isolated from the rest of the application. It is not possible to access the window from application by script directly and vice versa. All changes and actions in the open panel window must be executed by active panel graphic (Pmg objects) that can use the means for communication with the application itself (data bindings, panel/global methods). This mode allows opening panel window in the Web browser on another computer and also multiple panel windows of the same PmaPanel object simultaneously in local app.
This object inherits properties, methods and events of the PmaObject object.
Properties and methods of this object:
OpenView Opens the viewer of another object (obsolete)
Print Print the panel (or its part) to a printer or into the file
Obsolete properties and methods:
Arguments Input value for opening the panel
Close Close panel
Dx Panel width
Dy Panel height
Enabled Enable/disable the user's control of the whole panel
Focus Sets/gets whether the window has the focus
GetLastRefresh This is used for obtaining the time when this panel requested data (locally or on the Web) for the last time
Items Returns reference to Pmg object
OpenViewModal Opens the viewer of another object in the modal window
PrintToBmp Saving the panel or its part into the file *.bmp, *.png, *.jpg, *.gif or *.tif
Refresh Refresh panel
ReturnValue The output value on closing the panel
ScreenX X-coordinate of the left upper corner of the panel relative to the screen
ScreenY Y-coordinate of the left upper corner of the panel relative to the screen
ScrollX X-coordinate of the left upper corner
ScrollY Y-coordinate of the left upper corner
State The viewing mode of the panel
Title The panel title
Vars Returns variable of the PmgRoot object in this panel
ViewerType It gets whether the window is opened in the application or in the Web browser
Visible Gets whether the window is visible
X X-coordinate of the left upper corner of the panel
Y Y-coordinate of the left upper corner of the panel
Properties and methods inherited from the PmaObject object:
AddEvent Registers a function into selected event
GetInfo Returns the Info object with the specified name
GetOwnedByIndex Returns the subobject defined by its index
GetOwnedByName Returns reference to the subobject defined by its name
GetOwnedByType Array of references to the subobjects
GetOwnedNum Returns number of subobjects in the object
GetPar Reading the value of the Pma object parameter (or its parents)
GetPathName Object name with the path to this object
GetPermission Returns permission of corresponding operation from object
Methods Access to designer's methods of this object
Name Object name (without the path)
Parent Returns reference to the parent object in the tree of Pma objects
Pm Returns reference to the Pma object or to its implementation subobject
RemoveEvent Un-registers the function in the specified event
Root Returns reference to the root application object PmaRoot
Events of this object:
onOpen Is triggered after opening the panel
onClose Is triggered after closing the panel
onRefresh Is triggered after the panel is refreshed
onKeyPress Is triggered for the active panel after pressing or releasing a key
onMousePress Is triggered after pressing or releasing the mouse button
onFocusIn Is triggered after the panel gets the focus (the panel becomes active)
onFocusOut Is triggered after the panel gets lost the focus (the panel leaves to be active)
Events inherited from the PmaObject object:
onStart Is triggered for each object in the runtime only once at the beginning
onStop Is triggered for each Pma object in the runtime mode only once at the stop of the application
Configuration tabs:
Object General information about the object
Events Definition of object events algorithms
Methods Definition of designer's method of the object
Panel Basic settings of the panel
Graphic Graphics editor
Permissions Object permissions
Web server The link-up of the object to the Web server

Pm9.00.03: Panel compilation was removed. All modifications of the graphics content are saved automatically when the complete PmaPanel object is saved.
Pm9.00.00: Object name changed: PmPanel -> PmaPanel
Pm8.03.05: Fixed bug: JavaScript panels were sometimes rendered incorrectly in InternetExplorer9.
Pm8.03.01: Fixed bug: JavaScript panels sometimes caused memory shortages.
- New "Enable multiple opening of local panel" configurator. If is set, then the panel can be opened multiple times simultaneously (e.g. each time with different parameter).
- Many properties in this object are now considered obsolete because these properties are now contained in the PmgRoot object. Based on the fact that one panel can now be opened multiple times these properties in this object are no longer relevant.
- The option to save graphic content as template for other panels has been disabled. All such panels are converted automatically, i.e. this graphic content is copied into all PmaPanel objects that used such template. As for templates, it is better to use the PmaPrototype object.
Pm8.02.04: Fixed bug: If the values of panel parameters were entered in the "sViewPars default value" configurator, then the incorrect evaluation occured (bug since Pm8.2.3 version).
Pm8.00.02: Fixed bug: in some cases the displayed numbers were incorrectly rounded to 2 decimal places.
Pm8.00.00: The "Open at application start" configurator has been removed. The panel to be opened at application start is now defined in the PmaWorkspace object, in the "Viewer of component" configurator. The old applications can be converted, in order to set the starting window in the corresponding configurator.
PROMOTIC 9.0.17 SCADA system documentation - MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice