Partager via


<Label> (RibbonDiffXml)

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

Spécifie une ligne de texte utilisée pour fournir des informations.

Syntaxe

<Label 
 Command="String"
 ForId="String"
 Id="String"
 Image16by16="String"
 Image16by16Class="String"
 Image16by16Left="Non Positive Integer"
 Image16by16Top="Non Positive Integer"
 LabelText="String"
 ModernImage=”String”
 QueryCommand="String"
 Sequence="Integer"
 TemplateAlias="String"
/>

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

ForId

The ID of the control that this control labels.

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

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

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

ModernImage

Utilisation interne uniquement.

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

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

Informations sur l'élément

XPath

//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Label

Schema Name

LabelType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

Voir aussi

Autres ressources

Ribbon XML reference
Personnaliser les commandes et le ruban

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