Справка по XML-элементам LabelText и Text

С помощью элемента LabelText можно добавить автономную метку или информационный текст к форме рабочего элемента.Подпись не связана с каким-либо полем рабочего элемента.Дополнительно можно добавить гиперссылку к части текста или ко всему тексту.

Элемент LabelText является дочерним для элемента Control.

Схема иерархии

WITD

   WORKITEMTYPE

       FORM

           Макет

               Группа

               Столбец

               TabGroup

                  Вкладка

                     Элемент управления

<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 не указан, то текст атрибута Label элемента Control отображается в форме рабочего элемента.
Link	Необязательный элемент Text. Элемент контейнера для гиперссылки, которая должна применяться к появляющимся в форме рабочих элементов полю или автономной метке.Тип элемента — HyperLinkType. Примечание Следует указать атрибут Label в элементе Control, если задается дочерний элемент Link. Дополнительные сведения см. в разделе Справка по XML-элементам Link и Param.

Родительские элементы

Элемент	Описание
Элемент управления	Обязательное.Определяет отображение в форме рабочего элемента поля, текста, гиперссылки или другого элемента управления.

Заметки

Можно совмещать обычный текст и текст с гиперссылками, добавив несколько элементов Text в элемент LabelText.

Элемент LabelText распознается только клиентами, на которых работает последняя версия Team Explorer.Поэтому следует указать атрибут Label в элементе Control.Для клиентов, работающих с последней версией Team Explorer, текст, предоставленный элементом LabelText, отображается в форме рабочего элемента.Для клиентов, работающих с более ранними версиями Team Explorer, текст, заданный атрибутом Label элемента Control, отображается в форме рабочего элемента.

Пример. Автономная метка

Описание

В следующем примере в форму рабочего элемента добавляется обычный текст "введите сведения о том, как воспроизвести ошибку в пространстве ниже:".

Код

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

Определения схем

Element: 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)