Referencia de elementos Layout de XML

Artículo
08/10/2011

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 Diseñar el diseño de formularios 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">
    <Group> . . . </Group>
    <Control> . . . </Control>
    <TabGroup> . . . </TabGroup>
    <Splitter> . . . </Splitter>
</Layout >

Atributos y elementos

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

Atributos

Atributo	Descripción
Target	Atributo LayoutType 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 LayoutType 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 LayoutType 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 LayoutType 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 LayoutType opcional. Especifica el desplazamiento vertical de los controles definidos en el formulario. El tipo es xs:integer.
LabelSpacing	Atributo LayoutType opcional. Especifica el número de píxeles entre la etiqueta y el área de edición del control. El tipo es xs:integer.

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	Obligatorio. Contiene el elemento Layout que define cómo se muestran los elementos en el formulario de tipos de elementos 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

Historial de cambios

Fecha	Historial	Motivo
Enero de 2011	Se agrega un ejemplo de código y se quitan los vínculos a los temas que se han quitado.	Mejora de la información.
Septiembre de 2010	Se agregaron los valores válidos del atributo Target.	Comentarios de los clientes.

Enero de 2011

Se agrega un ejemplo de código y se quitan los vínculos a los temas que se han quitado.

Mejora de la información.

Septiembre de 2010

Se agregaron los valores válidos del atributo Target.

Comentarios de los clientes.

Compartir a través de