XML-Elementreferenz für LabelText und Text

Sie können einem Arbeitsaufgabenformular eine eigenständige Bezeichnung oder Informationstext hinzufügen, indem Sie das LabelText-Element verwenden. Die Bezeichnung ist keinem Arbeitsaufgabenfeld zugeordnet. Optional können Sie an einen Teil des Texts oder den gesamten Text einen Link anfügen.

Um Elemente einem Formular hinzuzufügen, ändern Sie einen Arbeitsaufgabentyp. Weitere Informationen finden Sie unter Anpassen oder Hinzufügen eines benutzerdefinierten Arbeitsaufgabentyps (WIT).

Das LabelText-Element ist ein untergeordnetes Element des Control-Elements.

Schemahierarchie

WITD

   WORKITEMTYPE

       FORM

           Layout

               Gruppieren

               Spalte

               TabGroup

                  TAB

                     Steuerelement

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Untergeordnete Elemente und Attribute

Element	Beschreibung
LabelText	Erforderliches Control-Element bei type="LabelControl". Containerelement für eine eigenständige Bezeichnung oder einen Informationstext. Der Elementtyp ist der komplexe Typ LabelElementType. Dieses Element überschreibt den Wert, der vom Label-Attribut angegeben wird, das wiederum vom Control-Element angegeben wird.
Text	Erforderliches LabelText-Element. Containerelement für die Informationen oder die Bezeichnung, die im Arbeitsaufgabenformular angezeigt werden. Wenn das Link-Element innerhalb der Bezeichnung angegeben ist, ist der Teil des Texts im Element durch einen Link verbunden. Wenn das Link-Element nicht angegeben ist, wird der Text ohne Link gerendert. Andere Teile des Bezeichnungstexts können mit verschiedenen URLs durch Link verbunden werden. Mehrere Textelementwerte können in einer Reihe angegeben werden. Der Elementtyp ist der komplexe Typ TextElementType. Wenn das Text-Element nicht angegeben wird, dann erscheint der Text des Control-Attributs des Label-Elements auf dem Arbeitsaufgabenformular.
Link	Optionales Text-Element. Containerelement für den Link, der für ein Feld oder eine eigenständige Bezeichnung gilt, die im Arbeitsaufgabenformular angezeigt wird. Der Elementtyp ist HyperLinkType. Hinweis Geben Sie das Label-Attribut in einem Control-Element an, wenn Sie ein untergeordnetes Link-Element angeben. Weitere Informationen finden Sie unter XML-Elementreferenz für Link und Param.

Übergeordnete Elemente

Element	Beschreibung
Steuerelement	Erforderlich. Definiert ein Feld, Text, einen Link oder ein anderes Steuerelement, das auf dem Arbeitsaufgabenformular angezeigt wird.

Hinweise

Sie können einfachen und durch Links verbundenen Text durch Hinzufügen mehrerer TextElemente in einem LabelText-Element kombinieren.

Das LabelText-Element wird nur von Clients erkannt, die die neueste Version von Team Explorer ausführen. Daher muss das Label-Attribut in einem Control-Element angegeben werden. Bei Clients, die die neueste Version von Team Explorer ausführen, erscheint der Text, der von einem LabelText-Element bereitgestellt wurde, im Arbeitsaufgabenformular. Bei Clients, die frühere Versionen von Team Explorer ausführen, erscheint der Text, der vom Control-Attribut des Label-Elements angegeben wurde, im Arbeitsaufgabenformular.

Beispiel: Eigenständige Bezeichnung

Beschreibung

Im folgenden Beispiel wird einem Arbeitsaufgabenformular folgender unformatierter Text hinzugefügt: "Enter details about how to reproduce the bug in the space below:"

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>

Beispiel: Eigenständige Bezeichnung mit Link

Beschreibung

Im folgenden Beispiel wird ein Link mit der Beschriftung "How do I use this work item?" einem Arbeitsaufgabenformular hinzugefügt.

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>

Beispiel: Ein Link wird auf Teile des Texts angewendet

Beschreibung

Im folgenden Beispiel wird eine zweiteilige Bezeichnung einem Arbeitsaufgabenformular hinzugefügt. Der erste Teil, "Iterationspfad", ist einem Link zugeordnet. Der zweite Teil, "(must be 3 levels deep)", wird im Arbeitsaufgabenformular als Nur-Text angezeigt.

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>

Schemadefinitionen

Element: LabelText

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

Komplexer Typ: LabelElementType

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

Komplexer Typ: TextElementType

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

Siehe auch

Konzepte

Specify work item form controls