ErgoTechWiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== URLButton =====

com.ergotech.vib.graphics.URLButton

==== Image Examples ====

| {{:mistudio:graphics:basic_layout:active_controls:pasted:20260622-142654.gif?35|URLButton in the graphics palette}} | {{:mistudio:graphics:basic_layout:active_controls:pasted:20260622-142543.png?100|URLButton graphic example}} |
| //URLButton in the graphics palette.// | //URLButton graphic example.// |

==== Overview ====

The URLButton graphic is an Active Control based on the [[mistudio:design_editor:basic_layout:active_controls:button|Button]] graphic.

A URLButton is used to switch applications in an MIStudio project or launch a web browser window with an external URL.

The default label is **Switch To ...** and can be changed to describe the application or web page the button opens. An image can also be added to change the button appearance.

URLButton shares many common properties with other button-style controls. See [[mistudio:design_editor:basic_layout:active_controls:button_style_common_properties|Button-Style Control Common Properties]] for shared label, image, bezel, quality indicator, enabled, rotation, and visibility properties.

==== Common Uses ====

  * Switching to another application in the project
  * Opening an external URL in a web browser
  * Creating a navigation button
  * Creating a button bar for application screens
  * Linking to documentation, support pages, dashboards, or other web resources

==== Input Behavior ====

A URL can be sent to the URLButton input.

When a URL is sent to the input, the web page is loaded into the web browser.

==== Output Behavior ====

URLButton does not provide an output.

==== Click Action ====

The most important URLButton property to configure is **Click Action**.

The Click Action panel controls what happens when the URLButton is clicked at runtime.

The available options include:

  * **Switch To** Used to switch to another application in the project.
  * **External URL** Used to open an external web page or web resource.
  * **None** No click action is configured.

The URLButton can also receive a URL through its input. When a URL is sent to the input, the web page can be loaded into the web browser.

==== Difference From Button ====

URLButton has many of the same properties as [[mistudio:design_editor:basic_layout:active_controls:button|Button]], but it is designed for navigation and URL behavior.

Key differences include:

  * URLButton can switch applications or launch a web browser window.
  * URLButton has a single label.
  * URLButton can use a single image.
  * URLButton does not use Toggle Mode.
  * URLButton does not provide an output.

==== Notes ====

A group or bar of URLButtons can be created as an MIStudio Component and reused on application screens.

For shared active control behavior, see [[mistudio:design_editor:active_control_common_properties|Active Control Common Properties]].

For shared Button, PushButton, and URLButton settings, see [[mistudio:design_editor:basic_layout:active_controls:button_style_common_properties|Button-Style Control Common Properties]].

For button-style controls that send values or trigger general application logic, see [[mistudio:design_editor:basic_layout:active_controls:button|Button]] and [[mistudio:design_editor:basic_layout:active_controls:pushbutton|PushButton]].

==== 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:active_control_common_properties|Active Control Common Properties]]
  * [[mistudio:design_editor:basic_layout:active_controls:button_style_common_properties|Button-Style Control Common Properties]]
  * [[mistudio:design_editor:basic_layout:active_controls:button|Button]]
  * [[mistudio:design_editor:basic_layout:active_controls:pushbutton|PushButton]]
  * [[mistudio:design_editor:active_graphic|Active Graphic]]