Поделиться через

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

  • Статья

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

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

Иерархия схемы

WITD

   WORKITEMTYPE

       FORM

           Макет

               Группа

               Столбец

               TabGroup

                  Вкладка

                     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 не указан, то текст атрибута Label элемента Control отображается в форме рабочего элемента.

Link

Необязательный элемент Text.

Элемент контейнера для гиперссылки, которая должна применяться к появляющимся в форме рабочих элементов полю или автономной метке. Тип элемента — HyperLinkType.

ПримечаниеПримечание
Следует указать атрибут Label в элементе Control, если задается дочерний элемент Link.

Дополнительные сведения см. в разделе Справка по XML-элементам Link и Param.

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

Элемент

Описание

Control

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

Заметки

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

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

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

Файлы схемы определения типов рабочих элементов можно загрузить на следующей странице веб-сайта Майкрософт: Process Template and Work Item Schemas for Visual Studio Team Foundation. Дополнительные сведения об использовании файла схемы см. на следующей странице веб-сайта Майкрософт: Using the Schemas to Edit Work Item Types and Process Templates for Team Foundation in Visual Studio.

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)

Журнал изменений

Дата

Журнал

Причина

Май 2011

Исправлен синтаксис для атрибута UrlPath, заданного для элемента Link.

Исправление ошибки содержимого.

Март 2011

Исправлена структура регистра примера и большинства элементов. Добавлены сведения о том, где можно получить доступ к файлам схемы.

Обратная связь от клиента.

Январь 2011

Удалены ссылки на удаленные разделы.

Улучшение информации.