Share via


Add the Attachments Control

If you are designing a work item form from the ground up, you may want to add the control to attach files to the work item. In general, each work item form contains a tab that supports the attachment of files, such as an e-mail thread, a document, an image, a log file, or another type of file.

You use the Control element AttachmentsControlType attribute to enable users to see and manage the file attachments of a work item. By adding this control to a work item form, you can open, add, and remove file attachments. In the following example, a tab that is labeled "Attachments" is added to a work item form by using all the controls that are shown.

<Tab Label="Attachments">
   <Control Type="AttachmentsControl" LabelPosition="Top" />
</Tab>

Attachments Control

Example of attachments control

Note

You must click or attach a file before the buttons to open an attachment (Open Attachment), save a copy (SaveSave Copy), and delete an attachment (Delete Item) become available. For more information, see Attachment Controls and Field Reference.

You can control the spacing and size of the attachment control by specifying the attributes in the following table.

Attribute

Description

Pattern value example

MinimumSize

Optional. String of the form (Width, Height). This value specifies the minimum size for the form itself. When the container control is smaller than this size, horizontal and vertical scrollbars appear.

(100,100)

Margin

Optional. String of the form (left, top, right, bottom) that specifies, in pixels, the amount of space around the control and between the control and its neighbors. You can vary the amount of space on each side.

(2,0,2,0)

Padding

Optional. String of the form (left, top, right, bottom) that specifies, in pixels, the amount of space around the outside border of the control and around the inside border. You can vary the amount of space on each side.

(2,0,2,0)

Label

Optional. Specifies the visible text on the form that identifies the control.

You can leave the label unspecified when the attachment control is the only control on a tab. The tab label is sufficient to identify the control.

Specify a string of no more than 80 characters.

See Also

Tasks

Create or Delete a File Attachment in a Work Item

Concepts

Attachment Controls and Field Reference