ComboBox 元素

上次修改时间: 2015年3月9日

适用范围: SharePoint Foundation 2010

本文内容
属性
子元素
父元素
出现次数

定义组合框控件。

<ComboBox
  AllowFreeForm="TRUE | FALSE"
  AltArrow="Text"
  Alt="Text"
  AutoComplete="TRUE | FALSE"
  AutoCompleteDelay="Integer"
  CacheMenuVersions="TRUE | FALSE"
  Command="Text"
  CommandMenuOpen="Text"
  CommandMenuClose="Text"
  CommandPreview="Text"
  CommandPreviewRevert="Text"
  ImeEnabled="TRUE | FALSE"
  InitialItem="Text"
  Id="Text"
  QueryCommand="Text"
  PopulateDynamically="TRUE | FALSE"
  PopulateQueryCommand="Text"
  PopulateOnlyOnce="TRUE | FALSE"
  Sequence="Integer"
  TemplateAlias="Text"
  ToolTipImage32by32="Url"
  ToolTipImage32by32Class="CSS Class Selector"
  ToolTipImage32by32Left="Negative Integer"
  ToolTipImage32by32Top="Negative Integer"
  ToolTipTitle="Text"
  ToolTipDescription="Text"
  ToolTipHelpKeyWord="Text"
  ToolTipShortcutKey="Text"
  Width="Integer"
/>

属性

属性

说明

AllowFreeForm

可选。若要限制输入以便只提交菜单上的项目,则为 FALSE;否则为 TRUE。默认值为 FALSE。

AltArrow

可选。用于下拉箭头按钮的可选文本。

Alt

可选。用于组合框的可选文本。

AutoComplete

可选。如果为 FALSE,则关闭记忆式键入建议。默认值为 TRUE(打开)。

AutoCompleteDelay

可选。记忆式键入功能使用最佳匹配填充文本框之前等待的毫秒数。默认值为 100。

CacheMenuVersions

可选。如果为 TRUE,则存储以前构建的动态菜单版本。默认值为 FALSE。

Command

可选。单击控件时要执行的命令的名称。如果此控件在 CommandUIDefinition 元素中,则此控件的 Command 属性值应该与相应 CommandUIHandler 元素的 Command 属性值相同。

CommandMenuOpen

可选。打开下拉菜单时要执行的命令的名称。

CommandMenuClose

可选。关闭下拉菜单时要执行的命令的名称。

CommandPreview

可选。预览所选内容时要执行的命令的名称。

CommandPreviewRevert

可选。返回到预览所选内容前所处的状态时要执行的命令的名称。

ImeEnabled

可选。若为 TRUE,则将Input Method Editor (IME) 设置为 active 状态。

InitialItem

可选。首次呈现文本框时,文本框中显示的菜单项的 ID。

Id

必需。用于标识控件的字符串,例如"Ribbon.EditingTools.CPEditTab.Font.Fonts"。

QueryCommand

可选。轮询状态信息时要执行的命令的名称。

PopulateDynamically

可选。如果为 TRUE,则动态创建菜单。默认值为 FALSE。

PopulateQueryCommand

可选。创建动态菜单时要执行的命令的名称。

PopulateOnlyOnce

可选。如果为 TRUE,则只在首次访问动态菜单时填充该菜单。默认值为 FALSE。

Sequence

可选。一个指定同级 XML 节点之间的放置顺序的整数。

TemplateAlias

可选。一个匹配 ControlRef 元素、OverflowArea 元素或 GroupTemplate 元素中的 OverflowSection 元素的 TemplateAlias 属性值的字符串。在对某个组应用模板时,可使用 TemplateAlias 属性调整该组中控件的大小和位置。

ToolTipImage32by32

可选。文件相对于服务器的 URL,该文件包含要用于工具提示的 32 X 32 像素图像,例如"/_layouts/1033/images/formatmap32x32.png"。

ToolTipImage32by32Class

可选。应用于工具提示图像的 CSS 类选择器的名称。

ToolTipImage32by32Left

可选。一个负整数,表示图像左边缘的偏移。当 ToolTipImage32by32 属性指向一个图像文件(其中包含许多图标的图像)时,使用此属性。ToolTipImage32by32Left 属性的值可用于在创建页面时设置级联样式 HTML img 标记的 CSS left 属性。

ToolTipImage32by32Top

可选。一个负整数,表示图像上边缘的偏移。当 ToolTipImage32by32 属性指向一个图像文件(其中包含许多图标的图像)时,使用此属性。ToolTipImage32by32Top 属性的值可用于在创建页面时设置级联样式 HTML img 标记的 CSS top 属性。

ToolTipTitle

可选。显示为工具提示标题的文本。

ToolTipDescription

可选。显示在工具提示正文中的文本。

ToolTipHelpKeyWord

可选。上下文相关帮助使用的关键字。

ToolTipShortcutKey

可选。在工具提示中针对快捷键显示的文本。例如,如果控件的快捷键为 Alt + J,则此属性的值为"Alt + J"。工具提示将在其标题后的括号中显示快捷键的文本:"(Alt + J)"。

Width

可选。此组合框所属的文本框的宽度(以像素为单位)。

子元素

Menu

父元素

CommandUIDefinition

Controls (Group)

出现次数

最小值:0

最大值:无限制