Управление отображением полей рабочих элементов

Можно управлять меткой, положением, размером текстового поля и другими отображаемыми элементами управления для полей обычного текста, целых чисел, чисел, дат и иерархических путей в формах рабочих элементов.Для отображения этих элементов управления необходимо правильно задать атрибут Type элемента Control. Возможны следующие значения.

• DateTimeControl: используется для отображения форматированных полей даты, имеющих тип поля DateTime.

• FieldControl: используется для отображения простых текстовых или числовых полей и списков значений для полей, имеющих тип поля String, Identity, Integer, Double и PlainText.

• HtmlFieldControl: используется для отображения многострочных полей с форматированным текстом, имеющих тип данных поля HTML.

• WorkItemClassificationControl используется для отображения полей иерархических путей, имеющих тип поля TreePath.

Дополнительные сведения о других элементах управления Type см. в следующих разделах.

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

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

• Определение элементов управления Link для ограничения ссылочных отношений

• Добавление элемента управления для работы с вложениями

Содержание раздела

• Управление размером и отображением полей данных

• Снабжение полей метками и добавление полей в двух местах формы

• Задание доступности поля только для чтения

• Добавление полей обычного текста и числовых полей

• Добавление полей форматированного текста

• Добавление полей дат или календаря

• Добавление полей для путей областей и итераций

Управление размером и отображением полей данных

Управлять размером и пространством вокруг каждого поля данных можно с помощью необязательных атрибутов, описанных в следующей таблице.

Примечание

Общий размер каждого поля для ввода данных определяется несколькими факторами: назначенными полю атрибутами, размером контейнера и областью, отведенной под остальные поля на форме.Если минимальный размер не задан, полям присваиваются значения по умолчанию.Тем не менее, влиять на размер полей могут атрибуты, назначенные другим полям в форме.Количество столбцов и размер по горизонтали, отведенный под самое большое поле в каждом столбце, определяют горизонтальный размер формы.Количество полей в вертикальной группе и размер по вертикали, отводимый под каждое поле, определяют размер верхней части формы, а также размер нижней части формы.

Снабжение полей метками и добавление полей в двух местах формы

Для каждого элемента управления в форме можно указать необязательную метку и задать положение этой метки с помощью атрибутов Label и LabelPosition.Метка может представлять собой имя, отличное от понятного имени, присвоенного элементом FIELD.Если метка не указана, используется понятное имя.Следует, однако, иметь в виду, что при запуске запроса для поиска рабочих элементов всегда используется понятное имя.Максимальный размер метки составляет 80 символов.

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

Если требуется добавить одно и то же поле в нескольких областях формы, например в верхней части формы и на вкладке, это можно сделать с помощью атрибута Name.Атрибут Name просто идентифицирует элемент управления как отличный от другого элемента управления, добавленного в форму.

Задание доступности поля только для чтения

Пометить поле как доступное только для чтения можно одним из двух способов.Первый способ заключается в добавлении элемента READONLY в качестве дочернего элемента для элемента FIELD в разделе FIELDS определения типа.С помощью элемента READONLY можно указать, могут ли определенные пользователи изменять поле.Как показано в следующем примере, изменять поле подзаголовка могут только руководители программ.

<FIELD name="Sub-Title" refname="ACME.ACE.SubTitle" type="String" >
<READONLY for="[Global]\Team Foundation Valid Users" not="Program Managers"/>
</FIELD>

Второй способ заключается в задании атрибута ReadOnly для элемента CONTROL.В этом случае всем пользователям запрещается изменять поле.

Control FieldName=" ACME.ACE.SubTitle" Type="FieldControl" Label="Sub-Title" LabelPosition="Left" ReadOnly="True" />

Добавление текстовых и числовых полей

Для добавления в форму полей обычного текста и числовых полей используется тип FieldControl.Этот атрибут используется также для добавления списков выбора, полей, используемых для отображения личных имен, таких как поля "Кому назначено" или "Владелец", а также целых и вещественных чисел.Элемент управления полем должен ссылаться на поле по его ссылочному имени.Метка поля представляет собой обычный текст или гиперссылку.Дополнительные сведения см. в разделе Предоставление текста справки, руководства по процессам, веб-содержимого и ссылок на веб-страницы на форме рабочего элемента.

Текстовые поля, целочисленные поля и списки выбора

Управлять форматом числовых полей и максимальным количеством символов, вводимых в текстовое или числовое поле, можно с помощью необязательных атрибутов, описанных в следующей таблице.

В следующем примере кода показан синтаксис, используемый для создания группы полей, показанной на предыдущем рисунке.

<TABGROUP>
<TAB Label="Planning">
<Group Label="Status" Padding="(0,0,0,3)">
   <Column PercentWidth="100">
      <Control FieldName="Microsoft.DevDiv.Importance" Type="FieldControl" Label="Importance" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Commitment" Type="FieldControl" Label="Commitment / Confidence" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.VisionDoc" Type="FieldControl" Label="Vision Doc" LabelPosition="Left" />
      <Control FieldName="Microsoft.DeveloperDivision.Features.EstimatedCost" Type="FieldControl" Label="Estimated Cost" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.BusinessUnit" Type="FieldControl" Label="BU (Use Area Path)" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Website" Type="FieldControl" Label="Website" LabelPosition="Left" />
   </Column>
</Group>
   . . .
</TAB>
</TABGROUP>

Добавление полей форматированного текста

Для добавления полей, имеющих тип данных HTML, используется тип HTMLFieldControl.Это элемент управления поддерживает отображение форматированного текста из нескольких строк.

Поле HTML

<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.ReproSteps" Label="Repro Steps"
LabelPosition="Top" Dock="Left" MinimumSize="100,500" />

Совет

При добавлении в форму нескольких элементов HTMLFieldControl, которые будут располагаться друг над другом, необходимо задать для каждого поля атрибут MinimumSize.Таким образом все текстовые поля будут приблизительного одинакового размера.В противном случае последний элемент управления HTML будет иметь размер, необходимый для заполнения формы, а все предыдущие элементы будут сжаты вместе и представлять собой небольшие текстовые поля.

Добавление полей дат или календаря

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

Поле календаря, Format="Short"

Например, можно задать желаемую начальную дату начала или дату будущей проверки.

<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStart"
Label="Preferred Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStartTime"
Label="Preferred Start Time:" LabelPosition="Left" Dock="Fill" Format="Time" />

Управлять форматом поля DateTime можно с помощью необязательных атрибутов, описанных в следующей таблице.

Добавление полей для путей областей и итераций

Для добавления полей, имеющих тип данных TreePath, используется тип WorkItemClassificationControl.Этот элемент управления поддерживает отображение полей пути к области и пути к итерации в иерархическом формате (в виде дерева).В дереве отображаются иерархические узлы, которые пользователь может разворачивать и сворачивать.

<Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area"LabelPosition="Left" />

Примечание
Элемент управления WorkItemClassificationControl можно использовать для отображения полей типа System.AreaPath и System.IterationPath.Отображать какие-либо другие типы полей или настраиваемые поля с помощью этого элемента управления нельзя.

Дополнительные сведения см. в разделе Создание и изменение областей и итераций.

См. также

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

Добавление и изменение полей рабочих элементов для поддержки отчетов

Добавление элемента управления для работы с вложениями

Определение элементов управления Link для ограничения ссылочных отношений

Проектирование и настройка формы рабочего элемента

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

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