LabelText 和 Text XML 元素引用

项目
11/18/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	Control 时的必需 type="LabelControl" 元素。独立标签或信息性文本的容器元素。元素类型是复杂类型：LabelElementType。此元素覆盖 Label 元素指定的 Control 特性指定的值。
Text	必需的 LabelText 元素。要在工作项窗体上显示的信息或标签的容器元素。如果在标签中指定了 Link 元素，则会为该元素中的部分文本创建超链接。如果未指定 Link 元素，则在不创建超链接的情况下呈现文本。可以使用不同的 URL 为标签文本的不同部分创建超链接。可以按序列指定多个文本元素值。元素类型是复杂类型：TextElementType。如果未指定 Text 元素，则 Control 元素 Label 特性文本会显示在工作项窗体上。
Link	可选的 Text 元素。要应用于在工作项窗体上显示的字段或独立标签的超链接的容器元素。元素类型是 HyperLinkType。备注指定子 Label 元素时，必须在 Control 元素中指定Link 特性。有关详细信息，请参阅 Link 和 Param XML 元素引用。

LabelText

Control 时的必需 type="LabelControl" 元素。

独立标签或信息性文本的容器元素。元素类型是复杂类型：LabelElementType。

此元素覆盖 Label 元素指定的 Control 特性指定的值。

Text

必需的 LabelText 元素。

要在工作项窗体上显示的信息或标签的容器元素。如果在标签中指定了 Link 元素，则会为该元素中的部分文本创建超链接。如果未指定 Link 元素，则在不创建超链接的情况下呈现文本。

可以使用不同的 URL 为标签文本的不同部分创建超链接。可以按序列指定多个文本元素值。

元素类型是复杂类型：TextElementType。

如果未指定 Text 元素，则 Control 元素 Label 特性文本会显示在工作项窗体上。

Link

可选的 Text 元素。

要应用于在工作项窗体上显示的字段或独立标签的超链接的容器元素。元素类型是 HyperLinkType。

备注

指定子 Label 元素时，必须在 Control 元素中指定Link 特性。

有关详细信息，请参阅 Link 和 Param XML 元素引用。

父元素

元素	描述
控件	必需。定义要在工作项窗体上显示的字段、文本、超链接或其他控件元素。

备注

可以通过在 LabelText 元素中添加多个 Text 元素来组合纯文本和超链接文本。

LabelText 元素仅由运行最新版本的团队资源管理器的客户端识别。因此，必须在 Label 元素中指定 Control 特性。对于运行最新版本的团队资源管理器的客户端，LabelText 元素提供的文本会显示在工作项窗体中。对于运行早期版本的团队资源管理器的客户端，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>

请参见

概念

指定工作项窗体控件

通过