<SplitButton> (RibbonDiffXml)

Artikel
01/13/2016

Betrifft: CRM 2016 on-prem, CRM Online

Gibt ein Steuerelement an, das als Schaltfläche und Menü verwendet wird.

Syntax

<SplitButton
 Alt="String"
 CacheMenuVersions="true"
 Command="String"
 CommandMenuClose="String"
 CommandMenuOpen="String"
 CommandType="General"
 Id="String"
 Image16by16="String"
 Image16by16Class="String"
 Image16by16Left="Non Positive Integer"
 Image16by16Top="Non Positive Integer"
 Image32by32="String"
 Image32by32Class="String"
 Image32by32Left="Non Positive Integer"
 Image32by32Top="Non Positive Integer"
 LabelText="String"
 MenuAlt="String"
 MenuCommand="String"
 ModernImage=”String”
 PopulateDynamically=["0" | "1" | "true" | "false"]
 PopulateOnlyOnce=["0" | "1" | "true" | "false"]
 PopulateQueryCommand="String"
 Sequence="Integer"
 TemplateAlias="String"
 ToolTipDescription="String"
 ToolTipHelpKeyWord="String"
 ToolTipImage32by32="String"
 ToolTipImage32by32Class="String"
 ToolTipImage32by32Left="Non Postive Integer"
 ToolTipImage32by32Top="Non Postive Integer"
 ToolTipSelectedItemTitle="String"
 ToolTipShortcutKey="String"
 ToolTipTitle="String"
 >
 <Menu />
</SplitButton>

Attribute und Elemente

The following describes 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

CacheMenuVersions

Zeigt an, ob die Definition für das Steuerelement zur Leistungssteigerung zwischengespeichert werden soll. Wählen Sie diesen Wert aus, wenn Sie PopulateDynamically nicht aktivieren.

String

Optional

Command

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

String

Optional

CommandMenuClose

Gibt die ID des Menübefehls an, der ausgeführt wird, wenn das Menü geschlossen wird.

String

Optional

CommandMenuOpen

Gibt die ID des Menübandbefehls an, der ausgeführt wird, wenn das Menü geöffnet wird.

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

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 are defining a ribbon element that will be used for multiple entities. This will insert 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

Failing to set a globally unique Id value can cause the ribbon not to 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

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

MenuAlt

Alternative text to represent the menu.

String

Optional

MenuCommand

The name of the command to execute when the menu is clicked.

String

Optional

ModernImage

Nur zur internen Verwendung.

String

Optional

PopulateDynamically

Gibt an, dass die Menüelemente, die Optionen für dieses Steuerelement enthalten, zur Laufzeit mithilfe des durch das PopulateQueryCommand-Attribut definierten Befehls dynamisch aufgefüllt werden.

Boolean

Default = false.

Optional

PopulateOnlyOnce

Wenn das Steuerelement dynamisch aufgefüllt wird, gibt diese Einstellung an, dass der durch das PopulateQueryCommand-Attribut definierte Befehl nur einmal aufgerufen werden soll.

Boolean

Default = false.

Optional

PopulateQueryCommand

Wenn das Steuerelement dynamisch aufgefüllt wird, ruft dieser Befehl die Menüelemente ab, die Optionen für dieses Steuerelement enthalten.

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

ToolTipSelectedItemTitle

Dieses Element wird in Microsoft Dynamics CRM nicht verwendet.

String

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

Element	Description
<Menu> (RibbonDiffXml)	Gibt einen Container zum Anzeigen von Popupmenüs an.

Ü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.

Anmerkungen

If this element does not have any <Menu> elements and does not have a valid PopulateQueryCommand, the application will throw the following script error at run time: ‘attrs' is null or not an object.

Elementinformationen

XPath	`//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/SplitButton \| //Controls/SplitButton`
Schema Name	SplitButtonType
Validation File	RibbonWSS.xsd
Can be Empty	Yes

Siehe auch

Weitere Ressourcen

Ribbon XML reference
Anpassen von Befehlen und des Menübands

Freigeben über

<SplitButton> (RibbonDiffXml)

Syntax

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Anmerkungen

Elementinformationen

Siehe auch

Weitere Ressourcen

Zusätzliche Ressourcen