Referência de elemento XML de layout

  • Artigo

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

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

Hierarquia de esquema

WITD

   WORKITEMTYPE

       FORMULÁRIO

           Layout

<xs:element name="Layout" type="LayoutType" minOccurs="1" maxOccurs="unbounded"/>

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

Atributos e elementos

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

Atributos

Atributo

Descrição

Target

Opcional LayoutType atributo.

Especifica o nome do cliente ao qual se aplica o layout. O tipo é xs: String. Especifique uma das seguintes seqüências:

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

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

MinimumSize

Opcional LayoutType atributo.

Especifica o tamanho mínimo em pixels para o formulário. A sintaxe é especificada em (width, height). O tipo de atributo é SizeType.

Valor padrão: ^\(\d+\,\d+\)$

Exemplo de valor padrão: (100,100)

Padding

Opcional LayoutType atributo.

Especifica a quantidade de espaço em pixels ao redor do interior borda do formulário. O tipo de atributo é SizeType.

Valor padrão: ^\(\d+\,\d+\,\d+\,\d+\)$

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

Margin

Opcional LayoutType atributo.

Especifica a quantidade de espaço em pixels ao redor da borda externa do formulário. O tipo de atributo é SizeType.

Valor padrão: ^\(\d+\,\d+\,\d+\,\d+\)$

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

ControlSpacing

Opcional LayoutType atributo.

Especifica o deslocamento vertical da controles definidos no formulário. O tipo é xs:integer.

LabelSpacing

Opcional LayoutType atributo.

Especifica o número de pixels entre o rótulo e a região de edição do controle. O tipo é xs:integer.

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, o texto, o hiperlink ou outro elemento de controle para exibir em um formulário de item de trabalho.

Grupo de abas

Opcional. Contém um ou mais Tab elementos.

Splitter

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 do formulário de 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, or Splitter. Você pode definir mais de um elemento filho.

minOccurs = "1"

maxOccurs = "não vinculado"

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

Definição de tipo de Item de trabalho

Arquivo de validação

WorkItemTypeDefinition.xsd

Tipo de elemento

Tipo do complexo de LayoutType

Pode ficar vazio

Não

Consulte também

Referência

Referência de elemento do controle XML

Conceitos

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

Criando e personalizando um formulário de Item de trabalho

Histórico de alterações

Date

History

Motivo

Janeiro de 2011

Adicionado um exemplo de código e removidos links para tópicos que foram removidos.

Aprimoramento de informações.

Setembro de 2010

Adicionado os valores válidos da Target atributo.

Comentários do cliente.