XML-Elementreferenz für Layout

Artikel
02/26/2013

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" 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 einen 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 Steuerelementrahmen, ausblenden und False Steuerelementrahmen angezeigt.
HideReadOnlyEmptyFields	Optionales Layout-Attribut. Geben Sie den Wert True , nur-Lese und leere Felder auszublenden, und False um diese Felder anzuzeigen.

Untergeordnete Elemente

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

Freigeben über