Partager via

<MenuSection> (RibbonDiffXml)

  • Article

S'applique à: CRM 2015 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].[entity].[ribbon].[function].[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 2015 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2014 Microsoft Corporation. All rights reserved.