Item
Items are contained in a group‘s MVCxRibbonGroup.Items collection. An action on the Item (for example, a button click or an editor value change) raises the ASPxClientRibbon.CommandExecuted event.
An item’s size can be small or large. Large items can be displayed in a small size when a ribbon has insufficient space to display all its items, provided that the small item images or text are specified.
The table below lists the main members that affect element appearance and functionality.
| Characteristics | Members |
|---|---|
| Access Key | RibbonItemBase.AccessKey |
| Drop-down Popup Style | RibbonStyles.ItemDropDownPopup (via RibbonSettings.Styles.ItemDropDownPopup) |
| Image | RibbonButtonItem.SmallImage, RibbonButtonItem.LargeImage |
| Item Separator Visibillity | RibbonItemBase.BeginGroup |
| Pop-out Image | RibbonImages.PopOut (via RibbonSettings.Images.PopOut) |
| Size | RibbonItemBase.Size |
| Style | RibbonItemBase.ItemStyle, RibbonStyles.Item (via RibbonSettings.Styles.Item) |
| Text | RibbonItemBase.Text |
| Tooltip | RibbonItemBase.ToolTip |
| Visibility | RibbonItemBase.Visible |
The following table outlines the element’s structural API:
| Structural Element | API Reference |
|---|---|
| Class | RibbonItemBase descendant |
| Collection | MVCxRibbonGroup.Items |
| Item Type | MVCxRibbonItemType (available though the MVCxRibbonItemCollection.Add method overloads) |
Refer to the Item Types topic to learn more about available item types.