ErgoTechWiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== 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 an MIStudio application requires 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 properties that are specific to that control and link back to this page for shared behavior.

Active controls also share behavior with [[mistudio:design_editor:active_graphic|Active Graphic]] components, including 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
  * Allow users to interact with an MIStudio application

==== Common Properties ====

Not every active control supports every property listed below. 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.

For general graphic behavior, see [[mistudio:design_editor:active_graphic|Active Graphic]].

==== Related Pages ====

  * [[mistudio:design_editor:start|MIStudio Design Editor]]
  * [[mistudio:design_editor:basic_layout:start|Basic Layout]]
  * [[mistudio:design_editor:basic_layout:active_controls:start|Active Controls]]
  * [[mistudio:design_editor:basic_layout:active_controls:button|Button]]
  * [[mistudio:design_editor:basic_layout:active_controls:pushbutton|PushButton]]
  * [[mistudio:design_editor:basic_layout:active_controls:urlbutton|URLButton]]
  * [[mistudio:design_editor:active_graphic|Active Graphic]]