<Controls> (RibbonDiffXml)

Artikel
01/13/2016

Betrifft: CRM 2016 on-prem, CRM Online

Enthält eine Sammlung von Steuerelementen.

Wichtig

The valid child elements of the Controls element depend on the parent element.

Syntax

    <CommandUIDefinition>
     <Controls
      Id="String"
      ToolTipDescription="String"
      ToolTipHelpKeyWord="String"
      ToolTipImage32by32="String"
      ToolTipImage32by32Class="String"
      ToolTipImage32by32Left="NonPositiveInteger"
      ToolTipImage32by32Top="NonPositiveInteger"
      ToolTipTitle="String">
      [ 
        <Button /> |
        <CheckBox /> |
        <ComboBox /> |
        <ColorPicker /> |
        <ContextualGroup /> |
        <Controls /> |
        <DropDown /> |
        <FlyoutAnchor /> |
        <Gallery /> |
        <GalleryButton /> |
        <GroupTemplate /> |
        <Group /> |
        <Groups /> |
        <InsertTable /> |
        <Label /> |
        <MRUSplitButton /> |
        <MaxSize /> |
        <Menu /> |
        <MenuSection /> |
        <Scale /> |
        <Scaling /> |
        <Spinner /> |
        <SplitButton /> |
        <Tab /> |
        <TextBox/> |
        <ToggleButton />
       ]
     </Controls>
    </CommandUIDefinition>

    <MenuSection>
     <Controls
      Id="String"
      ToolTipDescription="String"
      ToolTipHelpKeyWord="String"
      ToolTipImage32by32="String"
      ToolTipImage32by32Class="String"
      ToolTipImage32by32Left="NonPositiveInteger"
      ToolTipImage32by32Top="NonPositiveInteger"
      ToolTipTitle="String">
      [ 
        <ToggleButton /> |
        <Button /> |
        <ColorPicker /> |
        <FlyoutAnchor /> |
        <InsertTable /> 
       ]
     </Controls>
    </MenuSection>

Attribute und Elemente

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

Attribute

Attribute	Description	Type	Usage
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
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
<Button> (RibbonDiffXml)	Gibt eine einfache Schaltfläche an, die zum Ausführen einer Aktion verwendet wird.
<CheckBox> (RibbonDiffXml)	Gibt ein Kontrollkästchen an, das zum Auswählen einer Option verwendet wird. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<ColorPicker> (RibbonDiffXml)	Veraltet: Gab ein Raster an, das zum Auswählen einer Farbe oder eines Stils verwendet wurde. This element is only valid when Controls is a child of <MenuSection> (RibbonDiffXml)
<ComboBox> (RibbonDiffXml)	Veraltet: Gab eine Liste an, die zum Auswählen eines Werts durch Klicken oder Eingeben verwendet wird. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<DropDown> (RibbonDiffXml)	Veraltet: Gab eine Liste an, die zum Auswählen eines Wert durch Klicken verwendet wird. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<FlyoutAnchor> (RibbonDiffXml)	Gibt eine Schaltfläche mit einem Abwärtspfeil zum Öffnen eines Menüs an.
<GalleryButton> (RibbonDiffXml)	Veraltet: Gab ein Schaltflächensteuerelement in einem Galerieelement an. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<InsertTable> (RibbonDiffXml)	Veraltet: Gab ein 10 x 10-Raster zum Angeben der Abmessungen einer Tabelle an. This element is only valid when Controls is a child of <MenuSection> (RibbonDiffXml)
<Label> (RibbonDiffXml)	Gibt eine Textzeile zum Bereitstellen von Informationen an. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<MRUSplitButton> (RibbonDiffXml)	Veraltet: Gab ein Trennschaltflächensteuerelement an, das zuletzt verwendete Elemente anzeigt. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<Spinner> (RibbonDiffXml)	Gibt ein Steuerelement zum Einfügen eines Werts durch Eingeben oder Verwenden der Pfeiltasten an, um durch die Werte zu wechseln. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<SplitButton> (RibbonDiffXml)	Gibt ein Steuerelement an, das als Schaltfläche und Menü verwendet wird. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<TextBox> (RibbonDiffXml)	Veraltet: Ein Steuerelement zum Eingeben von Text angegeben. This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<ToggleButton> (RibbonDiffXml)	Gibt eine Schaltfläche an, die zum Umschalten zwischen einem Ein- und Aus-Status verwendet wird.

Übergeordnete Elemente

Element	Description
<Group> (RibbonDiffXml)	Gibt eine Gruppe von Steuerelementen auf einer Registerkarte an, die eine Layoutvorlage gemeinsam nutzen.
<CommandUIDefinition> (RibbonDiffXml)	Gibt die sichtbaren Menübandelemente an, die in einem CustomAction-Element enthalten sein sollen.
<MenuSection> (RibbonDiffXml)	Gibt einen Abschnitt an, der zum Teilen eines Menüs verwendet wird. Ein Menüabschnitt kann einen Titel aufweisen und Steuerelemente enthalten.

Elementinformationen

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

Siehe auch

Weitere Ressourcen

Anpassen von Befehlen und des Menübands
Ribbon XML reference

Freigeben über