Partager via


<Group> (RibbonDiffXml)

S'applique à: CRM 2016 on-prem, CRM Online

Spécifie un groupe de contrôles au sein d'un onglet partageant un modèle de disposition commun.

Syntaxe

<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>

Attributs et éléments

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

Attributs

Attribute Description Type Usage

Command

Spécifie l'ID de la commande de ruban pour ce contrôle.

String

Optional

Description

L'attribut Description n'est pas utilisé par Microsoft Dynamics CRM.

String

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].[entité].[ruban].[fonction].[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

Image32by32Popup

Spécifie l'image de 32x32 pixels affichée lorsqu'un groupe est affiché en tant que liste contextuelle dans le ruban. Il peut s'agir du chemin d'accès à un fichier image ou d'une référence à une ressource web utilisant la directive $webresource:.

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

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

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

Éléments enfants

Element Description

<Controls> (RibbonDiffXml)

Contient un ensemble de contrôles.

Éléments parents

Element Description

<CommandUIDefinition> (RibbonDiffXml)

Spécifie les éléments de ruban visibles à inclure dans un élément CustomAction.

<Groups> (RibbonDiffXml)

Contient un ensemble d'éléments Group.

Informations sur l'élément

XPath

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

Schema Name

GroupType

Validation File

RibbonWSS.xsd

Can be Empty

No

Voir aussi

Autres ressources

Ribbon XML reference
Personnaliser les commandes et le ruban

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