Partager via


Label, élément

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>