Differences

This shows you the differences between two versions of the page.

--- mistudio:design_editor:basic_layout:active_controls:button_style_common_properties [2026/09/18 13:34] – removed - external edit (Unknown date) 127.0.0.1
+++ mistudio:design_editor:basic_layout:active_controls:button_style_common_properties [2026/09/18 13:57] (current) – tputman
@@ Line 1: / Line 1: @@
+===== Button-Style Control Common Properties =====
+This page documents common properties shared by button-style active controls in MIStudio.
+Button-style controls include:
+  * [[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]]
+==== Overview ====
+Button-style controls are Active Controls that users can click at runtime.
+They are commonly used to send values, trigger actions, display on/off states, show labels or images, and provide button-style interaction in an application.
+Not every button-style control supports every property listed on this page. Check the individual control page for differences specific to that control.
+==== Common Uses ====
+Button-style controls can be used for:
+  * Creating clickable controls
+  * Sending on/off values
+  * Triggering application logic
+  * Displaying button labels
+  * Displaying button images
+  * Showing enabled, disabled, on, or off states
+  * Opening or triggering a configured action
+==== Common Basic Properties ====
+**Name** Sets the name of the control.
+**Draw Label** Controls whether the label text is displayed.
+**Font** Controls the font used for the label.
+**Label Color** Sets the color used for the label text.
+**Color On** Sets the color used for the on state, if supported.
+**Color Off** Sets the color used for the off state, if supported.
+**Label For On** Sets the text displayed when the control is in the on state.
+**Label For Off** Sets the text displayed when the control is in the off state, if supported.
+**Value for On** Sets the output value used for the on state.
+**Value for Off** Sets the output value used for the off state.
+**Click Action** Defines the action used when the control is clicked, if supported.
+==== Common Image Properties ====
+**Image On Name** Selects an image to display when the control is in the on state.
+**Image Off Name** Selects an image to display when the control is in the off state, if supported.
+**Disabled Image** Selects an image to display when the control is disabled, if an image is configured.
+**Image Resizes** Controls whether the selected image resizes to fit the control area.
+**Disabled Text** Sets the text displayed when the control is disabled, if supported.
+==== Common Expert Properties ====
+**Bad Qual. Indicator** Controls the indicator used when the control receives bad quality data.
+**Warning Qual. Indicator** Controls the indicator used when the control receives warning or transitional quality data.
+**Bezel** Sets the bezel style.
+**Bezel Color** Sets the outside bezel color.
+**Bezel Inside Color** Sets the inside bezel color.
+**Bezel Thickness** Sets the thickness of the bezel.
+**Cursor** Sets the cursor shown when the pointer is over the control.
+**Depth** Sets the depth used when the control is drawn with a 3D appearance.
+**Draw 3D** Controls whether the control is drawn with a 3D appearance.
+**Enabled** Controls whether the user can interact with the control.
+**Authorized Groups** Defines authorized groups for the control, if security or authorization is configured.
+**Rotation** Sets the control rotation.
+**Visible** Controls whether the control is shown.
+==== Runtime Behavior ====
+At runtime, button-style controls can respond to user clicks and send output values or trigger configured actions.
+A typical on/off setup uses **Value for Off** and **Value for On**. These are commonly configured as 0 for off and 1 for on.
+==== Notes ====
+The exact properties available depend on the selected control and the current MIStudio version.
+For general active control behavior, see [[mistudio:design_editor:active_control_common_properties|Active Control Common Properties]].
+==== Related Pages ====
+  * [[mistudio:design_editor:start|MIStudio Design Editor]]
+  * [[mistudio:design_editor:basic_layout:active_controls:start|Active Controls]]
+  * [[mistudio:design_editor:active_control_common_properties|Active Control Common Properties]]
+  * [[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]]