通过

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

语法

<GalleryButton 
 Alt="String"
 Command="String"
 CommandPreview="String"
 CommandRevert="String"
 CommandType=["General" | "OptionSelection" | "IgnoredByMenu"]
 CommandValueId="String"
 ElementDimensions=
  ["Size16by16" |
  "Size32by32" |
  "Size48by48" |
  "Size64by48" |
  "Size72by96" |
  "Size96by72" |
  "Size96by96" |
  "Size128by128" |
  "Size190by30" |
  "Size190by40" |
  "Size190by50" |
  "Size190by60"]
 Id="String"
 Image="String"
 ImageClass="String"
 ImageLeft="Non Positive Integer"
 ImageTop="Non Positive Integer"
 InnerHTML="String"
 MenuItemId="String"
 QueryCommand="String"
 Sequence="Integer"
 TemplateAlias="String"
 ToolTipDescription="String"
 ToolTipHelpKeyWord="String"
 ToolTipImage32by32="String"
 ToolTipImage32by32Class="String"
 ToolTipImage32by32Left="Non Positive Integer"
 ToolTipImage32by32Top="Non Positive Integer"
 ToolTipShortcutKey="String"
 ToolTipTitle="String"
/>

属性和元素

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

属性

Attribute Description Type Usage

Alt

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

String

Optional

Command

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

String

Optional

CommandPreview

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

String

Optional

CommandRevert

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

String

Optional

CommandType

允许指定不同类型的命令。

Valid values:

 

Value Description

General

不是特定的命令类型。

OptionSelection

当用户在选项组选择一个选项时生成的命令。

IgnoredByMenu

用于控件的命令，这些控件在被单击时不会关闭菜单。

Enumeration

Optional

CommandValueId

一个字符串，在单击按钮时将与命令事件一起发送。

String

Optional

ElementDimensions

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

Valid values:

  • Size16by16

  • Size32by32

  • Size48by48

  • Size64by48

  • Size72by96

  • Size96by72

  • Size96by96

  • Size128by128

  • Size190by30

  • Size190by40

  • Size190by50

  • Size190by60

Enumeration

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

Image

A server-relative URL to a file that contains an image to be used as an icon.If an Image attribute is not defined, an InnerHTML attribute must be defined.

String

Optional

ImageClass

The name of a CSS class selector to be applied to the image.

String

Optional

ImageLeft

A negative integer that represents an offset for the left edge of the image. Use this attribute when the Image attribute points to an image file that contains images for several icons.

Non positive Integer

Optional

ImageTop

A negative integer that represents an offset for the top edge of the image. Use this attribute when the Image attribute points to an image file that contains images for several icons.

Non positive Integer

Optional

InnerHTML

HTML markup that illustrates the choice that the button represents.If the InnerHTML attribute is not defined, the Image attribute must be defined.

String

Optional

MenuItemId

指定从控件到菜单项 ID 的引用。

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

ToolTipShortcutKey

Microsoft Dynamics CRM 中未使用此元素。

String

Optional

ToolTipTitle

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

String

Optional

子元素

此元素没有子元素。

父元素

Element Description

<Gallery> (RibbonDiffXml)

不建议：指定显示功能区中相关控件的集合的控件。如果库中的项目过多，则将提供展开箭头以便在窗格中显示集合中的剩余项目。

元素信息

XPath

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

Schema Name

GalleryButtonType

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.