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

Статья
08/11/2011

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

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

Иерархия схемы

WITD

WORKITEMTYPE

FORM

Layout

<xs:element name="Layout" type="LayoutType" minOccurs="1" maxOccurs="unbounded"/>

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

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

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

Атрибуты

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

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

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

См. также

Ссылки

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

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

Справка по всем XML-элементам FORM

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

Журнал изменений

Дата	Журнал	Причина
Январь 2011	Добавлен пример кода и удалены ссылки на удаленные разделы.	Улучшение информации.
Сентябрь 2010	Добавлены допустимые значения атрибута Target.	Обратная связь от клиента.

Январь 2011

Добавлен пример кода и удалены ссылки на удаленные разделы.

Улучшение информации.

Сентябрь 2010

Добавлены допустимые значения атрибута Target.

Обратная связь от клиента.

Поделиться через