Home Search

DriveWorks Pro 22
Toggle Switch

Send Feedback

Toggle Switch

Allows on or off (yes or no) selections to be made.

Image showing an example of the Toggle Switch on a user form

The Toggle Switch control allows users to make Boolean decisions that result in on or off selections to be made.

The default value of a Toggle Control is False.

The return value of the Toggle Switch is True or False.

This can be used by using the reference:

<ControlName>Return

Left of the slider will return False.

Right of the slider will return True.

Properties

Appearance

Appearance - Caption

Behavior

  • Checked

    Controls whether the check box is checked.

  • Checked (Override Rule)

    Controls whether the check box is checked.

  • Default Value

    Controls the default value of the control. If the default value is based on a rule and the value changes, then the value of the control will be changed to be the new default value.

  • Enabled

    Controls whether the control is enabled (if the result is TRUE) or disabled (if the result is anything other than TRUE, e.g. FALSE).

  • Error Result

    Determines whether the value of the control is in error. The result of this rule is a string containing the error message if the value is in error, otherwise a blank string or the number zero.

  • Tab Index

    Configures the position of the control in the form tab order.

  • Visible

    Determines whether the control is visible (TRUE) or hidden (FALSE).

Events

  • Macro Argument

    Provides an optional argument to the macro

  • On Change

    Determines the name of the macro to fire when the value of this control changes.

General

  • (Metadata)

    Optional text which can be used to provide information belonging to or about a control. For example, a list of CSS classes which can be parsed and applied to the control using the Integration Theme in DriveWorks Live. This doesn't affect the control's behavior.

  • (Name)

    The name of the control

  • (Tag)

    Optional text which can be used to describe the control, but which doesn't affect the control's behavior.

  • Tooltip Duration

    Controls the duration, in seconds, for which the tooltip will remain visible. Values of 0 and below indicate an infinite duration.

  • Tooltip Text

    Specifies the text to display in a tooltip when hovering over the control.

Layout

  • Height

    Controls the height of the control.

  • Left

    Controls the left position of the control.

  • Top

    Controls the top position of the control.

  • Width

    Controls the width of the control.