작업 항목 필드의 표시 제어
작업 항목 폼에서 텍스트 상자의 레이블 이름, 위치 및 크기와 일반 텍스트, 정수, 숫자, 날짜 및 트리 경로 작업 항목 필드의 다른 표시 컨트롤을 제어할 수 있습니다.이러한 필드를 표시하려면 다음 옵션에서 올바른 Control 요소 Type 특성을 지정해야 합니다.
DateTimeControl: 필드 형식이 DateTime인 서식 있는 날짜 필드를 표시하는 데 사용됩니다.
FieldControl: 필드 형식이 String, Identity, Integer, Double 및 PlainText인 필드에 대한 값 목록과 일반 텍스트 또는 숫자 필드를 표시하는 데 사용됩니다.
HtmlFieldControl: 필드 데이터 형식이 HTML인 필드의 여러 줄로 된 서식 있는 텍스트 형식을 표시하는 데 사용됩니다.
WorkItemClassificationControl: 필드 형식이 TreePath인 계층적 경로 필드를 표시하는 데 사용됩니다.
다른 Type 컨트롤에 대한 자세한 내용은 다음 항목을 참조하십시오.
항목 내용
데이터 필드의 크기 및 표시 제어
폼의 두 위치에서 필드 레이블 지정 및 필드 추가
필드를 읽기 전용으로 설정
일반 텍스트 및 숫자 필드 추가
서식 있는 텍스트 필드 추가
날짜 또는 일정 필드 추가
영역 및 반복 경로에 대한 필드 추가
데이터 필드의 크기 및 표시 제어
다음 표에 설명된 선택적 특성을 사용하여 각 데이터 필드의 간격과 크기를 제어할 수 있습니다.
[!참고]
각 데이터 입력 필드의 전체 크기는 필드에 할당되는 특성, 컨테이너 크기, 폼의 다른 필드에 할당되는 영역 등의 여러 가지 요소에 의해 결정됩니다.최소 크기를 지정하지 않을 경우 필드에 기본값이 할당됩니다.폼의 다른 필드에 할당되는 특성이 필드의 크기에 영향을 줄 수 있습니다.열의 수와 각 열에서 가장 큰 필드에 할당하는 가로 크기에 따라 폼의 가로 크기가 결정됩니다.세로 그룹에서 지정하는 필드 수와 각 필드에 할당하는 세로 크기에 따라 폼의 위쪽 크기와 폼의 아래쪽 크기가 결정됩니다.
특성 |
설명 |
패턴 값 예 |
|---|---|---|
MinimumSize |
컨트롤에 대한 최소 크기(Width, Height)를 지정합니다.컨트롤의 컨테이너가 이 크기보다 작은 경우 가로 및 세로 스크롤 막대가 나타납니다. |
(100,100) |
Margin |
컨트롤 주위의 공간 크기와 컨트롤 간의 간격을 픽셀 단위로 지정합니다(left, top, right, bottom). |
(2,0,2,0) |
Padding |
컨트롤 테두리 바깥쪽의 공간 크기를 픽셀 단위로 지정합니다(left, top, right, bottom). |
(2,0,2,0) |
Dock |
컨테이너의 지정된 측면에 레이블 맞춤을 지정하거나, 필드를 확장하여 컨테이너를 채웁니다.Fill, Top, Bottom, Left 및 Right 값 중 하나에서 문자열을 지정합니다. |
N/A |
폼의 두 위치에서 필드 레이블 지정 및 필드 추가
각 폼 컨트롤에 대해 Label 및 LabelPosition 특성을 사용하여 선택적 레이블과 레이블의 위치를 지정할 수 있습니다.레이블은 FIELD 요소가 할당하는 이름과 다른 이름을 지정할 수 있습니다.레이블을 지정하지 않으면 이름이 사용됩니다.그러나 팀 멤버가 쿼리를 실행하여 작업 항목을 검색할 때는 항상 이름이 사용됩니다.최대 레이블 크기는 80자입니다.
[!참고]
동일한 그룹에 정의되는 모든 컨트롤에 동일한 레이블 위치를 정의해야 합니다.
폼의 여러 영역(예: 폼의 위쪽, 탭)에 필드를 추가하려면 Name 특성을 사용합니다.Name 특성은 폼에 추가되는 다른 컨트롤과 구별하여 컨트롤을 식별합니다.
필드를 읽기 전용으로 설정
다음 중 한 가지 방법을 사용하여 필드를 읽기 전용으로 표시할 수 있습니다.첫 번째 방법에서는 형식 정의의 FIELDS 섹션에 있는 FIELD 요소에 READONLY 요소를 자식으로 추가합니다.READONLY 요소를 사용하여 특정 사용자가 필드를 수정할 수 있는지 여부를 지정할 수 있습니다.다음 예제와 같이 프로그램 관리자만 Sub-Title 필드를 수정할 수 있습니다.
<FIELD name="Sub-Title" refname="ACME.ACE.SubTitle" type="String" >
<READONLY for="[Global]\Team Foundation Valid Users" not="Program Managers"/>
</FIELD>
두 번째 방법은 CONTROL 요소에 대한 ReadOnly 특성을 지정합니다.이 방법에서는 모든 사용자가 필드를 수정할 수 없습니다.
Control FieldName=" ACME.ACE.SubTitle" Type="FieldControl" Label="Sub-Title" LabelPosition="Left" ReadOnly="True" />
텍스트 및 숫자 필드 추가
FieldControl 형식을 사용하여 일반 텍스트 및 숫자 필드를 폼에 추가합니다.또한 이 특성은 선택 목록, 사용자 이름을 표시하는 데 사용되는 필드(예: 담당자 또는 소유자 필드), 정수 및 실수를 추가하는 데 사용됩니다.필드 컨트롤은 참조 이름으로 필드를 참조해야 합니다.필드 레이블은 일반 텍스트 또는 하이퍼링크로 스타일을 지정할 수 있습니다.자세한 내용은 도움말 텍스트, 프로세스 지침, 웹 콘텐츠 및 작업 항목 폼의 웹 페이지 링크 제공을 참조하십시오.
텍스트, 정수 및 선택 목록 필드
.png "여러 필드의 그룹")
다음 표에 설명된 선택적 특성을 사용하여 텍스트 또는 숫자 필드에 입력할 수 있는 최대 문자 길이와 숫자 필드의 서식을 제어할 수 있습니다.
특성 |
설명 |
|---|---|
NumberFormat |
필드 컨트롤에 입력할 수 있는 문자를 지정합니다.유효한 값은 WholeNumbers, SignedWholeNumbers, DecimalNumbers 및 SignedDecimalNumbers입니다. |
MaxLength |
필드 컨트롤에 사용할 수 있는 최대 문자 길이를 지정합니다. |
다음 코드에서는 앞의 그림에 표시된 필드 그룹을 생성하는 데 사용되는 구문을 보여 줍니다.
<TABGROUP>
<TAB Label="Planning">
<Group Label="Status" Padding="(0,0,0,3)">
<Column PercentWidth="100">
<Control FieldName="Microsoft.DevDiv.Importance" Type="FieldControl" Label="Importance" LabelPosition="Left" />
<Control FieldName="Microsoft.DevDiv.Commitment" Type="FieldControl" Label="Commitment / Confidence" LabelPosition="Left" />
<Control FieldName="Microsoft.DevDiv.VisionDoc" Type="FieldControl" Label="Vision Doc" LabelPosition="Left" />
<Control FieldName="Microsoft.DeveloperDivision.Features.EstimatedCost" Type="FieldControl" Label="Estimated Cost" LabelPosition="Left" />
<Control FieldName="Microsoft.DevDiv.BusinessUnit" Type="FieldControl" Label="BU (Use Area Path)" LabelPosition="Left" />
<Control FieldName="Microsoft.DevDiv.Website" Type="FieldControl" Label="Website" LabelPosition="Left" />
</Column>
</Group>
. . .
</TAB>
</TABGROUP>
서식 있는 텍스트 필드 추가
HTMLFieldControl 형식을 사용하여 데이터 형식이 HTML인 필드를 추가합니다.이 컨트롤을 사용하면 서식 있는 텍스트를 여러 줄에 표시할 수 있습니다.
HTML 필드
.png "작업 항목 폼에 표시된 HTML 필드")
<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.ReproSteps" Label="Repro Steps"
LabelPosition="Top" Dock="Left" MinimumSize="100,500" />
.gif "팁") 팁 |
|---|
폼에서 세로로 누적되는 여러 HTMLFieldControl 요소를 추가할 경우 각 필드 컨트롤에 대해 MinimumSize 특성을 지정해야 합니다.이 방법에서는 텍스트 상자를 모두 비슷한 크기로 지정할 수 있습니다.그렇지 않으면 마지막 HTML 컨트롤 요소의 크기가 폼 크기에 맞게 조정되고 이전 요소는 작은 여러 텍스트 상자에 함께 표시됩니다. |
날짜 또는 일정 필드 추가
DateTimeControl 형식을 사용하여 DateTime 필드의 날짜를 선택하는 일정 선택을 사용자에게 제공할 수 있습니다.이 컨트롤을 사용하여 필드의 날짜 및 시간을 빠르게 선택할 수 있습니다.
Format="Short"인 일정 필드
.png "일정 필드")
예를 들어, 이후에 원하는 시작 날짜 또는 검토 날짜를 지정할 수 있습니다.
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStart"
Label="Preferred Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStartTime"
Label="Preferred Start Time:" LabelPosition="Left" Dock="Fill" Format="Time" />
다음 표에 설명된 선택적 특성을 사용하여 DateTime 필드의 서식을 제어할 수 있습니다.
특성 |
설명 |
|---|---|
Format |
DateTimePickerFormat 열거형의 값 중 하나에 해당하는 날짜/시간 필드의 서식을 지정합니다.유효한 값은 Custom, Long, Short 및 Time입니다. Custom을 지정할 경우 CustomFormat 특성도 설정해야 합니다. |
CustomFormat |
DateTimePicker.CustomFormat 속성에 대해 정의되는 구문에 해당하는 날짜/시간 필드에 사용할 사용자 지정 서식을 지정합니다.예를 들면 다음과 같습니다. Format="Custom" CustomFormat = "MMM dd, 'of the year' yyyy" 자세한 내용은 Microsoft 웹 사이트: DateTimePicker.CustomFormat 속성을 참조하십시오. |
영역 및 반복 경로에 대한 필드 추가
WorkItemClassificationControl 형식을 사용하여 데이터 형식이 TreePath인 필드를 추가합니다.이 컨트롤은 영역 경로 필드 및 반복 경로 필드를 계층 구조의 중첩된 트리 형식으로 표시하는 데 사용됩니다.트리에는 확장하거나 축소할 수 있는 계층적 노드가 표시됩니다.
<Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area"LabelPosition="Left" />
[!참고]
WorkItemClassificationControl을 사용하여 System.AreaPath 및 System.IterationPath 필드를 표시할 수 있습니다.이 컨트롤을 사용하여 다른 형식의 필드 또는 사용자 지정 필드를 표시할 수 없습니다.
자세한 내용은 영역 및 반복 만들기 및 수정을 참조하십시오.