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 | It specifies Specifies the text displayed with in the Buttonbutton. |
Localize | It enables Enables the label text can to be dynamically adjusted based on the user's user’s locale settings, ensuring the interface is accessible and understandable to 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
In Runtime Execution, users interact with components dynamically. When users press 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 the configured actionsevent handlers in the solution, which carry out the designated operation, such as updating starting a value, opening a displaymachine, submitting data, or executing opening a script. These interactions happen in real time, providing immediate feedback and functionality based on development configurations.new interface.
In this section:
Page Tree | ||||
---|---|---|---|---|
|