Windows 窗体组件 > 产品 > XtraBars > 公共功能 > Bar Items 和 Links 清单

XtraBars 库提供了许多可以被添加到工具栏、子菜单、弹出式菜单和 Ribbon 控件中的 bar items。本文档提供了可用 bar items 及其对应的 bar item links 的列表。

Bar Item 和 Link 类型

每个 bar item 都由一个特定的派生于 BarItem 的类表示， BarItem 类是所有 bar items 的基类。当把一个 bar item 放置到 bar 或子菜单中，或者把它添加到 Ribbon 控件中时，将创建一个与 bar item 的类型相对应的 link。 Bar item links 的基类是 BarItemLink。

下表列示了由 XtraBars 套件提供的 bar items 及其对应的 links。

Item/Link

说明

BarButtonItem / BarButtonItemLink

BarButtonItem 类型表示工具栏按钮。按钮是工具栏上最普遍的元素。 BarButtonItem 项允许创建：

- 标准按钮；

- 复选按钮 (把 BarButtonItem.ButtonStyle 属性设置为 Check);

- 有下拉菜单的按钮 (把 BarButtonItem.ButtonStyle 属性设置为 DropDown)

- 复选按钮组 (使用 BarBaseButtonItem.GroupIndex 属性来组合形成复选组)。

编写 BarItem.ItemClick 或 BarBaseButtonItem.DownChanged 事件处理程序来定义按钮的行为。

注意
在 Ribbon 控件中，BarButtonItem 项仅支持大图像。在弹出式菜单中不支持 links 的大图像。

BarLargeButtonItem / BarLargeButtonItemLink

表示工具栏内的大按钮。

BarLargeButtonItem 继承了所有由 BarButtonItem 类 (请参阅上面) 提供的功能。另外，它允许指定项标题相对于图像的位置。

在弹出式菜单中，BarLargeButtonItems 被使用小图像呈现。如果没有为菜单项指派小图像，则仅显示它的标题。

注意
Ribbon 控件不支持 BarLargeButtonItem 项。使用 BarButtonItem 来代替。

BarCheckItem / BarCheckItemLink

表示可以有“选中”和“未选中”两种状态的按钮。接管 BarCheckItem.CheckedChanged 事件来对改变选中状态作出响应。

也可以使用 BarButtonItem 类型实现复选按钮。把 BarButtonItem 的 BarButtonItem.ButtonStyle 属性设置为 Check，就允许按钮有“选中”和“未选中”两种状态。

注意
在 Ribbon 控件中仅支持 BarCheckItems 的大图像。

BarSubItem / BarSubItemLink

表示包含在其他项中的子项。在视觉上，它被呈现为子菜单。使用 BarCustomContainerItem.ItemLinks 属性来添加子项。

注意
在 Ribbon 控件中仅支持 BarSubItems 的大图像。

BarStaticItem / BarStaticItemLink

此类型的项被用于表示工具栏和 Ribbon 控件上的静态文本。这种项可以被用作任何 bar item link 的标题。这种项不能被选中，也没有快捷键。但是可以单击它来调用 BarItem.ItemClick 事件。

BarEditItem / BarEditItemLink

这种项允许在 bars 和 Ribbon 控件内显示源自 XtraEditors 库的编辑器。使用 BarEditItem.Edit 属性来指定要显示的编辑器类型。使用 BarEditItem.EditValue 属性来指定编辑器的初值。当编辑值被改变时，要执行特定的操作，则接管 BarEditItem.EditValueChanged 事件。

BarLinkContainerItem / BarLinkContainerItemLink

这种项类型表示 links 的一个组。

可以创建一个 BarLinkContainerItem，并通过 BarCustomContainerItem.ItemLinks 属性为它装载 links，然后把它添加到菜单中。在运行时刻，该菜单将包含由 BarLinkContainerItem 所拥有的 links。

例如，如果需要在多个菜单内显示相同的菜单项组，就可以使用 BarLinkContainerItem。也可以使用这种容器项来实现类似于 Microsoft® Internet Explorer 中的“收藏夹”功能。

如果把一个 BarLinkContainerItem 放置到工具栏或 Ribbon 控件中，则它被呈现为子菜单。

BarListItem / BarListItemLink

这种项类型表示一个字符串列表。例如，该项允许实现最近使用文件的列表。

可以创建一个 BarListItem，通过 BarListItem.Strings 属性为它装载字符串，然后把它添加到菜单中。在运行时刻，该菜单将包含由 BarListItem 所拥有的字符串列表。使用 BarListItem.ListItemClick 事件来对单击列表项作出响应。

如果把一个 BarListItem 项放置到工具栏或 Ribbon 控件中，则它以子菜单呈现。

BarMdiChildrenListItem / BarMdiChildrenListItemLink

这种项类型表示所有已打开的 MDI 子窗口的一个列表。这种项的功能与 BarListItem 类似，但是它被设计用于仅显示活动的 MDI 窗口。不能把项显式添加到 BarMdiChildrenListItem 中。

可以把 BarMdiChildrenListItem 添加到菜单中。在运行时刻，该菜单将包含属于当前窗体的 MDI 子窗口的可勾选列表。单击特定的菜单项将激活相应的窗口。

如果 BarMdiChildrenListItem 被放置到工具栏中，则以子菜单呈现它。

注意
Ribbon 控件不支持 BarMdiChildrenListItem 项。

BarToolbarsListItem / BarToolbarsListItemLink

这种项类型表示现有 bars 和停靠面板的一个列表。

可以把 BarToolbarsListItem 添加到菜单中。在运行时刻，该菜单将包含现有 bars 和停靠面板的可勾选列表。单击切换任一项的复选框将改变相应 bar/停靠面板的可视性。

如果 BarToolbarsListItem 被放置到工具栏中，则以子菜单呈现它。

注意
Ribbon 控件不支持 BarToolbarsListItem 项。

BarButtonGroup / BarButtonGroupLink

表示 Ribbon 控件内的一个按钮组。当调整 Ribbon 控件的大小时，按钮组不会被拆开。可以使用 BarButtonGroup.ItemLinks 属性来把任意项添加到 BarButtonGroup 中。被显示在按钮组内的 links 仅支持小图像。

注意
只有 Ribbon 控件支持 BarButtonGroup 项。

RibbonGalleryBarItem / RibbonGalleryBarItemLink

表示在 RibbonControl 内的一个 In-Ribbon gallery。 In-Ribbon gallery 可以显示在视觉上被呈现为图像的多个 gallery 项。可以为每个 gallery 项随意指定标题和说明文本。

注意
仅在 RibbonControl 内支持 RibbonGalleryBarItem 项。