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

               Grupo

               Coluna

               TabGroup

                  Tab

                     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 de atributo em um Control quando você especifica um filho de elemento Link elemento.

Para obter mais informações, consulte Referência de elementos XML Link e Param.

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

Você pode combinar texto sem formatação e hiperlink adicionando vários Textelementos em um LabelText elemento.

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 de atributo em um 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