共用方式為

控制工作項目欄位的顯示

  • 發行項

您可以控制工作項目表單上純文字、整數、數字、日期和樹狀路徑工作項目欄位的標籤名稱、位置、文字方塊大小和其他顯示控制項。 若要顯示這些欄位，您必須從下列選項指定正確的 Control 項目 Type 屬性：

  • DateTimeControl：用來顯示欄位型別為 DateTime 的格式化日期欄位。

  • FieldControl：用來顯示純文字或數字欄位，以及欄位型別為 String、Identity、Integer、Double 和 PlainText 之欄位的值清單。

  • HtmlFieldControl：用來顯示欄位資料型別為 HTML 的多行、RTF 格式的欄位。

  • WorkItemClassificationControl：用來顯示欄位型別為 TreePath 的階層式路徑欄位。

如需其他 Type 控制項的詳細資訊，請參閱下列主題：

本主題內容

  • 控制資料欄位的大小和顯示方式

  • 在表單的兩個地方標示欄位和加入欄位

  • 將欄位設為唯讀的

  • 加入純文字和數字欄位

  • 加入格式化的文字欄位

  • 加入日期或行事曆欄位

  • 加入區域和反覆項目路徑欄位

控制資料欄位的大小和顯示方式

您可以使用下表中說明的選擇性屬性，控制每個資料欄位的間距和大小。

注意事項注意事項

每個資料輸入欄位的整體大小由數個因素決定：指派給欄位的屬性、容器大小，以及配置給表單上其他欄位的區域。如果您未指定大小下限，則會指派預設值給欄位。不過，指派給其他表單欄位的屬性可能會影響欄位大小。資料行數目和您配置給每個資料行之最大欄位的水平大小會決定表單的水平維度。您在垂直群組中指定的欄位數目以及配置給每個欄位的垂直大小，會決定表單頂端大小和表單底部大小。

屬性

描述

模式值範例

MinimumSize

指定控制項的大小下限 (Width, Height)。 如果控制項的容器大小比這個值還要小，就會出現水平與垂直捲軸。

(100,100)

Margin

指定控制項周圍以及控制項與相鄰項目之間的空間，以像素為單位 (left, top, right, bottom)。

(2,0,2,0)

Padding

指定控制項外框線周圍的空間，以像素為單位 (left, top, right, bottom)。

(2,0,2,0)

Dock

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

N/A

在表單的兩個地方標示欄位和加入欄位

對於每個表單控制項，您可以使用 Label 和 LabelPosition 屬性指定選擇性標籤和標籤位置。 標籤指定的名稱可以不同於 FIELD 項目所指派的易記名稱。 如果您未指定標籤，則會使用易記名稱。 不過，請注意當小組成員執行查詢以搜尋工作項目時，一律使用易記名稱。 標籤大小上限是 80 個字元。

注意事項注意事項

您必須對定義在相同群組中的所有控制項定義相同的標籤位置。

如果您想要在表單中的多個區域加入同一個欄位，例如在表單頂端和索引標籤上，可以使用 Name 屬性。 Name 屬性會將此控制項識別為不同於加入至表單的另一個控制項。

將欄位設為唯讀的

您可以用下列兩種方式將欄位設為唯讀的。 第一個方法就是在型別定義的 FIELDS 區段 FIELD 項目中，加入 READONLY 項目做為子項目。 透過使用 READONLY 項目，可以指定特定使用者是否可以修改欄位。 如下列範例所示，只有程式管理人員才能修改子標題欄位。

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

第二個方法是指定 CONTROL 項目的 ReadOnly 屬性。 這個方法會限制所有使用者修改欄位。

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" Dock="Left" MinimumSize="100,500" />

提示

在表單上加入數個將垂直堆疊的 HTMLFieldControl 項目時，您應該指定每個欄位控制項的 MinimumSize 屬性。如此，您可以將文字方塊全部設為相似大小。否則，最後一個 HTML 控制項項目會調整大小以填滿表單，而前面的項目會以較小的文字方塊一起顯示。

加入日期或行事曆欄位

您可以使用 DateTimeControl 型別提供行事曆選擇器給使用者，以便選取 DateTime 欄位的日期。 使用這個控制項，您即可快速地選取欄位的日期和時間。

具有 Format="Short" 的行事曆欄位

行事曆欄位

例如，您可以指定未來的慣用開始日期或檢閱日期。

<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStart"
Label="Preferred Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStartTime"
Label="Preferred Start Time:" LabelPosition="Left" Dock="Fill" 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 欄位。您無法使用這個控制項來顯示其他類型的欄位或自訂欄位。

如需詳細資訊，請參閱建立和修改區域和反覆項目。

請參閱

概念

加入和修改工作項目欄位以支援報告

加入 Attachments 控制項

定義連結控制項以限制連結關聯性

設計和自訂工作項目表單

其他資源

在工作項目表單上提供說明文字、流程指引、Web 內容和網頁的連結