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. Siehe Anpassen oder Hinzufügen eines benutzerdefinierten Arbeitsaufgabentyps (WIT).
Das LabelText-Element ist ein untergeordnetes Element des Control-Elements.
Schemahierarchie
<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 Label-Attributs des Control-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 |
|---|---|
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 Text-Elemente 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 Label-Attribut des Control-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&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>