分享方式:


<Group> (RibbonDiffXml)

適用於: CRM 2015 on-prem, CRM Online

在索引標籤內指定共用通用配置範本的控制項群組。

語法

<Group 
 Command="String"
 Description="String"
 Id="String"
 Image32by32Popup="String"
 Image32by32PopupClass="String"
 Image32by32PopupLeft="Non Positive Integer"
 Image32by32PopupTop="Non Positive Integer"
 PopupWidth ="String"
 Sequence="Integer"
 Template="String"
 Title="String" >
 <Controls />
</Group>

屬性和元素

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

屬性

Attribute Description Type Usage

Command

指定此控制項的功能區命令識別碼。

String

Optional

Description

Microsoft Dynamics CRM 不使用 Description 屬性。

String

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.

> [!IMPORTANT] > If you don’t set a globally unique Id value, the ribbon might not display.

String

Required

Image32by32Popup

指定當群組在功能區中顯示為快顯清單時所顯示的 32x32 像素影像。這可以是影像檔的路徑,也可以透過 $webresource: 指示詞來參照 Web 資源。

String

Optional

Image32by32PopupClass

The name of a CSS class selector to be applied to the image.

String

Optional

Image32by32PopupLeft

A negative integer that represents an offset for the left edge of the image. Use this attribute when the Image32by32Popup attribute points to an image file that contains images for many icons. The value of the Image32by32PopupLeft attribute is used to set the CSS left attribute for the inline style of an HTML img tag.

Non Positive Integer

Optional

Image32by32PopupTop

A negative integer that represents an offset for the top edge of the image. Use this attribute when the Image32by32Popup attribute points to an image file that contains images for many icons. The value of the Image32by32PopupTop attribute is used to set the CSS top attribute for the inline style of an HTML img tag.

Non Positive Integer

Optional

PopupWidth

The width of the popup to display in pixels.

String

Optional

Sequence

藉由將 Sequence 值設定為高於或低於現有功能區元素,以指定功能區修改的位置。

Integer

Optional

Template

A string that corresponds to the Id attribute of a <GroupTemplate> (RibbonDiffXml) element.

String

Optional

Title

The text to include in the label for the group.

String

Optional

子元素

Element Description

<Controls> (RibbonDiffXml)

包含控制項的集合。

上層元素

Element Description

<CommandUIDefinition> (RibbonDiffXml)

指定要包含在 CustomAction 元素中的可見 Ribbon 元素。

<Groups> (RibbonDiffXml)

包含 Group 元素的集合。

元素資訊

XPath

//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Group |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Groups/Group

Schema Name

GroupType

Validation File

RibbonWSS.xsd

Can be Empty

No

請參閱

其他資源

Ribbon XML reference
自訂命令和功能區

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