Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Panel - page of object PmPanel

Description:
Basic settings of the panel. The panel description is defined here, rights for opening/closing, panel printing, etc. By the "Edit graphic content" button it is possible to open the Panel editor with the panel.
Configuration items:
Panel titleUser name of the panel that is displayed for example in:
- in the window title bar (if opened outside the workspace)
- in the panel list obtained for example by the FindViewers method

This configurator sets the initial value of the property PmPanel.Title and PmiRoot.ViewerTitle.

Macro expression can be used for input ($.text ..) (it is evaluated while the window is opening).

Open by hotkeyHotkey or combination of keys used for opening the panel. The key(s) is defined by pressing it (not editing).

This configurator is considered obsolete and is displayed only if a valit hotkey or combination of keys is defined.

sOptions default valueThe parameters transfered to the viewer. These define where and how to open the viewer.

Entries with assigned value are separated by a semicolon, for example "target:_blank;modal:1;".

For detailed description see sOptions.

Macro expression can be used for input (it is evaluated while the window is opening).

Additional parameters can be edited manually, or created by the button on the right, that will open the window for Setup of the Options default values.

 
It is a static default setup of entries. The entries can also be defined dynamically at viewer opening, see the sOptions parameter in the OpenView method. In such case the static default setup of the object is combined with the entries provided dynamically. If the same information is present on both places, the dynamical information provided at viewer opening is preferred by the system.
sParams default valueParameters transfered to the object that is to be viewed by the corresponding viewer.

Entries with assigned value are separated by a semicolon, for example "name1:value1;name2:value2;".

For detailed description see sParams.

Macro expression can be used for input (it is evaluated while the window is opening).

 
It is a static default setup of entries. The entries can also be defined dynamically at viewer launch, see the sParams parameter in the OpenView method. In such case the static default setup of the object is combined with the entries provided dynamically. If the same information is present on both places, the dynamical information provided at viewer opening is preferred by the system.
 
Allows to set the value of parameters of PmiRoot graphic item. This parameter is then accessible in the panel configurators by the Macro expression $.par and from the script by the GetPar method. Each parameter consists of an identifier (name) and a value. Syntax: "par:name1=value1;par:name2=value2; ...". See also: Parameters of graphic item.
 
The relation between PROMOTIC object and graphic item: It is important that it is possible to deliver the PROMOTIC object parameter into the panel as a graphic item parameter. The basic principle is that the PROMOTIC object parameter cannot get inside the panel autoamtically. It is necessary to create the corresponding parameter in the PmiRoot graphic item and set it to the value of the PROMOTIC object parameter when opening the panel. This can be done by Macro expression $.par, that allows to get the PROMOTIC object parameter values in this configurator and use them to create the PmiRoot graphic item parameters.

Example: There are PROMOTIC object parameters "name1" and "name2" with the values "boiler" and "temperature". The values of these parameters are to be delivered to the panel parameters of the same names when the panel is opened. The macro expression: $.join("par:name1=",$.par("name1"),";par:name2=",$.par("name2"),";") will be evaluated as: "par:name1=boiler;par:name2=temperature;". By evaluating the macro expression and using the PROMOTIC object parameters, the configurator value has been created, setting the panel parameter values for panel opening.

Panel help topicYou can enter the identifier of the internal document here that is displayed if you press the key F1 in this panel (when it is active). In case of the CHM file the path (in case of HLP, the number) to the internal document is entered here. For example, if you want to display the description of the PmData object in the PromoticEn.chm, it would be the path: /Objects/Promotic/PmData/Desc.htm. See the configurator "Runtime helps path". See also: How to call user helps in application.

Macro expression can be used for input (it is evaluated while the window is opening).

Scripting language settingsSets the scripting language type (VBScript or JavaScript).
vbscript (obsolete) - All scripts in events of graphic items in this panel will be written in VBScript language. In such case the WEB panels are functional only in Internet Explorer browser.

In such case, the Level of integration of panel viewer and the local application configurator is visible and it is possible to enter both "full" and "client".

javascript - All scripts in events of graphic items in this panel will be written in VBScript language. In such case the WEB panels are functional in all standard web browsers (Chrome, Firefox, Edge ...).

In such case, the Level of integration of panel viewer and the local application configurator is not visible and the "client" mode is set.

Level of integration of panel viewer and the local application Defines the level of integration of panel viewer and local application. One point of view is the access to the application objects from panel viewer scripts, and the other is access to the contents of open panel viewer from local application.

This configurator is visible only if VBScript language is set. For JavaScript language, the "client" mode is set.

full - FULL access from scripts to the whole application (only for VBScript - From the scripts in panel viewer it is possible to access the complete local application (i.e. the application objects). It is also possible to access the contents of open panel viewer from the application (i.e. the graphic objects). In the scripts in graphic item events in panel viewer, it is possible to access the complete local application the same way as in PROMOTIC object events. Caution! The option is available only for VBScript scripting language. If the panel is enabled also for WEB then it is neccessary to test in scripts whether the viewer is open localy or on the web for example by the PmiRoot.ClientType property.

Caution! The setting is valid only for local application, in the web panel the panel viewer is always in "client" mode.

client - LIMITED access from scripts to the PmPanel object and Pm object - From the scripts in the panel viewer it is not possible to access the local application (i.e. the application objects). There is only limited access to the PmPanel and Pm objects, that work as interface between the panel viewer and application. From the application, there is no access to the contents of open panel viewer(i.e. to the graphic items). This is the recommended mode, where the viewers of both local and web panels is limited the same way. Therefore it is not necessary to test whether the viewer is open localy or on the web. Caution! The option is enabled for both VBScript and JavaScript scripting languages.
Enable multiple opening of local panel If checked, the panel can be opened multiple times. This is handy especially for parametrized panels - if the same panel is opened with different parameters.

Caution! This option is enabled only for panels that have the "Level of integration of panel viewer and the local application" configurator set to "client - LIMITED access from scripts to the PmPanel object and Pm object".

Edit graphic contentBy pressing this button editing the panel is called in the Panel editor
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice