All Work Item FORM Elements
The following table describes all the permissible elements and attributes of the <FORM> section of a work item type definition.
Element |
Attribute |
Description |
Required? |
Schema Reference |
|---|---|---|---|---|
FORM |
|
Top-level form element |
Yes |
|
Layout |
|
Defines a control |
Yes |
|
|
MinimumSize |
String of the form width, height. This value specifies the minimum size for the form itself. When the container control is sized smaller than this size, horizontal and vertical scrollbars appear. |
|
|
|
Target |
String that specifies to which client this layout applies. The Visual Studio IDE renders this work item type in this layout if the Target attribute is omitted or set to WinForms. Third-party clients can specify additional layouts by using custom Target attributes that the IDE ignores. |
No |
|
|
Padding |
String of the form (left, top, right, bottom) that specifies, in pixels, the amount of room you want around the outside border of the control and around the inside border. You can vary the amount of space on each side. |
|
|
|
Margin |
String of the form (left, top, right, bottom) that specifies the amount of room you want, in pixels, around the control and between the control and its neighbors. You can vary the amount of space on each side. |
|
|
Column |
|
Divides a form's regions into columns. |
|
|
|
PercentWidth |
The width the column should occupy as a percentage of the width in the containing element. PercentWidth and FixedWidth are mutually exclusive. |
No |
|
|
FixedWidth |
The column width in pixels. PercentWidth and FixedWidth are mutually exclusive. |
No |
|
Group |
|
Provides visual grouping of elements, similar to the Windows GroupBox. |
|
|
|
Label |
Label to be displayed in a group element. |
No |
|
|
Padding |
See description for Padding under Layout element. |
|
|
|
Margin |
See description for Margin under Layout element. |
|
|
TabGroup |
|
Hosts one or more tabs. |
|
|
|
Padding |
See description for Padding under Layout element. |
|
|
|
Margin |
See description for Margin under Layout element. |
|
|
Tab |
|
Defines one tab in a tab group. |
|
|
|
Label |
The label shown on the tab. |
Yes |
|
|
Padding |
See description for Padding under Layout element. |
|
|
|
Margin |
See description for Margin under Layout element. |
|
|
Control |
|
Specifies a field that is to appear on the form. |
|
|
|
Name |
Name for the control. If unspecified, the name is the same as the FieldName. |
No |
|
|
Type |
The type of the control. |
Yes |
|
|
FieldName |
The value of the FieldName property of the control. |
No |
|
|
ID |
Identifier for the field. Use of ID and Name are mutually exclusive. |
No |
|
|
Label |
Label for the field. If a label is specified, it overrides any label associated with the field in the metadata. |
No |
|
|
LabelPosition |
The label position relative to the field data. Possible values are as follows: Top Bottom Left Right |
No |
|
|
Dock |
If you specify it, the Dock property stretches a field to fill the rest of the container. Valid field docking values are as follows: Fill Top Bottom Left Right |
No |
|
|
Padding |
See description for Padding under Layout element. |
|
|
|
Margin |
See description for Margin under Layout element. |
|
|
|
ReadOnly |
If you specify it, you can display a read-only field in a control. Different controls respond in slightly different ways to this attribute. |
No |
|
Splitter |
|
Positions a splitter with the designed orientation on the form between two sibling form elements. |
|
|
|
Dock |
The orientation and docking behavior for the splitter. Valid values are as follows: Fill Top Bottom Left Right |
Yes |