LabelText 和 Text XML 項目參考

發行項
06/09/2015

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

若要將項目加入表單，您可以修改工作項目類型。請參閱修改或加入自訂工作項目類型 (WIT)。

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

結構描述階層架構

<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 屬性所指定的文字。

範例：獨立標籤

描述

下列範例會將純文字 "Enter details about how to reproduce the bug in the space below:" 加入工作項目表單。

程式碼

<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>

範例：含有超連結的獨立標籤

描述

下列範例會將標示為 "How do I use this work item?" 的超連結加入工作項目表單。

程式碼

<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>

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

描述

下列範例會將兩部分的標籤加入工作項目表單。第一個部分 "Iteration Path" 會與超連結產生關聯。第二個部分 "(must be 3 levels deep)" 會以純文字形式出現在工作項目表單上。

程式碼

<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>

請參閱

概念

指定工作項目表單控制項

共用方式為