XML-Elementreferenz für Layout

Artikel
11/18/2015

Sie können mit dem Layout-Element definieren, wie die Elemente im Arbeitsaufgabenformular angezeigt werden. Sie können mehr als ein Layout definieren, um verschiedene Clients zu unterstützen, z. B. den Windows-Client für Visual Studio oder den Webclient für Team Web Access.

Um Elemente zu einem Formular hinzuzufügen, ändern Sie die Definition eines Arbeitsaufgabentyps. Weitere Informationen finden Sie unter Anpassen oder Hinzufügen eines benutzerdefinierten Arbeitsaufgabentyps (WIT).

Das Layout-Element ist ein erforderliches untergeordnetes Element des FORM-Elements. Weitere Informationen zum Verwenden dieses Layout Elements finden Sie unter Design the work item form.

Schemahierarchie

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 >

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
Target	Optionales Layout-Attribut. Gibt den Namen des Clients an, auf den das Layout angewendet wird. Der Typ ist "xs: String". Geben Sie eine der folgenden Zeichenfolgen an: WinForms: Übernimmt das Formular für Team Explorer und Team Explorer Everywhere. Web: Übernimmt das Formular für Team Web Access.
MinimumSize	Optionales Layout-Attribut. Gibt die minimale Größe in Pixel für das Formular an. Die Syntax wird in (Breite, Höhe) angegeben. Der Attributtyp ist SizeType. Musterwert: ^$\d+\,\d+$$ Musterwertbeispiel: (100,100)
Padding	Optionales Layout-Attribut. Gibt den Platz um den inneren Rahmen des Formulars in Pixeln an. Der Attributtyp ist SizeType. Musterwert: ^$\d+\,\d+\,\d+\,\d+$$ Musterwertbeispiel: (2,0,2,0)
Margin	Optionales Layout-Attribut. Gibt den Platz um den äußeren Rahmen des Formulars in Pixeln an. Der Attributtyp ist SizeType. Musterwert: ^$\d+\,\d+\,\d+\,\d+$$ Musterwertbeispiel: (2,0,2,0)
ControlSpacing	Optionales Layout-Attribut. Gibt den vertikalen Offset von im Formular definierten Steuerelementen an.
LabelSpacing	Optionales Layout-Attribut. Gibt die Anzahl von Pixeln zwischen der Bezeichnung und dem Bearbeitungsbereich des Steuerelements an.
HideControlBorders	Optionales Layout-Attribut. Geben Sie den Wert True zum Ausblenden von Steuerelementrahmen und False zum Anzeigen von Steuerelementrahmen an.
HideReadOnlyEmptyFields	Optionales Layout-Attribut. Geben Sie den Wert True zum Ausblenden schreibgeschützter und leerer Felder und False zum Anzeigen dieser Felder an.

Untergeordnete Elemente

Element	Beschreibung
Gruppieren	Dies ist optional. Definiert eine Gruppe von Elementen, die im Formular gemeinsam angezeigt werden sollen.
Steuerelement	Dies ist optional. Definiert ein Arbeitsaufgabenfeld, Text, einen Link oder ein anderes Steuerelement, der bzw. das in einem Arbeitsaufgabenformular angezeigt werden soll.
TabGroup	Dies ist optional. Enthält mindestens ein Tab-Element.
Aufteilung	Dies ist optional. Definiert eine Aufteilung und die Ausrichtung von nebengeordneten Formularelementen im Formular.

Übergeordnete Elemente

Element	Beschreibung
FORM	Erforderlich. Enthält das Layout-Element, das definiert, wie die Elemente auf dem Arbeitsaufgabentypformular angezeigt werden.

Hinweise

Das Layout-Element ist ein erforderliches untergeordnetes Element von FORM. Das Layout-Element gibt eine Auswahlmöglichkeit an, und es muss mindestens eines der untergeordneten Elemente definiert sein: Group, Control, TabGroup, oder Splitter. Sie können mehr als ein untergeordnetes Element definieren.

minOccurs="1"

maxOccurs="unbounded"

Beispiel

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

Elementinformationen

Namespace	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Schemaname	Definition des Arbeitsaufgabentyps
Validierungsdatei	WorkItemTypeDefinition.xsd
Elementtyp	Komplexer LayoutType-Typ
Kann leer sein	Nein