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

Article
08/10/2011

Vous pouvez utiliser l'élément Layout pour 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.

L'élément Layout est un élément enfant requis de l'élément FORM. Pour plus d'informations sur l'utilisation de l'élément Layout, consultez Définition de la disposition du formulaire d'élément de travail.

Hiérarchie de schéma

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 >

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 LayoutType 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 LayoutType 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 LayoutType 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 LayoutType 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 LayoutType facultatif. Spécifie le décalage vertical de contrôles définis dans le formulaire. Le type est xs:integer.
LabelSpacing	Attribut LayoutType facultatif. Spécifie le nombre de pixels entre l'étiquette et la région d'édition du contrôle. Le type est xs:integer.

Éléments enfants

Élément	Description
Groupe	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.
Splitter	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 requis 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

Voir aussi

Référence

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

Concepts

Référence de tous les éléments XML FORM

Conception et personnalisation d'un formulaire d'élément de travail

Historique des modifications

Date	Historique	Motif
Janvier 2011	Exemple de code ajouté et liens supprimés vers les rubriques qui ont été supprimées.	Améliorations apportées aux informations.
Septembre 2010	Ajout des valeurs valides de l'attribut de Target.	Commentaires client.

Janvier 2011

Exemple de code ajouté et liens supprimés vers les rubriques qui ont été supprimées.

Améliorations apportées aux informations.

Septembre 2010

Ajout des valeurs valides de l'attribut de Target.

Commentaires client.

Partager via