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

Статья
02/20/2013

Элемент 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" 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, чтобы отображать эти поля.

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

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

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

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