Referencia de elementos Layout de XML

Artículo
02/19/2013

Puede utilizar el elemento Layout para definir cómo aparecen los elementos en el formulario del elemento de trabajo.Puede definir más de un diseño que admita diferentes clientes, como el cliente de Windows para Visual Studio o el cliente web para Team Web Access.

El elemento Layout es un elemento secundario necesario del elemento FORM.Para obtener más información sobre el uso del elemento Layout, vea Definir el diseño del formulario de elemento de trabajo.

Jerarquía del esquema

WITD

WORKITEMTYPE

FORM

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

En las próximas 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 del formulario.La sintaxis se especifica en (ancho, alto).El tipo de atributo es SizeType. Valor de modelo: ^$\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 de True para ocultar los bordes de control y especifique el valor False para mostrar los bordes de control.
HideReadOnlyEmptyFields	Atributo Layout opcional. Especifique un valor de True para ocultar a solo lectura y a campos vacíos y un valor de False para mostrar estos campos.

Elementos secundarios

Elemento	Descripción
Grupo	Opcional.Define un grupo de elementos que se mostrarán juntos en el formulario.
Control	Opcional.Define un elemento de trabajo, texto, hipervínculo u otro elemento de control que aparecerá en un formulario de elemento de trabajo.
TabGroup	Opcional.Contiene uno o varios elementos Tab.
Splitter	Opcional.Define un divisor y su orientación en el formulario entre elementos de formulario relacionados.

Elementos primarios

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

Comentarios

El elemento Layout es un elemento secundario necesario de FORM.El elemento Layout especifica una opción; debe definirse al menos uno de estos 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

Vea también

Referencia

Referencia de elementos Control de XML

Conceptos

Referencia de todos los elementos FORM de XML

Diseñar y personalizar un formulario de elementos de trabajo

Compartir a través de