Compartilhar via


Referência de elementos XML LabelText e Text

Você pode adicionar um rótulo autônomo ou texto informativo para um formulário de item de trabalho usando o LabelText elemento. O rótulo não estiver associado a qualquer campo de item de trabalho. Opcionalmente, você pode adicionar um hiperlink a parte ou todo o texto.

Para adicionar elementos a um formulário, você deve modificar um tipo de item de trabalho. Consulte Modificar ou adicionar um WIT (tipo de item de trabalho) personalizado.

O LabelText é um elemento filho do Control elemento.

Hierarquia de esquema

WITD

   WORKITEMTYPE

       FORMULÁRIO

           Layout

               Group

               Coluna

               TabGroup

                  Tabulação

                     Controle

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos e elementos filho

Elemento

Descrição

LabelText

Necessário Control elemento quando type="LabelControl".

Elemento de contêiner para um rótulo autônomo ou texto informativo. O tipo de elemento é o tipo complexo: LabelElementType.

Esse elemento substitui o valor especificado pelo Label atributo especificado o Control elemento.

Text

Necessário LabelText elemento.

Elemento de contêiner para as informações ou o rótulo a ser exibido no formulário de item de trabalho. Se o Link elemento for especificado dentro do rótulo, a parte do texto dentro do elemento é vinculado por hiperlink. Se o Link elemento não for especificado, o texto é renderizado sem um hiperlink.

Partes diferentes do texto do rótulo podem ser vinculado por hiperlink com diferentes URLs. Vários valores de elemento de texto podem ser especificados em uma série.

O tipo de elemento é o tipo complexo: TextElementType.

Se o Text elemento não for especificado, o Control elemento Label atributo texto aparece no formulário de item de trabalho.

Link

Opcional Text elemento.

Elemento de contêiner para o hiperlink seja aplicado a um rótulo de campo ou autônomo que aparece no formulário de item de trabalho. O tipo de elemento é HyperLinkType.

Dica

Você deve especificar o Label atributo em uma Control quando você especifica um filho de elemento Link elemento.

Para obter mais informações, consulte Referência de elementos XML para link e parâmetro.

Elementos pai

Elemento

Descrição

Controle

Obrigatório. Define um campo, texto, hiperlinks ou outro elemento de controle apareça no formulário de item de trabalho.

Comentários

You can combine plain and hyperlinked text by adding multiple Textelements in a LabelText element.

O LabelText elemento só é reconhecido por clientes que estão executando a versão mais recente do Team Explorer. Portanto, você deve especificar o Label atributo em uma Control elemento. Para clientes que estejam executando a versão mais recente do Team Explorer, o texto fornecido pelo LabelText elemento aparece no formulário de item de trabalho. Para clientes que estejam executando versões anteriores do Team Explorer, o texto especificado o Control elemento Label atributo aparece no formulário de item de trabalho.

Exemplo: Rótulo de autônomos

Descrição

O exemplo a seguir adiciona o texto sem formatação "Insira os detalhes sobre como reproduzir o bug no espaço abaixo:" a um formulário de item de trabalho.

Código

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

Descrição

O exemplo a seguir adiciona um hiperlink que é rotulado como "Como utilizo esse item de trabalho?" a um formulário de item de trabalho.

Código

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

Descrição

O exemplo a seguir adiciona um rótulo de duas partes a um formulário de item de trabalho. A primeira parte, "Caminho de iteração," está associada um hiperlink. A segunda parte, "(deve ser a 3 níveis de profundidade)" é exibida no formulário de item de trabalho como texto sem formatação.

Código

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

Definições de esquema

Elemento: LabelText

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

Tipo complexo: LabelElementType

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

Tipo complexo: TextElementType

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

Consulte também

Conceitos

Especificar controles de formulários de itens de trabalho