Preconfiguration "Button with icon"

Creates object configured as button.

This preconfiguration can be activated when creating a new Pmg object.

This preconfiguration is included in the "/ Button / One-state button" group.

The created PmgCanvas object has following variables:

title - text displayed in button

mode - (system variable) defines the appearance of the button if focused or cursor hovering over the object

push - (system variable) defines the appearance of the button if pressed

The events onKeyPress and onMousePress solve the conditions that are defined for calling the designer method onPressUp or onPressDown.

Designer 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 (by selection 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:

The name of created object	Name (identifier) of the Pmg object. It is used for obtaining 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 characters), empty string, spaces and first character must not be a number.
Button text	Text written into the title variable.

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;) Status change confirmation dialog Open form window (PmForm) Date and time entry Window (PmForm) Date and time entry Window (PmForm) - (time from/to) Selection of the item from the list Multi-selection from the list of items Selection of the item from the list in the multi-level menu
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. - It allows this window to be referenced, for example: - the method Pm.WndOper(0, "_blank.xy", 10) closes the window with xy identifier. This is a system name, so it must contain only alphanumeric and must not contain any diacritics (i.e. national dependent characters), spaces and 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
Image color	Setting of the color of the image. For some images this configurator sets the value of the imgColor variable of the PmgCanvas object. For some types of images this configurator is not displayed.
Image rotation	Rotation of the image in degrees (45, 90, 180, ...). For some images this configurator sets the value of the rotateAngle variable of the PmgCanvas object. For some types of images this configurator is not displayed.
Flip image	Specifies whether the image should be flipped along the vertical axis. For some types of images this configurator is not displayed. No Yes
State	The state of a device or component, e.g. the condition of a switch. For some panels this configurator sets the value of the state variable of the PmgCanvas object. For some types of images this configurator is not displayed.
Rotation of the moving part	The angle of rotation of a moving part, e.g. propeller or flap (0 - 360°). For some images this configurator sets the value of the rotate variable of the PmgCanvas object. For some types of images this configurator is not displayed.
Icon selection	Opens a window for selection of the image
Preview	Image preview