共用方式為

指定工作項目表單控制項

  • 發行項

更新：2010 年 6 月

您可以使用本主題提供的資訊，快速參考 Control 項目、其子項目和屬性。 針對要在工作項目表單上顯示的每個欄位或表單控制項，加入 Control 項目。 您可以自訂工作項目表單，以顯示有助於小組正確使用表單的資訊。 您可以加入工作項目欄位和控制項，以便輸入和檢視您要追蹤的資料。 Control 項目為 Type 屬性提供九個值，該屬性可用於加入欄位，或顯示純文字或超連結文字或欄位。 此外，您也可以定義特別控制項，以加入連結和附件、顯示 Web 內容，或建立自己的控制項並將它加入至工作項目表單。

本主題內容

  • 將工作項目欄位加入至工作項目表單

  • 將特別控制項加入至工作項目表單

  • 將自訂控制項加入至工作項目表單

將工作項目欄位加入至工作項目表單

當您自訂工作項目表單時，您通常會加入一小組工作項目欄位，這些欄位是針對您要在表單上顯示的工作項目類型所定義的。 欄位定義可控制顯示哪些資料或可在表單中輸入哪些資料的許多層面。 如需詳細資訊，請參閱定義工作項目欄位。

每個工作項目欄位會與一種資料型別產生關聯。 您可以使用下表中的資訊，判斷 Control 項目的哪個 Type 屬性支援哪種欄位型別。 使用 Label 屬性可指定要顯示在控制項旁邊的文字， 使用相關的 LabelPosition 屬性可指定此標籤相對於控制項的顯示位置。 如需詳細資訊，請參閱控制工作項目欄位的顯示。

注意事項注意事項

您無法變更系統欄位值，它們會自動更新。 例如，在第一次儲存工作項目時會定義 [建立日期] 和 [建立者] 欄位。 不過，您可以在搜尋準則中使用這些欄位。 如需每個系統欄位的說明，請參閱使用系統欄位和 MSF 流程範本所定義的欄位。

欄位型別

Control 項目 Type 屬性

使用方式

DateTime

FieldControl

DateTimeControl

使用 FieldControl 提供文字欄位，以便輸入或顯示 DateTime 資料型別欄位。

<Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" Label="Start Date" LabelPosition="Left" />

使用 DateTimeControl 提供行事曆選擇器，以選取欄位的日期，如下圖所示。

行事曆欄位 
<Control Type="DateTimeControl" FieldName="MyCompany.Group.ScheduleStart" Label="Scheduling Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />

Double

FieldControl

使用 FieldControl 提供文字欄位，以便輸入或顯示 Double 欄位。

<Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />

History

WorkItemLogControl

對於可追蹤討論區和其他歷史資訊的 History 欄位，使用 WorkItemLogControl 提供控制項欄位，如下圖所示。

工作項目表單上的 [記錄] 索引標籤和欄位

這個控制項只能用來支援顯示工作項目記錄欄位 (System.History 工作項目欄位)。 使用這個控制項，您可以展開與摺疊工作項目歷次修訂的詳細資料。 您也可以格式化加入至記錄欄位的文字。

<Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description
and History" LabelPosition="Top" Dock="Fill" />

HTML

HTMLControl

使用 HTMLControl 提供控制項欄位，讓 HTML 欄位擷取 RTF 格式，如下圖所示。

工作項目表單上顯示的 HTML 欄位 
<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />

Integer

FieldControl

使用 FieldControl 提供 Integer 欄位的控制項欄位。

<Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />

PlainText

FieldControl

使用 FieldControl 提供 PlainText 欄位 (例如含有可能超過 255 個字元之描述的文字方塊) 的控制項欄位。

<Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />

String

FieldControl

使用 FieldControl 提供 String 欄位的控制項欄位。 String 欄位的限制是 255 個字元。

<Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />

TreePath

WorkItemClassificationControl

使用 WorkItemClassificationControl 提供 TreePath 欄位的控制項欄位。

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

所有控制項型別的選擇性控制項目欄位屬性

僅可以針對列出的控制項型別指定下列選擇性屬性。

屬性

說明

Field

指定與工作項目欄位相關聯的控制項。

Label

指定表單上可識別控制項的可見文字。 指定長度不超過 80 個字元的字串。

注意事項注意事項
您可以使用 FieldControl 將超連結附加至已加入至工作項目表單之欄位的標籤。對欄位使用方式的相關資訊提供連結時，這個控制項很實用。如需詳細資訊，請參閱在工作項目表單上提供說明文字、流程指引、Web 內容和網頁的連結。

LabelPosition

指定標籤相對於控制項資料的位置。 從下列其中一個值來指定字串：Top、Bottom、Left 和 Right。

Dock

指定標籤與容器指定的一邊的對齊方式，或讓欄位延伸以填滿容器。 從下列其中一個值來指定字串：Fill、Top、Bottom、Left 和 Right。

Padding

指定控制項內框線周圍的空間 (以像素為單位)。 會提供四個對應於上、下、左、右的值。 例如：(2,0,2,0)。

Margin

指定控制項外框線周圍的空間 (以像素為單位)。 會提供四個對應於上、下、左、右的值。 例如：(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 內容及檢視與工作項目欄位沒有關聯的其他資料。

Control 項目 Type 屬性

使用方式

AttachmentsControl

用於將檔案附加至工作項目表單。 這個控制項通常包含在它自己的索引標籤群組中，如下圖所示。

Attachments 控制項

附件控制項範例

如需詳細資訊，請參閱加入 Attachments 控制項。

LabelControl

用於顯示與欄位沒有關聯的純文字或超連結文字，如下圖所示。

兩個套用至文字的超連結範例

使用 LabelText 和 Link 子項目和容器項目指定文字與超連結部分相關之欄位或標籤的文字、超連結和位置。 如需詳細資訊，請參閱在工作項目表單上提供說明文字、流程指引、Web 內容和網頁的連結、LabelText 和 Text XML 項目參考和Link 和 Param XML 項目參考。

LinksControl

用於建立和管理工作項目之間的連結。 這個控制項通常包含在它自己的索引標籤群組中，如下圖所示。

加入至工作項目表單的連結控制項範例

使用 LinksControlOptions 定義用於顯示連結清單之資料行欄位的連結篩選條件和配置。 如需詳細資訊，請參閱定義連結控制項以限制連結關聯性和LinksControlOptions 項目。

WebpageControl

用於在工作項目表單中顯示 Web 內容。 這個控制項通常包含在它自己的索引標籤群組中。 使用 WebpageControlOptions 和 Link 子項目指定在工作項目表單中載入網頁目標所需的控制項。

如需詳細資訊，請參閱將 Web 內容加入至工作項目表單、WebpageControlOptions XML 項目參考和Link 和 Param XML 項目參考。

將自訂控制項加入至工作項目表單

除了內建控制項以外，您也可以將自己的自訂控制項加入至工作項目表單。

例如，您可以加入自訂控制項，以從剪貼簿擷取螢幕擷取畫面。 或者，您也可以提供控制項，藉由為出現在清單或功能表中的值加入核取方塊，以擷取多個值。

若要實作自訂控制項，您必須指定 Type 屬性的控制項名稱。 如需詳細資訊，請參閱 Microsoft 網站：工作項目追蹤自訂控制項 (英文)。

請參閱

工作

加入和自訂工作項目的類型

變更工作項目表單配置

變更欄位的標籤

將 Web 內容加入至工作項目表單

參考

Control XML 項目參考

概念

設計和自訂工作項目表單

變更記錄

日期

記錄

原因

2010 年 6 月

加入圖例並將一些章節移至新主題。

資訊加強。