Promotic

Frames - tab of the PmaWorkspace object

Description:
Workspace frames layout definition.
Workspace is the main window with its client area represented by root frame with MainFrame identifier. The root frame size is determined by the size of the workspace window.
Each frame (including the root frame) can be divided on this tab into arbitrary number of subframes horizontally or vertically.
Each subframe can be continuously divided into smaller subframes.
This way the hierarchic frame structure si being created, where each frame has its parents (except for the root frame) and may contain multiple subframes on many levels. This hierarchic frame structure can be edited with the configurator.
Configurators:
Frames listHierarchical list of frames that can be edited.
Buttons:
NewOpens the configuration window that can be used for adding a new frame into the hierarchic level.
EditOpens the configuration window that can be used for editing the selected frame.
DeleteDeletes the marked frame
Up/DownIt is possible to change the order of frames.
After pressing the Up/Down button the marked item will be moved upward/downword in the list. The same effect can be achieved by pressing the key combination Alt+up key/down key.
Configurators:
IdentifierFrame text identifier. This identifier must be unique in the PmaWorkspace object.
Other methods and configurators are referring to this frame using this identifier (see for example the value "target" in the sFramePars parameter of the CreateView method).
This identifier must not contain values "blank" and "self" and must not begin with the "underscore" character.
This is a system name, so it must contain only alphanumeric and must not contain any diacritics (i.e. national dependent characters), empty string, spaces and the first character must not be a number or underscore.
Frame typeFrame type based on contained subframes point of view.
Simple - no subframes - The component viewers will be displayed only in this frame.
Horizontal - subframes placed horizontally (side-by-side)) - This frame is used for definition of subframes placed horizontally.
Vertical - subframes placed vertically (next one under previous) - This frame is used for definition of subframes placed vertically.
Border typeSpecifies the method of frame border highlighting, in order to help distinguish neighbor frames.
The dimension of the frame area used for rendering the viewer is decreased by the border width. It has sense only for frames of the Simple type used for viewers.
None - no border - The frame has no highlighted border and no optical differentiation element to distinguish neighbor frames.
Inset - inset efect - The frame has border creating effect of frame being immersed into surrounding area. The border width is 2 pixels.
Viewer of componentThe path to the object, that represents component viewer (path to the object PmaPanel, PmaReport, PmaAlarmGroup, ...), that will be present in this frame after opening the workspace for the first time.
Changing the viewer in this frame can be done by the Pm.CreateView method.
It has sense only for frames of the Simple type used for viewers.
Params default valueAdditional parameters for opening component viewer.
Similar parameter is the sViewPars parameter in CreateView methods. For example, PmaPanel object with Pmg object parameters (e.g. "pars:{boiler:5;}")
- Macro expression can be used for input (it is evaluated while the window is opening).
- It has sense only for frames of the Simple type used for viewers.
- The text in this configurator is entered without the quaotation marks (the " char is not used at start and at end).
Frame size
Frame size typeThe size of the frame. Can be specified relatively (* or in percentage) or absolutely (in pixels).
Npx - Absolute frame size (in pixels) - For example 50px or 50.
N% - Relative frame size (in percentage) - Relative frame size defined in percentage of the parent frame size decreased by the size of the other frames with absolute sizes. For example 25%.
* - Available remainder of the parent frame size - (asterisk) Complete accessible remainder (or its proportional part, if there is more of such frames).
The sizes of other frames are subtracted from the size of parent frame.
Remaining size is devided to all frames of the same level which requested remaining size.
Frame sizeIt is used for entering the value of the absolute size of the frame in pixels or the relative size of the frame in percentage.
Minimum width (px)Minimum frame width (in pixels).
Not used if the "Frame size type" configurator is set absolutely (in pixels).
If not set, then it is possible to decrease the size of the frame down to zero.

The minimum size can be entered in each individual frame, but it can also be set in the root frame (in the main frame with MainFrame identifier) separately for local and Web application.

Setting the minimum size ("Minimum width" or "Minimum height") is important, for example, when the workspace is enabled on the Web and displayed on small displays of handheld devices (Android smartphones...).
In such case the workspace is displayed very small (so it fits the small display), cannot be zoomed and is dificult to scroll.
For these cases it is recommended to define minimum size as the displays of supposed devices would be (e.g. according to configurators Panel width / Panel height of displayed PmaPanel object).
Minimum height (px)Minimum frame height (in pixels).
Not used if the "Frame size type" configurator is set absolutely (in pixels).
If not set, then it is possible to decrease the size of the frame down to zero.

The minimum size can be entered in each individual frame, but it can also be set in the root frame (in the main frame with MainFrame identifier) separately for local and Web application.

Setting the minimum size ("Minimum width" or "Minimum height") is important, for example, when the workspace is enabled on the Web and displayed on small displays of handheld devices (Android smartphones...).
In such case the workspace is displayed very small (so it fits the small display), cannot be zoomed and is dificult to scroll.
For these cases it is recommended to define minimum size as the displays of supposed devices would be (e.g. according to configurators Panel width / Panel height of displayed PmaPanel object).
PROMOTIC 9.0.27 SCADA system documentation MICROSYS, spol. s r.o.

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