Partilhar via


<MenuSection> (RibbonDiffXml)

Aplica-se a: CRM 2015 on-prem, CRM Online

Especifica uma seção usada para dividir um menu. Uma seção de menu pode ter um título e controles.

Sintaxe

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

Atributos e elementos

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

Atributos

Attribute Description Type Usage

DisplayMode

Controla o modo usado para exibir o elemento.

Valid values:

 

Value Description

Menu

Exibe o elemento como um menu.

Menu16

Exibe o elemento em um menu com 16 pixels de altura.

Menu32

Exibe o elemento em um menu com 32 pixels de altura.

Enumeration

Optional

Id

Especifica um identificador exclusivo para a definição de um elemento de Faixa de Opções. A convenção de nomenclatura recomendável é usar um ponto para separar as partes do nome, como: [identificador da solução].[entity].[ribbon].[function]...[nome do elemento]. Por exemplo: 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.

Importante

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

Especifica o local da modificação da Faixa de Opções definindo o valor da Sequência para um número mais alto ou mais baixo que os elementos de Faixa de Opções existentes.

Integer

Optional

Title

Species the label to display for the MenuSection.

String

Optional

Elementos filho

Element Description

<Controls> (RibbonDiffXml)

Contém uma coleção de controles.

<Gallery> (RibbonDiffXml)

Preterido: Especificava um controle que exibe uma coleção de controles relacionados na Faixa de Opções. Se houver muitos itens na galeria, uma seta de expansão será fornecida para exibir o restante da coleção em um painel.

Elemento pai

Element Description

<Menu> (RibbonDiffXml)

Especifica um contêiner usado para mostrar menus pop-up.

Comentários

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.

Informações do elemento

XPath

//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Menu/MenuSection |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/ComboBox/Menu/MenuSection

Schema Name

MenuSectionType

Validation File

RibbonWSS.xsd

Can be Empty

Consulte também

Outros recursos

Ribbon XML reference
Personalizar os comandos e a faixa de opções

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