Promotic

SysButtons - property of the PmForm object

Description:
System button selection on the right side in the form viewer.
Syntax:
String SysButtons
Values:
The values "auto" and "" are entered individually and cannot be merged with others. Other values can be merged (separator is comma) - it means that all buttons are displayed.
"auto" (default) - System buttons will be selected automatically depending on where is the form viewed.
- If viewed in a separate window, then it is similar as "ok,cancel" option.
- If viewed in the PmaWorkspace object or in the PmgFrame object, then it is similar as "" option (i.e. system buttons are not displayed).
"" - No system buttons are displayed.
"ok" - The following button is displayed: OK.
After pressing this button the system tests the validity of entered values in the configurator (e.g. if the value is within defined limits - see Min property, Max property, etc.). If all values are OK, then the viewer closes with the value: oSystem.CloseReason = "ok".
"cancel" - The following button is displayed: Cancel.
After pressing this button, the system closes the viewer (without validity test) with the value: oSystem.CloseReason = "cancel".
"close" - The following button is displayed: Close.
After pressing this button, the system closes the viewer (without validity test) with the value: oSystem.CloseReason = "close".
"yes" - The following button is displayed: Yes.
After pressing this button, the system closes the viewer (without validity test) with the value: oSystem.CloseReason = "yes".
"no" - The following button is displayed: No.
After pressing this button, the system closes the viewer (without validity test) with the value: oSystem.CloseReason = "no".
Note:
Property access for read and write.
 
It is possible to write into this property only if the PmForm window has not been opened yet.
This property is also functional in Web panels.

When the viewer is closed the oExtra.onClose action is called. It can be used in roder to detect the close reason by means of the oSystem.CloseReason property.
If the viewer is closed by another non-system button (by Esc key or by close button in the window title bar), then it is closed with the value: oSystem.CloseReason = "".
See also:
- PmForm.SysLayoutPos (property)
- PmForm.Close (method)
Example:
JavaScriptSelect and copy to clipboard

oForm.SysButtons = "ok,cancel";   // Writing into the property
var sSysButtons = oForm.SysButtons;   // Reading from the property

History:
Pm8.03.09: Created
PROMOTIC 9.0.27 SCADA system documentation MICROSYS, spol. s r.o.

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