Layout XML 元素引用

项目
11/18/2015

可以使用 Layout 元素定义工作项窗体上的元素的显示方式。可以定义多个布局以支持不同的客户端，如用于 Visual Studio 的 Windows 客户端或用于 Team Web Access 的 Web 客户端。

若要将元素添加到窗体，可修改工作项类型的定义。请参阅修改或添加自定义工作项类型 (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 Everywhere。 Web：将窗体应用于 Team Web Access。
MinimumSize	可选的 Layout 特性。为窗体指定最小大小（以像素为单位）。语法采用 (width, height) 进行指定。特性类型为 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 可显示这些字段。

子元素

元素	描述
Group	可选。定义一组要在窗体上一起显示的元素。
控件	可选。定义要在工作项窗体中显示的工作项字段、文本、超链接或其他控件元素。
TabGroup	可选。包含一个或多个 Tab 元素。
拆分器	可选。定义窗体上同级窗体元素之间的拆分器及其方向。

父元素

元素	描述
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 复杂类型
可为空	否