细品RibbonX(21)：toggleButton控件详解

切换按钮用于在两种状态之间选择，例如当按下某切换按钮时开启或关闭某功能。

1、toggleButton元素必需的属性

切换按钮需要下表1所列的id属性之一。

表1：toggleButton元素必需的属性

属性	何时使用
id	当创建自已的切换按钮时
idMso	当使用现有的Microsoft切换按钮时
idQ	当在命名空间之间创建共享的切换按钮时

切换按钮也需要表2所列出的onAction回调。

表2：toggleButton元素必需的回调

动态属性	允许值	VBA回调签名
onAction	1至4096个字符	Sub OnAction(control As IRibbonControl, selectedId As String, selectedIndex As Integer)

2、带有回调签名的可选的静态属性和动态属性

使用切换按钮时，可以使用下表3列出的任一insert属性。

表3：toggleButton元素可选的insert属性

INSERT属性	允许值	默认值	何时使用
insertAfterMso	有效的Mso组	在组末尾插入	在Microsoft控件之后插入
insertBeforeMso	有效的Mso组	在组末尾插入	在Microsoft控件之前插入
insertAfterQ	有效的组idQ	在组末尾插入	在共享的命名空间控件之后插入
insertBeforeQ	有效的组idQ	在组末尾插入	在共享的命名空间控件之前插入

也可以提供下表4所列的任何或所有的属性。

表4：toggleButton