分享方式：

<Gallery> (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 更新.

語法

<Gallery 
 Command="String"
 CommandPreview="String"
 CommandRevert="String"
 ElementDimensions=
 ["Size16by16" | 
  "Size32by32" |
  "Size48by48" |
  "Size64by48" |
  "Size72by96" |
  "Size96by72" |
  "Size96by96" |
  "Size128by128" |
  "Size190by30" |
  "Size190by40" |
  "Size190by50" |
  "Size190by60"]
 Id="String"
 QueryCommand="String"
 Sequence="Integer"
 Width="Integer" >
 <GalleryButton />
</Gallery>

屬性和元素

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

屬性

Attribute Description Type Usage

Command

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

String

Optional

CommandPreview

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

String

Optional

CommandRevert

指定在使用者選取 [復原] 時執行的功能區命令識別碼。

String

Optional

ElementDimensions

控制 Gallery 或 GalleryButton 元素的大小。

Valid values:

  • Size16by16

  • Size32by32

  • Size48by48

  • Size64by48

  • Size72by96

  • Size96by72

  • Size96by96

  • Size128by128

  • Size190by30

  • Size190by40

  • Size190by50

  • Size190by60

Enumeration

Required

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

QueryCommand

指定在輪詢狀態資訊時執行的命令名稱。

String

Optional

Sequence

藉由將 Sequence 值設定為高於或低於現有功能區元素，以指定功能區修改的位置。

Integer

Optional

Width

指定控制項所需的寬度 (以像素為單位)。

Integer

Required

子元素

Element Description

<GalleryButton> (RibbonDiffXml)

已被取代：指定圖庫元素內的按鈕控制項。

上層元素

Element Description

<CommandUIDefinition> (RibbonDiffXml)

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

<MenuSection> (RibbonDiffXml)

指定用於劃分功能表的區段。功能表區段可以有標題並包含控制項。

元素資訊

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Gallery |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/MenuSection/Gallery |
//Menu/MenuSection/Gallery

Schema Name

GalleryType

Validation File

RibbonWSS.xsd

Can be Empty

No

請參閱

其他資源

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.