Overview and Key Concepts

Dashboard widgets allow you to view and control parts of your model through a graphical interface. You can create input fields, buttons, tables and other input widgets.

Model Input Properties

The following shows the available model input properties from the Dashboard library:

It has the following options:

Text

Specify the title or text of the control.

Available for:

• Static Text
• Checkbox
• Radio Button
• Button

Link

Specify the path to a node in the model. If the widget is an Edit or Dynamic Text, the Link can also be to a Global Variable.

Available for:

• Dynamic Text
• Edit
• Checkbox
• Radio Button
• Combobox
• Listbox
• Tracker
• Table
• Button
• GUI Class

Hover Hint Text

This text will be displayed as a tooltip when the user hovers their mouse over the control.

Available for:

• Dynamic Text
• Edit
• Checkbox
• Radio Button
• Combobox
• Listbox
• Tracker
• Button

Image

Displays an image instead of text for the control.

Available for:

• Static Text
• Button

Font

Specifies the font name, size, properties and color of the control's text (color only available for Static Text, Dynamic Text and Edit controls).

Available for:

• All (except GUI Class)

Triggers

Some model input objects have triggers that fire, allowing you to execute your own custom code. It has the following properties:

• OnPress - Fires when a button, checkbox or radio button are pressed.
• OnApply - Fires when the enter key is pressed in an edit field and when you click off of an edit field (focus is removed).
• OnDrag - Fires as a tracker is clicked/dragged
• OnSelect - Fires when an item in the combobox/listbox is selected.

ID

A Dashboard Control's ID is a string that allows you to easily reference the control through code or picklist options. Use the getdashboardcontrol() command to get a reference to the model input object (the field, button, etc).

Available for:

• All

Combobox and Listbox Options

A list of items to display in the combobox/listbox drop down. Values must be numeric.

Tracker

The tracker has the following properties:

• Minimum Value - The minimum value of the tracker.
• Maximum Value - The maximum value of the tracker.
• Exponential Value - Changes the distribution of values between the minimum and maximum to be exponential. Setting this value to 1 will cause the tracker to be linear.
• Style - Changes the style of the thumb button.
• Vertical - If checked, the tracker will display vertically.

Spinner

The spinner has the following properties:

• Minimum Value - The minimum value of the spinner.
• Maximum Value - The maximum value of the spinner.
• Step Size - The amount the spinner increments the value by with one click.