IXRToggleButton (Windows Embedded CE 6.0)

Article
01/05/2012

1/6/2010

This class represents the base class for button controls that can switch states.

Syntax

class IXRToggleButton : public IXRButtonBase

Methods

Method	Description
IXRToggleButton::AddCheckedEventHandler	Attaches a delegate to the Checked event for this toggle button. When the Checked event is raised by this toggle button, this delegate will be invoked.
IXRToggleButton::AddIndeterminateEventHandler	Attaches a delegate to the Indeterminate event for this toggle button. When the Indeterminate event is raised by this toggle button, this delegate will be invoked.
IXRToggleButton::AddUncheckedEventHandler	Attaches a delegate to the Unchecked event for this toggle button. When the Unchecked event is raised by this toggle button, this delegate will be invoked.
IXRToggleButton::GetIsChecked	Retrieves a value that indicates whether this toggle button is in a checked state.
IXRToggleButton::GetIsThreeState	Retrieves a value that indicates whether this toggle button supports two or three states.
IXRToggleButton::RemovenCheckedEventHandler	Removes a delegate from the Checked event for this toggle button.
IXRToggleButton::RemoveIndeterminateEventHandler	Removes a delegate from the Indeterminate event for this toggle button.
IXRToggleButton::RemoveUncheckedEventHandler	Removes a delegate from the Unchecked event for this toggle button.
IXRToggleButton::SetIsChecked	Sets a value that indicates whether this toggle button is in a checked state.
IXRToggleButton::SetIsThreeState	Sets a value that indicates whether this toggle button supports two or three states.

Remarks

The IXRToggleButton class represents a toggle button that can switch to multiple states. The toggle button switches to another state when a user clicks on it. IXRToggleButton is the base class for IXRCheckBox and IXRRadioButton.

A toggle button can change its state to a maximum of three different states. For example, you could use a three-state toggle button to support "Yes", "No", and "Not Applicable" options for the user to choose from. When the toggle button raises a Checked event, you can query the state of the sending object to determine how to handle the event.

To access or modify the current state of this toggle button, use the methods IXRToggleButton::GetIsChecked and IXRToggleButton::SetIsChecked.

A toggle button can be configured to have three states, which enables the user to select a third, indeterminate state for the button by clicking it. To determine whether this toggle button has two or three states, call IXRToggleButton::GetIsThreeState. To enable the indeterminate state, call IXRToggleButton::SetIsThreeState.

You can also define a toggle button in Microsoft Silverlight 2 XAML. For information about the differences between XAML in Silverlight for Windows Embedded and Silverlight 2, see Differences Between Silverlight for the Web and Silverlight for Windows Embedded. For more information about how to define this element in the source XAML for your application, see this Microsoft Web site.