Condividi tramite


Riferimento agli elementi XML LabelText e Text

È possibile aggiungere un collegamento ipertestuale o testo informativo a un form 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.

L'elemento LabelText è un elemento figlio di Control.

Gerarchia dello schema

WITD

   WORKITEMTYPE

       FORM

           Layout

               Gruppo

               Column

               TabGroup

                  Tab

                     Controllo

<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 illustrati attributi, elementi figlio e padre.

Elementi figli e attributi

Elemento

Oggetto di 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 dell'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 ha un collegamento ipertestuale. Se non è specificato l'elemento Link, viene eseguito il rendering del testo 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 non è specificato l'elemento Text, l'elemento Control del testo dell'attributo Label viene visualizzato nel form elemento di lavoro.

Link

Elemento Text facoltativo.

Elemento del contenitore per il collegamento ipertestuale da applicare a un campo o un'etichetta autonoma visualizzata sul form elemento di lavoro. Il tipo di elemento è HyperLinkType.

NotaNota
È necessario specificare l'attributo Label in un elemento Control quando si specifica un elemento Link figlio.

Per ulteriori informazioni, vedere Riferimento agli elementi XML Link e Param.

Elementi padre

Elemento

Oggetto di descrizione

Controllo

Obbligatoria. 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 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 stanno eseguendo l'ultima versione di Team Explorer, il testo fornito dall'elemento LabelText viene visualizzato nel form elemento di lavoro. Per i client che stanno eseguendo versioni precedenti di Team Explorer, il testo specificato dall'elemento Control attributo Label viene visualizzato nel form elemento di lavoro.

Esempio: etichetta autonoma

Oggetto di descrizione

L'esempio seguente aggiunge testo normale "Immettere dettagli su come riprodurre il bug nel seguente spazio:" a un form 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

Oggetto di descrizione

Nell'esempio seguente viene aggiunto un collegamento ipertestuale identificato "How do I use this work item?" a un form 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

Oggetto di descrizione

Nell'esempio seguente viene aggiunta un'etichetta in due parti a un form elemento di lavoro. La prima parte, "Percorso di iterazione", è associata a un collegamento ipertestuale. La seconda parte, "(deve essere di 3 livelli profonda)" viene visualizzato sul form elemento di lavoro come testo normale.

Codice

<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>

Definizioni dello schema

È possibile scaricare i file di schema per la definizione dei tipi di elementi di lavoro dalla seguente pagina del sito Web Microsoft: Modello di processo e schemi di elementi di lavoro di Visual Studio Team Foundation. Per ulteriori informazioni sulle modalità di utilizzo dei file di schema, vedere la seguente pagina del sito Web Microsoft: Utilizzo degli schemi per modificare tipi di elementi di lavoro e modelli di processo di Team Foundation in Visual Studio.

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>

Vedere anche

Concetti

Specifica dei controlli dei form elemento di lavoro

Progettazione e personalizzazione di un form elemento di lavoro

Altre risorse

Elements (Work Item Type Definition Schema)

Cronologia delle modifiche

Data

Cronologia

Motivo

Maggio 2011

È stata corretta la sintassi per l'attributo UrlPath specificato per l'elemento Link.

Correzione di bug nel contenuto.

Marzo 2011

Corretta la struttura del caso di un esempio e la maggior parte degli elementi. Aggiunte informazioni relative alla posizione di accesso ai file di schema.

Commenti e suggerimenti dei clienti.

Gennaio 2011

Rimosso collegamenti a argomenti rimossi.

Miglioramento delle informazioni.