Freigeben über


<DropDown> (RibbonDiffXml)

Betrifft: CRM 2016 on-prem, CRM Online

Veraltet: Gab eine Liste an, die zum Auswählen eines Wert durch Klicken verwendet wird.

Wichtig

This control was deprecated in Microsoft Dynamics CRM 2011. This control will not render with Microsoft Dynamics CRM Online 2016 Update und Microsoft Dynamics CRM 2016 (lokal).

Use <FlyoutAnchor> (RibbonDiffXml) instead.

Syntax

<DropDown
 Alt="String"
 AltArrow="String"
 CacheMenuVersions=["0" | "1" | "true" | "false"]
 Command="String"
 CommandMenuClose="String"
 CommandMenuOpen="String"
 CommandPreview="String"
 CommandPreviewRevert="String"
 Id="String"
 InitialItem="String"
 PopulateDynamically=["0" | "1" | "true" | "false"]
 PopulateOnlyOnce=["0" | "1" | "true" | "false"]
 PopulateQueryCommand="String"
 QueryCommand="String"
 SelectedItemDisplayMode="Default"
 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"
 Width="String" >
 <Menu />
</DropDown>

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

AltArrow

Ein Pfad oder Webressourcenverweis auf ein alternatives Bild für den Pfeil für Kombinationsfeld- oder Dropdownsteuerelemente.

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.

Boolean

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

CommandPreview

Gibt die ID des Menübandbefehls an, der ausgeführt wird, wenn vor dem Auswählen mit dem Cursor auf das Steuerelement gezeigt wird.

String

Optional

CommandPreviewRevert

Gibt die ID des Menübandbefehls an, der ausgeführt wird, wenn das Steuerelement nach der Vorschau den Fokus verliert.

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.

Wichtig

String

Required

InitialItem

Gibt das Ausgangsmenü an, das im Steuerelement angezeigt werden soll.

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

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

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

QueryCommand

Gibt den Namen des Befehls an, der ausgeführt wird, wenn Statusinformationen abgerufen werden.

String

Optional

SelectedItemDisplayMode

The display mode of the selected option.

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

Width

Gibt die gewünschte Breite für das Steuerelement in Pixel an.

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.

Elementinformationen

XPath

//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/DropDown |
//Controls/DropDown

Schema Name

DropDownType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

Siehe auch

Weitere Ressourcen

Ribbon XML reference
Anpassen von Befehlen und des Menübands

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