This is an old revision of the document!
Table of Contents
Active Control Common Properties
Active controls are MIStudio graphics that users can interact with at runtime.
Common examples in the Basic Layout Active Controls group include Button, PushButton, and URLButton.
Overview
Active controls are used when a MIStudio application needs user interaction. A control may allow a user to click a button, send a value, open a link, or trigger behavior in the application.
Many active controls share common properties. Individual control pages should describe the properties that are specific to that control and link back to this page for shared behavior.
Active controls also share some behavior with Active Graphic components, such as visibility, labels, colors, and runtime value behavior.
Common Uses
Active controls can be used to:
- Create operator controls
- Trigger actions
- Send values to application logic
- Open a URL
- Let users interact with a MIStudio application
Common Properties
Not every active control supports every property listed below. The available properties depend on the selected control.
Basic
Name Identifies the control in the project.
Visible Controls whether the control is shown or hidden.
Enabled Controls whether the user can interact with the control.
Text or Label Controls the text displayed by the control, if supported.
Output and Interaction
PrimaryOutPort The main output value sent by the control when it is activated or changed.
Click Action Defines what happens when the control is clicked, if supported.
Click Count Defines the number of clicks required to trigger the click action, if supported.
Appearance
Font Controls the font used for control text.
Foreground Color Controls the text or foreground color, if supported.
Background Color Controls the background color, if supported.
Bezel Adds a border or styled edge around the control, if supported.
Runtime Behavior
At runtime, active controls can send values, trigger actions, or change application behavior based on user interaction.
For example:
- A Button may send a value when clicked.
- A PushButton may be used for press and release behavior.
- A URLButton may open a configured link.
Logic Connections
Active controls can appear in the Logic Editor as blocks with ports.
Depending on the control, a user action may send an output value to another logic component, data connection, or application behavior.
Notes
Not every active control supports every property listed on this page. Check the individual control page for details about that specific graphic.