Layout Element (Work Item Type Definition Schema)

Defines how the elements on the work item form are displayed.

Schema Hierarchy

WITD Element (Work Item Type Definition Schema)

    WORKITEMTYPE Element (Work Item Type Definition Schema)

        FORM Element (Work Item Type Definition Schema)

            Layout Element (Work Item Type Definition Schema)

<xs:element name="Layout" type="LayoutType" minOccurs="1" maxOccurs="unbounded"/>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute

Description

Target

Optional LayoutType attribute.

Specifies the name of the client to which the layout applies.

MinimumSize

Optional LayoutType attribute.

Specifies the minimum size for the form.

Padding

Optional LayoutType attribute.

Specifies the amount of space in pixels around the inside border of the control.

Margin

Optional LayoutType attribute.

Specifies the amount of space in pixels around the outside border of the control.

ControlSpacing

Optional LayoutType attribute.

Specifies the vertical offset of controls.

LabelSpacing

Optional LayoutType attribute.

Specifies the number of pixels between the label and the edit region of the control.

Child Elements

Element

Description

Group Element (Work Item Type Definition Schema)

Optional element.

Defines a group of elements to display together on the form.

Control Element (Work Item Type Definition Schema)

Optional element.

Defines a field to display on the form.

TabGroup Element (Work Item Type Definition Schema)

Optional element.

Contains one or more Tab elements.

Splitter Element (Work Item Type Definition Schema)

Optional element.

Defines a splitter and its orientation on the form between sibling form elements.

Parent Elements

Element

Description

FORM Element (Work Item Type Definition Schema)

Required element.

Contains the Layout element that defines how the elements on the work item type form are displayed.

Remarks

Layout is a required child element of FORM. The Layout element specifies a choice and at least one of the child elements must be defined: Group, Control, TabGroup, or Splitter. You can define more than one child element, but only one instance of each.

minOccurs="1"

maxOccurs="unbounded"

Example

<Layout Target="client name" 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>

Element Information

Namespace

https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef

Schema Name

Work Item Type Definition

Validation File

WorkItemTypeDefinition.xsd

Element Type

LayoutType Complex Type (Work Item Type Definition Schema)

Can Be Empty

No

See Also

Concepts

All Work Item FORM Elements

Reference

Group Element (Work Item Type Definition Schema)

Control Element (Work Item Type Definition Schema)

TabGroup Element (Work Item Type Definition Schema)

Splitter Element (Work Item Type Definition Schema)

Other Resources

Defining the Work Item Form