Work Item Form <Layout>, <Group>, and <Column> Elements

Three elements are at the top level of the <FORM> section of a work item type definition: <LAYOUT>, <GROUP>, and <COLUMN>.

  • **<LAYOUT>   **This parent element contains all the layout information for the work item type form. Child elements put groups, columns, and controls on the form.

  • **<GROUP>   **Child elements are contained in the same group on the form. A group is visually demarcated by a border and an optional label. Groups that are defined in an adjacent position in the XML stack are vertically in the displayed form.

    Note

    All label positions must be the same for a single group.

  • **<COLUMN>   **Use the COLUMN element to keep all child elements in the same column and split a form horizontally. Columns must appear in a <GROUP>. <GROUP> elements within <COLUMN>s can be used to create nested groupings. By default, columns split a <GROUP> evenly. An optional PercentWidth attribute can be used to change the column width.

The following XML example defines a form with two rows of groups and two columns in each group.

<FORM>
<LAYOUT>
<GROUP>
        <COLUMN PercentWidth="70">
        ...
        </COLUMN>
        <COLUMN PercentWidth="30">
        ...
        </COLUMN>
</GROUP>
<GROUP Label="2nd Group">
        <COLUMN>
        ...
        </COLUMN>
        <COLUMN>
        ...
        </COLUMN>
</GROUP>
</LAYOUT>
</FORM>

See Also

Other Resources

Defining the Work Item Form