Partilhar via

Todas as referências de elementos do formulário XML

  • Artigo

Você pode usar as informações neste tópico como uma referência rápida para todos os elementos e atributos principais que controlam o formulário para um tipo de item de trabalho.Esses elementos em você especifica o FORM container de elemento, a terceira e última seção principal da definição de um tipo de item de trabalho.Muitos elementos são aninhados dentro de outras pessoas para formar grupos, seções ou guias em um formulário de item de trabalho.Para obter mais informações sobre como agrupar esses elementos, consulte Criar o layout do formulário de item de trabalho.

Neste tópico

  • Exemplo de formulário

  • Sintaxe dos elementos de formulário

  • Atributos que especificam a elementos de formulário

  • Elementos que especificam os rótulos autônomos, hiperlinks, páginas da Web ou conteúdo HTML

  • Elementos que filtrar e exibem relacionamentos de Link

Exemplo de formulário

O exemplo a seguir mostra a estrutura geral do FORM elemento.Você especifica o layout de um formulário usando o Layout elemento.Você pode especificar diferentes layouts diferentes clientes-alvo.Por exemplo, você pode especificar um layout para clientes Windows e um layout diferente para Team Web Access.Um layout normalmente consiste em parte superior do formulário e, em seguida, um grupo de guias.A seqüência na qual você define os elementos no layout determina a seqüência na qual os elementos aparecem no formulário.

Agrupar elementos sejam exibidas em colunas usando o Group e Column elementos.Você pode usar um Control elemento para definir cada campo que você deseja que apareça no formulário.Você pode usar o Tab elemento para oferecer suporte a diferentes áreas funcionais de grupos de campos.

<FORM>
      <Layout>
        <Group>
          <Column PercentWidth="70">
            <Group>
              <Column PercentWidth="100">
                <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
                <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />
                <Control FieldName="System.IterationPath" Type="WorkItemClassificationControl" Label="&amp;Iteration Path:" LabelPosition="Left" />
                <Group>
                  <Column PercentWidth="50">
                    <Control FieldName="Microsoft.VSTS.Common.ProductUnit" Type="FieldControl" Label="PU (Use Area Path)" LabelPosition="Left" />
                  </Column>
                  <Column PercentWidth="50">
                    <Control FieldName="Microsoft.VSTS.Common.Priority" Type="FieldControl" Label="Priority" LabelPosition="Left" />
                  </Column>
                </Group>
              </Column>
            </Group>
          </Column>
          <Column PercentWidth="30">
            <Group Label="Status">
              <Column PercentWidth="100">
                <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
                <Control FieldName="System.State" Type="FieldControl" Label="State" LabelPosition="Left" />
                <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assigned To" LabelPosition="Left" />
              </Column>
            </Group>
          </Column>
        </Group>

. . .
</Layout>
</FORM>

Elementos de formulário

Você pode especificar como os campos de item de trabalho e as informações são agrupados e aparecem em um formulário de item de trabalho usando os elementos que estão descritos na tabela a seguir.

ObservaçãoObservação

Para obter melhores resultados, você deve se aninhar Control elementos em um Group, e você deve se aninhar Group elementos em um Column, mesmo que a coluna atinge a largura total do formulário.Além disso, você deve se aninhar cada Column seção em um Group, mesmo que o grupo não tem rótulo visível ou limite.

Elemento

Descrição

Necessário?

Column

Divide as regiões de um formulário em colunas.

<Column PercentWidth="WidthPerceOfContainingElement" FixedWidth="WidthInPixels">
   <Group> . . . </Group
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Column >

Recomendado

Control

Define um campo, o texto, o hiperlink ou outro elemento de controle seja exibido no formulário de item de trabalho.

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" Label="LabelText" LabelPosition="Top | Bottom | Left | Right" 
Dock="Fill | Top | Bottom | Left | Right" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ReadOnly="True | False" MinimumSize="(Width,Height)" 
Name="InstanceName" />

Para mais informações, consulte Referência de elemento do controle XML.

Necessário

FORM

Define o elemento de nível superior do formulário.

<FORM>
   <Layout> . . . </Layout>
</FORM>

Necessário

Group

Fornece um agrupamento visual de elementos, semelhantes à caixa de grupo do Windows.

<Group Label="LabelText" Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Column> . . . </Column>
</Group >

Recomendado

Layout

Define o layout do formulário de item de trabalho.

<Layout Target="ClientName" MinimumSize="(width,height)" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ControlSpacing="Distance" LabelSpacing="Distance">
   <Group> . . . </Group>
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Layout>

Necessário

Splitter

Divide um formulário em duas áreas para suportar o layout de dois elementos de formulário irmãos.

Splitter Dock="Left" />

Optional

Tab

Define o layout de uma única guia em um grupo de guias.

<Tab Label="LabelText" Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Group> . . . </Group
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Tab>

Optional

TabGroup

Define uma ou mais guias para o formulário.

<TabGroup Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Tab> . . . </Tab>
</TabGroup>

