checkBox控件能够使用户在两种状态之间切换。虽然默认情况下状态是真和假,但是该元素能够指明开/关、上/下、左/右、1/0、或者任何可以想象到的相对状态组合。
您可能想使用checkBox来做下列操作:
² 表明数据库中的某字段是否满足特定的条件。在这种情况下,当满足条件时,将自动选中复选框。
² 允许用户确定是否显示某对象,例如显示或隐藏网格线,或者子窗体。
1、checkBox元素必需的属性
复选框控件需要下表1所列的id属性之一。
表1:checkBox元素必需的属性
属性 |
何时使用 |
id |
当创建自已的复选框时 |
idMso |
当使用现有的Microsoft复选框时 |
idQ |
当在命名空间之间创建共享的复选框时 |
每个复选框控件也需要表2所列出的onAction回调。
表2:checkBox元素必需的回调
动态属性 |
允许值 |
VBA回调签名 |
onAction |
1至4096个字符 |
Sub OnAction(control As IRibbonControl, pressed as Boolean) |
2、带有回调签名的可选的静态属性和动态属性
复选框控件可以使用下表3列出的任一insert属性。
表3:checkBox元素可选的insert属性
INSERT属性 |
允许值 |
默认值 |
何时使用 |
insertAfterMso |
有效的Mso组 |
在组末尾插入 |
在Microsoft控件之后插入 |
insertBeforeMso |