Control XML 요소 참조

아티클
08/10/2011

업데이트: 2011년 1월

작업 항목 폼에 표시하는 작업 항목 필드, 텍스트, 하이퍼링크 또는 기타 컨트롤 요소를 정의하려면 Control 요소를 사용합니다. 이 요소를 사용하는 방법에 대한 예제는 작업 항목 폼 컨트롤 지정을 참조하십시오. 자세한 내용은 작업 항목 폼 디자인 및 사용자 지정을 참조하십시오.

스키마 계층 구조

<xs:element name="Control" type="ControlType" minOccurs="0"/>

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" Label="LabelText" LabelPosition="Top | Bottom | Left | Right" 
Dock="Fill | Top | Bottom | Left | Right" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ReadOnly="True | False" MinimumSize="(width,height)" 
Name="InstanceName" >
<LabelText> . . . </LabelText>
<Link> . . . </Link>
<LinksControlOptions> . . . </LinksControlOptions>
<WebpageControlOptions> . . . </WebpageControlOptions>
</Control>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성	설명
FieldName	선택적 ControlType 특성입니다. 컨트롤이 연결되는 작업 항목 필드를 지정합니다. 특성 형식은 typelib:ReferenceFieldName입니다. 최소 길이: 1, 최대 길이: 70 패턴 값: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ 패턴 값 예: Company.Division.IssueType
Type	필수 ControlType 특성입니다. 컨트롤의 데이터 형식을 지정합니다. 특성 형식은 ValidControlsType 단순 형식입니다. 다음 기본 제공 형식 중 하나의 문자열을 지정합니다: AttachmentControl: 작업 항목 첨부 파일을 표시하는 데 사용합니다. 이 컨트롤은 연결된 필드 또는 필드 형식이 없습니다. DateTimeControl: DateTime 필드 형식의 형식 지정된 데이터 필드를 표시할 수 있습니다. FieldControl: 필드 형식 String Identity, Integer, Double 및 PlainText로 필드에 대한 일반 텍스트 또는 숫자 필드를 표시하고 값 목록을 나열할 수 있습니다. HtmlFieldControl: HTML 필드 형식으로 필드의 여러 줄, 서식 있는 텍스트 형식을 표시할 수 있습니다. LabelControl: 필드와 연결되지 않은 텍스트를 표시하는 데 사용합니다. 이 텍스트는 일반 텍스트나 하이퍼링크 텍스트일 수 있습니다. LinksControl: 작업 항목 링크를 표시하는 데 사용합니다. 이 컨트롤은 연결된 필드 또는 필드 형식이 없습니다. WebpageControl: URI로 정의되거나 CDATA 태그 안에 포함된 HTML 기반 콘텐츠를 표시하는 데 사용합니다. 이 컨트롤은 연결된 필드 또는 필드 형식이 없습니다. WorkItemClassificationControl TreePath 필드 형식의 계층적 경로 필드를 표시할 수 있습니다. 참고 System.AreaPath 및 System.IterationPath 필드는 이 데이터 형식을 사용하는 유일한 필드입니다.이 데이터 형식을 사용하여 사용자 지정 필드를 정의할 수 없습니다. WorkItemLogControl: History 필드 형식으로 작업 항목 기록 정보 및 필드를 표시할 수 있습니다. 참고 System.History 필드는 이 데이터 형식을 사용하는 유일한 필드입니다.이 데이터 형식을 사용하여 사용자 지정 필드를 정의할 수 없습니다. 자세한 내용은 작업 항목 폼 컨트롤 지정을 참조하십시오. 참고 Type 특성을 사용자 지정 값으로 설정하면 사용자 지정 컨트롤을 사용할 수 있습니다.Type 값이 기본 제공 형식의 이름과 일치하지 않는 모든 컨트롤은 사용자 지정 컨트롤로 간주됩니다.자세한 내용은 Microsoft 웹 사이트에서 Work Item Tracking Custom Controls를 참조하십시오.
Label	선택적 ControlType 특성입니다. 폼에서 컨트롤을 식별하는 표시되는 텍스트를 지정합니다. 80자를 초과하지 않는 문자열을 지정합니다.
LabelPosition	선택적 ControlType 특성입니다. 컨트롤 데이터를 기준으로 한 레이블의 위치를 지정합니다. 다음 값 중 하나의 문자열을 지정합니다: Top: 컨트롤 데이터 위에 레이블을 배치합니다. Bottom: 컨트롤 데이터 아래에 레이블을 배치합니다. Left: 컨트롤 데이터의 왼쪽에 레이블을 배치합니다. Right: 컨트롤 데이터의 오른쪽에 레이블을 배치합니다.
Dock	선택적 ControlType 특성입니다. 컨테이너의 지정된 측면에 필드를 함께 맞추거나, 필드를 확장하여 컨테이너를 채웁니다. 특성 형식은 DockType입니다. 다음 값 중 하나의 문자열을 지정합니다: Fill: 컨테이너가 채워지도록 필드를 정렬합니다. 이 값은 Splitter 요소에 대해 지원되지 않는 방향입니다. Top: 컨테이너 위쪽에 필드를 함께 정렬합니다. 이 값은 Splitter 요소에 대해 지원되지 않는 방향입니다. Bottom: 컨테이너 아래쪽에 필드를 함께 정렬합니다. 이 값은 Splitter 요소에 대해 지원되지 않는 방향입니다. Left: 필드를 컨테이너 왼쪽에 함께 정렬합니다. Right: 필드를 컨테이너 오른쪽에 함께 정렬합니다. 이 값은 Splitter 요소에 대해 지원되지 않는 방향입니다.
Padding	선택적 ControlType 특성입니다. 위, 아래, 왼쪽 및 오른쪽 공간에 해당하는 컨트롤의 내부 테두리 주변의 공간 크기를 픽셀 단위로 지정합니다. 특성 형식은 SizeType입니다. 패턴 값: ^$\d+\,\d+\,\d+\,\d+$$ 패턴 값 예: (2,0,2,0)
Margin	선택적 ControlType 특성입니다. 위, 아래, 왼쪽 및 오른쪽 공간에 해당하는 컨트롤의 외부 테두리 주변의 공간 크기를 픽셀 단위로 지정합니다. 특성 형식은 SizeType입니다. 패턴 값: ^$\d+\,\d+\,\d+\,\d+$$ 패턴 값 예: (2,0,2,0)
ReadOnly	선택적 ControlType 특성입니다. 필드를 읽기 전용으로 지정합니다. 특성 형식은 ReadOnlyType입니다. 다음 값 중 하나의 문자열을 지정합니다: True: 컨트롤 데이터를 읽기 전용으로 지정합니다. False: 컨트롤 데이터가 읽기 전용이 아니도록 지정합니다.
MinimumSize	선택적 ControlType 특성입니다. 폼에서 컨트롤이 차지하는 픽셀의 최소 크기를 지정합니다. 구문은 (width,height)에 지정됩니다. 특성 형식은 SizeType입니다. 패턴 값: ^$\d+\,\d+$$ 패턴 값 예: (100,100) 참고 세로 공간이 충분하지 않은 경우 최소 크기로 유지할 수 있는 스크롤 막대가 나타납니다.이 특성이 없으면 컨트롤은 다른 탭의 컨트롤이 더 많은 공간을 차지하지 않는 한 기본 크기로 그려집니다.한 폼 컨트롤의 전체 크기는 가장 큰 폼 영역 또는 탭 크기에 따라 다릅니다.
Name	선택적 ControlType 특성입니다. 컨트롤을 고유하게 식별합니다. 폼에 있는 두 개 이상의 컨트롤이 동일한 작업 항목 필드와 연결되어 있는 경우 Name이 중요합니다. 특성 형식은 xs:string입니다. 참고 양식에서 둘 이상의 위치에 같은 필드를 표시하려면 Name 특성을 사용합니다.시스템이 각 컨트롤을 고유하게 식별하도록 두 컨트롤 항목의 Name 특성에 대해 고유한 값을 지정합니다.이렇게 하면 탭의 컨텍스트를 기반으로 다양한 위치에서 동일한 컨트롤을 표시하는 데 유용합니다.
NumberFormat	FieldControl과 함께 사용할 때만 유효한 옵션 ControlType 특성. 필드 컨트롤에 입력할 수 있는 문자를 지정합니다. 사용할 수 있는 유효한 값은 다음과 같습니다. WholeNumbers: 정수를 허용하도록 지정합니다. SignedWholeNumbers: 부호가 있는 정수를 허용하도록 지정합니다. DecimalNumbers: 10진수를 허용하도록 지정합니다. SignedDecimalNumbers: 부호가 있는 10진수를 허용하도록 지정합니다.
MaxLength	FieldControl과 함께 사용할 때만 유효한 옵션 ControlType 특성. 필드 컨트롤에 허용되는 문자의 최대 길이를 지정합니다. 특성 형식은 xs:integer입니다.
Format	DateTimeControl과 함께 사용할 때만 유효한 옵션 ControlType 특성. DateTimePickerFormat 열거형의 값 중 하나에 해당하는 날짜/시간 필드의 형식을 지정합니다. 사용할 수 있는 유효한 값은 다음과 같습니다. Custom: 사용자 지정 형식으로 날짜 및 시간 값을 표시합니다. 형식 특성의 값으로 '사용자 지정'을 지정하고 CustomFormat이라는 다른 특성을 사용자 지정 형식 문자열을 사용하여 설정하여 사용자 지정 형식을 설정할 수 있습니다. 예를 들면 다음과 같습니다. Format="Custom" CustomFormat = "MMM dd, 'of the year' yyyy " 자세한 내용은 Microsoft 웹 사이트: DateTimePicker.CustomFormat 속성을 참조하십시오. Long: 운영 체제에서 설정한 자세한 날짜 서식으로 날짜 및 시간 값을 표시합니다. Short: 운영 체제에서 설정한 간단한 날짜 서식으로 날짜 및 시간 값을 표시합니다. Time: 운영 체제에서 설정한 시간 서식으로 날짜 및 시간 값을 표시합니다. 자세한 내용은 Microsoft 웹 사이트: DateTimePickerFormat 열거를 참조하십시오.
CustomFormat	DateTimeControl 및 Format 특성과 함께 사용할 때만 유효한 옵션 ControlType 특성. DateTimePicker.CustomFormat 속성에 대해 정의되는 구문에 해당하는 날짜/시간 필드에 대한 사용자 지정 서식을 지정합니다. 자세한 내용은 Microsoft 웹 사이트: DateTimePicker.CustomFormat 속성을 참조하십시오.