Optional

De volta ao topo

Atributos que são usados para formatar elementos de formulário

Você pode controlar o espaçamento e o tamanho dos muitos elementos em um formulário de item de trabalho, especificando os atributos que a tabela a seguir descreve.Para mais informações, consulte Criar o layout do formulário de item de trabalho.

Atributo

Descrição

Elementos aplicáveis

ControlSpacing

Opcional.Especifica o deslocamento vertical de controles.Número inteiro.

Layout

Dock

Opcional.Estica um controle de campo ou um divisor para preencher o restante do recipiente.Estes são valores de campo válido encaixe: Preencher, Top, Bottom, Left, e direita.

  • Fill: Alinha o campo para que ela preencha o recipiente.

  • Top: Alinha o campo com a parte superior do recipiente.

  • Bottom: Alinha o campo com a parte inferior do recipiente.

  • Left: Alinha o campo ou o divisor com o lado esquerdo do recipiente.Esse valor é a orientação com suporte apenas para o SPLITTER elemento.

  • Right: Alinha o campo ou o divisor com o lado direito do recipiente.

Control

Splitter

FixedWidth

Opcional.A largura da coluna em pixels.PercentWidthe FixedWidth são mutuamente exclusivos.

Column

Label

Opcional.Texto a ser exibido para um controle ou grupo.Se for especificado um rótulo, ele substitui qualquer rótulo associado com o campo nos metadados para o controle.

Necessário para o Tab elemento.Texto a ser exibido para uma tabulação.

LabelText é uma seqüência de texto que contenha entre 1 e 80 caracteres.

Control

Group

Tab

LabelPosition

Opcional.A posição do rótulo em relação aos dados do campo.Valores possíveis são: superior, inferior, esquerda e direita.

Control

LabelSpacing

Opcional.Especifica o número de pixels entre o rótulo e a região de edição do controle.

Layout

Margin

Opcional.Seqüência de caracteres do formulário (esquerda, superior, direita, inferior) que especifica, em pixels, a quantidade de espaço ao redor do controle e entre o controle e seus vizinhos.Você pode variar a quantidade de espaço em cada lado.

Padrão de valor: ^ \(\d+\,\d+\,\d+\,\d+\)$

Exemplo de valor padrão: (2,0,2,0)

Control

Group

Layout

Tab

TabGroup

MinimumSize

Opcional.Seqüência de caracteres do formulário (largura, altura).Esse valor Especifica o tamanho mínimo para o próprio formulário.Quando o contêiner de controle de menores do que esse tamanho, aparecem as barras de rolagem horizontais e verticais.

Control

Layout

Name

Opcional.Nome do controle.Se não for especificado, o nome é igual a FieldName.

Control

Padding

Opcional.String no formato (esquerda, superior, direita, inferior) que especifica, em pixels, a quantidade de espaço ao redor da borda externa do controle e ao redor do interior borda.Você pode variar a quantidade de espaço em cada lado.

Control

Group

Layout

Tab

TabGroup

PercentWidth

Opcional.A largura da coluna como uma porcentagem da largura do elemento contido.PercentWidthe FixedWidth são mutuamente exclusivos.

Column

ReadOnly

Opcional.Você pode exibir um campo somente leitura em um controle.Controles diferentes respondem a este atributo maneiras ligeiramente diferentes.

Control

Target

Opcional.Seqüência de caracteres que especifica para qual cliente se aplica a esse layout.Visual StudioExibe este tipo de item de trabalho neste layout se o Target atributo for omitido ou definido como Windows Forms.Os clientes externos podem especificar outros layouts usando personalizado Target atributos que Visual Studio ignora.

Os seguintes valores são válidos:

  • WinForms: Aplica-se o formulário para Team Explorer e Team Explorer Everywhere.

  • Web: Aplica-se o formulário para Team Web Access.

Layout

Type

Necessário.O tipo de controle.Para mais informações, consulte Referência de elemento do controle XML.

Control

De volta ao topo

O WebpageControlOptions tem a seguinte estrutura de sintaxe de elemento e seus elementos filho:

<WebpageControlOptions AllowScript="true | false" ReloadOnParamChange="true | false" >
   <Link UrlRoot="UrlRoot" UrlPath ="UrlPathWithParameters">
      <Param index="IndexValue" value="ParamValue" type ="Original | Current"/>
   </Link>
   <Content>
      <![CDATA[Contents of HTML]]>
   </Content>
</WebpageControlOptions>

Você usar os elementos que estão descritos na tabela a seguir para definir o texto sem formatação ou rótulos com hiperlinks, adicionar hiperlinks a um campo ou exibir o conteúdo da página da Web em um formulário de item de trabalho.Para mais informações, consulte Fornecer texto da Ajuda, diretrizes de processo, conteúdo da Web e links para páginas da Web em um formulário de item de trabalho.

Elemento

Necessário?

Descrição

Content

Opcional WebpageControlOptions elemento.

