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

Статья
06/09/2015

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

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

Элемент Layout является обязательным дочерним элементом элемента FORM. Дополнительные сведения об использовании элемента Layout см. в статье Разработка формы рабочего элемента.

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

WITD

WORKITEMTYPE

FORM

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 для отображения этих полей.

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

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

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

Элемент	Описание
FORM	Обязательный. Содержит элемент 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
Может быть пустым	Нет