자식 요소

요소	설명
LabelText	선택적 요소입니다. ControlType이 FieldControl 또는 LabelControl로 지정할 때 이 요소를 지정할 수 있습니다. 텍스트, 하이퍼링크 그리고 텍스트가 하이퍼링크와 부분적으로 연결되는 필드 또는 레이블의 위치를 지정하는 컨테이너 요소입니다. 자세한 내용은 LabelText 및 Text XML 요소 참조 및 도움말 텍스트, 프로세스 지침, 웹 콘텐츠 및 작업 항목 폼의 웹 페이지 링크 제공을 참조하십시오.
Link	선택적 요소입니다. ControlType이 FieldControl 또는 LabelControl로 지정할 때 이 요소를 지정할 수 있습니다. 필드 또는 레이블의 하이퍼링크를 정의합니다. 자세한 내용은 Link 및 Param XML 요소 참조 및 도움말 텍스트, 프로세스 지침, 웹 콘텐츠 및 작업 항목 폼의 웹 페이지 링크 제공을 참조하십시오.
LinksControlOptions	선택적 요소입니다. ControlType이 LinksControl로 지정되면 이 요소를 지정할 수 있습니다. 링크 필터 그리고 링크 목록을 표시하는 열 필드의 레이아웃을 정의합니다. 자세한 내용은 링크 관계를 제한하기 위한 링크 컨트롤 정의을 참조하십시오.
WebpageControlOptions	선택적 요소입니다. ControlType이 WebpageControl일 때 이 요소를 지정할 수 있습니다. 작업 항목 폼에 웹 페이지 대상을 로드하는 데 필요한 컨트롤을 지정합니다. 자세한 내용은 WebpageControlOptions XML 요소 참조 및 도움말 텍스트, 프로세스 지침, 웹 콘텐츠 및 작업 항목 폼의 웹 페이지 링크 제공을 참조하십시오.
anyAttribute	선택적 요소입니다. 선택적 요소로서, ControlType은 anyAttribute 요소를 사용하여 확장할 수 있습니다. ProcessContents: skip

