Référence des éléments XML Layout

Article
11/18/2015

L'élément Layout Layout permet de définir la façon dont les éléments s'affichent sur le formulaire d'élément de travail. Vous pouvez définir plusieurs dispositions pour prendre en charge différents clients, tels que le client Windows pour Visual Studio ou le client web pour Team Web Access.

Pour ajouter des éléments à un formulaire, vous modifiez la définition d'un type d'élément de travail. Consultez Modifier ou ajouter un type d'élément de travail personnalisé (WIT).

L'élément Layout est un élément enfant obligatoire de l'élément FORM. Pour plus d'informations sur l'utilisation de l'élément Layout, consultez Concevoir le formulaire d'élément de travail.

Hiérarchie de schéma

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 >

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
Target	Attribut Layout facultatif. Spécifie le nom du client auquel la disposition s'applique. Le type est xs:string. Spécifiez l'une des chaînes suivantes : WinForms : Applique le formulaire à Team Explorer et à Team Explorer Everywhere. Web : Applique le formulaire à Team Web Access.
MinimumSize	Attribut Layout facultatif. Spécifie la taille minimale en pixels pour le formulaire. La syntaxe est spécifiée en (largeur, hauteur). Le type de l'attribut est SizeType. Valeur de modèle : ^$\d+\,\d+$$ Exemple de valeur de modèle : (100,100)
Padding	Attribut Layout facultatif. Spécifie la quantité d'espace en pixels autour de la bordure interne du formulaire. Le type de l'attribut est SizeType. Valeur de modèle : ^$\d+\,\d+\,\d+\,\d+$$ Exemple de valeur de modèle : (2,0,2,0)
Margin	Attribut Layout facultatif. Spécifie la quantité d'espace en pixels autour de la bordure externe du formulaire. Le type de l'attribut est SizeType. Valeur de modèle : ^$\d+\,\d+\,\d+\,\d+$$ Exemple de valeur de modèle : (2,0,2,0)
ControlSpacing	Attribut Layout facultatif. Spécifie le décalage vertical de contrôles définis dans le formulaire.
LabelSpacing	Attribut Layout facultatif. Spécifie le nombre de pixels entre l'étiquette et la région d'édition du contrôle.
HideControlBorders	Attribut Layout facultatif. Spécifiez une valeur True pour masquer les bordures du contrôle, et False pour afficher les bordures du contrôle.
HideReadOnlyEmptyFields	Attribut Layout facultatif. Spécifiez une valeur True pour masquer les champs vides et en lecture seule, et False pour afficher ces champs.

Éléments enfants

Élément	Description
Regrouper	Facultatif. Définit un groupe d'éléments à afficher ensemble sur le formulaire.
Contrôle	Facultatif. Définit un champ, un texte, un lien hypertexte ou tout autre élément de contrôle à afficher dans un formulaire d'élément de travail.
TabGroup	Facultatif. Contient un ou plusieurs éléments Tab.
Séparateur	Facultatif. Définit un séparateur et son orientation sur le formulaire entre des éléments de formulaire frères.

Éléments parents

Élément	Description
FORM	Obligatoire. Contient l'élément Layout qui définit comment les éléments du formulaire de type d'élément de travail sont affichés.

Notes

L'élément Layout est un élément enfant obligatoire de FORM. L'élément Layout spécifie un choix, et au moins l'un des éléments enfants doit être défini : Group, Control, TabGroup ou Splitter. Vous pouvez définir plusieurs éléments enfants.

minOccurs="1"

maxOccurs="unbounded"

Exemple

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

Informations sur les éléments

Espace de noms	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Nom du schéma	Définition du type d'élément de travail
Fichier de validation	WorkItemTypeDefinition.xsd
Type d'élément	Type complexe LayoutType
Peut être vide	Non