<MenuSection> (RibbonDiffXml)

S'applique à: CRM 2016 on-prem, CRM Online

Spécifie une section utilisée pour séparer un menu. Une section de menu peut avoir un titre et contenir des contrôles.

Syntaxe

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

Attributs et éléments

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

Attributs

Attribute	Description	Type	Usage
DisplayMode	Contrôle le mode utilisé pour afficher l'élément. Valid values:   Value Description Menu Affiche l'élément comme un menu. Menu16 Affiche l'élément dans un menu avec une hauteur de 16 pixels. Menu32 Affiche l'élément dans un menu avec une hauteur de 32 pixels.	Enumeration	Optional
Id	Spécifie un identificateur unique pour la définition d'un élément de ruban. Il est recommandé d'utiliser un point pour séparer les parties du nom, comme suit : [identificateur de solution].[entité].[ruban].[fonction].[nom d'élément]. Par exemple : 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. Important 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	Spécifie l'emplacement de la modification du ruban en définissant la valeur Sequence plus haut ou plus bas que les éléments de ruban existants.	Integer	Optional
Title	Species the label to display for the MenuSection.	String	Optional

Éléments enfants

Element	Description
<Controls> (RibbonDiffXml)	Contient un ensemble de contrôles.
<Gallery> (RibbonDiffXml)	Déconseillé : spécifie un contrôle affichant un ensemble de contrôles associés dans le Ruban. S'il y a trop d'éléments dans la galerie, une flèche d'agrandissement permet d'afficher le reste de l'ensemble dans un volet.

Éléments parents

Element	Description
<Menu> (RibbonDiffXml)	Spécifie un conteneur utilisé pour afficher les menus contextuels.

Remarques

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.

Informations sur l'élément

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

Voir aussi

Autres ressources

Ribbon XML reference
Personnaliser les commandes et le ruban

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