Partager via


<Gallery> (RibbonDiffXml)

S'applique à: CRM 2015 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 Microsoft Dynamics CRM 2015 et Microsoft Dynamics CRM Online 2015 Update.

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].[entity].[ribbon].[function].[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

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