指定工作项窗体控件
本主题提供对 Control 元素、其子元素和特性的快速参考。 对于要在工作项窗体上显示的每个字段或窗体控件，都应添加一个 Control 元素。
您可自定义工作项窗体，以显示有助于您的团队正确使用该窗体的信息。 您可以添加工作项字段和控件，以便输入和查看要跟踪的数据。
Control 元素为 Type 特性提供了 9 个值，可以用于添加字段或者显示纯文本、超链接文本或字段。 此外，也可以定义特殊控件以添加链接和附件，显示基于 Web 的内容，或创建您自己的控件并将其添加到工作项窗体中。
添加工作项字段
自定义工作项窗体时，通常可添加为要在窗体上显示的工作项类型定义的工作项字段的子集。 字段定义控制与显示的数据或可向窗体中输入的数据有关的许多方面。 有关详细信息，请参阅修改或添加字段以支持查询、报告和工作流。
每个工作项字段都与一个数据类型相关联。 可用下表中的信息来确定 Type 元素的各个 Control 特性支持的字段类型。 使用 Label 特性指定要显示在控件旁边的文本。 使用相关的 LabelPosition 特性指定标签相对于控件的出现位置。 有关详细信息，请参阅控制工作项字段的显示。
备注
您不能更改系统字段的值，系统字段值是自动更新的。例如，“创建日期”和“创建者”字段在第一次保存工作项时进行定义。但是，可在搜索条件中使用这些字段。有关每个系统字段的说明，请参见Visual Studio ALM 的工作项字段参考。
字段类型 |
控件元素类型特性 |
用法 |
|---|---|---|
DateTime |
FieldControl DateTimeControl |
使用 FieldControl 可为 DateTime 数据类型字段的输入或显示提供文本字段。 使用 DateTimeControl 可提供日历选取器，以便为字段选择日期，如下图所示。 .png "日历字段")
|
Double |
FieldControl |
使用 FieldControl 可 Double 字段的输入或显示提供文本字段。 |
History |
WorkItemLogControl |
使用 WorkItemLogControl 可为跟踪讨论线索和其他历史记录信息的 History 字段提供控件字段，如下图所示。 .png "工作项表单上的“历史记录”选项卡和字段")
可以使用此控件仅支持显示工作项的历史记录字段，即 System.History 工作项字段。 使用此控件，您可以展开和折叠有关工作项的修订历史记录的详细信息。 也可以格式化添加到历史记录字段中的文本。 |
HTML |
HTMLControl |
使用 HTMLControl 可提供控件字段使 HTML 字段能够捕获 RTF 格式，如下图所示。 .png "工作项表单上显示的 HTML 字段")
|
Integer |
FieldControl |
使用 FieldControl 可为 Integer 字段提供控件字段。 |
PlainText |
FieldControl |
使用 FieldControl 可为 PlainText 字段（例如，包含可能会大于 255 个字符的说明的文本框）提供控件字段。 |
String |
FieldControl |
使用 FieldControl 可为 String 字段提供控件字段。 String 字段限制为 255 个字符。 |
TreePath |
WorkItemClassificationControl |
使用 WorkItemClassificationControl 可为 TreePath 字段提供控件字段。 |
所有控件类型的可选控件元素字段特性
只能为列出的控件类型指定以下可选特性。
特性 |
描述 |
|---|---|
Field |
指定与工作项字段关联的控件。 |
Label |
指定窗体上标识控件的可见文本。 指定一个不超过 80 个字符的字符串。 备注 使用 FieldControl 可将超链接附加到已添加到工作项窗体的字段的标签上。此控件可用于提供指向有关如何使用字段的信息的链接。有关详细信息，请参阅在工作项窗体上提供帮助文本、超链接或 Web 内容。 |
LabelPosition |
指定相对于控件数据的标签位置。 通过以下值之一指定字符串：Top、Bottom、Left 和 Right。 |
Dock |
指定标签与容器的指定一侧对齐，或拉伸字段以填充容器。 通过以下值之一指定字符串：Fill、Top、Bottom、Left 和 Right。 |
Padding |
指定控件内部边框四周的空间大小（以像素为单位）。 提供 4 个对应于顶部、底部、左侧和右侧的值。 例如：(2,0,2,0)。 |
Margin |
指定控件外部边框四周的空间大小（以像素为单位）。 提供 4 个对应于顶部、底部、左侧和右侧的值。 例如：(2,0,2,0)。 |
ReadOnly |
指定该字段为只读。 指定 True 或 False。 |
MinimumSize |
指定控件在窗体中应占用的最小大小（以像素为单位）。 指定两个对应于宽度和高度的值。 例如：(100,100)。 |
Name |
唯一地标识一个控件。 如果窗体上有多个控件与同一个工作项字段关联，则需要 Name 特性。 备注 使用 Name 特性可在窗体上多个区域中显示相同的字段。您可以为两个控件项的 Name 特性分别指定唯一值，以便系统唯一地标识每个控件。基于选项卡上下文在各种位置显示相同的控件，这非常有用。 |
特定控件类型的可选控件元素字段特性
只能为列出的控件类型指定以下可选特性。
特性 |
控件类型 |
描述 |
|---|---|---|
NumberFormat |
FieldControl |
指定可以在字段控件中输入的字符。 下面的值有效：WholeNumbers、SignedWholeNumbers、DecimalNumbers 和 SignedDecimalNumbers。 |
MaxLength |
FieldControl |
指定可用于字段控件的最大字符长度。 |
Format |
DateTimeControl |
为日期-时间字段指定对应于 DateTimePickerFormat 枚举值之一的格式。 下面的值有效：Custom、Long、Short、Time。 |
CustomFormat |
DateTimeControl |
指定用于日期-时间字段的自定义格式，该格式对应于为 DateTimePicker.CustomFormat 属性定义的语法。 |
添加特殊控件
下表描述了 Control 元素的 Type 特性，这些特性提供支持，以便您可以管理文件的附件、创建链接、显示基于 Web 的内容以及查看不与工作项字段关联的其他数据。
控件元素类型特性 |
用法 |
|---|---|
AttachmentsControl |
用于将文件附加到工作项窗体。 此控件通常包含在其自己的选项卡组中，如下图所示。 附件控件 .png "将文件附加到工作项")
有关详细信息，请参阅添加附件控件。 |
LabelControl |
用于显示不与字段相关联的纯文本或超链接文本，如下图所示。 .png "应用到文本的两个超链接的示例")
使用 LabelText 和 Link 子元素和容器元素可指定文本、超链接以及其部分文本与超链接关联的字段或标签的位置。 有关详细信息，请参阅在工作项窗体上提供帮助文本、超链接或 Web 内容、LabelText 和 Text XML 元素引用和Link 和 Param XML 元素引用。 |
LinksControl |
用于创建和管理工作项之间的链接。 此控件通常包含在其自己的选项卡组中，如下图所示。 .png "添加到工作项表单的链接控件示例")
使用 LinksControlOptions 可定义用于显示链接列表的链接筛选器和列字段布局。 有关详细信息，请参阅定义链接控制以限制链接关系和LinksControlOptions 元素。 |
WebpageControl |
用于在工作项窗体中显示 Web 内容。 此控件通常包含在其自己的选项卡组中。 使用 WebpageControlOptions 和 Link 子元素可指定在工作项窗体中加载网页目标所需的控件。 有关详细信息，请参阅编辑 WIT 定义以向工作项窗体添加 Web 内容、WebpageControlOptions XML 元素引用和Link 和 Param XML 元素引用。 |
添加自定义控件
除了内置控件外，还可以向工作项窗体添加自己的自定义控件。
例如，可以添加用于从剪贴板捕获屏幕快照的自定义控件。 或者，可通过为列表或菜单中显示的值添加复选框，来提供用于捕获多个值的控件。
若要实现自定义控件，必须为 Type 特性指定控件名称。