Label, élément

Article
09/24/2014

Dernière modification : vendredi 15 octobre 2010

S’applique à : SharePoint Foundation 2010

Dans cet article
Attributs
Éléments enfants
Éléments parents
Occurrences

Définit un contrôle d’étiquette.

<Label
  ForId="Text"
  Id="Text"
  LabelText="Text"
  Image16by16="Url"
  Image16by16Class="CSS Class Selector"
  Image16by16Left="Negative Integer"
  Image16by16Top="Negative Integer"
  Sequence="Integer"
  TemplateAlias="Text"
  QueryCommand="Text"
  Command="Text"
/>

Attributs

Attribut	Description
ForId	Facultatif. ID du contrôle dont ce contrôle définit l’étiquette.
Id	Obligatoire. Chaîne qui identifie le contrôle, telle que « Ribbon.Image.Image.Size.HorizontalSizeLabel ».
LabelText	Facultatif. Texte de l’étiquette.
Image16by16	Facultatif. URL relative de serveur vers un fichier qui contient une image de 16 pixels de côté à utiliser comme icône, telle que « /_layouts/1033/images/formatmap16x16.png ».
Image16by16Class	Facultatif. Nom d’un sélecteur de classe CSS à appliquer à l’image.
Image16by16Left	Facultatif. Entier négatif qui représente un décalage pour le bord gauche de l’image. Utilisez cet attribut lorsque l’attribut Image16by16 pointe vers un fichier image qui contient des images de nombreuses icônes. La valeur de l’attribut Image16by16Left permet de définir l’attribut CSS left pour le style intraligne d’une balise HTML img.
Image16by16Top	Facultatif. Entier négatif qui représente un décalage pour le bord supérieur de l’image. Utilisez cet attribut lorsque l’attribut Image16by16 pointe vers un fichier image qui contient des images de nombreuses icônes. La valeur de l’attribut Image16by16Top permet de définir l’attribut CSS top pour le style intraligne d’une balise HTML img.
Sequence	Facultatif. Entier qui spécifie l’ordre d’emplacement dans les nœuds XML frères.
TemplateAlias	Facultatif. Chaîne qui correspond à la valeur de l’attribut TemplateAlias pour un élément ControlRef, un élément OverflowArea ou un élément OverflowSection dans un élément GroupTemplate. L’attribut TemplateAlias permet de dimensionner et de positionner les contrôles dans un groupe lorsqu’un modèle est appliqué au groupe.
QueryCommand	Facultatif. Nom de la commande à exécuter lors de l’interrogation des informations d’état.
Command	Facultatif. Nom de la commande à exécuter lorsque l’étiquette reçoit le focus.

Éléments enfants

Aucun

Éléments parents

CommandUIDefinition

Controls

Occurrences

Minimum : 0

Maximum : 1

Exemple

L’exemple suivant est un fragment XML qui montre un élément Controls contenant deux contrôles de zone de texte et deux étiquettes pour ceux-ci.

<Controls Id="Ribbon.Link.Link.Properties.Controls">
  <Label
    Id="Ribbon.Link.Link.Properties.LinkAddressLabel"
    LabelText="$Resources:core,LabelLinkAddress;"
    Command="LinkUrlLabel"
    ForId="Ribbon.Link.Link.Properties.LinkAddress"
    Sequence="10"
    Image16by16="/_layouts/$Resources:core,Language;/images/formatmap16x16.png" Image16by16Top="-160" Image16by16Left="-224"
    TemplateAlias="o1"/>
  <TextBox
    Id="Ribbon.Link.Link.Properties.LinkAddress"
    Command="LinkUrlChanged"
    ToolTipTitle="$Resources:core,cui_LinkAddress;"
    ToolTipDescription="$Resources:core,cui_STT_LinkAddress;"
    QueryCommand="QueryLinkUrl"
    MaxLength="512"
    TemplateAlias="o2"
    Sequence="20"
                />
  <Label
    Id="Ribbon.Link.Link.Properties.LinkTooltipLabel"
    LabelText="$Resources:core,LabelLinkTooltip;"
    Command="LinkAltLabel"
    ForId="Ribbon.Link.Link.Properties.LinkTooltip"
    Image16by16="/_layouts/$Resources:core,Language;/images/formatmap16x16.png" Image16by16Top="0" Image16by16Left="-88"
    Sequence="30"
    TemplateAlias="o1"/>
  <TextBox
    ToolTipTitle="$Resources:core,cui_LinkTooltip;"
    ToolTipDescription="$Resources:core,cui_STT_LinkTooltip;"
    Id="Ribbon.Link.Link.Properties.LinkTooltip"
    Command="LinkTitleChanged"
    QueryCommand="QueryLinkTitle"
    MaxLength="128"
    Sequence="40"
    TemplateAlias="o2"/>
</Controls>