Справка по XML-элементам LabelText и Text
Вы можете добавить автономную метку или текст информационного характера в форму рабочего элемента с помощью элемента 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 не указан, то текст атрибута 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, отображается в форме рабочего элемента.
Пример. Автономная метка
Описание
В следующем примере в форму рабочего элемента добавляется обычный текст "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)" (глубина должна составлять 3 уровня) отображается в форме рабочего элемента как обычный текст.
Код
<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>