<SplitButton> (RibbonDiffXml)

Article
01/13/2016

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

Spécifie un contrôle utilisé comme bouton et menu.

Syntaxe

<SplitButton
 Alt="String"
 CacheMenuVersions="true"
 Command="String"
 CommandMenuClose="String"
 CommandMenuOpen="String"
 CommandType="General"
 Id="String"
 Image16by16="String"
 Image16by16Class="String"
 Image16by16Left="Non Positive Integer"
 Image16by16Top="Non Positive Integer"
 Image32by32="String"
 Image32by32Class="String"
 Image32by32Left="Non Positive Integer"
 Image32by32Top="Non Positive Integer"
 LabelText="String"
 MenuAlt="String"
 MenuCommand="String"
 ModernImage=”String”
 PopulateDynamically=["0" | "1" | "true" | "false"]
 PopulateOnlyOnce=["0" | "1" | "true" | "false"]
 PopulateQueryCommand="String"
 Sequence="Integer"
 TemplateAlias="String"
 ToolTipDescription="String"
 ToolTipHelpKeyWord="String"
 ToolTipImage32by32="String"
 ToolTipImage32by32Class="String"
 ToolTipImage32by32Left="Non Postive Integer"
 ToolTipImage32by32Top="Non Postive Integer"
 ToolTipSelectedItemTitle="String"
 ToolTipShortcutKey="String"
 ToolTipTitle="String"
 >
 <Menu />
</SplitButton>

Attributs et éléments

The following describes 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

CacheMenuVersions

Indique si la définition du contrôle doit être mise en cache pour optimiser les performances. Sélectionnez cette valeur si vous n'avez pas sélectionné l'option PopulateDynamically.

String

Optional

Command

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

String

Optional

CommandMenuClose

Spécifie l'ID de la commande de menu à exécuter lors de la fermeture du menu.

String

Optional

CommandMenuOpen

Spécifie l'ID de la commande de ruban à exécuter lors de l'ouverture du menu.

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

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 are defining a ribbon element that will be used for multiple entities. This will insert 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

Failing to set a globally unique Id value can cause the ribbon not to 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

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

MenuAlt

Alternative text to represent the menu.

String

Optional

MenuCommand

The name of the command to execute when the menu is clicked.

String

Optional

ModernImage

Utilisation interne uniquement.

String

Optional

PopulateDynamically

Spécifie que les éléments de menu qui fournissent des options pour ce contrôle seront renseignés de façon dynamique au moment de l'exécution à l'aide de la commande définie par l'attribut PopulateQueryCommand.

Boolean

Default = false.

Optional

PopulateOnlyOnce

Lorsque le contrôle est renseigné de façon dynamique, ce paramètre indique que la commande définie par l'attribut PopulateQueryCommand ne doit être appelée qu'une fois.

Boolean

Default = false.

Optional

PopulateQueryCommand

Lorsque le contrôle est renseigné de façon dynamique, cette commande récupère les éléments de menu qui fournissent des options pour ce contrôle.

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

ToolTipSelectedItemTitle

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

String

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

Element	Description
<Menu> (RibbonDiffXml)	Spécifie un conteneur utilisé pour afficher les menus contextuels.

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

Remarques

If this element does not have any <Menu> elements and does not have a valid PopulateQueryCommand, the application will throw the following script error at run time: ‘attrs' is null or not an object.

Informations sur l'élément

XPath	`//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/SplitButton \| //Controls/SplitButton`
Schema Name	SplitButtonType
Validation File	RibbonWSS.xsd
Can be Empty	Yes

Voir aussi

Autres ressources

Ribbon XML reference
Personnaliser les commandes et le ruban

<SplitButton> (RibbonDiffXml)

Syntaxe

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Remarques

Informations sur l'élément

Voir aussi

Autres ressources

Ressources supplémentaires