细品RibbonX(33)：separator元素详解

细品RibbonX(33)：separator元素详解

资料整理来自于论坛
完整版下载地址：http://download.csdn.net/download/nodeman/10264659

 

 Loading ...

 

separator控件作为一条垂直线出现，分开组中的项目，从组的顶部跨越到组的底部，并且不能够设置任何其它的方向或尺寸。然而，它能够在功能区中提供空白，与使用垂直的box控件创建的空白相似。

1、separator元素必需的属性

separator元素需要下表1所列的id属性之一。

表1：separator元素必需的属性

属性	何时使用
id	当创建自已的分隔条时
idQ	当在命名空间之间创建共享的分隔条时

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

separator控件相对于已存在的控件的放置需要使用下表2列出的insert属性之一。

表2：separator元素可选的insert属性

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

separator元素接受下表3所列的静态可见的属性或等价的回调。

表3：separator元素可选的属性和回调

静态属性	动态属性	允许值	默认值	动态属性的VBA回调签名
visible	getVisible	true,false,1,0	true	Sub GetVisible(control As IRibbonControl, ByRef returnedVal)

3、separator元素允许的子对象

separator元素不支持任何类型的子控件。

4、separator元素的父对象

在下列任何控件内都能放置separator控件：

n         documentControl

n         group

n         sharedControl

5、创建自定义的separator元素

下面的示例演示如何使用分隔条来在功能区中创建空白。

（1）创建一个新的.xlsx文件，并将其保存为Excel separator Example.xlsx。

（2）关闭该文件并在CustomUI Editor中打开。

（3）输入下列XML代码：

<customUI xmlns=“http://schemas.microsoft.com/office/2006/01/customui“>

    <ribbon>

       <tabs>

           <tab id = “rxtab_Demo“

              label=“Demo“

              insertBeforeMso=“TabHome“>

              <group id=“rxgrp_Demo“

                  label=“Demo Group“>

                  <box id=“rxboxFormat1“

                     boxStyle=“horizontal“

                     visible=“true“>

                     <toggleButton idMso=“Bold“/>

                     <toggleButton idMso=“Italic“/>

                     <toggleButton idMso=“Underline“/>

                     <toggleButton idMso=“UnderlineDouble“/>

                  </box>

                  <separator id=“rxsep1“/>

                  <button id=“rxbtnHappy1“

                     imageMso=“HappyFace“

                     label=“Button 1“/>

                  <button id=“rxbtnHappy2“

                     imageMso=“HappyFace“

                     label=“Button 2“/>

                  <button id=“rxbtnHappy3“

                     imageMso=“HappyFace“

                     label=“Button 3“/>

                  <button id=“rxbtnHappy4“

                     imageMso=“HappyFace“

                     label=“Button 4“/>

              </group>

           </tab>

       </tabs>

    </ribbon>

</customUI>

（4）保存后关闭CustomUI Editor。

（5）在Excel中重新打开该文件，结果如下图所示。