Freigeben über


XML-Elementreferenz für Layout

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.