通过

<Gallery> (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（本地）.

语法

<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

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

String

Optional

CommandPreview

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

String

Optional

CommandRevert

指定当用户选择“撤消”时要运行的功能区命令的 ID。

String

Optional

ElementDimensions

控制 Gallery 元素或 GalleryButton 元素的大小。

Valid values:

  • Size16by16

  • Size32by32

  • Size48by48

  • Size64by48

  • Size72by96

  • Size96by72

  • Size96by96

  • Size128by128

  • Size190by30

  • Size190by40

  • Size190by50

  • Size190by60

Enumeration

Required

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

QueryCommand

指定在轮询状态信息时要运行的命令的名称。

String

Optional

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