细品RibbonX(13)：初识XML

细品RibbonX(13)：初识XML

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

 Loading ...

 

XML是扩展标记语言（Extensible Markup Language）的缩写，最初由W3C发布。XML不是真正的编程语言，因为它缺乏执行操作的某种机制，相反，XML是一组规则，其意图是简化跨平台的数据共享。

Office 2007文件以Microsoft的OpenXML格式发布，是包含几个XML文件的一个简单的压缩容器。使用XML格式的文件具有下列优点：

（1）XML文件能够明显地节省空间。

（2）通过XML结构化数据后，能够快速地被索引，因而能使其他程序通过索引搜索到特定的字符串或其他项目。

（3）对于开发者来说，能够链接某个应用程序里的XML架构来验证XML而确保代码像意料中的那样工作。例如前面介绍的CustomUI Editor和XML Notepad，如果没有这些架构，CustomUI Editor将不能验证代码，XML Notepad也不能提供智能感知功能。

当然，我们之所以关心XML，是因为XML是功能区的核心。要定制Office 2007用户界面，必须编写XML代码。虽然VBA在定制界面时也能起到关键的作用，但它不是必需的。而XML在定制中几乎总是必需的，但也有例外。例如弹出式菜单和一些出现在加载项选项卡中的VBA定制。

下面，我们来了解如何构成XML代码，以及如何编写XML。

标签（Tags）

先看看下面的代码片断：

<group id="rxgrpTest">

<button idMso="Bold"/>

<button idMso="Italic"/>

<splitButton id="rxsbtnTest">

<button idMso="Underline"/>

</splitButton>

</group>

留意上面代码的结构，注意<、>和/号的使用，这些符号在XML中有特定的用途：指出了标签的开始和结束位置。例如，开始的<group>标签和结束的</group>标签之间的内容包含了在功能区中显示的组。

在组里面列出的splitButton标签使用与组相同的结构，以<splitButton>标签开始，接着包含了所有的项目直至由</splitButton>标签结束。本例中，仅仅下划线按钮出现在拆分按钮中。

现在，看看按钮本身的代码，注意到/号位于标签的结尾，这样就不需要单独的标签来关闭元素。

这里演示了用于开始和结束XML标签的两种方法。您需要理解和使用这两种方法来创建自定义UI的结构。如下所示：

开始和关闭标签分开：<element attribute(s)="Value"></element>

开始和关闭标签未分开：<element attribute(s)="Value"/>

通过上面的例子，应该了解到：

（1）在XML中，每个标签至少包含一个元素并且通常至少有一个属性。

（2）在处理代码时，涉及的每个项目都被称作对象（object）。例如，对象包括功能区中的组、按钮、复选框、甚至是菜单。许多对象都有子对象。当某控件有子控件时，该控件称作为父控件。注意，父对象通常（但不总是）有不同类型的子对象。选项卡有一个或多个组对象作为子对象，并且一个组可能有按钮、复选框和动态菜单子对象的组合。其中，dynamicMenu对象除了其他子对象类型外，还有dynamicMenu子对象。某些父对象甚至有完整的子对象群，称之为集合（collection）。

每个子对象同时也是它自已的子对象的父对象。每个子对象控件必须嵌套在其父对象的开始和结束标签中。并且，每个子对象仅可能有一个父对象。

（3）为了创建格式良好（有效的）XML，必须理解：①所有的标签，无论是元素还是属性，都区分大小写，即SPLITBUTTON元素与splitButton元素不相同。②属性值必须被放置在单引号或双引号内。③在父元素中的子元素的嵌套必须准确，每个开始标签必须与其结束标签相匹配，或者使用"/>"结束在相同的标签内，或者在后面使用单独的标签。

元素（Elements）

当处理功能区的XML时，可以看到每个元素指定功能区控件（或结构）的特定部分。

对于初学者来说不容易弄清楚标签和元素的区别，然而很容易定义：group是一个元素，而<group>是一个标签。因此，标签实质上是通过<和>符号识别代码块的标志。

每个标签必须包括一个且唯一一个元素。此外，元素总是XML标签的第一部分，告诉编译器希望开始处理或者停止处理的特定项目。

属性（Attributes）

标签告诉编译器要处理的对象，而属性告诉编译器该对象的特性，例如对象的名称、在屏幕中显示的标题以及是否对象可见。

