<Button> (RibbonDiffXml)

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

Spécifie un bouton simple utilisé pour effectuer une action.

Syntaxe

<Button Alt="String"
  Command="String"
  CommandType=["General" | "OptionSelection" | "IgnoredByMenu" ]
  CommandValueId="String"
  Description="String"
  Id="String"
  Image16by16="String"
  Image16by16Class="String"
  Image16by16Left="Non Positive Integer"
  Image16by16Top="Non Positive Integer"
  Image32by32="String"
  Image32by32Class="String"
  Image32by32Left="String"
  Image32by32Top="String"
  LabelCss="String"
  LabelText="String"
  MenuItemId="String"
  ModernCommandType=[ "ControlCommand"| "System"]
  ModernImage=”String”
  Sequence="1"
  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. The command to perform when this button is pressed. A reference to an existing CommandDefinition.Id value.	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
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
Image16by16	Spécifie une image de 16x16 pixels. 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
Image16by16Class	Spécifie le nom d'une classe CSS à utiliser pour l'image de 16x16 pixels.	String	Optional
Image16by16Left	Spécifie le nombre de pixels duquel déplacer l'image de 16x16 pixels vers la gauche. Cette valeur est représentée par un nombre négatif.	Non Positive Integer	Optional
Image16by16Top	Spécifie le nombre de pixels duquel déplacer l'image de 16x16 pixels vers le haut. Cette valeur est représentée par un nombre négatif.	Non Positive Integer	Optional
Image32by32	Spécifie une image de 32x32 pixels. 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
Image32by32Class	Spécifie le nom d'une classe CSS à utiliser pour l'image de 16x16 pixels.	String	Optional
Image32by32Left	Spécifie le nombre de pixels duquel déplacer l'image de 32x32 pixels vers la gauche. Cette valeur est représentée par un nombre négatif.	Non Positive Integer	Optional
Image32by32Top	Spécifie le nombre de pixels duquel déplacer l'image de 32x32 pixels vers le haut. Cette valeur est représentée par un nombre négatif.	Non Positive Integer	Optional
LabelCss	Spécifie une classe CSS à appliquer à l'étiquette du contrôle.	String	Optional
LabelText	Spécifie une chaîne à afficher comme texte de la commande. Peut référencer un élément LocLabel à l'aide de la directive $LocLabels: (par exemple, « $LocLabels:MyISV.account.Save.Button.Label »).	String	Optional
MenuItemId	Spécifie une référence d'un contrôle à l'ID d'un élément de menu.	String	Optional
ModernCommandType	Utilisation interne uniquement. Valid values:   Value Description ControlCommand Utilisation interne uniquement. System Utilisation interne uniquement.	Enumeration	Optional
ModernImage	Utilisation interne uniquement.	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
<CommandUIDefinition> (RibbonDiffXml)	Spécifie les éléments de ruban visibles à inclure dans un élément CustomAction.
<Controls> (RibbonDiffXml)	Contient un ensemble de contrôles.

Exemple

<Button Id="MyISV.account.form.SendToOtherSystem.Button"        Command="MyISV.account.form.SendToOtherSystem.Command"        LabelText="$LocLabels:MyISV.account.SendToOtherSystem.LabelText"        ToolTipTitle="$LocLabels:MyISV.account.SendToOtherSystem.LabelText"        ToolTipDescription="$LocLabels:MyISV.account.SendToOtherSystem.ToolTip"        TemplateAlias="o2"        Image16by16="$webresource:New_TIcon16x16.png"        Image32by32="$webresource:New_TIcon32x32.png" />

Informations sur l'élément

XPath	//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Button | //RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Controls/Button | //RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Menu/MenuSection/Controls/Button
Schema Name	ButtonType
Validation File	RibbonWSS.xsd
Can be Empty	Yes

Voir aussi

Autres ressources

Personnaliser les commandes et le ruban
Ribbon XML reference

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