2007 Office Fluent Ribbon定制用户指南(连载12)
(您认为本文值几颗星)
Loading ...dialogBoxLauncher
为一个组包含对话框启动器，一个组仅能包含一个单个的dialogBoxLauncher控件。该控件必须包含一个按钮控件，并且必须作为组元素里最后一个元素出现。
(1) 属性
无
(2) 子元素
button(必需的)
dropDown
代表一个下拉列表控件
(1) 属性
通用：
enabled,getEnabled,getImage,getImageMso,getKeytip,getLabel,getScreentip,
getShowImage,getShowLabel,getSupertip,getVisible,id,idMso,idQ,image,
imageMso,insertAfterMso,insertAfterQ,insertBeforeMso,insertBeforeQ,
keytip,label,onAction,screentip,showImage,showLabel,supertip,tag,visible
与组合框(comboBox)共享的属性：
getItemCount,getItemID,getItemImage,getItemLabel,getItemScreentip,
getItemSupertip,showItemImage
与编辑框(editBox)共享的属性：sizeString
表：dropDown的属性和方法
| 方法 | 行为 | 描述 |
|---|---|---|
| getSelectedItemID | 回调 | 请求应该通过ID选择的项目，指定该属性或getSelectedItemIndex属性，或者两者都不 |
| getSelectedItemIndex | 回调 | 请求应该通过索引选择的项目，指定该属性或getSelectedItemId属性，或者两者都不 |
| showItemLabel | True,False,1,0 | 指定是否显示项目的标签 |
(2) 子元素
item
dynamicMenu
代表在运行时创建的菜单
(1) 属性
通用：
description,enabled,getDescription,getEnabled,getImage,getImageMso,
getKeytip,getLabel,getScreentip,getShowImage,getShowLabel,getSize,
getSupertip,getVisible,id,idMso,idQ,image,imageMso,insertAfterMso,
insertAfterQ,insertBeforeMso,insertBeforeQ,keytip,label,screentip,
showImage,showLabel,supertip,tag,visible
表：dynamicMenu的方法
| 方法 | 行为 | 描述 |
|---|---|---|
| getContent | 回调 | 获取包含该动态菜单内容的XML字符串 |
getContent方法必须返回与下面标记相似的XML，填充菜单。
<menu xmlns=”http://schemas.microsoft.com/office/2006/01/customui“>
<button id=”dynaButton” label=”Button” onAction=”OnAction” imageMso=”FoxPro”/>
<toggleButton id=”dynaToggleButton” label=”Toggle Button” onAction=”OnToggleAction” image=”logo.bmp”/>
<menuSeparator id=”div2″/>
<dynamicMenu id=”subMenu” label=”Sub Menu” getContent=”GetSubContent” />
</menu>
(2) 子元素
与菜单相同，但是通过使用getContent回调来填充。
editBox
代表一个编辑框控件。
(1) 属性
通用：
Enabled,getEnabled,getImage,getImageMso,getKeytip,getLabel,getScreentip,
getShowImage,getShowLabel,getSupertip,getVisible,id,idMso,idQ,image,
imageMso,insertAfterMso,insertAfterQ,insertBeforeMso,insertBeforeQ,
keytip,label,screentip,showImage,showLabel,supertip,tag,visible
表：editBox的属性和方法
| 属性或方法 | 类型或行为 | 描述 |
|---|---|---|
| getText | 回调 | 获取显示在编辑框中的文本 |
| maxLength | Integer | 用户可以在编辑框中输入的字符串的最大字符数 |
| onChange | 回调 | 当编辑框中的值变化和用户提交时调用 |
| sizeString | String | 一个字符串，例如“wwwwwwwwww”，确定编辑框的尺寸 |
(2) 子元素
无
gallery
代表一个库控件。
(1) 属性
通用：
Description,enabled,getDescription,getEnabled,,getImage,getImageMso,
getKeytip,getLabel,getScreentip,getShowImage,getShowLabel,getSize,
getSupertip,getVisible,id,idMso,idQ,image,imageMso,insertAfterMso,
insertAfterQ,insertBeforeMso,insertBeforeQ,keytip,label,onAction,
screentip,showImage,showLabel,size,supertip,tag,visible
与comboBox共享的属性：
getItemCount,getItemID,getItemImage,getItemLabel,getItemScreentip,
getItemSupertip,showItemImage,showItemLabel
与dropDown共享的属性：getSelectedItemID,getSelectedItemIndex
与editBox共享的属性：sizeString
表：gallery的属性和方法
| 属性或方法 | 类型或行为 | 描述 |
|---|---|---|
| columns | Integer | 在库中显示的列数 |
| getItemHeight | 回调 | 请求项目的高度，以像素为单位 |
| getItemWidth | 回调 | 请求项目的宽度，以像素为单位 |
| itemHeight | Integer | 项目的高度，以像素为单位 |
| itemWidth | Integer | 项目的宽度，以像素为单位 |
| rows | Integer | 在库中显示的行数 |
(2) 子元素
item,button
按钮必须在项目之后列出，所有的按钮都出现在库的底部。
