The Button Control in the software platform allows users to create interactive buttons for applications. It includes a mechanism for initiating actions or commands within the interface. The functionality includes customizable label text , with positioning options (Auto, Top, Left, Inside, None), and width settings, with an option to auto-set the width to 80.
On this page:
| Table of Contents | ||||
|---|---|---|---|---|
|
Requirements
The TButton is a Portable component, functioning on both Windows and web pages across any platform. It is compatible with WPF and HTML5 displays, offering versatile use without any specific requirements.
Button vs PushButton (or ToggleButton)
The Button and PushButton controls have similar appearance, but there are distinctions on how typically they are used.
The Button is typically used in combination with the Action Dynamic. When there is an action connected with the Button, its appearance will automatically act to the Mouse Over events, and when is pressed, a visual feedback is provided. The pressed visual stays only while the button is pressed, there is no state or dynamic property connected with the Button.
The PushButton (or ToggleButton), on the other hand, can be in either a Checked or Not Checked state, with its appearance reflecting the current state.
See PushButton Control for more information.
Configuration
Button Settings configuration include Label Text for button naming, Localize checkbox for localization, and Label Settings for positioning (Auto, Top, Left, Inside, None). Width settings offer manual adjustment or an Auto checkbox set to 80. To configure, navigate to
- Go to Displays / Draw.
- On the Components Panel, select
- Interaction
- , then Button.
- Click or drag-and-drop it on the Drawing
- area to use it.
- Double-click the component to open the configuration
- window.
Button Settings | |
|---|---|
Field | Description |
Label Text | Specifies the text displayed in the button. |
Localize | Enables the label text to be dynamically adjusted based on the user’s locale settings, ensuring the interface is accessible and understandable for users from different language backgrounds. |
Label Settings
Label Settings | |
|---|---|
Field | Description |
Position | Defines the label's position. There are the following options: Auto: The label position is determined automatically based on the available space and button size. Top: The label is positioned above the button. Left: The label is positioned to the left of the button. Inside: The label is positioned inside the button, usually centered. None: The button has no visible label. |
Width | Defines the label's width. |
Auto | When enabled, defines the label's width automatically. |
Preview | This option is available only when you link an object to the button. Preview options control the preview of the label content or data bindings. These options indicate the data linked to the button. Linked tag: Displays the object path of a linked tag, such as "Tag.Temperature.Value". Whitespace: Shows a white space as a placeholder. Placeholder: Displays the symbol "#" as a placeholder. |
Format | This option is available only when an object is linked to the button. It allows you to define an expression to format the selected label. For example, ‘N1’ formats a number with one decimal place. |
Hover Color
The colors of the button hover effect can be redefined under Display > Themes by adjusting the HoverBackground and HoverBorder options for the active theme.
Dynamics
Usually, configuring Graphic Elements also involves defining Dynamics for them. A dynamic defines how graphic elements respond to user inputs and other events, including handling clicks, updating displays in real-time, and dynamic data visualization. Refer to Dynamics and UI Elements for more information.
Runtime Execution
When users click a button, the application executes the associated command or action immediately. The button provides visual feedback, such as changing color or appearance, to indicate it has been pressed. This triggers event handlers in the solution, which carry out the designated operation, such as starting a machine, submitting data, or opening a new interface.
Runtime Execution
In Runtime, the control has embedded controls to allow the Operator to modify the view.
Typically the configuration settings of <> is attached to a Tag exposed in the Display User Interface, allowing the operator to select <.> .
In this section:
| Page Tree | ||||
|---|---|---|---|---|
|