控制工作项字段的显示

可以控制工作项窗体上的纯文本、整数、数字、日期和树路径工作项字段的标签名称、位置、文本框大小以及其他显示控件。 若要显示这些字段,必须从下列选项指定正确的 Control 元素 Type 特性:

  • DateTimeControl:用于显示具有 DateTime 字段类型的格式化日期字段。

  • FieldControl:用于显示具有 String、Identity、Integer、Double 和 PlainText 字段类型的纯文本或数字字段以及此类字段的值列表。

  • HtmlFieldControl:用于显示具有 HTML 字段数据类型的多行及 RTF 格式的字段。

  • WorkItemClassificationControl:用于显示具有 TreePath 字段类型的分层路径字段。

有关其他 Type 控件的更多信息,请参见以下主题:

主题内容

  • 控制数据字段的大小和显示

  • 在窗体上的两个位置标记字段和添加字段

  • 使字段成为只读字段

  • 添加纯文本字段和数字字段

  • 添加格式化文本字段

  • 添加日期字段或日历字段

  • 为区域和迭代路径添加字段

控制数据字段的大小和显示

通过使用下表中描述的可选特性,可以控制每个数据字段的间距和大小。

备注

每个数据输入字段的整体大小由若干因素确定:指派给字段的特性、容器大小以及分配给窗体上其他字段的区域。如果未指定最小大小,则将默认值指派给字段。但是,指派给窗体中其他字段的特性会影响字段大小。列数以及分配给每列中最大字段的水平大小可确定窗体的水平维度。在垂直组中指定的字段数以及分配给每个字段的垂直大小,可确定窗体的顶部大小和底部大小。

特性

描述

模式值示例

MinimumSize

指定控件的最小大小 (Width, Height)。 如果控件容器的大小小于此大小,将显示水平滚动条和垂直滚动条。

(100,100)

Margin

以像素为单位指定控件周围以及控件与其相邻元素之间的空间量(上、下、左、右)。

(2,0,2,0)

Padding

以像素为单位指定控件外部边框四周的空间量(上、下、左、右)。

(2,0,2,0)

在窗体上的两个位置标记字段和添加字段

对于每个窗体控件,可通过使用 Label 和 LabelPosition 特性指定一个可选标签及标签位置。 该标签可指定一个与 FIELD 元素指派的友好名称不同的名称。 如果未指定标签,则使用友好名称。 但是请注意,当团队成员运行查询搜索工作项时始终使用友好名称。 标签的最大大小是 80 个字符。

备注

必须对同一个组中定义的所有控件定义相同的标签位置。

如果要在窗体的多个区域中添加字段(如在窗体顶部和选项卡上),则可以使用 Name 特性执行此操作。 Name 特性只标识不同于添加到窗体上的其他控件的控件。

使字段成为只读字段

您可以使用下面两种方法之一将字段标记为只读字段。 第一种方法是,将 READONLY 元素作为子元素添加到类型定义的 FIELD 部分的 FIELDS 元素中。 使用 READONLY 元素可指定某些用户是否能够修改字段。 如下面的示例所示,只有程序经理可以修改子标题字段。

<FIELD name="Sub-Title" refname="ACME.ACE.SubTitle" type="String" >
<READONLY for="[Global]\Team Foundation Valid Users" not="Program Managers"/>
</FIELD>

第二种方法是,为 ReadOnly 元素指定 CONTROL 特性。 使用此方法将限制所有用户修改字段。

Control FieldName=" ACME.ACE.SubTitle" Type="FieldControl" Label="Sub-Title" LabelPosition="Left" ReadOnly="True" />

添加文本字段和数字字段

可使用 FieldControl 类型向窗体中添加纯文本字段和数字字段。 此特性还可用于添加选取列表、添加用于显示人名的字段(如“指派给”或“所有者”字段)以及添加整数和实数。 该字段控件必须按字段的引用名来引用字段。 字段标签可为纯文本或以超链接为样式。 有关详细信息,请参阅在工作项窗体上提供帮助文本、超链接或 Web 内容

