<Button> (RibbonDiffXml)
適用於: CRM 2015 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 |
指定此控制項的功能區命令識別碼。 The command to perform when this button is pressed. A reference to an existing CommandDefinition.Id value. |
String |
Optional |
||||||||
CommandType |
允許指定不同類型的命令。 Valid values:
|
Enumeration |
Optional |
||||||||
CommandValueId |
按一下按鈕時隨命令事件傳送的字串。 |
String |
Optional |
||||||||
Description |
Microsoft Dynamics CRM 不使用 Description 屬性。 |
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 重要 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 |
指定從控制項到功能表項目識別碼的參照。 |
String |
Optional |
||||||||
ModernCommandType |
僅供內部使用。 Valid values:
|
Enumeration |
Optional |
||||||||
ModernImage |
僅供內部使用。 |
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 |
||||||||
ToolTipShortcutKey |
此元素未使用於 Microsoft Dynamics CRM。 |
String |
Optional |
||||||||
ToolTipTitle |
為控制項的工具提示標題指定顯示字串。這通常與 LabelText 控制項的值相同。這可以透過 $LocLabels: 指示詞來參照 LocLabel 元素,例如 "$LocLabels:MyISV.account.Save.Button.Label"。 |
String |
Optional |
子元素
此元素沒有子元素。
上層元素
Element | Description |
---|---|
指定要包含在 CustomAction 元素中的可見 Ribbon 元素。 |
|
包含控制項的集合。 |
範例
<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 |
|
Schema Name |
ButtonType |
Validation File |
RibbonWSS.xsd |
Can be Empty |
Yes |
請參閱
其他資源
Microsoft Dynamics CRM 2015 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2014 Microsoft Corporation. All rights reserved.