Referência de elemento XML de layout

Artigo
08/01/2011

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.

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.

Compartilhar via