Referência de elemento XML de layout

Artigo
02/25/2013

Você pode usar o Layout elemento para definir a aparecem de elementos no 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 da web para Team Web Access.

O Layout é um elemento filho necessário do 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 do 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" 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	Opcional Layout 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 Layout atributo. Especifica o tamanho mínimo em pixels para o formulário.A sintaxe é especificada no (largura, altura).O tipo de atributo é SizeType. Valor de padrão: ^ $\d+\,\d+$$ Exemplo de valor padrão: (100,100)
Padding	Opcional Layout atributo. Especifica a quantidade de espaço em pixels ao redor o interior borda do formulário.O tipo de atributo é SizeType. Valor de padrão: ^ $\d+\,\d+\,\d+\,\d+$$ Exemplo de valor padrão: (2,0,2,0)
Margin	Opcional Layout atributo. Especifica a quantidade de espaço em pixels ao redor da borda externa do formulário.O tipo de atributo é SizeType. Valor de padrão: ^ $\d+\,\d+\,\d+\,\d+$$ Exemplo de valor padrão: (2,0,2,0)
ControlSpacing	Opcional Layout atributo. Especifica o deslocamento vertical dos controles no formulário.
LabelSpacing	Opcional Layout atributo. Especifica o número de pixels entre o rótulo e a região de edição do controle.
HideControlBorders	Opcional Layout atributo. Especifique um valor de True para ocultar as bordas do controle, e False para exibir as bordas do controle.
HideReadOnlyEmptyFields	Opcional Layout atributo. Especifique um valor de True para ocultar campos vazios e somente leitura, e False exibir esses campos.

Elementos filho

Elemento	Descrição
Group	Opcional.Define um grupo de elementos para exibir juntos no formulário.
Controle	Opcional.Define um campo de item de trabalho, texto, 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 irmão.

Elementos pai

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

Comentários

O Layout é um elemento filho necessário de 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 = "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 do esquema	Definição de tipo de Item de trabalho
Arquivo de validação	WorkItemTypeDefinition.xsd
Tipo de elemento	Tipo complexo LayoutType
Pode ser 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

Criar e personalizar um formulário de item de trabalho

Compartilhar via