Partager via


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

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.