通过

<ComboBox> (RibbonDiffXml)

  • 项目

应用到: CRM 2016 on-prem, CRM Online

不建议：通过单击或键入指定用于选择值的列表。

重要

This control was deprecated in Microsoft Dynamics CRM 2011. This control will not render with Microsoft Dynamics CRM Online 2016 Update 和 Microsoft Dynamics CRM 2016（本地）.

语法

<ComboBox
 AllowFreeForm=["0" | "1" | "true" | "false"]
 Alt="String"
 AltArrow="String"
 AutoComplete="true"
 AutoCompleteDelay="Integer"
 CacheMenuVersions=["0" | "1" | "true" | "false"]
 Command="String"
 CommandMenuClose="String"
 CommandMenuOpen="String"
 CommandPreview="String"
 CommandPreviewRevert="String"
 Id="String"
 ImeEnabled=["0" | "1" | "true" | "false"]
 InitialItem="String"
 PopulateDynamically=["0" | "1" | "true" | "false"]
 PopulateOnlyOnce =["0" | "1" | "true" | "false"]
 PopulateQueryCommand="String"
 QueryCommand="String"
 Sequence="Integer"
 TemplateAlias="String"
 ToolTipDescription="String"
 ToolTipHelpKeyWord="String"
 ToolTipImage32by32="String"
 ToolTipImage32by32Class="String"
 ToolTipImage32by32Left="NonPositiveInteger"
 ToolTipImage32by32Top="NonPositiveInteger "
 ToolTipSelectedItemTitle="String"
 ToolTipShortcutKey="String"
 ToolTipTitle="String"
 Width="String" >
 <Menu />
</ComboBox>

属性和元素

The following table lists the attributes, child elements, and parent elements.

属性

Attribute Description Type Usage

AllowFreeForm

False to restrict input so that only items on the menu are submitted; otherwise, true. The default is false.

Boolean

Optional

Alt

用于显示为替代文本的字符串或对本地化标签的引用。

String

Optional

AltArrow

组合框控件或下拉控件的箭头图标的替代图像的路径或 Web 资源引用。

String

Optional

AutoComplete

False to turn AutoComplete suggestions off. The default is true (on).

Boolean

Optional

AutoCompleteDelay

The delay in milliseconds before AutoComplete fills the text box with a best-guess match. The default is 100.

Integer

Optional

CacheMenuVersions

指示是否应缓存控件的定义以获得更佳性能。如果未选择 PopulateDynamically，请选择此值。

Default value = "false".

Boolean

Optional

Command

指定此控件的功能区命令的 ID。

String

Optional

CommandMenuClose

指定菜单关闭时要运行的菜单命令的 ID。

String

Optional

CommandMenuOpen

指定菜单打开时要运行的功能区命令的 ID。

String

Optional

CommandPreview

指定在选定控件之前，光标悬停在控件上方时要运行的功能区命令的 ID。

String

Optional

CommandPreviewRevert

指定控件在预览后丢失焦点时要运行的功能区命令的 ID。

String

Optional

Id

指定功能区元素的定义的唯一标识符。强烈建议的命名约定是使用句点分隔名称的各个部分，如：[解决方案标识符].[实体].[功能区].[函数].[元素名称]。例如：MyISV.account.form.SendToOtherSystem.Button。

Use the {!EntityLogicalName} token in the Id attribute when you define a ribbon element that will be used for multiple entities. This inserts the entity logical name into the Id value to make sure that the Id value is globally unique.

For example, if you use MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button with the account entity, the Id will be MyISV.account.form.SendToOtherSystem.Button. For the contact entity, the Id will be MyISV.contact.form.SendToOtherSystem.Button.

重要

If you don’t set a globally unique Id value, the ribbon might not display.

String

Required

ImeEnabled

指定是否启用输入法编辑器 (IME) 的活动状态。可使用 IME 输入和编辑中文、日语和朝鲜语字符。IME 可处于活动状态或不活动状态。活动状态可接受中文、日语或朝鲜语字符。不活动状态的行为与常规键盘类似，使用的字符集有限。

Boolean

Optional

InitialItem

指定要在控件中显示的初始菜单。

String

Optional

PopulateDynamically

指定将使用 PopulateQueryCommand 属性定义的命令在运行时动态填充提供此控件的选项的菜单元素。

Default value = "false".

Boolean

Optional

PopulateOnlyOnce

当动态填充控件时，此设置指示只应调用由 PopulateQueryCommand 属性定义的命令一次。

Default Value = "false".

Boolean

Optional

PopulateQueryCommand

当动态填充控件时，此命令会检索为此控件提供选项的菜单元素。

String

Optional

QueryCommand

当动态填充控件时，此命令会检索为此控件提供选项的菜单元素。

String

Optional

Sequence

通过将序列值设置为高于或低于现有功能区元素来指定功能区修改内容的位置。

Integer

Optional

TemplateAlias

将 CommandUIDefinition 的功能区元素子级与 Layout 元素子级中的位置占位符关联。此值定义了控件在布局发生更改时在控件组中的显示位置。

String

Optional

ToolTipDescription

指定要为控件的工具提示显示的字符串。这可以使用 $LocLabels: 指令引用 LocLabel 元素，例如“$LocLabels:MyISV.account.Save.Button.Tooltip”。

String

Optional

ToolTipHelpKeyWord

本元素不用于 Microsoft Dynamics CRM。

String

Optional

ToolTipImage32by32

指定一个将与工具提示一起显示的 32x32 像素的图像。

String

Optional

ToolTipImage32by32Class

指定要应用于随工具提示一起显示的 32x32 像素的图像的 CSS 类。

String

Optional

ToolTipImage32by32Left

指定要将工具提示的 32x32 像素的图像左移的像素数。此数字可由负数表示。

Non Positive Integer

Optional

ToolTipImage32by32Top

指定要将工具提示的 32x32 像素的图像上移的像素数。此数字可由负数表示。

Non Positive Integer

Optional

ToolTipSelectedItemTitle

本元素不用于 Microsoft Dynamics CRM。

String

Optional

ToolTipShortcutKey

本元素不用于 Microsoft Dynamics CRM。

String

Optional

ToolTipTitle

指定要为控件的工具提示标题显示的字符串。这通常与控件 LabelText 的值相同。这可以使用 $LocLabels: 指令引用 LocLabel 元素，例如“$LocLabels:MyISV.account.Save.Button.Label”。

String

Optional

Width

指定控件的所需宽度（以像素为单位）。

String

Optional

子元素

Element Description

<Menu> (RibbonDiffXml)

指定用于显示弹出菜单的容器。

父元素

Element Description

<CommandUIDefinition> (RibbonDiffXml)

指定要包含在 CustomAction 元素中的可见 Ribbon 元素。

<Controls> (RibbonDiffXml)

包含一个控件集合。

元素信息

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/ComboBox |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Controls/ComboBox |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Menu/MenuSection/Controls/ComboBox

Schema Name

ComboBoxType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

另请参阅

其他资源

自定义命令和功能区
Ribbon XML reference

Microsoft Dynamics CRM 2016 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.