Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Setup of the Options default values

Description:
The 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.

 
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.
 
This configuration window can be opened in the configurator PmPanel > Panel > sOptions default value.
Configuration items:
This configuration is for: Here it is possible to select the desired default window type (the way the panel will be displayed). According to this setting, additional configugurators become visible/invisible. This configurator does not affect the resulting values, it only makes the configurators easier to fill in.
Window in frame in Workspace or in graphic item - The panel is to be displayed either in the PmWorkspace object (see PmPanel.OpenView) or in the PmiWFrame graphic item (see PmiWFrame.Src).
Stand-alone or modal window - The panel is to be displayed as an independent modal window
Where to open the window (target)Defines where will viewer be opened. This configurator is visible only if the configuration is for: "Window in frame in Workspace or in graphic item".
frameid - The new viewer is opened in PmWorkspace object in frame with frameid identifier.
_blank - The new viewer is opened in a new window.
target:_self; - The new viewer is opened in the current window (frame) and the viewer, over which the method was called, is closed.
Modal window (modal)Defines the modal window option. This configurator is visible only if the configuration is for: "Stand-alone or modal window".
0 - No (default) - The window will not be modal.
1 - Yes - The window will be modal.
Caption enabled (caption)Defines whether the window has the header or not (i.e. the blue stripe on top). This configurator is visible only if the configuration is for: "Stand-alone or modal window".
0 - No - The window will have no header. So far it is not functional when opening WEB panel.
1 - Yes (default) - The window will have the header.
Application dependent (dependent)Defines the window dependency on the application main window. This configurator is visible only if the configuration is for: "Stand-alone or modal window".
0 - No - The window will be independent on the application main window. So far it is not functional when opening WEB panel.
1 - Yes (default) - The window will be dependent on the application main window.
Always on top (ontop)Defines whether the window will be "Always on top". This configurator is visible only if the configuration is for: "Stand-alone or modal window".
0 - No (default) - The window will not be "Always on top".
1 - Yes - The window will be "Always on top". So far it is not functional when opening WEB panel.
Initial state (state)Defines the initial state of the window. This configurator is visible only if the configuration is for: "Stand-alone or modal window".
normal (default) - The window will be displayed normally (neither maximalized nor minimalized).
max - The window will be maximalized. So far it is not functional when opening WEB panel.
Forbid state change (fixed:state)Forbids to change the window state (normal / maximized / minimized). This configurator is visible only if the configuration is for: "Stand-alone or modal window".
No (default) - The window state can be changed.
Yes - The window state cannot be changed.
Initial position (pos)Defines the initial position of the window in normal state. This configurator is visible only if the configuration is for: "Stand-alone or modal window".
top,center (default) - The window will be displayed in the center of the active application window (workspace).
top,x,y - The window will have the top left corner in coordinates x and y (in pixels) relative to the active application window (workspace).
frame,center - The window will be displayed in the center of the window from which the new window was opened.
view,x,y - The window will have the top left corner in coordinates x and y (in pixels) relative to content of the window from which it is opened.
Forbid position change (fixed:pos)Forbids to change the position of the window in normal state. This configurator is visible only if the configuration is for: "Stand-alone or modal window".
No (default) - The position of the window in normal state can be changed.
Yes - The position of the window in normal state cannot be changed.
Initial size (size)Defines the initial size of the window in normal state. This configurator is visible only if the configuration is for: "Stand-alone or modal window".
panel (default) - The size of the window will be set in order to contain the whole opened panel (i.e. no scrollbars are created). Width and height of the panel is defined in the panel editor in PmiRoot object on the Panel page.
Dx,Dy - The size of the window will be defined by the dx and dy values (in pixels). These values define the outer size of the window (i.e. inctluding the margins and window title bar).
Forbid change of size (fixed:size)Forbids to change the size of the window in normal state. This configurator is visible only if the configuration is for: "Stand-alone or modal window".
No (default) - The size of the window in normal state can be changed.
size - The size of the window in normal state cannot be changed.
size2 - Disables changing the size of the window in normal state - the window size cannot be larger than the size of corresponding panel.
Display the scrollbars (scrollbar)Defines whether the window will have the scroll bars for moving the contents, if the panel size is greater than the size of the window, the panel is inside.
0 - No - The scrollbars will not be displayed and therefore the content cannot be scrolled. It is handy for example for a window of the "toolbar" type, where the window is very narrow.
1 - Yes (default) - The window will display the scrollbars automatiacally thus allwing to scroll the panel, if the panel size is greater than the size of the window, the panel is inside.
Refresh period (refresh)Only for opening the PmPanel object viewer. Defines whether the panel has the automatic refresh according to the globally set system period or the panel has its own refresh rate. So far it is not functional when opening WEB panel.
system (default) - The panel will have the automatic refresh according to the globally set system period (See PmRoot > Application > Panels timer period).
0 - No - The panel will have its own refresh, i.e. the PmPanel.Refresh method will be called.
Additional parameters Additional parameters, that do not have specific configurators. The final string will consist of the values of specific configurators, that will be combined with the value of this configurator.
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice