Référence des éléments XML LabelText et Text

Vous pouvez ajouter une étiquette autonome ou un texte informatif à un formulaire d'élément de travail à l'aide de l'élément LabelText. L'étiquette n'est pas associée à un champ d'élément de travail. Vous pouvez éventuellement ajouter un lien hypertexte à une partie de texte ou à la totalité de celui-ci.

L'élément LabelText est un élément enfant de l'élément Control.

Hiérarchie de schéma

WITD

   WORKITEMTYPE

       FORM

           Disposition

               Groupe

               Colonne

               TabGroup

                  Onglet

                     Contrôle

<LabelText>
   <Text>
      <Link OpenInNewWindow="true | false" UrlPath="URLLinkWithParameters">
         <Param index="IndexValue " value="ParamValue " type ="Original | Current"/>
      </Link>
      LabelText
   </Text>
</LabelText>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Éléments enfants et attributs

Élément	Description
LabelText	Élément Control requis lorsque type="LabelControl". Élément conteneur pour une étiquette autonome ou texte informatif. L'élément est de type complexe : LabelElementType. Cet élément remplace la valeur spécifiée par l'attribut Label spécifié par l'élément Control.
Text	Élément LabelText obligatoire. Élément conteneur pour les informations ou l'étiquette à afficher sur le formulaire d'élément de travail. Si l'élément Link est spécifié dans l'étiquette, la partie du texte dans l'élément est un lien hypertexte. Si l'élément Link n'est pas spécifié, le texte est restitué sans un lien hypertexte. Les parties différentes du texte d'étiquette peuvent être des liens hypertexte d'autres URL. Plusieurs valeurs d'élément de type texte peuvent être spécifiées dans une série. L'élément est de type complexe : TextElementType. Si l'élément Text n'est pas spécifié, le texte de l'attribut Label de l'élément Control apparaît sur le formulaire d'élément de travail.
Link	Élément Text facultatif. Élément conteneur pour le lien hypertexte à s'appliquer à un champ ou étiquette autonome qui apparaît sur le formulaire d'élément de travail. Le type d'élément est HyperLinkType. Remarque Vous devez spécifier l'attribut Label dans un élément Control lorsque vous spécifiez un élément Link enfant. Pour plus d'informations, consultez Référence des éléments XML Link et Param.

Éléments parents

Élément	Description
Contrôle	Obligatoire. Définit un élément de champ, de texte, de lien hypertexte ou d'autre contrôle à afficher sur le formulaire d'élément de travail.

Notes

Vous pouvez combiner du texte ordinaire et hypertexte en ajoutant plusieurs éléments Text dans un élément LabelText.

L'élément LabelText est reconnu uniquement par les clients qui exécutent la version la plus récente de Team Explorer. Par conséquent, vous devez spécifier l'attribut Label dans un élément Control. Pour les clients qui exécutent la version la plus récente de Team Explorer, le texte fourni par l'élément LabelText s'affiche dans le formulaire d'élément de travail. Pour les clients qui exécutent des versions antérieures de Team Explorer, le texte spécifié par l'élément Control de l'attribut Label s'affiche dans le formulaire d'élément de travail.

Exemple : Étiquette autonome

Description

L'exemple suivant ajoute le texte brut « Enter details about how to reproduce the bug in the space below: » (Entrez des détails sur la méthode à suivre pour reproduire le bogue dans l'espace ci-dessous :) à un formulaire d'élément de travail.

Code

<Control Type="LabelControl" Label=" Enter details about how to reproduce the bug in the space below:">
   <LabelText>
      <Text>Enter details about how to reproduce the bug in the space below:
      </Text>
   </LabelText>
</Control>

Exemple : Étiquette autonome avec le lien hypertexte

Description

L'exemple suivant ajoute un lien hypertexte qui est étiqueté « Comment faire pour utiliser cet élément de travail ? » à un formulaire d'élément de travail.

Code

<Control Type="LabelControl" Label="How do I use this work item?">
   <LabelText>
      <Text>
   <Link UrlRoot="http://www.live.com"></Link>
      How do I use this work item?
      </Text>
   </LabelText>
</Control>

Exemple : Le lien hypertexte s'appliqué aux parties de texte

Description

L'exemple suivant ajoute une étiquette en deux parties à un formulaire d'élément de travail. La première partie, "Chemin de l'itération", est associée à un lien hypertexte. La deuxième partie "(must be 3 levels deep)" apparaît sur le formulaire d'élément de travail sous forme de texte brut.

Code

<Control Type="FieldControl" FieldName="System.IterationPath" LabelPosition="Left">
   <LabelText>
      <Text>
         <Link UrlRoot="@WssSiteUrl/render.aspx?wit=bug&amp;topic=Iteration">
         </Link>
      Iteration Path
      </Text>
      <Text> (must be 3 levels deep)</Text>
   </LabelText>
</Control>

Définitions de schéma

Vous pouvez télécharger les fichiers de schéma permettant de définir des types d'éléments de travail à partir de la page suivante du site Web Microsoft : Process Template and Work Item Schemas for Visual Studio Team Foundation. Pour plus d'informations sur l'utilisation des fichiers de schéma, consultez la page suivante sur le site Web Microsoft : Using the Schemas to Edit Work Item Types and Process Templates for Team Foundation in Visual Studio.

Élément : LabelText

<xs:element name="LabelText" type="LabelElementType" minOccurs="0" maxOccurs="1" />
<xs:element name="Text" type="TextElementType" minOccurs="1" maxOccurs="unbounded" />

Type complexe : LabelElementType

<xs:complexType name="LabelElementType">
   <xs:sequence>
      <xs:element name="Text" type="TextElementType" minOccurs="1" maxOccurs="unbounded" />
   </xs:sequence>
</xs:complexType>

Type complexe : TextElementType

<xs:complexType name="TextElementType" mixed="true">
   <xs:sequence>
      <xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
   </xs:sequence>
</xs:complexType>

Voir aussi

Concepts

Spécification des contrôles de formulaire d'élément de travail

Conception et personnalisation d'un formulaire d'élément de travail

Autres ressources

Elements (Work Item Type Definition Schema)

Historique des modifications

Date	Historique	Motif
Mai 2011	A corrigé la syntaxe de l'attribut UrlPath spécifié pour l'élément Link.	Résolution des bogues de contenu.
Mars 2011	Correction de la structure des cas d'un exemple et de la plupart des éléments. Ajout des informations sur le point d'accès des fichiers de schéma.	Commentaires client.
Janvier 2011	Liens retirés vers les rubriques qui ont été supprimées.	Améliorations apportées aux informations.