| Panel title | User name of the panel that is displayed for example in:
- in the window title bar (if is opened outside the workspace)
- in the panel list obtained for example by the FindViewers method
This configurator sets the initial value of the property PmaPanel.Title and PmgRoot.ViewerTitle. Macro expression can be used for input ($.text ..) (it is evaluated while the window is opening). |
|---|---|
| Open by hotkey | Key or combination of keys used for opening the panel. The key(s) it is necessary to define by pressing it (not editing).
This configurator is considered obsolete and is displayed only if a valit hotkey or combination of keys is defined. |
| sFramePars default value | Parameters for the frame where the viewer will be displayed.
See the PmViewCreator.Frame property. Entries are in the KeyVal format, for example "target:_blank;". Macro expression can be used for input (it is evaluated while the window is opening). Values can be edited manually, or can be created by the button on the right, that will open the window for Setting of the sFramePars default values. It is a static default setting of entries. The entries can also be defined dynamically at viewer opening (see the sFramePars parameter in the CreateView method). In this case the static default setting of the object is combined with the entries provided dynamically. If the same information is present on both places, then the dynamical information provided at viewer opening is preferred by the system. |
| sViewPars default value | Viewer parameters (they differ for various viewer types).
See the PmViewCreator.View property. Entries are in the KeyVal format. Macro expression can be used for input (it is evaluated while the window is opening). It is a static default setting of entries. The entries can also be defined dynamically at viewer opening (see the sViewPars parameter in the CreateView method). In this case the static default setting of the object is combined with the entries provided dynamically. If the same information is present on both places, then the dynamical information provided at viewer opening is preferred by the system. It allows to set the value of parameters of the PmgRoot object. This parameter is then accessible in configurators of the panel by means of the Macro expression $.par and in the script by the GetPar method. Each parameter here consists of an identifier (name) and a value. Syntax: "pars:{name1:value1;name2:value2; ...}". See also: Parameters of the Pmg object. The relation of parameters between Pma object and Pmg object: It is important that it is possible to deliver the Pma object parameter into the panel as a Pmg object parameter. The basic principle is that the Pma object parameter cannot get inside the panel automatically. It is necessary to create the corresponding parameter in the PmgRoot object and set it to the value of the Pma object parameter when opening the panel. This can be done by Macro expression $.par, that allows to get the Pma object parameter values in this configurator and use them to create parameters of the PmgRoot object. Example: There are Pma object parameters "name1" and "name2" with values "boiler" and "temperature". The values of these parameters are to be delivered to the panel parameters of the same names when opening the panel. The macro expression: $.join("pars:{name1:",$.par("name1"),";name2:",$.par("name2"),";}") will be evaluated as: "pars:{name1:boiler;name2:temperature;}". By evaluating the macro expression and using the Pma object parameters, the configurator value has been created, setting the panel parameter values for panel opening. |
| Panel help topic | The identifier of the internal document can be entered here that is displayed if you press the key F1 in the panel (if it is active). 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 PmaData object in the PromoticEn.chm, then it would be the path: /pmdoc/Objects/Promotic/PmaData/Desc.htm. See the "Runtime helps path" configurator. See also: How to display help texts in running application.
Macro expression can be used for input (it is evaluated while the window is opening). |
| Scripting language settings | Sets the scripting language type (VBScript or JavaScript).
vbscript (obsolete) - All scripts in events of Pmg objects in this panel will be written in the VBScript language.
Such panel cannot be viewed as Web panel, because the Web browsers do not support the VBScript language. In this case the next "Level of integration of the 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 Pmg objects in this panel will be written in the JavaScript language. In such case the Web panels are functional in all standard Web browsers (Chrome, Firefox, Edge, InternetExplorer ...).
In this case, the next "Level of integration of the panel viewer and the local application" configurator is not visible and the "client" mode is set. |
| Level of integration of the panel viewer and the local application | Specifies the level of integration of the panel viewer and local application. One point of view is the access to the application objects from panel viewer scripts, and also the other is access to the contents of open panel viewer from local application.
This configurator is visible only if the 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 Pma objects). It is also possible to access the contents of open panel viewer from the application (i.e. the Pmg objects). In scripts in events of Pmg objects in local panel viewer, it is possible to access the complete local application the same way as in events of Pma objects. Caution! The option is available only for VBScript language. If the panel is enabled also for the Web, then it is necessary to test in scripts whether the viewer is open localy or in the Web panel for example by means of the PmgRoot.ClientType property.
Caution! The setting is valid only in the local application. In the Web panel the panel viewer is always in "client" mode. client - LIMITED access from scripts to the PmaPanel object and Pm object - From the scripts in the panel viewer it is not possible to access the local application (i.e. the Pma objects). There is only limited access to the PmaPanel 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 Pmg objects). 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 where 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". |