与元素不同的是，在所给标签内可以为对象设置多个属性。例如，下面的代码片断显示了带有多个属性的标签示例：

<button id="rxbtnProtectAll"

size="normal"

label="Protect All Sheets"

imageMso="ReviewProtectWorkbook"

onAction="rxbtnProtectAll_click"/>

上面的代码提供给按钮一个唯一的id并指定了大小、标签文本和图像，还提供了一个onAction回调签名，当单击该按钮时启动相应的VBA过程。

1、id属性

在创建额外的对象之前，需要探讨如何在代码中识别这些对象。而id属性用于识别在自定义XML代码内特定的对象，为其提供名称，使得后面能够使用该名称引用该对象。这是引用对象的唯一方法。在下列容器中每个对象都需要id属性：

         contextualTabs

         officeMenu

         qat

         tabs

id属性有几种不同的类型并且每一个都有不同的用途。下面列出了id属性的不同类型及其主要用途。

         id属性用于唯一地标识控件。如果动态地装载项目，其属性将被赋值。

         idMso属性用于唯一地标识内置控件、选项卡、命令，等等。使用该属性与内置对象交互。

         idQ属性用于跨共享的命名空间引用对象。

为了识别某对象，只需简单地在开始标签中添加id属性，例如，要通过id引用某选项卡，使用下列XML：

<tab id="rxtab"

<!—放置其它的选项卡属性! –>

</tab>

同样地，如果试图引用内置的字体（Font）组，则使用下面的XML：

<group idMso="Font"

<!—放置其它的组属性! –>

</group>

注意，所有的id和idQ属性都是唯一的。如果使用已存在的id，或者由Microsoft保留的id，将会导致错误并阻止装载自定义用户界面。

为了避免与内置的控件相冲突，建议所有自定义控件使用标准的命名约定加上前缀。

2、label属性

label属性指定用户能够在屏幕上读取的内容，它不必是唯一的，但应该合乎逻辑、简洁明了且一致。label属性为用户提供了清晰的向导。要为控件添加标签文本，使用下面所示的代码：

<tab id="rxtab"

label="My Custom Tab">

</tab>

XML代码的排版技巧

在编写代码时，建议使用硬回车或制表符将代码分成逻辑块，使代码更容易阅读和理解。看看下面的示例代码，非常清晰，更容易阅读：

<group

id="rxgrp"

label="My First Group">

  

<button

id="rxbtn1″

imageMso="Italic"

label="Large size button"

size="large"

onAction="rxbtn1_Click"/>

  

<button

id="rxbtn2″

imageMso="Bold"

label="Normal size button"

size="normal"

onAction="rxbtn2_Click"/>

  

<button

id="rxbtn3″

imageMso="WrapText"

label="Normal size button"

size="normal"

onAction="rxbtn3_Click"/>

  

<button

id="rxbtn4″

imageMso="ConditionalFormatting"

label="Normal size button"

size="normal"

onAction="rxbtn4_Click"/>

</group>

在XML代码中创建注释

注释能够使自已或他人清楚代码的作用。

放置注释的方法是：在开始处放置一个小于号（<），然后输入感叹号（！），随后是两个连字号（–），结束注释需要两个连字号加一个大于号（>），例如：

<!—这是一段注释 –>

如果注释很长，可能需要几行，那么可以按如下所示编写：

<!–

这是一段相当长的注释。因为您想使用长的注释解释这段代码有什么作用，各个符号代码什么意思，以帮助您以后好理解。

–>

在<!–和–>之间的内容被当作连续的注释。

此外，不能够将注释放置在一块开始的XML代码的中间。下面的示例来进行演示：

<!—这是我的按钮 –>

<button id="rxbtn"

label="This is my button"

imageMso="HappyFace"

size="large"

onAction="rxbtn_Click"/>

或：

<button id="rxbtn"

label="This is my button"

imageMso="HappyFace"

size="large"

onAction="rxbtn_Click">

<!—这是我的按钮 –>

</button>

上述两段代码都是正确的，但下面的代码会产生错误：

<button id="rxbtn"

<!—这是我的按钮 –>

label="This is my button"

imageMso="HappyFace"

size="large"

onAction="rxbtn_Click"/>

上面的问题在于注释被插入到了未关闭的代码块中。