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

Статья
08/11/2011

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

DateTimeControl: используется для отображения форматированных полей даты, имеющих тип поля DateTime.
FieldControl: используется для отображения простых текстовых или числовых полей и списков значений для полей, имеющих тип поля String, Identity, Integer, Double и PlainText.
HtmlFieldControl: используется для отображения многострочных полей с форматированным текстом, имеющих тип данных поля HTML.
WorkItemClassificationControl используется для отображения полей иерархических путей, имеющих тип поля TreePath.

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

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

Управление размером и отображением полей данных
Снабжение полей метками и добавление полей в двух местах формы
Задание доступности поля только для чтения
Добавление полей обычного текста и числовых полей
Добавление полей форматированного текста
Добавление полей дат или календаря
Добавление полей для путей областей и итераций

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

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

Примечание

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

Атрибут	Описание	Пример значения шаблона
MinimumSize	Задает минимальный размер (ширина, высота) элемента управления. Когда контейнер элемента управления имеет размер меньший, чем заданный этим атрибутом, появляются горизонтальные и вертикальные полосы прокрутки.	(100,100)
Margin	Задает размер пространства вокруг элемента управления и между элементом управления и его соседями в пикселях (слева, сверху, справа, снизу).	(2,0,2,0)
Padding	Задает размер пространства вокруг внешней границы элемента управления в пикселях (слева, сверху, справа, снизу).	(2,0,2,0)
Dock	Задает выравнивание метки по заданному краю контейнера или растягивает поле на весь контейнер. Укажите строку, которая представляет собой одно из следующих значений: Fill, Top, Bottom, Left, Right.	Неприменимо

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

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

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

Группа из нескольких полей

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

Атрибут	Описание
NumberFormat	Задает символы, которые могут быть введены в поле элемента управления. Допустимыми значениями являются: WholeNumbers, SignedWholeNumbers, DecimalNumbers, SignedDecimalNumbers.
MaxLength	Указывает максимально длину строки символов, которую можно использовать в поле элемента управления.

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

<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

Поле 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 можно с помощью необязательных атрибутов, описанных в следующей таблице.

Атрибут	Описание
Format	Задает для поля даты-времени формат, соответствующий одному из значений перечисления DateTimePickerFormat. Допустимые значения: Custom, Long, Short, Time. При задании значения Custom необходимо также задать атрибут CustomFormat.
CustomFormat	Задает пользовательский формат, используемый для полей даты-времени, который соответствует синтаксису, определенному для свойства DateTimePicker.CustomFormat. Например: Format="Custom" CustomFormat = "MMM dd, 'of the year' yyyy" Дополнительные сведения см. на веб-сайте Майкрософт: DateTimePicker.CustomFormat - свойство.

Format

Задает для поля даты-времени формат, соответствующий одному из значений перечисления DateTimePickerFormat. Допустимые значения: Custom, Long, Short, Time.

При задании значения Custom необходимо также задать атрибут CustomFormat.

CustomFormat

Задает пользовательский формат, используемый для полей даты-времени, который соответствует синтаксису, определенному для свойства DateTimePicker.CustomFormat. Например:

Format="Custom"

CustomFormat = "MMM dd, 'of the year' yyyy"

Дополнительные сведения см. на веб-сайте Майкрософт: DateTimePicker.CustomFormat - свойство.

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

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

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

Примечание

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

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