Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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
maxLevel3
stylenone


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

  1. Go to Displays / Draw.
  2. On the Components Panel, select
the
  1.  Interaction
components category, and drag and drop the button
  1. , then Button.
  2. Click or drag-and-drop it on the Drawing
Area
  1. area to use it.
  2. Double-click the component to open the configuration
popup for adjustments
  1. 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

It defines It defines it It It you link :User: {Client.CurrentUser.Name.ToString().ToUpper()}

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.

Image Added


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.

Image Added


In this section:

Page Tree
root@parent
spacesV10