LabelText 및 Text XML 요소 참조
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입니다. 이 요소는 Control 요소로 지정된 Label 특성이 지정하는 값을 덮어씁니다. |
Text |
필수 LabelText 요소입니다. 작업 항목 폼에 표시할 정보 또는 레이블에 대한 컨테이너 요소입니다. 레이블 내에 Link 요소가 지정되어 있으면 해당 요소 내의 텍스트 부분에 하이퍼링크가 적용됩니다. Link 요소를 지정하지 않으면 텍스트가 하이퍼링크 없이 렌더링됩니다. 각기 다른 URL을 사용하여 레이블 텍스트의 여러 부분에 하이퍼링크를 적용할 수 있습니다. 한 계열에서 여러 텍스트 요소 값을 지정할 수 있습니다. 요소 형식은 복합 형식인 TextElementType입니다. Text 요소를 지정하지 않으면 Control 요소 Label 특성 텍스트가 작업 항목 폼에 표시됩니다. |
Link |
선택적 Text 요소입니다. 작업 항목 폼에 표시되는 필드 또는 독립 실행형 레이블에 적용할 하이퍼링크에 대한 컨테이너 요소입니다. 요소 형식은 HyperLinkType입니다. 참고 자식 Link 요소를 지정할 때는 Control 요소에서 Label 특성을 지정해야 합니다. 자세한 내용은 Link 및 Param XML 요소 참조을 참조하십시오. |
부모 요소
요소 |
설명 |
|---|---|
필수 요소. 작업 항목 폼에 나타나는 필드, 텍스트, 하이퍼링크 또는 기타 컨트롤 요소를 정의합니다. |
설명
LabelText 요소에 여러 Text요소를 추가하여 일반 텍스트와 하이퍼링크 텍스트를 결합할 수 있습니다.
LabelText 요소는 최신 버전의 팀 탐색기를 실행하는 클라이언트에서만 인식됩니다. 그러므로 Control 요소에서 Label 특성을 지정해야 합니다. 최신 버전의 팀 탐색기를 실행하는 클라이언트의 경우 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&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>