<MenuSection> (RibbonDiffXml)

適用対象: CRM 2016 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

Id

リボン要素の定義の一意の識別子を指定します。[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

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
コマンドおよびリボンをカスタマイズする

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