Preconfiguration "Button with icon"

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

Image (text) location in button	Image and text location in button. Whole area (no text) Top (text centered down) Left (text behind image on left) Left (text centered to the right) Left (text to right edge) Right (text to left edge) Right (text centered left) Right (text to image right)
Text color	Text color
Background color	Image background color
Icon selection	Opens image selection window
Preview	Image preview