通过

Layout XML 元素引用

  • 项目

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

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 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 复杂类型

是否可以为空

否

请参见

参考

Control XML 元素引用

概念

所有 FORM XML 元素参考

设计和自定义工作项窗体