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.
On this page:
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, it can have the state Checked or Not Checked, and its visual reflecting that state.
See PushButton Control for more information.
Configuration
Button 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.
- 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. |
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.
In this section: