枪火游侠英雄技能介绍:细品RibbonX(17)：RibbonX控件概述

在Office 2007中，可以使用比以前版本更多的控件，并且在大多数情况下也能改变控件尺寸。各种各样的控件选项意味着可以通过从RibbonX工具箱中选择正确的控件并正确地设置它们来创建更好的界面。下面，让我们先概要了解一下RibbonX控件。
RibbonX控件概览
在Office 2007中，控件不仅仅有特定的作用，而且有大小和上下文内容。例如，在大多数编程环境中按钮都是标准形式的按钮，然而在RibbonX中，可以创建大尺寸或者标准尺寸的按钮。此外，按钮的使用（以及在某些情况下的外观）随上下文而不同：
l         功能区中的标准按钮
l         对话框启动器的一部分
l         下拉列表的一部分
l         在快速访问工具栏中（QAT）
l         拆分按钮的一部分
l         带有标题的拆分按钮的一部分
l         在控件组内
l         菜单的一部分
上下文使得在如何使用控件方面有非常大的不同。例如，在对话框启动器里面必须包括一个按钮。Office限制下拉列表中按钮的数量是16，但不必包括任何任何内容。在拆分按钮里包括的按钮总是可见的，如果试图使用visible属性，Office就会激发错误。
下表提供了RibbonX控件列表及其简要的介绍。
控件名称
描  述
框（box）
将控件组合在一个组里。可以在框里放置任何控件，将控件按水平或垂直流向设置。必须提供boxStyle属性：vertical或horizontal。与按钮组控件不同，除了设置控件流向外，框控件不会提供可视化外观。
按钮（button）
提供基本的执行功能。单击按钮，会发生某项操作。上文已提及，Office在多种上下文内容中使用按钮控件。
按钮组（buttonGroup）
将不同类型的按钮组合在一起。按钮出现在自然的框里面，并且Office将它们放置在一起来表明其以某种方式联系。可以使用其组合下列控件：按钮、切换按钮、库、菜单、动态菜单和拆分按钮控件。
复选框（checkBox）
提供基本的选择功能。通过单击该控件，用户启用或禁用某选项。Office为复选框控件提供了两种上下文环境，包括作为单独的控件或者是菜单的一部分。
组合框（comboBox）
为用户显示一列选项，使用item控件创建选项列表。每个comboBox控件必须包括至少一个item控件作为子项。当使用comboBox控件时，用户也能够输入一个不在列表中出现的值（dropDown控件需要用户选择列表中的某个项目）。
下拉控件（dropDown）
为用户为示一列选项，使用item或button控件创建选项列表。列表至少应包含两类可选的控件之一。用户必须选择提供的列表中的某选项。当用户选择button而不是item时，Office执行所需求的动作，而不是选择期望的选项。
动态菜单（dynamicMenu）
定义在运行时而不是设计时所创建的菜单。菜单内容能够修改以满足特定的需要。必须包括getContent回调来使用该控件。dynamicMenu控件能够作为buttonGroup、menu或splitButton控件的一部分出现。
编辑框（editBox）
让用户输入纯文本到功能区中。可以使用这项功能执行某任务，例如搜索。使用这个控件来进行任何不能通过使用其它控件来定义的输入。
库（gallery）
在下拉结构中显示一组控件以节省功能区空间。Word在“开始”选项卡的“样式”组中使用这样的组。gallery控件不同于其它的组合控件，它提供了可以以不同方式控制的下拉列表。可以使用rows和columns属性修改控件的外观。itemWidth和itemHeight属性用来控制组中每项的大小。在buttonGroup或menu控件里使用Gallery控件，或者作为独立的控件。要在库中显示项目，则需在getItemCount、getItemImage和getItemLabel回调中添加代码。
标签控件（labelControl）
在屏幕中创建标签。可以在标签控件组或者不易使其以其它形式识别的元素中使用该控件。用户不能够与提供的标签相交互。
菜单（menu）
定义在设计时创建的菜单。菜单可以包含诸如button和checkBox控件之类的控件。可以单独使用菜单，也可以作为splitButton控件的一部分。使用menuSeparator控件在菜单元素之间放置分隔条。与gallery控件不同，menu控件在单列呈现所有的选项（更像老版本Office的菜单系统）。
菜单分隔条（menuSeparator）
在任何控件组里提供分隔元素。
拆分按钮（splitButton）
创建具有默认操作和一列选择性选项的按钮。拆分按钮最好的示例之一是“开始”选项卡的“剪贴板”组中的“粘贴”按钮。必须包括button或toggleButton控件为默认控件。在menu控件里出现可选的操作，这里可以添加button或toggleButton控件。
切换按钮（toggleButton）
提供checkBox和button控件的组合。用户通过单击toggleButton选择某状态和执行某操作。
通用的RibbonX控件属性
RibbonX提供了许多通用的属性，可以用来控制应用程序的外观。下表简要介绍了大多数通用的属性。
属性
描  述
description
当菜单的itemSize属性设置为大时指定Office显示的描述文本。
enabled
确定Office是否启用或禁用控件。可以选择true或false作为其值。
id
为自定义控件指定标识符。不能与idMso或idQ属性一起使用。
idMso
为内置控件指定标识符。不能与id或idQ属性一起使用。
idQ
为限定的控件指定标识符（限定的控件取决于定义的自定义命名空间）。不能与id或idMso属性一起使用。
image
定义控件使用的自定义图像的名称。
imageMso
定义控件使用的内置图像的名称。
insertAfterMso
基于内置控件的位置，标识新控件的位置。
insertAfterQ
基于限定的控件的位置，标识新控件的位置。
insertBeforeMso
基于内置控件的位置，标识新控件的位置。
insertBeforeQ
基于限定的控件的位置，标识新控件的位置。
itemSize
确定菜单或其它控件项的大小。可以选择large和normal。
keyTip
对控件添加指定的加速键组合。当用户按下Alt键时显示键提示。可以指定任意键组合，使用1至3个字母。
label
指定控件显示的文本。
screenTip
提供简要的提示，帮助用户理解控件的用途。
showImage
确定Office是否显示与控件项相关的图像。可以选择true或false。
showItemImage
确定Office是否显示与菜单或其它控件项相关的图像。可以选择true或false。
showItemLabel
确定Office是否显示与菜单或其它控件项相前的标签。可以选择true或false。
showLabel
确定Office是否显示与控件相关的标签。可以选择true或false。
size
确定控件的大小。可以选择large或normal。
sizeString
设置控件的大小来包含指定宽度的字符串。
superTip
提供详细的提示，帮助用户理解控件的用途。
tag
包含用户定义的数据，可以在应用程序中用来与控件或其它元素交互。
title
为menuSeparator控件指定显示的文本代替水平线。
visible
确定Office是否显示某控件或其它功能。可以选择true或false。
通用的RibbonX控件回调
RibbonX提供了许多通用的回调，可用于监控应用程序。下表介绍了创建应用程序时常用的回调。
回调
相关的控件
描述
getContent
dynamicMenu
定义控件的内容。
getDescription
多个控件
获取控件的描述。
getEnabled
多个控件
让代码启用或禁用控件。
getImage
多个控件
获取为控件提供的自定义图像。
getImageMso
多个控件
获取为控件定义的标准图像。
getItemCount
comboBox，DropDown，gallery
获取控件的项目列表中的项目数。
getItemHeight
gallery
以像素为单位确定项目显示在屏幕中的高度。
getItemID
comboBox，dropDown，gallery
确定当前项目的ID。
getItemImage
comboBox，dropDown，gallery
获取与当前项目相关的图像。
getItemLabel
comboBox，dropDown，gallery
获取与当前项目相关的标签。
getItemScreenTip
comboBox，dropDown，gallery
获取与当前项目相关的屏幕提示。
getItemSuperTip
comboBox，dropDown，gallery
获取与当前项目相关的超级提示。
getItemWidth
gallery
以像素为单位确定项目显示在屏幕中的宽度。
getKeytip
多个控件
获取控件的键提示（加速键）。
getLabel
多个控件
获取控件的标签。
getPressed
checkBox，toggleButton
确定用户是否以手动的方式单击了控件以激活该控件。
getScreentip
多个控件
获取控件的屏幕提示。
getSelectedItemIndex
dropDown，gallery
确定用户从列表中选取的项目。
getSelectItemID
gallery
获取用户已经在列表中选取的项目的ID。
getShowImage
button
确定控件是否显示图像（允许禁止图像，即便已经为控件定义了图像）。
getShowLabel
button
确定控件是否显示标签（允许禁止标签，即便已经为控件定义了标签）。
getSize
多个控件
基于应用程序的输出，定义控件的大小。
getSupertip
多个控件
获取控件的超级工具提示。
getText
comboxBox，editBox
获取与列表中当前所选择的项目相关的文本。
getTitle
menuSeparator
为指定的控件提供标题。Office显示文本来代替通常显示的水平线。
getVisible
button
确定是否控件可见。
LoadImage
customUI
作为整体装载与用户界面相关的图像。
onAction
多个控件
执行控件在应用程序代码中定义的操作。
onChange
comboBox，editBox
在用户选择或控件内容中发现变化。
onLoad
customUI
在装载过程中执行指定的操作。