부모 요소

요소	설명
레이아웃	필수적 요소로서, 작업 항목 폼에 요소가 표시되는 방법을 정의합니다.
Column 요소	필수적 요소로서, 폼의 열을 정의합니다.
Tab 요소	필수적 요소로서, 폼의 탭을 정의합니다.

설명

Control는 Layout, Column 및 Tab의 선택적 자식 요소입니다.

Layout 및 Column 표시기:

minOccurs = "0"

maxOccurs = "1"

Tab 표시기:

minOccurs = "0"

maxOccurs = "unbounded"

사용자 지정 컨트롤을 구현하려면 Type 특성의 컨트롤 이름을 지정해야 합니다. 자세한 내용은 Microsoft 웹 사이트에서 Work Item Tracking Custom Controls를 참조하십시오.

각 컨트롤 형식의 예제는 작업 항목 폼 컨트롤 지정을 참조하십시오.

예제

<Control Type=" WorkItemClassificationControl " FieldName="System.AreaPath"
  Label="Area" LabelPosition="Left" />

요소 정보

Namespace	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
스키마 이름	작업 항목 형식 정의
유효성 검사 파일	WorkItemTypeDefinition.xsd
요소 형식	ControlType 복합 형식
비워 둘 수 있음	해당 없음

참고 항목

개념

작업 항목 폼 디자인 및 사용자 지정

모든 FORM XML 요소 참조

작업 항목 폼 컨트롤 지정

변경 기록

날짜	변경 내용	이유
2011년 1월	자식 요소가 구문에 추가되었고 제거된 항목에 대한 링크가 제거되거나 교체되었습니다.	향상된 기능 관련 정보

2011년 1월

자식 요소가 구문에 추가되었고 제거된 항목에 대한 링크가 제거되거나 교체되었습니다.

향상된 기능 관련 정보

다음을 통해 공유