切换按钮用于在两种状态之间选择,例如当按下某切换按钮时开启或关闭某功能。
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