Partager via

<GalleryButton> (RibbonDiffXml)

  • Article

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

Déconseillé : spécifie un contrôle de bouton dans un élément de galerie.

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

<GalleryButton 
 Alt="String"
 Command="String"
 CommandPreview="String"
 CommandRevert="String"
 CommandType=["General" | "OptionSelection" | "IgnoredByMenu"]
 CommandValueId="String"
 ElementDimensions=
  ["Size16by16" |
  "Size32by32" |
  "Size48by48" |
  "Size64by48" |
  "Size72by96" |
  "Size96by72" |
  "Size96by96" |
  "Size128by128" |
  "Size190by30" |
  "Size190by40" |
  "Size190by50" |
  "Size190by60"]
 Id="String"
 Image="String"
 ImageClass="String"
 ImageLeft="Non Positive Integer"
 ImageTop="Non Positive Integer"
 InnerHTML="String"
 MenuItemId="String"
 QueryCommand="String"
 Sequence="Integer"
 TemplateAlias="String"
 ToolTipDescription="String"
 ToolTipHelpKeyWord="String"
 ToolTipImage32by32="String"
 ToolTipImage32by32Class="String"
 ToolTipImage32by32Left="Non Positive Integer"
 ToolTipImage32by32Top="Non Positive Integer"
 ToolTipShortcutKey="String"
 ToolTipTitle="String"
/>

Attributs et éléments

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

Attributs

Attribute Description Type Usage

Alt

Chaîne ou référence à une étiquette localisée à afficher comme texte de remplacement.

String

Optional

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

CommandType

Permet de spécifier un autre type de commande.

Valid values:

 

Value Description

General

Pas un type de commande spécifique.

OptionSelection

Commande générée lorsqu'un utilisateur sélectionne une option dans un groupe d'options.

IgnoredByMenu

Commande utilisée pour les contrôles qui ne doivent pas fermer le menu lorsqu'ils sont sélectionnés.

Enumeration

Optional

CommandValueId

Chaîne envoyée avec l'événement de commande lorsque le bouton est sélectionné.

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

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].[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

Image

A server-relative URL to a file that contains an image to be used as an icon.If an Image attribute is not defined, an InnerHTML attribute must be defined.

String

Optional

ImageClass

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

String

Optional

ImageLeft

A negative integer that represents an offset for the left edge of the image. Use this attribute when the Image attribute points to an image file that contains images for several icons.

Non positive Integer

Optional

ImageTop

A negative integer that represents an offset for the top edge of the image. Use this attribute when the Image attribute points to an image file that contains images for several icons.

Non positive Integer

Optional

InnerHTML

HTML markup that illustrates the choice that the button represents.If the InnerHTML attribute is not defined, the Image attribute must be defined.

String

Optional

MenuItemId

Spécifie une référence d'un contrôle à l'ID d'un élément de menu.

String

Optional

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

TemplateAlias

Associe un élément de ruban enfant de CommandUIDefinition à un espace réservé d'emplacement au sein d'un enfant d'un élément Layout. Cette valeur définit l'emplacement d'affichage du contrôle dans un groupe de contrôles lorsque la disposition change.

String

Optional

ToolTipDescription

Spécifie une chaîne à afficher pour l'info-bulle d'une commande. Peut référencer un élément LocLabel à l'aide de la directive $LocLabels: (par exemple, « $LocLabels:MyISV.account.Save.Button.Tooltip »).

String

Optional

ToolTipHelpKeyWord

Cet élément n'est pas utilisé dans Microsoft Dynamics CRM.

String

Optional

ToolTipImage32by32

Spécifie une image de 32x32 pixels à afficher avec l'info-bulle.

String

Optional

ToolTipImage32by32Class

Spécifie une classe CSS applicable à l'image de 32x32 pixels à afficher avec l'info-bulle.

String

Optional

ToolTipImage32by32Left

Spécifie le nombre de pixels duquel déplacer l'image d'info-bulle de 32x32 pixels vers la gauche. Cette valeur est représentée par un nombre négatif.

Non positive Integer

Optional

ToolTipImage32by32Top

Spécifie le nombre de pixels duquel déplacer l'image d'info-bulle de 32x32 pixels vers le haut. Cette valeur est représentée par un nombre négatif.

Non positive Integer

Optional

ToolTipShortcutKey

Cet élément n'est pas utilisé dans Microsoft Dynamics CRM.

String

Optional

ToolTipTitle

Spécifie une chaîne à afficher pour le titre d'une info-bulle d'un contrôle. Il s'agit généralement de la même valeur que le LabelText du contrôle. Peut référencer un élément LocLabel à l'aide de la directive $LocLabels: (par exemple, « $LocLabels:MyISV.account.Save.Button.Label »).

String

Optional

Éléments enfants

Cet élément n'a pas d'élément enfant.

Éléments parents

Element Description

<Gallery> (RibbonDiffXml)

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.

Informations sur l'élément

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Gallery/GalleryButton |
//Menu/MenuSection/Gallery/GalleryButton

Schema Name

GalleryButtonType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

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.