XRThreeState (Compact 2013)

  • Article

3/28/2014

This enumeration contains values that specify the possible toggle states of a UI element such as an IXRCheckBox control.

Syntax

enum XRThreeState
{
        XRThreeState_Unchecked,
        XRThreeState_Checked,
        XRThreeState_Indeterminate,
};

Members

  • XRThreeState_Unchecked
    The UI element is not selected, checked, marked, or otherwise activated.
  • XRThreeState_Checked
    The UI element is selected, checked, marked, or otherwise activated.
  • XRThreeState_Indeterminate
    The UI element is in an indeterminate state.

Remarks

A control must cycle through its toggle states in the following order:

  1. XRThreeState_Unchecked
  2. XRThreeState_Checked
  3. XRThreeState_Intermediate (if supported by the control)

The XRThreeState_Indeterminate value can be used to indicate whether the user has acted on a control. For example, a check box can be displayed as checked or with a dash, which indicates an indeterminate state.

Creating an indeterminate state is different from disabling the control. Consequently, a check box in the indeterminate state can still receive the focus. When the user clicks an indeterminate control, the XRThreeState value cycles to the next value.

.NET Framework Equivalent

System.Windows.Automation.ToggleState

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

XAML for Windows Embedded Enumerations
IXRRadioButton
IXRToggleButton::GetIsChecked
IXRToggleButton::SetIsChecked