MenuItem.Checked Property
Gets or sets whether the menu item is checked.
Namespace: DevExpress.Web
Assembly: DevExpress.Web.v24.1.dll
NuGet Package: DevExpress.Web
Declaration
Property Value
| Type | Default | Description |
|---|---|---|
| Boolean | false |
|
Remarks
Use the Checked property to specify the menu item’s check state (checked or unchecked). The capability to manipulate the check state of menu items is useful when, for instance, you use ASPxMenu to implement a kind of toolbar.
A menu item can function as a check box if the item belongs to a logical group defined via the item’s MenuItem.GroupName property. To arrange an item/items into a logical group, set its/their MenuItem.GroupName property to the same value. Arranging several menu items into a group makes them function as radio buttons - checking an item unchecks the one previously selected. So, only one menu item in a group can be checked at one time.
Note
If the ASPxMenuBase.AllowSelectItem is enabled or the ASPxMenuBase.ItemLinkMode property is not set to ItemLinkMode.ContentBounds, the check state of menu items cannot be manipulated (obtained or set) on the client side, either programmatically or via UI.
Example
This example demonstrates how the checked state of items can be manipulated to emulate the toolbar behavior (using the ASPxMenu control).
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>
<%@ Register Assembly="DevExpress.Web.v8.3, Version=8.3.2.0, Culture=neutral,
PublicKeyToken=b88d1754d700e49a"
Namespace="DevExpress.Web.ASPxMenu" TagPrefix="dxm" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>Check states of items</title>
</head>
<body>
<form id="form1" runat="server">
<br/>
<dxm:ASPxMenu ID="ASPxMenu1" runat="server" ItemSpacing="1px"
SeparatorColor="Transparent"
SeparatorHeight="15px" SeparatorWidth="2px">
<Items>
<dxm:MenuItem GroupName="Bold" Text="">
<Image Url="~/ASPxperience/Menu/Images/bold.gif" />
</dxm:MenuItem>
<dxm:MenuItem GroupName="Italic" Text="">
<Image Url="~/ASPxperience/Menu/Images/italic.gif" />
</dxm:MenuItem>
<dxm:MenuItem GroupName="Underline" Text="">
<Image Url="~/ASPxperience/Menu/Images/underline.gif" />
</dxm:MenuItem>
<dxm:MenuItem BeginGroup="True" GroupName="Align" Text="" Checked="True">
<Image Url="~/ASPxperience/Menu/Images/left.gif" />
</dxm:MenuItem>
<dxm:MenuItem GroupName="Align" Text="">
<Image Url="~/ASPxperience/Menu/Images/center.gif" />
</dxm:MenuItem>
<dxm:MenuItem GroupName="Align" Text="">
<Image Url="~/ASPxperience/Menu/Images/right.gif" />
</dxm:MenuItem>
<dxm:MenuItem GroupName="Align" Text="">
<Image Url="~/ASPxperience/Menu/Images/justify.gif" />
</dxm:MenuItem>
</Items>
<ItemStyle>
<Paddings Padding="2px" />
<HoverStyle BackColor="#B6BDD2">
<Border BorderColor="#0A246A" BorderWidth="1px" />
</HoverStyle>
<CheckedStyle BackColor="#D4D5D8">
<Border BorderColor="#0A246A" BorderWidth="1px" />
</CheckedStyle>
</ItemStyle>
<Paddings Padding="1px" />
<BackgroundImage ImageUrl="~/ASPxperience/Menu/Images/back.gif" />
<SeparatorPaddings PaddingLeft="2px" PaddingRight="2px" />
<SeparatorBackgroundImage ImageUrl="~/ASPxperience/Menu/Images/separator.gif"
Repeat="NoRepeat" />
</dxm:ASPxMenu>
</form>
</body>
</html>