Referência de elemento XML do layout

Artigo
06/09/2015

Você pode usar o Layout elemento para definir como os elementos no formulário de item de trabalho são exibidos. Você pode definir mais de um layout para dar suporte a clientes diferentes, como o cliente do Windows para Visual Studio ou o cliente web para Team Web Access.

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

O Layout é um elemento filho obrigatório do FORM elemento. Para obter mais informações sobre como usar o Layout elemento, consulte Criar o formulário de item de trabalho.

Hierarquia de esquema

WITD

WORKITEMTYPE

FORMULÁRIO

Layout

<Layout Target="ClientName" MinimumSize="(width,height)" Padding="(left, top, right, bottom)"  Margin="(left, top, right, bottom)" ControlSpacing="distance" LabelSpacing="distance" HideControlBorders="True | False" HideReadOnlyEmptyFields="True | False">     <Group> . . . </Group>     <Control> . . . </Control>     <TabGroup> . . . </TabGroup>     <Splitter> . . . </Splitter> </Layout >

Atributos e elementos

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

Atributos

Atributo	Descrição
Target	Atributo Layout opcional. Especifica o nome do cliente ao qual se aplica o layout. O tipo é xs: String. Especifique uma das seguintes cadeias de caracteres: WinForms: Aplica-se o formulário Team Explorer e Team Explorer Everywhere. Web: Aplica-se o formulário Team Web Access.
MinimumSize	Atributo Layout opcional. Especifica o tamanho mínimo em pixels para o formulário. A sintaxe é especificada em (largura, altura). O tipo de atributo é SizeType. Valor do padrão: ^ $\d+\,\d+$$ Exemplo de valor padrão: (100,100)
Padding	Atributo Layout opcional. Especifica a quantidade de espaço em pixels ao redor do interior borda do formulário. O tipo de atributo é SizeType. Valor do padrão: ^ $\d+\,\d+\,\d+\,\d+$$ Exemplo de valor padrão: (2,0,2,0)
Margin	Atributo Layout opcional. Especifica a quantidade de espaço em pixels ao redor da borda externa da forma. O tipo de atributo é SizeType. Valor do padrão: ^ $\d+\,\d+\,\d+\,\d+$$ Exemplo de valor padrão: (2,0,2,0)
ControlSpacing	Atributo Layout opcional. Especifica o deslocamento vertical de controles definido no formulário.
LabelSpacing	Atributo Layout opcional. Especifica o número de pixels entre o rótulo e a região de edição do controle.
HideControlBorders	Atributo Layout opcional. Especifique um valor de True para ocultar as bordas do controle, e False para exibir as bordas do controle.
HideReadOnlyEmptyFields	Atributo Layout opcional. Especifique um valor de True para ocultar campos somente leitura e está vazios, e False para exibir esses campos.

Elementos filho

Elemento	Descrição
Group	Opcional. Define um grupo de elementos a serem exibidos juntos no formulário.
Controle	Opcional. Define um campo de item de trabalho, texto, hiperlinks ou outro elemento de controle para exibir em um formulário de item de trabalho.
TabGroup	Opcional. Contém um ou mais Tab elementos.
Divisor	Opcional. Define um divisor e sua orientação no formulário entre elementos de formulário de irmãos.

Elementos pai

Elemento	Descrição
FORMULÁRIO	Obrigatório. Contém o Layout elemento que define como os elementos no formulário tipo de item de trabalho são exibidos.

Comentários

O Layout é um elemento filho obrigatório do FORM. O Layout elemento Especifica uma opção e pelo menos um dos elementos filho deve ser definido: Group, Control, TabGroup, ou Splitter. Você pode definir mais de um elemento filho.

minOccurs = "1"

maxOccurs = "ilimitado"

Exemplo

<FORM>
   <Layout>
      <Group>
          <Column PercentWidth="36">
            <Group>
            <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
            <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area" LabelPosition="Left" />
            <Control FieldName="Microsoft.VSTS.Common.ProductUnit" Type="FieldControl" Label="Product Unit" LabelPosition="Left" />
            <Control FieldName="Microsoft.DevDiv.BusinessUnit" Type="FieldControl" Label="Business Unit" LabelPosition="Left" />
            </Group>
          </Column>
          <Column PercentWidth="33">
            <Group>
            <Control FieldName="Microsoft.DevDiv.SubTitle" Type="FieldControl" Label="Sub Title" LabelPosition="Left" />
            <Control FieldName="System.IterationPath" Type="WorkItemClassificationControl" Label="Iteration" LabelPosition="Left" />
            <Control FieldName="Microsoft.DevDiv.Other" Type="FieldControl" Label="Other" LabelPosition="Left" />
            </Group>
          </Column>
          <Column PercentWidth="31">
            <Group>
            <Control FieldName="Microsoft.DevDiv.Type" Type="FieldControl" Label="Type" LabelPosition="Left" />
            <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assigned To" LabelPosition="Left" />
            <Control FieldName="System.State" Type="FieldControl" Label="State" LabelPosition="Left" />
            </Group>
          </Column>
      </Group>
. . .
   </Layout>
</FORM>

Informações do elemento

Namespace	https://schemas.microsoft.com/VisualStudio/2008/WorkItemTracking/TypeDef
Nome do esquema	Definição de tipo de Item de trabalho
Arquivo de validação	WorkItemTypeDefinition.xsd
Tipo de elemento	Tipo complexo de LayoutType
Pode estar vazio	Não