LabelText 和 Text XML 項目參考

您可以使用 LabelText 項目，將獨立標籤或資訊文字加入至工作項目表單。標籤不會與任何工作項目欄位產生關聯。您可以選擇性地將超連結加入至部分或所有文字。

LabelText 項目是 Control 項目的子項目。

結構描述階層架構

WITD

   WORKITEMTYPE

       FORM

           Layout

               Group

               資料行

               TabGroup

                  Tab

                     控制項

<LabelText>
   <Text>
      <Link OpenInNewWindow="true | false" UrlPath="URLLinkWithParameters">
         <Param index="IndexValue " value="ParamValue " type ="Original | Current"/>
      </Link>
      LabelText
   </Text>
</LabelText>

屬性和項目

下列章節會說明屬性、子項目和父項目。

子項目及屬性

元素	描述
LabelText	type="LabelControl" 時為必要的 Control 項目。 獨立的標籤或資訊性文字的容器項目。項目型別是複雜型別：LabelElementType。 這個項目會覆寫 Label 屬性指定的値 (此屬性是由 Control 項目指定的)。
Text	必要的 LabelText 項目。 容器項目，容納要顯示在工作項目表單上的資訊或標籤。如果在標籤內指定 Link 項目，項目內的文字部分會是超連結。如果未指定 Link 項目，則會在呈現沒有超連結的文字。 標籤文字的不同部分可以具有不同的 URL 超連結。可在系列中指定多個文字項目値。 項目型別是複雜型別：TextElementType。 如果未指定 Text 項目，則 Control 項目 Label 屬性文字會出現在工作項目表單上。
Link	選擇性 Text 項目。 超連結的容器項目，此超連結將套用至出現在工作項目表單上的欄位或獨立標籤。項目型別是 HyperLinkType。 注意事項 當您指定 Link 子項目時，必須在 Control 項目中指定 Label 屬性。 如需詳細資訊，請參閱Link 和 Param XML 項目參考。

父項目

元素	描述
控制項	必要項。定義要顯示在工作項目表單上的欄位、文字、超連結或其他控制項項目。

備註

您可以在 LabelText 項目中加入多個 Text 項目，以結合純文字與超連結文字。

只有執行最新版 Team Explorer 的用戶端能辨識 LabelText 項目。因此，您必須在Control 項目中指定 Label 屬性 。針對執行最新版 Team Explorer的用戶端，LabelText 項目所提供的文字會出現在工作項目表單中。針對執行舊版 Team Explorer的用戶端，Control 項目 Label 屬性所指定的文字會出現在工作項目表單中。

範例: 獨立標籤

描述

下列範例會在工作項目表單中加入純文字「在下列空格中輸入如何重現錯誤的詳細資訊：」。

程式碼

<Control Type="LabelControl" Label=" Enter details about how to reproduce the bug in the space below:">
   <LabelText>
      <Text>Enter details about how to reproduce the bug in the space below:
      </Text>
   </LabelText>
</Control>

範例: 附超連結的獨立標籤

描述

下列範例會將標示為「我要如何使用此工作項目？」的超連結加入至工作項目表單。

程式碼

<Control Type="LabelControl" Label="How do I use this work item?">
   <LabelText>
      <Text>
   <Link UrlRoot="http://www.live.com"></Link>
      How do I use this work item?
      </Text>
   </LabelText>
</Control>

範例: 套用至部分文字的超連結

描述

下列範例會在工作項目表單中加入兩部分的標籤。第一個部分 (「反覆項目路徑」) 與超連結相關。第二個部分 "(深度必須為 3 個層級)" 會以純文字形式出現在工作項目表單上。

程式碼

<Control Type="FieldControl" FieldName="System.IterationPath" LabelPosition="Left">
   <LabelText>
      <Text>
         <Link UrlRoot="@WssSiteUrl/render.aspx?wit=bug&amp;topic=Iteration">
         </Link>
      Iteration Path
      </Text>
      <Text> (must be 3 levels deep)</Text>
   </LabelText>
</Control>

結構描述定義

項目：LabelText

<xs:element name="LabelText" type="LabelElementType" minOccurs="0" maxOccurs="1" />
<xs:element name="Text" type="TextElementType" minOccurs="1" maxOccurs="unbounded" />

複雜型別：LabelElementType

<xs:complexType name="LabelElementType">
   <xs:sequence>
      <xs:element name="Text" type="TextElementType" minOccurs="1" maxOccurs="unbounded" />
   </xs:sequence>
</xs:complexType>

複雜型別：TextElementType

<xs:complexType name="TextElementType" mixed="true">
   <xs:sequence>
      <xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
   </xs:sequence>
</xs:complexType>

請參閱

概念

指定工作項目表單控制項

設計和自訂工作項目表單

其他資源

Elements (Work Item Type Definition Schema)