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 not outside the limit - 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 event is triggered. 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 the
Esc key or by close button in the window title bar), then it is closed with the value:
oSystem.CloseReason =
"".
Example:
JavaScriptSelect and copy to clipboard
oForm.SysButtons = "ok,cancel";
// Writing into the property
var sSysButtons = oForm.SysButtons;
// Reading from the property