Checkable Menu Items

In This Topic

You can make any C1MenuItem a checkable menu item by setting its IsCheckable property to True. The value of the IsChecked property determines whether or not the menu item is checked or unchecked. By default, the IsChecked property of an item is False. When the item is clicked, the value of the IsChecked property sets to True.

You can create a group of mutually exclusive checkable items by setting the GroupName property of each item you wish to add to the group. For example, the XAML below will create a group of three mutually exclusive checkable items.

XAML	Copy Code
<c1:C1MenuItem Header="MenuItem1" IsCheckable="True" GroupName="MutuallyExclusiveGroup"/> <c1:C1MenuItem Header="MenuItem2" IsCheckable="True" GroupName="MutuallyExclusiveGroup"/> <c1:C1MenuItem Header="MenuItem3" IsCheckable="True" GroupName="MutuallyExclusiveGroup"/>

XAML

Copy Code

<c1:C1MenuItem Header="MenuItem1" IsCheckable="True" GroupName="MutuallyExclusiveGroup"/>
<c1:C1MenuItem Header="MenuItem2" IsCheckable="True" GroupName="MutuallyExclusiveGroup"/>
<c1:C1MenuItem Header="MenuItem3" IsCheckable="True" GroupName="MutuallyExclusiveGroup"/>

To create checkable menu items, use one of the following methods:

In XAML
In Code
At Design Time

Complete the following steps:

Locate the <c1:C1MenuItem> tag for the menu item you wish to make checkable and then add IsCheckable="True" to the tag so that the XAML resembles the following:

XAML
Copy Code
<c1:C1MenuItem Header="C1MenuItem" IsCheckable="True"/>
Optional: If you want the item to be checked at run time, you can also add IsChecked="False" to the tag.

XAML	Copy Code
<c1:C1MenuItem Header="C1MenuItem" IsCheckable="True"/>

Run the project.

Complete the following steps:

In Source view, locate the <c1:C1MenuItem> tag for the item you wish to make checkable and add x:Name="CheckableMenuItem" to it. This will give the item a unique identifier that you can use in code.
Enter Code view and add the following code beneath the InitializeComponent() method:

Visual Basic
Copy Code
CheckableMenuItem.IsCheckable = True

Visual Basic	Copy Code
CheckableMenuItem.IsCheckable = True

C#
Copy Code
CheckableMenuItem.IsCheckable = true;
Optional: If you want the item to be checked at run time, you can add the following code to the project:
Visual Basic
Copy Code
CheckableMenuItem.IsChecked = True
C#
Copy Code
CheckableMenuItem.IsChecked = true;

C#	Copy Code
CheckableMenuItem.IsCheckable = true;

Visual Basic	Copy Code
CheckableMenuItem.IsChecked = True

C#	Copy Code
CheckableMenuItem.IsChecked = true;

Run the program.

Complete the following steps:

In Source view, select the C1MenuItem that you wish to make checkable.
In the Properties window, select the IsCheckable check box to set the IsCheckable property to True. This makes the item checkable at run time.

Optional: If you want the item to be checked at run time, you can also select the IsChecked check box, but doing so isn't necessary to make an item checkable.

Run the project.