指定工作項目表單控制項

發行項
06/10/2015

本主題提供 Control 項目、其子項目和屬性的快速參考。針對要在工作項目表單上顯示的每個欄位或表單控制項，加入 Control 項目。

您可以自訂工作項目表單，以顯示有助於小組正確使用表單的資訊。您可以加入工作項目欄位和控制項，以便輸入和檢視您要追蹤的資料。

Control 項目為 Type 屬性提供九個值，該屬性可用於加入欄位，或顯示純文字或超連結文字或欄位。此外，您也可以定義特別控制項，以加入連結和附件、顯示 Web 內容，或建立自己的控制項並將它加入至工作項目表單。

加入工作項目欄位

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

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

注意事項
您無法變更系統欄位值，它們會自動更新。例如，在第一次儲存工作項目時會定義 [建立日期] 和 [建立者] 欄位。不過，您可以在搜尋條件中使用這些欄位。如需每個系統欄位的說明，請參閱Visual Studio ALM 的工作項目欄位參考。

欄位類型	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 格式，如下圖所示。 `<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 子項目指定在工作項目表單中載入網頁目標所需的控制項。如需詳細資訊，請參閱編輯 WIT 定義以便將 Web 內容加入至工作項目表單、WebpageControlOptions XML 項目參考和Link 和 Param XML 項目參考。