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

Статья
11/18/2015

С помощью элемента Layout можно определить внешний вид элементов в форме рабочего элемента. Вы можете задать несколько макетов для поддержки различных клиентов, например клиента Windows для Visual Studio или веб-клиента для Team Web Access.

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

Элемент Layout является обязательным дочерним элементом элемента FORM. Подробнее об использовании элемента Layout читайте в разделе Design the work item form.

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

WITD

WORKITEMTYPE

ФОРМА

Layout

<Layout Target="ClientName" MinimumSize="(width,height)" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ControlSpacing="distance" LabelSpacing="distance" HideControlBorders="True | False"
HideReadOnlyEmptyFields="True | False">
    <Group> . . . </Group>
    <Control> . . . </Control>
    <TabGroup> . . . </TabGroup>
    <Splitter> . . . </Splitter>
</Layout >

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

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

Атрибуты

Атрибут	Описание
Target	Необязательный атрибут элемента Layout. Задает имя клиента, к которому применяется макет. Тип — xs:string. Укажите одну из следующих строк: WinForms. Применяет форму к Team Explorer и Team Explorer Everywhere. Web. Применяет форму к Team Web Access.
MinimumSize	Необязательный атрибут элемента Layout. Задает минимальный размер формы в пикселях. Используйте следующий синтаксис: (ширина, высота). Тип атрибута —SizeType. Значение шаблона: ^$\d+\,\d+$$ Пример значения шаблона: (100,100)
Padding	Необязательный атрибут элемента Layout. Задает интервал в пикселях вокруг внутренней границы формы. Тип атрибута —SizeType. Значение шаблона: ^$\d+\,\d+\,\d+\,\d+$$ Пример значения шаблона: (2,0,2,0)
Margin	Необязательный атрибут элемента Layout. Задает интервал в пикселях вокруг внешней границы формы. Тип атрибута —SizeType. Значение шаблона: ^$\d+\,\d+\,\d+\,\d+$$ Пример значения шаблона: (2,0,2,0)
ControlSpacing	Необязательный атрибут элемента Layout. Задает вертикальное смещение элементов управления, определенных в форме.
LabelSpacing	Необязательный атрибут элемента Layout. Задает количество пикселей между меткой и редактируемой областью элемента управления.
HideControlBorders	Необязательный атрибут элемента Layout. Укажите значение True, чтобы скрыть границы элемента управления, или False, чтобы отобразить границы.
HideReadOnlyEmptyFields	Необязательный атрибут элемента Layout. Укажите значение True, чтобы скрыть поля только для чтения и пустые поля, или значение False для отображения этих полей.

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

Элемент	Описание
Группа	Необязательно. Определяет группу элементов, которые нужно отобразить вместе в форме.
Управление	Необязательно. Определяет поле рабочего элемента, текст, гиперссылку или другой элемент управления для отображения в форме рабочего элемента.
Группа вкладок	Необязательно. Содержит один или несколько элементов Tab.
Разделитель	Необязательно. Определяет разделитель и его ориентацию в форме между одноуровневыми элементами формы.

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

Элемент	Описание
ФОРМА	Обязательный. Содержит элемент Layout, который определяет способ отображения элементов в форме типа рабочего элемента.

Заметки

Элемент Layout является обязательным дочерним элементом элемента FORM. Элемент Layout определяет выбор. Необходимо задать хотя бы один из дочерних элементов: Group, Control, TabGroup или Splitter. Вы можете задать несколько дочерних элементов.

minOccurs="1"

maxOccurs="unbounded"

Пример

<FORM>
   <Layout>
      <Group>
          <Column PercentWidth="36">
            <Group>
            <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
            <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area" LabelPosition="Left" />
            <Control FieldName="Microsoft.VSTS.Common.ProductUnit" Type="FieldControl" Label="Product Unit" LabelPosition="Left" />
            <Control FieldName="Microsoft.DevDiv.BusinessUnit" Type="FieldControl" Label="Business Unit" LabelPosition="Left" />
            </Group>
          </Column>
          <Column PercentWidth="33">
            <Group>
            <Control FieldName="Microsoft.DevDiv.SubTitle" Type="FieldControl" Label="Sub Title" LabelPosition="Left" />
            <Control FieldName="System.IterationPath" Type="WorkItemClassificationControl" Label="Iteration" LabelPosition="Left" />
            <Control FieldName="Microsoft.DevDiv.Other" Type="FieldControl" Label="Other" LabelPosition="Left" />
            </Group>
          </Column>
          <Column PercentWidth="31">
            <Group>
            <Control FieldName="Microsoft.DevDiv.Type" Type="FieldControl" Label="Type" LabelPosition="Left" />
            <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assigned To" LabelPosition="Left" />
            <Control FieldName="System.State" Type="FieldControl" Label="State" LabelPosition="Left" />
            </Group>
          </Column>
      </Group>
. . .
   </Layout>
</FORM>

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

Пространство имен	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Имя схемы	Определение типа рабочего элемента
Файл проверки	WorkItemTypeDefinition.xsd
Тип элемента	Сложный тип LayoutType
Может быть пустым	Нет