Layout XML 要素のリファレンス
Layout 要素を使用すると、作業項目フォーム上で要素をどのように表示するかを定義できます。Windows の Visual Studio クライアントや Team System Web Access の Web クライアントなど、異なるクライアントをサポートするように複数のレイアウトを定義できます。
Layout 要素は、FORM 要素の必須の子要素です。Layout 要素の使用方法の詳細については、「作業項目フォームのレイアウトのデザイン」を参照してください。
スキーマの階層
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 >
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
Description |
|---|---|
Target |
省略可能な Layout 型の属性です。 このレイアウトが適用されるクライアントの名前を指定します。型は xs:string です。次のいずれかの文字列を指定します。
|
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これらのフィールドを表示します。 |
子要素
要素 |
Description |
|---|---|
省略可能です。フォーム上にまとめて表示される要素のグループを定義します。 |
|
省略可能です。作業項目フォームに表示する作業項目フィールド、テキスト、ハイパーリンク、その他のコントロール要素を定義します。 |
|
省略可能です。1 つ以上の Tab 要素を含みます。 |
|
省略可能です。フォーム上の分割線とその方向を兄弟フォーム要素の間に定義します。 |
親要素
要素 |
Description |
|---|---|
必ず指定します。作業項目の種類フォームでの要素の表示方法を定義する Layout 要素を含みます。 |
解説
Layout 要素は、FORM に必須の子要素です。Layout 要素は選択項目を指定します。Group、Control、TabGroup、または Splitter のうち、少なくとも 1 つの子要素を定義する必要があります。複数の子要素を定義できます。
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 複合型 |
空も使用できる |
Ｘ |