通过

<Button> (RibbonDiffXml)

  • 项目

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

指定用于执行操作的简单按钮。

语法

<Button Alt="String"
  Command="String"
  CommandType=["General" | "OptionSelection" | "IgnoredByMenu" ]
  CommandValueId="String"
  Description="String"
  Id="String"
  Image16by16="String"
  Image16by16Class="String"
  Image16by16Left="Non Positive Integer"
  Image16by16Top="Non Positive Integer"
  Image32by32="String"
  Image32by32Class="String"
  Image32by32Left="String"
  Image32by32Top="String"
  LabelCss="String"
  LabelText="String"
  MenuItemId="String"
  ModernCommandType=[ "ControlCommand"| "System"]
  ModernImage=”String”
  Sequence="1"
  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。

The command to perform when this button is pressed.

A reference to an existing CommandDefinition.Id value.

String

Optional

CommandType

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

Valid values:

 

Value Description

General

不是特定的命令类型。

OptionSelection

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

IgnoredByMenu

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

Enumeration

Optional

CommandValueId

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

String

Optional

Description

Microsoft Dynamics CRM 不使用 Description 属性。

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

Image16by16

指定一个 16x16 像素的图像。这可以是某个图像文件的路径，也可以是使用 $webresource: 指令引用 Web 资源。

String

Optional

Image16by16Class

指定要用于 16x16 像素的图像的 CSS 类的名称。

String

Optional

Image16by16Left

指定要将 16x16 像素的图像左移的像素数。此数字可由负数表示。

Non Positive Integer

Optional

Image16by16Top

指定要将 16x16 像素的图像上移的像素数。此数字可由负数表示。

Non Positive Integer

Optional

Image32by32

指定一个 32x32 像素的图像。这可以是某个图像文件的路径，也可以是使用 $webresource: 指令引用 Web 资源。

String

Optional

Image32by32Class

指定要用于 16x16 像素的图像的 CSS 类的名称。

String

Optional

Image32by32Left

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

Non Positive Integer

Optional

Image32by32Top

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

Non Positive Integer

Optional

LabelCss

指定要应用于控件的标签的 CSS 类。

String

Optional

LabelText

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

String

Optional

MenuItemId

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

String

Optional

ModernCommandType

仅供内部使用。

Valid values:

 

Value Description

ControlCommand

仅供内部使用。

System

仅供内部使用。

Enumeration

Optional

ModernImage

仅供内部使用。

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

<CommandUIDefinition> (RibbonDiffXml)

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

<Controls> (RibbonDiffXml)

包含一个控件集合。

示例

<Button Id="MyISV.account.form.SendToOtherSystem.Button"        Command="MyISV.account.form.SendToOtherSystem.Command"        LabelText="$LocLabels:MyISV.account.SendToOtherSystem.LabelText"        ToolTipTitle="$LocLabels:MyISV.account.SendToOtherSystem.LabelText"        ToolTipDescription="$LocLabels:MyISV.account.SendToOtherSystem.ToolTip"        TemplateAlias="o2"        Image16by16="$webresource:New_TIcon16x16.png"        Image32by32="$webresource:New_TIcon32x32.png" />

元素信息

XPath

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

Schema Name

ButtonType

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.