<MenuSection> (RibbonDiffXml)

项目
12/05/2014

应用到: CRM 2015 on-prem, CRM Online

指定用于划分菜单的部分。菜单部分可包含一个标题和多个控件。

语法

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

属性和元素

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

属性

Attribute Description Type Usage

DisplayMode

控制用于显示元素的模式。

Valid values:

Value	Description
Menu	显示诸如菜单这样的元素。
Menu16	以 16 像素的高度显示菜单元素。
Menu32	以 32 像素的高度显示菜单元素。

Enumeration

Optional

指定功能区元素的定义的唯一标识符。强烈推荐的命名约定是使用句点来分隔名称各部分的，如[solution identifier].[entity].[ribbon].[function].[element name]。例如：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.

重要

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

通过将序列值设置为高于或低于现有功能区元素来指定功能区修改内容的位置。

Integer

Optional

Title

Species the label to display for the MenuSection.

String

Optional

子元素

Element	Description
<Controls> (RibbonDiffXml)	包含一个控件集合。
<Gallery> (RibbonDiffXml)	不建议：指定显示功能区中相关控件的集合的控件。如果库中的项目过多，则将提供展开箭头以便在窗格中显示集合中的剩余项目。

父元素

Element	Description
<Menu> (RibbonDiffXml)	指定用于显示弹出菜单的容器。

备注

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.

元素信息

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

另请参阅

其他资源

Ribbon XML reference
自定义命令和功能区