Especifica o conteúdo em HTML CDATA apareça em um formulário de item de trabalho.

<Content>
   <![CDATA[Contents of HTML]]>
</Content>

Para mais informações, consulte Referência de elementos XML WebpageControlOptions.

LabelText

Opcional Control elemento quando type="LabelControl".

Define ou um rótulo puro ou hiperlink.

Para mais informações, consulte Referência de elementos XML LabelText e texto.

Link

Opcional Control elemento quando type="FieldControl".

Opcional Text elemento.

Opcional WebpageControl elemento.

Opcional WebpageControlOptions elemento.

Define o hiperlink para um campo, rótulo ou conteúdo do navegador da Web seja exibido em um formulário de item de trabalho.

<Link URLRoot="URLRoot" URLPath ="URLPathWithParameters">
   <Param />
</Link>

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

Param

Opcional Link elemento.

Especifica um valor para determinar a URL do hiperlink quando URLPath é especificado para o Link elemento.

<Param index="IndexValue " value="ParamValue " type ="Original | Current"/>

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

Text

Opcional LabelText elemento.

Elemento de contêiner para as informações ou o rótulo apareça no formulário de item de trabalho.

<Text>
   <Link >
      <Param />
   </Link>
   LabelText
</Text>

Para mais informações, consulte Referência de elementos XML LabelText e texto.

WebpageControlOptions

Opcional Control elemento quandotype="WebpageControl"

Elemento de recipiente que especifica as opções para o controle de página da Web.

Para mais informações, consulte Referência de elementos XML WebpageControlOptions.

De volta ao topo

Você pode usar o LinksControlOptions elemento para definir as opções para controlar quais links pode ser adicionado a um item de trabalho e as colunas padrão que você deseja que apareça para a lista de links em um item de trabalho.Quando você adiciona um controle de vínculo a um formulário de item de trabalho, você pode especificar filtros restringem os tipos de links que os usuários podem criar e os tipos de itens de trabalho entre os quais usuários podem criar vínculos.O LinksControlOptions elemento e seus elementos filho tem a seguinte estrutura:

<LinksControlOptions>
   <WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
       <Filter LinkType="linkTypeRefName" FilterOn="reverseName | forwardName" />
   </WorkItemLinkFilters>
   <ExternalLinkFilters FilterType ="include | exclude | includeAll | excludeAll">
       <Filter LinkType="externalLinkName"/>
   </ExternalLinkFilters>
   <WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" />
       <Filter WorkItemType="workItemTypeReferenceName"/>
   </WorkItemTypeFilters>
   <LinkColumns>
      <LinkColumn RefName="referenceName" | LinkAttribute="linkAttributeName"/>
   </LinkColumns>
</LinksControlOptions>

Especificamente, você pode usar os elementos que estão resumidos na tabela a seguir.Para obter mais informações sobre como usar esses elementos, consulte Definir controles de link para restringir as relações de link e Elementos de LinksControlOptions.

Elemento

Necessário?

Descrição

LinksControlOptions

Opcional Control elemento quandotype="LinksControl"

Fornece um contêiner para elementos que definem as opções para controlar os links que pode ser adicionado a um item de trabalho e as colunas padrão que você deseja que apareça para a lista de links em um item de trabalho.

WorkItemLinkFilters

Opcional LinksControlOptions elemento

Fornece um contêiner para um ou mais Filter elementos que especificam o link filtragem critérios a serem usados para tipos de link que são definidos para a coleção de projeto de equipe.

ExternalLinkFilters

Opcional LinksControlOptions elemento

Fornece um contêiner para um ou mais Filter elementos que especificam os critérios de filtro a ser usado para vincular tipos definidos em outros projetos de equipe.

WorkItemTypeFilters

Opcional LinksControlOptions elemento

Fornece um contêiner para um ou mais Filter elementos que especificam os critérios de filtro para aplicar a tipos de item de trabalho.

Filter(tipos de link)

Obrigatório WorkItemLinkFilters elemento quando o FilterType atributo é exclude ou include.

Obrigatório ExternalLinkFilters elemento quando o FilterType atributo é exclude ou include.

Especifica os tipos de links para incluir ou excluir do conjunto de links que podem ser criados para o item de trabalho.

Filter(tipos de item de trabalho)

Opcional WorkItemTypeFilters elemento quando o FilterType atributo é exclude ou include.

Especifica os tipos de itens de trabalho para incluir ou excluir do conjunto de tipos de item de trabalho entre os quais os usuários podem vincular.

LinkColumns

Opcional LinksControlOptions elemento

Fornece um contêiner para um ou mais LinkColumn marcas.

LinkColumn

Obrigatório LinkColumns elemento

Especifica os campos de item de trabalho e os atributos de tipo de link apareça em que o formulário de item de trabalho para a lista de links.

De volta ao topo

Consulte também

Conceitos

Criar o layout do formulário de item de trabalho

Criar e personalizar um formulário de item de trabalho

Outros recursos

Índice para definições de elementos XML para tipos de item de trabalho