Preconfiguration "Button"
Creates object configured as button.
This preconfiguration can be activated when
creating a new Pmg object and is included in the group:
"/ Button / One-state button".
The created
PmgCanvas object has following
variables:
title - text displayed in button
mode - (system variable) defines the look of the button if focused or cursor hovering over the object
push - (system variable) defines the look of the button if pressed
The events
onKeyPress and
onMousePress solve the conditions that are defined for calling the designer's method
onPressUp or
onPressDown.
Designer's methods onPressUp or
onPressDown on the "
Methods" tab of the
Pmg object are used to define action that will be connected with pressing and releasing the button. But the button configured as
Menu (selected from button menu) has the item selection and user actions configured in events
onMenuFill and
onMenuSelect.
There are variables that affect the button and text color, text size and margins in the script on the "
Draw" tab.
These configurators can be set before the preconfiguration is created:
| Object name | Name (identifier) of the Pmg object. It is used to obtain the Pmg object by the PmgObject.Items method.
This configurator sets the initial value of the Name property.
The maximum name length is 30 characters. This is a system name, so it must contain only alphanumeric and must not contain any diacritics (i.e. national dependent chars), empty string, spaces and the first character must not be a number. |
|---|
| Button text | Text written into variable title. |
|---|
|
| Action |
Simple example - Releasing the button
Simple example - Pressed and released button
Simple example - Selection from button menu
Open panel - in the main frame (target:main;)
Open panel - in this frame (target:_self)
Open panel - in a separate window (target:_blank;)
Open modal panel (target:_blank;modal:1;)
Opening the viewer for option selection (/#glob/list) with item selection from menu
Status change confirmation dialog
Open form window (PmForm)
Open form window - (time from)
Open form window - (time from/to)
Multi-selection from the list of items |
|---|
| Path to panel | |
|---|
| Identifier of the window (blankid) | Identifier of the independent or modal window.
If a window with blankid identifier already exists then the new viewer opens in current window, otherwise it opens in a new window.
The meaning of the identifier:
- Prevents opening a large number of windows with the same identifier.
- Allows this window to be referenced, for example:
- the method Pm.WndOper(0, "_blank.xy", 10) closes the window with the identifier "xy". This is a system name, so it must contain only alphanumeric and must not contain any diacritics (i.e. national dependent chars), spaces and the first character must not be a number. |
|---|
| Question before confirming the action | |
|---|