文本、整数和选取列表字段

多个字段的分组

通过使用下表中描述的可选特性,可以控制能在文本或数字字段中输入的数字字段格式和最大字符长度。

特性

描述

NumberFormat

指定可以在字段控件中输入的字符。 有效值如下:WholeNumbers、SignedWholeNumbers、DecimalNumbers 和 SignedDecimalNumbers。

MaxLength

指定可用于字段控件的最大字符长度。

下面的代码列出了用于创建上图所示的字段组的语法。

<TABGROUP>
<TAB Label="Planning">
<Group Label="Status" Padding="(0,0,0,3)">
   <Column PercentWidth="100">
      <Control FieldName="Microsoft.DevDiv.Importance" Type="FieldControl" Label="Importance" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Commitment" Type="FieldControl" Label="Commitment / Confidence" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.VisionDoc" Type="FieldControl" Label="Vision Doc" LabelPosition="Left" />
      <Control FieldName="Microsoft.DeveloperDivision.Features.EstimatedCost" Type="FieldControl" Label="Estimated Cost" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.BusinessUnit" Type="FieldControl" Label="BU (Use Area Path)" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Website" Type="FieldControl" Label="Website" LabelPosition="Left" />
   </Column>
</Group>
   . . .
</TAB>
</TABGROUP>

添加格式化文本字段

可使用 HTMLFieldControl 类型添加数据类型为 HTML 的字段。 此控件可为在多行中显示格式化文本提供支持。

HTML 字段

工作项表单上显示的 HTML 字段

<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.ReproSteps" Label="Repro Steps"
LabelPosition="Top" MinimumSize="(100,500)" />

提示

在窗体上添加若干个将垂直堆放的 HTMLFieldControl 元素时,应为每个字段控件指定 MinimumSize 特性。通过此方式,可以使所有文本框大小相似。否则,最后一个 HTML 控件元素的大小将填充剩余窗体,而上面的元素则以较小的文本框显示在一起。

添加日期字段或日历字段

可使用 DateTimeControl 类型为用户提供日历选取器,以便为 DateTime 字段选择日期。 使用此控件,可快速为字段选择日期和时间。

格式为“Short”的日历字段

日历字段

例如,您可指定首选开始日期或未来的考核日期。

<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStart"
Label="Preferred Start Date:" LabelPosition="Left" Format="Short" />
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStartTime"
Label="Preferred Start Time:" LabelPosition="Left" Format="Time" />

通过使用下表中描述的可选特性,可以控制 DateTime 字段的格式。

特性

描述

Format

为日期-时间字段指定对应于 DateTimePickerFormat 枚举值之一的格式。 有效值如下:Custom、Long、Short、Time。

指定 Custom 时,还必须设置 CustomFormat 特性。

CustomFormat

指定用于日期-时间字段的自定义格式,该格式对应于为 DateTimePicker.CustomFormat 属性定义的语法。 例如:

Format="Custom"

CustomFormat = "MMM dd, 'of the year' yyyy"

有关详细信息,请参阅 Microsoft 网站:DateTimePicker.CustomFormat 属性

为区域和迭代路径添加字段

可使用 WorkItemClassificationControl 类型添加数据类型为 TreePath 的字段。 此控件可为以分层嵌入式树格式显示区域路径字段和迭代路径字段提供支持。 树可显示您可展开和折叠的分层节点。

<Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area"LabelPosition="Left" />

备注

可以使用 WorkItemClassificationControl 显示 System.AreaPath 和 System.IterationPath 字段。不能使用此控件显示任何其他类型的字段或自定义字段。

有关详细信息,请参阅添加和修改区域和迭代路径

请参见

概念

添加或修改工作项字段以支持报告

添加附件控件

定义链接控制以限制链接关系

其他资源

在工作项窗体上提供帮助文本、超链接或 Web 内容