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 ou à la totalité du texte.
Pour ajouter des éléments à un formulaire, vous modifiez un type d'élément de travail. Consultez Modifier ou ajouter un type d'élément de travail personnalisé (WIT).
L'élément LabelText est un élément enfant de l'élément Control.
Hiérarchie de schéma
<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 un texte informatif. L'élément est de type complexe : LabelElementType. Cet élément remplace la valeur spécifiée par l'attribut Label défini par l'élément Control. |
Text |
Élément LabelText requis. É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 rendu sans un lien hypertexte. Les parties différentes du texte d'étiquette peuvent être des liens hypertexte avec diverses 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 à appliquer à un champ, ou étiquette autonome qui apparaît sur le formulaire d'élément de travail. Le type d'élément est HyperLinkType. Notes 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 |
|---|---|
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 Textdans un élément LabelText.
L'élément LabelText est reconnu uniquement par les clients qui exécutent la dernière version 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'attribut Label de l'élément Control 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 étiqueté « How do I use this work item? » (« 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 : lien hypertexte appliqué à des parties de texte
Description
L'exemple suivant ajoute une étiquette en deux parties à un formulaire d'élément de travail. La première partie, « Iteration Path » (« Chemin d'itération »), est associée à un lien hypertexte. La deuxième partie « (must be 3 levels deep) » (« (doit avoir une profondeur de 3 niveaux) ») 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&topic=Iteration">
</Link>
Iteration Path
</Text>
<Text> (must be 3 levels deep)</Text>
</LabelText>
</Control>
Définitions de schéma
É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>