IXRCheckBox (Compact 2013)

3/28/2014

This class represents a control that a user can select (check), or clear (uncheck).

Syntax

class IXRCheckBox : public IXRToggleButton

Inheritance Hierarchy

IXRDependencyObject

    IXRUIElement

        IXRFrameworkElement

            IXRControl

                IXRButtonBase

                    IXRToggleButton

                        IXRCheckBox

Methods

This class implements no new methods. All its methods are inherited from IXRToggleButton.

Thread Safety

Members of this class are thread-safe if you previously called IXRApplication::CreateHostFromXaml and supplied it with an XRWindowCreateParams structure that has AllowsMultipleThreadAccess set to true.

Remarks

The IXRCheckBox control inherits from IXRToggleButton and can have three states: checked, unchecked, and indeterminate.

Use the IXRCheckBox control to provide a list of options that a user can select, such as a list of settings to apply to an application.

Both IXRCheckBox and IXRRadioButton controls allow the user to select from a list of options. Check-box controls allow the user to select a combination of options. In contrast, radio-button controls allow the user to select from mutually exclusive options.

IXRCheckBox is also a content control and inherits from IXRContentControl. You can retrieve its content by calling the inherited method IXRContentControl::GetContent.

When you create a class instance, use an IXRCheckBoxPtr smart pointer instead of a raw interface pointer. For more information, see XRPtr<Interface>.

You can also define a check box in Microsoft Silverlight 3. For information about the differences between XAML in XAML for Windows Embedded and Silverlight 3, see Differences Between Microsoft Silverlight 3 and XAML for Windows Embedded. For more information about how to define this element in the source XAML for your application, see the CheckBox Class on MSDN.

.NET Framework Equivalent

System.Windows.Controls.CheckBox

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

Classes for UI Element Management