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 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 created (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 a separate 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 the 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 the 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 the local application.
This object inherits properties, methods and events of the PmaObject object.
Properties and methods of this object:
Print()Print the panel (or its part) to a printer or into the file
Obsolete properties and methods:
ArgumentsInput value for opening the panel
Close()Close panel
DxPanel width
DyPanel height
EnabledEnable/disable the user's control of the whole panel
FocusSets/gets whether the window has the focus
GetLastRefresh()It 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
OpenView()Opens the viewer of another object
OpenViewModal()Opens the viewer of another object in a modal window
PrintToBmp()Saving the panel or its part into the file *.bmp, *.png, *.jpg, *.gif or *.tif
Refresh()Refresh panel
ReturnValueThe output value on closing the panel
ScreenXX-coordinate of the left upper corner of the panel relative to the screen
ScreenYY-coordinate of the left upper corner of the panel relative to the screen
ScrollXX-coordinate of the left upper corner
ScrollYY-coordinate of the left upper corner
StateThe viewing mode of the panel
TitleThe panel title
Vars()Returns variable of the PmgRoot object in this panel
ViewerTypeIt gets whether the window is opened in the application or in the Web browser
VisibleGets whether the panel is visible
XX-coordinate of the left upper corner of the panel
YY-coordinate of the left upper corner of the panel
Properties and methods inherited from the PmaObject object:
AddEvent()Registers a function into the specified 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
MethodsAccess to designer's methods of this object
NameObject name (without the path)
ParentReturns reference to the parent Pma object
Pm()Returns reference to the Pma object or to its implementation subobject
RemoveEvent()Unregisters the function in the specified event
RootReturns reference to the root application object PmaRoot
Events of this object:
onOpenIs triggered after opening the panel
onCloseIs triggered after closing the panel
onRefreshIs triggered after the panel is refreshed
onKeyPressIs triggered for the active panel after pressing or releasing a key
onMousePressIs triggered after pressing or releasing the mouse button
onFocusInIs triggered after the panel gets the focus (the panel becomes active)
onFocusOutIs triggered after the panel gets lost the focus (the panel leaves to be active)
Events inherited from the PmaObject object:
onStartIs triggered for each object in runtime only once at the beginning
onStopIs triggered for each Pma object in runtime only once at the stop of the application
Configuration tabs:
ObjectGeneral information about the object
EventsDefinition of object events algorithms
MethodsDefinition of designer's method of the object
PanelBasic settings of the panel
GraphicGraphics editor
PermissionsObject permissions
Web serverThe link-up of the object to 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 launch" configurator has been removed. The panel to be opened at application launch 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.27 SCADA system documentation MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r.o.