Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Control Element (Work Item Type Definition Schema)

Defines a field that is to appear on the form.


<Control FieldName="control name" Type="control type" Label="label text" LabelPosition="Top | Bottom | Left | Right" Dock="Fill | Top | Bottom | Left | Right" Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)" ReadOnly="True | False" />

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

Attributes

Attribute Description

FieldName

Optional ControlType attribute.

The name of the field.

Type

Required ControlType attribute.

The type of the control. Valid built-in types are FieldControl, DateTimeControl, HtmlFieldControl, LinksControl, AttachmentControl, WorkItemClassificationControl, and WorkItemLogControl. For more information, see Work Item Form Controls.

You can use a custom control by setting the Type attribute to a custom value. Any control whose Type value does not match the name of a built-in type is considered a custom control. For more information, see the topic "Work Item Tracking Custom Controls" in the Community Technical Preview that was released in December 2006 for Visual Studio SDK 4.0.

Label

Optional ControlType attribute.

The label for the field.

LabelPosition

Optional ControlType attribute.

The position of the label relative to the field data.

Dock

Optional ControlType attribute.

Stretches the field to fill the container.

Padding

Optional ControlType attribute.

The amount of space around the inside border of the control.

Margin

Optional ControlType attribute.

The amount of space around the outside border of the control.

ReadOnly

Optional ControlType attribute.

Specifies that the field is read-only.

Child Elements

None.

Parent Elements

Element Description

Layout

Required element.

Defines how to display the elements on the work item form.

Column

Required element.

Defines columns for the form.

Tab

Required element.

Defines a tab for the form.

Control is an optional child element of Layout, Column, and Tab.

Namespace

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

Schema Name

Work Item Type Definition

Validation File

WorkItemTypeDefinition.xsd

Element Type

ControlType

Can Be Empty

Not applicable

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft