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éfinir la disposition du formulaire d'élément de travail.
Hiérarchie de schéma
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" 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 :
|
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 de 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 de True pour masquer les champs vides et en lecture seule, et False pour afficher ces champs. |
Éléments enfants
Élément |
Description |
---|---|
Facultatif.Définit un groupe d'éléments à afficher ensemble sur le formulaire. |
|
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. |
|
Facultatif.Contient un ou plusieurs éléments Tab. |
|
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 |
---|---|
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
Concevoir et personnaliser un formulaire d'élément de travail