Referencia de elementos Layout de XML

Artículo
06/09/2015

El elemento Layout se puede usar para definir cómo se muestran los elementos en el formulario de elemento de trabajo. Se puede definir más de un diseño para admitir clientes diferentes, como el cliente de Windows para Visual Studio o el cliente web de Team Web Access.

Para agregar elementos a un formulario, modifique la definición de un tipo de elemento de trabajo. Consulta Modificar o agregar un tipo de elemento de trabajo (WIT) personalizado.

El elemento Layout es un elemento secundario obligatorio del elemento FORM. Para obtener más información sobre cómo usar el elemento Layout, consulte Diseñar el formulario de elemento de trabajo.

Jerarquía del esquema

WITD

WORKITEMTYPE

FORM

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

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
Target	Atributo Layout opcional. Especifica el nombre del cliente al que se aplica el diseño. El tipo es xs:string. Especifique una de las siguientes cadenas: WinForms: aplica el formulario a Team Explorer y Team Explorer Everywhere. Web: aplica el formulario a Team Web Access.
MinimumSize	Atributo Layout opcional. Especifica el tamaño mínimo en píxeles para el formulario. La sintaxis se especifica en (ancho, alto). El tipo de atributo es SizeType. Valor de patrón: ^$\d+\,\d+$$ Ejemplo de un valor de modelo: (100,100)
Padding	Atributo Layout opcional. Especifica, en píxeles, la cantidad de espacio alrededor del borde interior del formulario. El tipo de atributo es SizeType. Valor de modelo: ^$\d+\,\d+\,\d+\,\d+$$ Ejemplo de un valor de modelo: (2,0,2,0)
Margin	Atributo Layout opcional. Especifica, en píxeles, la cantidad de espacio alrededor del borde exterior del formulario. El tipo de atributo es SizeType. Valor de modelo: ^$\d+\,\d+\,\d+\,\d+$$ Ejemplo de un valor de modelo: (2,0,2,0)
ControlSpacing	Atributo Layout opcional. Especifica el desplazamiento vertical de los controles definidos en el formulario.
LabelSpacing	Atributo Layout opcional. Especifica el número de píxeles entre la etiqueta y el área de edición del control.
HideControlBorders	Atributo Layout opcional. Especifique un valor True para ocultar los bordes de control y False para mostrar los bordes del control.
HideReadOnlyEmptyFields	Atributo Layout opcional. Especifique un valor True para ocultar los campos de solo lectura y vacíos y False para mostrar estos campos.

Elementos secundarios

Elemento	Descripción
Group	Opcional. Define un grupo de elementos que se mostrarán juntos en el formulario.
Control	Opcional. Define un campo de elemento de trabajo, texto, hipervínculo u otro elemento de control para mostrarlo en un formulario de elemento de trabajo.
TabGroup	Opcional. Contiene uno o más elementos Tab.
Splitter	Opcional. Define un divisor y su orientación en el formulario entre elementos de formulario del mismo nivel.

Elementos primarios

Elemento	Descripción
FORM	Requerido. Contiene el elemento Layout que define cómo se muestran los elementos en el formulario de tipo de elemento de trabajo.

Comentarios

El elemento Layout es un elemento secundario obligatorio de FORM. El elemento Layout especifica una opción y debe definirse al menos uno de los elementos secundarios: Group, Control, TabGroup o Splitter. Puede definir más de un elemento secundario.

minOccurs="1"

maxOccurs="unbounded"

Ejemplo

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

Información de elemento

Espacio de nombres	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Nombre de esquema	Definición del tipo de elemento de trabajo
Archivo de validación	WorkItemTypeDefinition.xsd
Tipo de elemento	Tipo complejo LayoutType
Puede estar vacío	No