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


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

Вы можете отображать содержимое, определенное для веб-страницы или в теге CDATA, в форме рабочего элемента с помощью элемента WebpageControlOptions. Чтобы указать URL-адрес или код HTML для отображения содержимого в форме, можно включить дочерний элемент Link или Content.

Чтобы добавить элементы в форму, измените тип рабочего элемента. См. раздел Изменение или добавление пользовательского типа рабочего элемента (WIT).

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

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

WITD

   WORKITEMTYPE

       ФОРМА

           Макет

               Группа

               Столбец

               Группа вкладок

                  Табуляция

                     Управление

<WebpageControlOptions AllowScript="true | false" ReloadOnParamChange="true | false" >
   <Link UrlRoot="UrlRoot" UrlPath="UrlPathWithParameters">
      <Param Index="IndexValue " Value="Param Value " Type="Original | Current" />
   </Link>
   <Content>
      <![CDATA[Contents of HTML]]>
   </Content>
</WebpageControlOptions>

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Дочерние элементы и атрибуты

Элемент

Атрибут

Описание

WebpageControlOptions

 

Необязательный элемент Control при type="WebpageControl".

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

Необязательный элемент Link. Требуется, если задан параметр UrlPath.

Указывает значение, которое должно использоваться для определения URL-адреса гиперссылки, если указан параметр UrlPath.

Тип элемента — это сложный тип WebpageControlOptionsType.

 

AllowScript

Необязательный атрибут элемента WebpageControlOptions.

Указывает, разрешено ли запускать JavaScript на веб-странице (true) или нет (false). Тип атрибута —xs:boolean.

Все прочие параметры, такие как ActiveX, основаны на параметрах Internet Explorer, определенных для клиента.

 

ReloadOnParamChange

Необязательный атрибут элемента WebpageControlOptions.

Указывает, следует ли перезагружать (true) содержимое веб-страницы при изменении параметра в форме рабочего элемента (true) или нет (false). Тип атрибута —xs:boolean.

Значение по умолчанию — true.

Link

 

Необязательный элемент WebpageControlOptions. Этот элемент является взаимоисключающим по отношению к элементу Content.

Указывает URL-адрес веб-страницы для отображения в форме рабочего элемента.

Подробнее см. в разделе Справочник по XML-элементам Link и Param.

Content

 

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

Этот элемент является взаимоисключающим по отношению к элементу Link.

Задает содержимое HTML, которое должно отображаться элементом управления веб-страницы. Содержимое указывается внутри тега CDATA. Пример:

<![CDATA[Click here for detailed <b><a href="http://www.microsoft.com">Process Guidance</a></b>]]>

Тип элемента — xs:string.

Примечание

Содержимое HTML не проверяется до отображения его в форме рабочего элемента.

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

Элемент

Описание

Управление

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

Текст

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

Элемент контейнера для информации или метки, отображаемых в форме рабочего элемента.

Подробнее см. в разделе Справочник по XML-элементам LabelText и Text.

Заметки

Элементы Link и Content являются взаимоисключающими.

Атрибуты AllowScript и ReloadOnParamChange не допускаются при использовании элемента Content.

При настройке элемента управления веб-страницы для отображения необработанного кода HTML все скрипты отключаются. Все гиперссылки в содержимом при щелчке по ним открываются в веб-браузере Visual Studio, если форма рабочего элемента отображается в Visual Studio, или в Internet Explorer.

Несколько кнопок панели инструментов добавляются в форму рабочего элемента для вкладки, содержащей WebpageControl. Эти кнопки выполняют следующие функции:

  • навигация назад и вперед;

  • остановка загрузки содержимого и обновление содержимого;

  • возврат на домашнюю страницу содержимого;

  • открытие содержимого в новом окне или во внешнем браузере.

Кроме того, если загружаемая веб-страница содержит ненадежное содержимое, то значок блокируется и появляется заблокированный значок.

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

Пример

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

<Control Type="WebpageControl">
   <WebpageControlOptions>
      <Content>
         <![CDATA[Click here for detailed <b><a href="https://www.microsoft.com">Process Guidance</a></b>]]>
      </Content>
   </WebpageControlOptions>
</Control>

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

WebpageControlOptionsType

<xs:complexType name="WebpageControlOptionsType">
   <xs:choice minOccurs="1" maxOccurs="1">
      <xs:element name="Link" type="HyperLinkType"/>
      <xs:element name="Content" type="xs:string"/>
   </xs:choice>
      <xs:attribute name="AllowScript" type="xs:boolean" use="optional" />
      <xs:attribute name="ReloadOnParamChange" type="xs:boolean" use="optional" />
</xs:complexType>

NonBlankString

<xs:simpleType name="NonBlankString">
   <xs:restriction  base="xs:string">
   <xs:pattern value=".*\S+.*"/>
   </xs:restriction>
</xs:simpleType>

Сведения об элементе

Пространство имен

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef

Имя схемы

Определение типа рабочего элемента

Файл проверки

WorkItemTypeDefinition.xsd

Тип элемента

WebpageControlOptionsType

Может быть пустым

Неприменимо

См. также

Основные понятия

Указание элементов управления на форме рабочего элемента

Design the work item form

Другие ресурсы

Предоставление текста справки, гиперссылок или веб-содержимого в форму рабочего элемента