<MenuSection> (RibbonDiffXml)

Betrifft: CRM 2016 on-prem, CRM Online

Gibt einen Abschnitt an, der zum Teilen eines Menüs verwendet wird. Ein Menüabschnitt kann einen Titel aufweisen und Steuerelemente enthalten.

Syntax

<MenuSection
 DisplayMode=["Default" | "Small" | "Medium"  | "Large"  | "Text"  | "Menu"  | "Menu16"  | "Menu32"  | "Thin"]
 Id="String"
 MaxHeight="String"
 Scrollable="true"
 Sequence="Integer"
 Title="String">
 [<Controls /> | <Gallery />]
</MenuSection>

Attribute und Elemente

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

Attribute

Attribute	Description	Type	Usage
DisplayMode	Steuert den Modus zum Anzeigen des Elements. Valid values:   Value Description Menu Zeigt das Element wie ein Menü an. Menu16 Zeigt das Element in einem Menü mit einer Höhe von 16 Pixel an. Menu32 Zeigt das Element in einem Menü mit einer Höhe von 32 Pixel an.	Enumeration	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
MaxHeight	Specifies the maximum height of the section in pixels.	String	Optional
Scrollable	Specifies whether to make this section of the menu scrollable. Set to true to make scrollable. The default is false.	Boolean	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
Title	Species the label to display for the MenuSection.	String	Optional

Untergeordnete Elemente

Element	Description
<Controls> (RibbonDiffXml)	Enthält eine Sammlung von Steuerelementen.
<Gallery> (RibbonDiffXml)	Veraltet: Gab ein Steuerelement an, das eine Sammlung verknüpfter Steuerelemente im Menüband anzeigt. Wenn in der Galerie zu viele Elemente vorhanden sind, wird ein Erweiterungspfeil zum Anzeigen der übrigen Sammlung in einem Bereich bereitgestellt.

Übergeordnete Elemente

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

Anmerkungen

You may get the following error “MenuSections can only have children of type MenuItem, Gallery or GroupPopup.” when viewing a Ribbon that has a MenuSectionDisplayMode attribute value set to the following values: Default, Small, Medium, Large, Text, Thin. While according to the RibbonWSS.xsd these are valid values, they should not be used.

Elementinformationen

XPath	//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Menu/MenuSection | //RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/ComboBox/Menu/MenuSection
Schema Name	MenuSectionType
Validation File	RibbonWSS.xsd
Can be Empty

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.