Указание элементов управления на форме рабочего элемента
Информацию данного раздела можно использовать в качестве краткого справочника по элементу Control, его дочерним элементам и атрибутам.Элемент Control добавляется к каждому полю или элементу управления формы, который должен отображаться на форме рабочего элемента.Можно настроить форму рабочего элемента для отображения сведений, помогающих команде разработчиков правильно использовать форму.Можно добавить поля рабочего элемента и элементы управления, которые позволяют вводить и просматривать данные, которые необходимо отслеживать.Элемент Control предоставляет девять значений для атрибута Type, которые можно использовать для добавления полей, отображения простого текста или текста и полей в виде гиперссылок.Кроме того, можно определить специальные элементы управления для добавления ссылок, вложений и отображения веб-содержимого или создать собственный элемент управления и добавить его в форму рабочего элемента.
Содержание раздела
Добавление полей рабочего элемента в форму рабочего элемента
Добавление в форму рабочего элемента специальных элементов управления
Добавление в форму рабочего элемента пользовательских элементов управления
Добавление полей рабочего элемента в форму рабочего элемента
При настройке формы рабочего элемента обычно добавляется подмножество полей рабочего элемента, которые должны отображаться в форме. Набор этих полей зависит от типа рабочего элемента.Задание полей определяет множество аспектов — какие данные должны отображаться, какие данные могут быть введены в форму.Дополнительные сведения см. в разделе Определение полей рабочих элементов.
Каждый рабочий элемент связан с определенным типом данных.Сведения в следующей таблице можно использовать для определения типа поля, который поддерживается атрибутом Type элемента Control.С помощью атрибута Label можно указать текст, отображаемый возле элемента управления.С помощью связанного атрибута LabelPosition можно указать, где располагается подпись относительно элемента управления.Дополнительные сведения см. в разделе Управление отображением полей рабочих элементов.
.gif "Примечание") Примечание |
|---|
Нельзя изменять значения системных полей, обновляемых вручную.Например, поля "Дата создания" и "Кем создано" определены при первом сохранении рабочего элемента.Однако эти поля можно использовать в условиях поиска.Описание всех системных полей см. в разделе Справочник по полям рабочих элементов для Visual Studio ALM. |
Тип поля |
Атрибут Type элемента управления |
Использование |
|---|---|---|
DateTime |
FieldControl DateTimeControl |
Используйте элемент управления с типом FieldControl для предоставления текстового поля ввода или для отображения поля с типом DateTime. Используйте элемент управления с типом DateTimeControl для предоставления полю календаря с выбором даты, как показано на следующем рисунке. .png "Поле календаря")
|
Double |
FieldControl |
Используйте элемент управления с типом FieldControl для предоставления текстового поля ввода или для отображения полей с типом Double. |
History |
WorkItemLogControl |
Используйте элемент управления с типом WorkItemLogControl для предоставления поля элемента управления полям с типом History, которые отслеживают цепочки обсуждений и другие сведения журнала, как показано на следующем рисунке. .png "Вкладка и поле \"Журнал\" в форме рабочего элемента")
Этот элемент управления можно использовать только для поддержки отображения поля журнала рабочего элемента (поле рабочего элемента System.History).С его помощью пользователь может разворачивать и сворачивать сведения о всех редакциях рабочего элемента.Также можно форматировать текст, добавляемый в поле журнала. |
HTML |
HTMLControl |
Используйте элемент управления с типом HTMLControl для предоставления поля элемента управления для полей с типом HTML, чтобы захватывать текст RTF, как показано на следующем рисунке. .png "Поле HTML в форме рабочего элемента")
|
Integer |
FieldControl |
Используйте элемент управления с типом FieldControl для предоставления поля элемента управления полям с типом Integer. |
PlainText |
FieldControl |
Используйте элемент управления с типом FieldControl для предоставления поля элемента управления полям с типом PlainText, например, текстовому полю, которое содержит описание с длиной не более 255 символов. |
String |
FieldControl |
Используйте элемент управления с типом FieldControl для предоставления поля элемента управления полям с типом String.Поля с типом String могут содержать не более 255 символов. |
TreePath |
WorkItemClassificationControl |
Используйте элемент управления с типом WorkItemClassificationControl для предоставления поля элемента управления полям с типом TreePath. |
.gif "ms194985.collapse_all(ru-ru,VS.110).gif")
Необязательные атрибуты полей элемента управления для всех типов элементов управления
Следующие необязательные атрибуты могут быть заданы только для перечисленных типов элементов управления.
Атрибут |
Описание |
|---|---|
Field |
Определяет элемент управления, который связан с полем рабочего элемента. |
Label |
Задает отображаемый в форме текст, определяющий элемент управления.Введите строку, длина которой не превышает 80 символов. Примечание
Используя FieldControl, можно вложить гиперссылку в метку поля, которая добавляется в форму рабочего элемента.Этот элемент управления рекомендуется использовать для предоставления ссылок на сведения о порядке использования поля.Дополнительные сведения см. в разделе Предоставление текста справки, руководства по процессам, веб-содержимого и ссылок на веб-страницы на форме рабочего элемента.
|
LabelPosition |
Задает положение метки относительно данных элемента управления.Укажите строку, которая представляет собой одно из следующих значений: Top, Bottom, Left, Right. |
Dock |
Задает выравнивание метки по заданному краю контейнера или растягивает поле на весь контейнер.Укажите строку, которая представляет собой одно из следующих значений: Fill, Top, Bottom, Left, Right. |
Padding |
Задает интервал в пикселях вокруг внутренней границы элемента управления.Четыре значения, соответствующие верхнему, нижнему, левому и правому интервалам.Например: (2,0,2,0). |
Margin |
Задает интервал в пикселях вокруг внешней границы элемента управления.Четыре значения, соответствующие верхнему, нижнему, левому и правому интервалам.Например: (2,0,2,0). |
ReadOnly |
Задает доступность поля только для чтения.Следует задать True или False. |
MinimumSize |
Задает минимальный размер в пикселях, который должен занимать элемент управления в форме.Два значения, соответствующие ширине и высоте.Например: (100,100). |
Name |
Является уникальным идентификатором элемента управления.Атрибут Name нужен, если в форме более одного элемента управления связано с одним полем рабочего элемента. Примечание
Атрибут Name используется для отображения одного поля в нескольких областях формы.Атрибуту Name задается уникальное значение для обоих элементов управления, чтобы система могла однозначно определить каждый элемент управления.Рекомендуется отображать один и тот же элемент управления в различных расположениях, в зависимости от контекста вкладок.
|
Необязательные атрибуты полей элемента управления для определенных типов элементов управления
Следующие необязательные атрибуты могут быть заданы только для перечисленных типов элементов управления.
Атрибут |
Типы элементов управления |
Описание |
|---|---|---|
NumberFormat |
FieldControl |
Задает символы, которые могут быть введены в поле элемента управления.Допустимыми являются следующие значения: WholeNumbers, SignedWholeNumbers, DecimalNumbers и SignedDecimalNumbers. |
MaxLength |
FieldControl |
Указывает максимально длину строки символов, которую можно использовать в поле элемента управления. |
Format |
DateTimeControl |
Задает для поля даты-времени формат, соответствующий одному из значений перечисления DateTimePickerFormat.Допустимы следующие значения: Custom, Long, Short, Time. |
CustomFormat |
DateTimeControl |
Задает пользовательский формат, используемый для полей даты-времени, который соответствует синтаксису, определенному для свойства DateTimePicker.CustomFormat. |
Добавление в форму рабочего элемента специальных элементов управления
В следующей таблице представлены сведения об элементе Control атрибутов Type, которые поддерживают управление вложениями файлов, создание ссылок, отображение веб-содержимого и просмотр других данных, которые не связаны с полем рабочего элемента.
Атрибут Type элемента управления |
Использование |
|---|---|
AttachmentsControl |
Используется для прикрепления файлов к форме рабочего элемента.Данный элемент управления обычно содержит собственную группу вкладок, как показано на следующем рисунке.
Управление вложениями
.png "Пример элемента управления вложениями")
Дополнительные сведения см. в разделе Добавление элемента управления для работы с вложениями. |
LabelControl |
Используется для отображения обычного текста, текста, в виде гиперссылки, который не связан с полем, как показано на следующем рисунке. .png "Пример двух гиперссылок, применяемых к тексту")
Для определения текста, гиперссылки, расположения поля или метки, текст которых частично связан с гиперссылкой, используются дочерние элементы LabelText и Link, а также элементы контейнера.Дополнительные сведения см. в разделах Предоставление текста справки, руководства по процессам, веб-содержимого и ссылок на веб-страницы на форме рабочего элемента, Справка по XML-элементам LabelText и Text и Справка по XML-элементам Link и Param. |
LinksControl |
Используется для создания и управление ссылками между рабочими элементами.Данный элемент управления обычно содержит собственную группу вкладок, как показано на следующем рисунке. .png "Пример элемента управления ссылками, добавляемый в форму рабочего элемента")
Элемент LinksControlOptions используется для определения фильтров ссылок и структуры полей столбцов, используемых для отображения списка ссылок.Дополнительные сведения см. в разделах Определение элементов управления Link для ограничения ссылочных отношений и Элементы LinksControlOptions. |
WebpageControl |
Используется для отображения веб-содержимого в форме рабочего элемента.Этот элемент управления обычно содержится в выделенной группе элементов управления.Дочерние элементы WebpageControlOptions и Link используются для указания элементов управления, необходимых для загрузки целевой веб-страницы в форму рабочего элемента. Дополнительные сведения см. в разделах Добавление веб-содержимого в форму рабочего элемента, Справка по XML-элементам WebpageControlOptions и Справка по XML-элементам Link и Param. |
Добавление в форму рабочего элемента пользовательских элементов управления
Дополнительно к встроенным элементам управления в форму рабочего элемента можно добавить собственный пользовательский элемент управления.
Например, можно добавить пользовательский элемент управления для захвата снимка экрана из буфера обмена.Или можно предоставить элемент управления для захвата множества значений с помощью добавления флажка для значений, представленных в списке или меню.
Для реализации пользовательского элемента управления необходимо задать имя элемента управления для атрибута Type.Дополнительные сведения см. на веб-сайте корпорации Майкрософт: Пользовательские элементы управления отслеживания рабочего элемента.
См. также
Задачи
Добавление и настройка типа рабочего элемента
Изменение макета формы рабочего элемента
Ссылки
Справка по XML-элементу Control
Основные понятия
Проектирование и настройка формы рабочего элемента