Referencia de elementos Layout de XML
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
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:
|
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 |
---|---|
Opcional. Define un grupo de elementos que se mostrarán juntos en el formulario. |
|
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. |
|
Opcional. Contiene uno o más elementos Tab. |
|
Opcional. Define un divisor y su orientación en el formulario entre elementos de formulario del mismo nivel. |
Elementos primarios
Elemento |
Descripción |
---|---|
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 |
Vea también
Referencia
Referencia del elemento Control de XML
Conceptos
Especificar controles de formulario de elemento de trabajo