Riferimento agli elementi XML LabelText e Text
È possibile aggiungere un'etichetta autonoma o un testo informativo a un form dell'elemento di lavoro tramite l'elemento LabelText. L'etichetta non è associata a nessun campo dell'elemento di lavoro. Facoltativamente è possibile aggiungere un collegamento ipertestuale a una parte o a tutto il testo.
Per aggiungere elementi a un form, modificare un tipo di elemento di lavoro. Vedere Modificare o aggiungere un tipo di elemento di lavoro personalizzato (WIT).
L'elemento LabelText è un elemento figlio dell'elemento Control.
Gerarchia dello schema
<LabelText>
<Text>
<Link OpenInNewWindow="true | false" UrlPath="URLLinkWithParameters">
<Param index="IndexValue " value="ParamValue " type ="Original | Current"/>
</Link>
LabelText
</Text>
</LabelText>
Attributi ed elementi
Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.
Elementi figli e attributi
Elemento |
Descrizione |
|---|---|
LabelText |
Elemento Control obbligatorio quando type="LabelControl". Elemento del contenitore per un'etichetta autonoma o un testo informativo. Il tipo di elemento è complesso: LabelElementType. Questo elemento sovrascrive il valore specificato dall'attributo Label specificato dall'elemento Control. |
Text |
Elemento LabelText obbligatorio. Elemento del contenitore per le informazioni o l'etichetta da visualizzare nel form dell'elemento di lavoro. Se l'elemento Link viene specificato all'interno dell'etichetta, la parte del testo all'interno dell'elemento avrà un collegamento ipertestuale. Se l'elemento Link non viene specificato, il rendering del testo verrà eseguito senza un collegamento ipertestuale. Parti diverse del testo dell'etichetta possono essere collegate con un collegamento ipertestuale a URL diversi. È possibile specificare più valori dell'elemento di testo in una serie. Il tipo di elemento è complesso: TextElementType. Se l'elemento Text non viene specificato, nel form dell'elemento di lavoro verrà visualizzato il testo dell'attributo Control dell'elemento Label. |
Link |
Elemento Text facoltativo. Elemento del contenitore per il collegamento ipertestuale da applicare a un campo o un'etichetta autonoma visualizzata nel form dell'elemento di lavoro. Il tipo di elemento è HyperLinkType. Nota È necessario specificare l'attributo Label in un elemento Control quando si specifica un elemento Link figlio. Per altre informazioni, vedere Riferimento agli elementi XML Link e Param. |
Elementi padre
Elemento |
Descrizione |
|---|---|
Necessario. Definisce un campo, un testo, un collegamento ipertestuale o un altro elemento di controllo da visualizzare nel form dell'elemento di lavoro. |
Note
È possibile combinare testo con collegamento ipertestuale e testo normale aggiungendo più elementi Text in un elemento LabelText.
L'elemento LabelText viene riconosciuto solo dai client che eseguono la versione più recente di Team Explorer. Pertanto, è necessario specificare l'attributo Label in un elemento Control. Per i client che eseguono l'ultima versione di Team Explorer, nel form dell'elemento di lavoro viene visualizzato il testo fornito dall'elemento LabelText. Per i client che eseguono versioni precedenti di Team Explorer, nel form dell'elemento di lavoro viene visualizzato il testo specificato dall'attributo Control dell'elemento Label.
Esempio: etichetta autonoma
Descrizione
L'esempio seguente aggiunge il testo normale "Enter details about how to reproduce the bug in the space below:" a un form dell'elemento di lavoro,
Codice
<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>
Esempio: etichetta autonoma con collegamento ipertestuale
Descrizione
L'esempio seguente aggiunge un collegamento ipertestuale con l'etichetta "How do I use this work item?" a un form dell'elemento di lavoro.
Codice
<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>
Esempio: collegamento ipertestuale applicato a parti di testo
Descrizione
L'esempio seguente aggiunge un'etichetta in due parti a un form dell'elemento di lavoro. La prima parte, "Iteration Path", è associata a un collegamento ipertestuale. La seconda parte, "(must be 3 levels deep)" viene visualizzata nel form dell'elemento di lavoro come testo normale.
Codice
<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>
Definizioni dello schema
Elemento: LabelText
<xs:element name="LabelText" type="LabelElementType" minOccurs="0" maxOccurs="1" />
<xs:element name="Text" type="TextElementType" minOccurs="1" maxOccurs="unbounded" />
Tipo complesso: LabelElementType
<xs:complexType name="LabelElementType">
<xs:sequence>
<xs:element name="Text" type="TextElementType" minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
Tipo complesso: TextElementType
<xs:complexType name="TextElementType" mixed="true">
<xs:sequence>
<xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
</xs:sequence>
</xs:complexType>