XML-Elementreferenz für Layout

2011-07-20

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.

Das Layout-Element ist ein erforderliches untergeordnetes Element des FORM-Elements. Weitere Informationen zum Verwenden des Layout-Elements finden Sie unter Entwerfen des Layouts des Arbeitsaufgabenformulars.

Schemahierarchie

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 >

Attribute und Elemente

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

Attribute

Attribut	Beschreibungen
Target	Optionales LayoutType-Attribut. Gibt den Namen des Clients an, auf den das Layout angewendet wird. Der Typ ist xs:string. Geben Sie einen der folgenden Zeichenfolgen an: WinForms: Übernimmt das Formular für Team Explorer und Team Explorer Everywhere 2010. Web: Übernimmt das Formular für Team Web Access.
MinimumSize	Optionales LayoutType-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 LayoutType-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 LayoutType-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 LayoutType-Attribut. Gibt den vertikalen Offset von im Formular definierten Steuerelementen an. Der Typ ist xs:integer.
LabelSpacing	Optionales LayoutType-Attribut. Gibt die Anzahl von Pixeln zwischen der Bezeichnung und dem Bearbeitungsbereich des Steuerelements an. Der Typ ist xs:integer.

Untergeordnete Elemente

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

Übergeordnete Elemente

Element	Beschreibungen
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	Arbeitsaufgabentypdefinition
Validierungsdatei	WorkItemTypeDefinition.xsd
Elementtyp	Komplexer LayoutType-Typ
Kann leer sein	nein

Siehe auch

Referenz

XML-Elementreferenz für Control

Konzepte

XML-Elementreferenz für FORM

Entwerfen und Anpassen eines Arbeitsaufgabenformulars

Änderungsprotokoll

Datum	Versionsgeschichte	Grund
Januar 2011	Ein Codebeispiel wurde hinzugefügt, und Links zu Themen entfernt, die entfernt wurden.	Informationsergänzung.
September 2010	Die gültigen Werte des Target-Attributs hinzugefügt.	Kundenfeedback.

Januar 2011

Ein Codebeispiel wurde hinzugefügt, und Links zu Themen entfernt, die entfernt wurden.

Informationsergänzung.

September 2010

Die gültigen Werte des Target-Attributs hinzugefügt.

Kundenfeedback.

Freigeben über