分享方式：

<ComboBox> (RibbonDiffXml)

  • 文章

適用於: CRM 2015 on-prem, CRM Online

已被取代：指定清單，藉由按一下或輸入來選取值。

重要

This control was deprecated in Microsoft Dynamics CRM 2011. This control will not render with Microsoft Dynamics CRM 2015 和 Microsoft Dynamics CRM Online 2015 更新.

語法

<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

指定此控制項的功能區命令識別碼。

String

Optional

CommandMenuClose

指定在功能表關閉時執行的功能表命令識別碼。

String

Optional

CommandMenuOpen

指定在功能表開啟時執行的功能區命令識別碼。

String

Optional

CommandPreview

指定在選取控制項前游標停留在上方時執行的功能區命令識別碼。

String

Optional

CommandPreviewRevert

指定在預覽後控制項失去焦點時執行的功能區命令識別碼。

String

Optional

Id

為功能區元素定義指定唯一識別碼。強烈建議的命名慣例是使用句號分隔名稱的各個部分，如下：[solution identifier].[entity].[ribbon].[function]...[element name]。例如：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

藉由將 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

指定 CSS 類別，以套用至工具提示中顯示的 32x32 像素影像。

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 2015 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2014 Microsoft Corporation. All rights reserved.