<Gallery> (RibbonDiffXml)

Article
01/13/2016

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

Déconseillé : spécifie un contrôle affichant un ensemble de contrôles associés dans le Ruban. S'il y a trop d'éléments dans la galerie, une flèche d'agrandissement permet d'afficher le reste de l'ensemble dans un volet.

Important

This control was deprecated in Microsoft Dynamics CRM 2011. This control will not render with Mise à jour de Microsoft Dynamics CRM Online 2016 et Microsoft Dynamics CRM 2016 (local).

Syntaxe

<Gallery 
 Command="String"
 CommandPreview="String"
 CommandRevert="String"
 ElementDimensions=
 ["Size16by16" | 
  "Size32by32" |
  "Size48by48" |
  "Size64by48" |
  "Size72by96" |
  "Size96by72" |
  "Size96by96" |
  "Size128by128" |
  "Size190by30" |
  "Size190by40" |
  "Size190by50" |
  "Size190by60"]
 Id="String"
 QueryCommand="String"
 Sequence="Integer"
 Width="Integer" >
 <GalleryButton />
</Gallery>

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
CommandPreview	Spécifie l'ID de la commande de ruban à exécuter lorsque le curseur pointe sur le contrôle avant sa sélection.	String	Optional
CommandRevert	Spécifie l'ID de la commande de ruban à exécuter lorsque l'utilisateur sélectionne Annuler.	String	Optional
ElementDimensions	Contrôle la taille d'un élément Gallery ou GalleryButton. Valid values: Size16by16 Size32by32 Size48by48 Size64by48 Size72by96 Size96by72 Size96by96 Size128by128 Size190by30 Size190by40 Size190by50 Size190by60	Enumeration	Required
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
QueryCommand	Spécifie le nom de la commande à exécuter lors de l'interrogation des informations d'état.	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
Width	Spécifie une largeur souhaitée pour le contrôle en pixels.	Integer	Required

Éléments enfants

Element	Description
<GalleryButton> (RibbonDiffXml)	Déconseillé : spécifie un contrôle de bouton dans un élément de galerie.

Éléments parents

Element	Description
<CommandUIDefinition> (RibbonDiffXml)	Spécifie les éléments de ruban visibles à inclure dans un élément CustomAction.
<MenuSection> (RibbonDiffXml)	Spécifie une section utilisée pour séparer un menu. Une section de menu peut avoir un titre et contenir des contrôles.

Informations sur l'élément

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

Voir aussi

Autres ressources

Ribbon XML reference
Personnaliser les commandes et le ruban