Freigeben über


<Button> (RibbonDiffXml)

Betrifft: CRM 2016 on-prem, CRM Online

Gibt eine einfache Schaltfläche an, die zum Ausführen einer Aktion verwendet wird.

Syntax

<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"
/>

Attribute und Elemente

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

Attribute

Attribute Description Type Usage

Alt

Zeichenfolge oder Verweis auf eine lokalisierte Beschriftung, die als alternativer Text angezeigt wird.

String

Optional

Command

Gibt die ID des Menübandbefehls für dieses Steuerelement an.

The command to perform when this button is pressed.

A reference to an existing CommandDefinition.Id value.

String

Optional

CommandType

Ermöglicht das Angeben eines anderen Befehlstyps.

Valid values:

 

Value Description

General

Kein bestimmter Befehlstyp.

OptionSelection

En Befehl, der generiert wird, wenn ein Benutzer eine Option in einer Optionsgruppe auswählt.

IgnoredByMenu

Ein Befehl, der für Steuerelemente verwendet wird, die das Menü beim Anklicken nicht schließen sollen.

Enumeration

Optional

CommandValueId

Eine Zeichenfolge, die mit dem Befehlsereignis gesendet wird, wenn auf die Schaltfläche geklickt wird.

String

Optional

Description

Das Attribut Description wird von Microsoft Dynamics CRM nicht verwendet.

String

Optional

Id

Gibt einen eindeutigen Bezeichner für die Definition eines Menübandelements an. Die dringend empfohlene Namenskonvention sieht die Verwendung eines Punkts zum Trennen der Teile des Namens vor: [Lösungsbezeichner].[Entität].[Menüband].[Funktion].[Elementname]. Beispiel: 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.

Wichtig

If you don’t set a globally unique Id value, the ribbon might not display.

String

Required

Image16by16

Gibt ein Bild mit 16 x 16 Pixel an. Dies kann der Pfad zu einer Bilddatei sein oder mithilfe der $webresource:-Direktive auf eine Webressource verweisen.

String

Optional

Image16by16Class

Gibt den Namen einer CSS-Klasse an, die für das Bild mit 16 x 16 Pixel verwendet werden soll.

String

Optional

Image16by16Left

Gibt die Anzahl der Pixel an, um die das Bild mit 16 x 16 Pixel nach links verschoben werden soll. Dies wird durch eine negative Zahl dargestellt.

Non Positive Integer

Optional

Image16by16Top

Gibt die Anzahl der Pixel an, um die das Bild mit 16 x 16 Pixel nach oben verschoben werden soll. Dies wird durch eine negative Zahl dargestellt.

Non Positive Integer

Optional

Image32by32

Gibt ein Bild mit 32 x 32 Pixel an. Dies kann der Pfad zu einer Bilddatei sein oder mithilfe der $webresource:-Direktive auf eine Webressource verweisen.

String

Optional

Image32by32Class

Gibt den Namen einer CSS-Klasse an, die für das Bild mit 16 x 16 Pixel verwendet werden soll.

String

Optional

Image32by32Left

Gibt die Anzahl der Pixel an, um die das Bild mit 32 x 32 Pixel nach links verschoben werden soll. Dies wird durch eine negative Zahl dargestellt.

Non Positive Integer

Optional

Image32by32Top

Gibt die Anzahl der Pixel an, um die das Bild mit 32 x 32 Pixel nach oben verschoben werden soll. Dies wird durch eine negative Zahl dargestellt.

Non Positive Integer

Optional

LabelCss

Gibt eine CSS-Klasse an, die auf die Beschriftung für das Steuerelement angewendet werden soll.

String

Optional

LabelText

Gibt eine Zeichenfolge an, die als Text für das Steuerelement angezeigt werden soll. Dieser kann auf ein LocLabel-Element mithilfe der $LocLabels:-Direktive verweisen, z. B. "$LocLabels:MyISV.account.Save.Button.Label".

String

Optional

MenuItemId

Gibt einen Verweis von einem Steuerelement auf die ID eines Menüelements an.

String

Optional

ModernCommandType

Nur zur internen Verwendung.

Valid values:

 

Value Description

ControlCommand

Nur zur internen Verwendung.

System

Nur zur internen Verwendung.

Enumeration

Optional

ModernImage

Nur zur internen Verwendung.

String

Optional

Sequence

Geben Sie die Position der Menübandänderung an, indem Sie den Sequenzwert höher oder niedriger als vorhandene Menübandelemente festlegen.

Integer

Optional

TemplateAlias

Verknüpft ein untergeordnetes Menübandelement von CommandUIDefinition mit einem Positionsplatzhalter in einem untergeordneten Element eines Layoutelements. Dieser Wert definiert, wo das Steuerelement in einer Gruppe von Steuerelementen angezeigt wird, wenn das Layout geändert wird.

String

Optional

ToolTipDescription

Gibt eine Zeichenfolge an, die für die QuickInfo für ein Steuerelement angezeigt werden soll. Diese kann auf ein LocLabel-Element mithilfe der $LocLabels:-Direktive verweisen, z. B. "$LocLabels:MyISV.account.Save.Button.Tooltip".

String

Optional

ToolTipHelpKeyWord

Dieses Element wird in Microsoft Dynamics CRM nicht verwendet.

String

Optional

ToolTipImage32by32

Gibt ein Bild mit 32 x 32 Pixel zum Anzeigen mit der QuickInfo an.

String

Optional

ToolTipImage32by32Class

Gibt eine CSS-Klasse an, die auf das Bild mit 32 x 32 Pixel zum Anzeigen mit der QuickInfo angewendet werden soll.

String

Optional

ToolTipImage32by32Left

Gibt die Anzahl der Pixel an, um die das QuickInfo-Bild mit 32 x 32 Pixel nach links verschoben werden soll. Dies wird durch eine negative Zahl dargestellt.

Non Positive Integer

Optional

ToolTipImage32by32Top

Gibt die Anzahl der Pixel an, um die das QuickInfo-Bild mit 32 x 32 Pixel nach oben verschoben werden soll. Dies wird durch eine negative Zahl dargestellt.

Non Positive Integer

Optional

ToolTipShortcutKey

Dieses Element wird in Microsoft Dynamics CRM nicht verwendet.

String

Optional

ToolTipTitle

Gibt eine Zeichenfolge an, die für den Titel einer QuickInfo für ein Steuerelement angezeigt werden soll. Hierbei handelt es sich in der Regel um denselben Wert wie der LabelText des Steuerelements. Dieser kann auf ein LocLabel-Element mithilfe der $LocLabels:-Direktive verweisen, z. B. "$LocLabels:MyISV.account.Save.Button.Label".

String

Optional

Untergeordnete Elemente

Diese Element verfügt nicht über untergeordnete Elemente.

Übergeordnete Elemente

Element Description

<CommandUIDefinition> (RibbonDiffXml)

Gibt die sichtbaren Menübandelemente an, die in einem CustomAction-Element enthalten sein sollen.

<Controls> (RibbonDiffXml)

Enthält eine Sammlung von Steuerelementen.

Beispiel

<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" />

Elementinformationen

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

Siehe auch

Weitere Ressourcen

Anpassen von Befehlen und des Menübands
Ribbon XML reference

Microsoft Dynamics CRM 2016 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.