Layout XML 요소 참조

아티클
06/09/2015

Layout 요소를 사용하여 작업 항목 폼에서 요소가 표시되는 방법을 정의할 수 있습니다. Visual Studio용 Windows 클라이언트 또는 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 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 복합 형식
비워 둘 수 있음	아니요