Riferimento all'elemento XML Layout

Articolo
06/09/2015

È possibile usare l'elemento Layout per definire la modalità di visualizzazione degli elementi nel form dell'elemento di lavoro. È possibile definire più di un layout per supportare client diversi, quale il client Windows per Visual Studio o il client Web per Team Web Access.

Per aggiungere elementi a un form, modificare la definizione per un tipo di elemento di lavoro. Vedere Modificare o aggiungere un tipo di elemento di lavoro personalizzato (WIT).

L'elemento Layout è un elemento figlio obbligatorio dell'elemento FORM. Per altre informazioni su come usare l'elemento Layout, vedere Progettare il form elemento di lavoro.

Gerarchia dello schema

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 >

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo	Descrizione
Target	Attributo Layout facoltativo. Specifica il nome del client al quale viene applicato il layout. Il tipo è xs:string. Specificare una delle stringhe seguenti: WinForms: applica il form a Team Explorer e Team Explorer Everywhere. Web: applica il form a Team Web Access.
MinimumSize	Attributo Layout facoltativo. Specifica la dimensione minima del form in pixel. La sintassi è specificata in (larghezza, altezza). Il tipo dell'attributo è SizeType. Valore di schema: ^$\d+\,\d+$$ Esempio valore del modello: (100,100)
Padding	Attributo Layout facoltativo. Specifica la quantità di spazio in pixel intorno al bordo interno del form. Il tipo dell'attributo è SizeType. Valore di schema: ^$\d+\,\d+\,\d+\,\d+$$ Esempio valore del modello: (2,0,2,0)
Margin	Attributo Layout facoltativo. Specifica la quantità di spazio in pixel intorno al bordo esterno del form. Il tipo dell'attributo è SizeType. Valore di schema: ^$\d+\,\d+\,\d+\,\d+$$ Esempio valore del modello: (2,0,2,0)
ControlSpacing	Attributo Layout facoltativo. Specifica l'offset verticale dei controlli definiti nel form.
LabelSpacing	Attributo Layout facoltativo. Specifica il numero di pixel tra l'etichetta e l'area di modifica del controllo.
HideControlBorders	Attributo Layout facoltativo. Specificare un valore True per nascondere i bordi del controllo, e False per visualizzarli.
HideReadOnlyEmptyFields	Attributo Layout facoltativo. Specificare un valore True per nascondere i campi di sola lettura e vuoti, e False per visualizzarli.

Elementi figlio

Elemento	Descrizione
Gruppo	Facoltativo. Definisce un gruppo di elementi da visualizzare insieme nel form.
Controllo	Facoltativo. Definisce un campo, un testo, un collegamento ipertestuale o un altro elemento di controllo da visualizzare nel form di un elemento di lavoro.
TabGroup	Facoltativo. Contiene uno o più elementi Tab.
Splitter	Facoltativo. Definisce una barra di divisione e il relativo orientamento nel form tra elementi di pari livello del form.

Elementi padre

Elemento	Descrizione
FORM	Obbligatorio. Contiene l'elemento Layout che definisce la modalità di visualizzazione degli elementi nel form del tipo di elemento di lavoro.

Note

L'elemento Layout è un elemento figlio obbligatorio dell'elemento FORM. L'elemento Layout specifica una scelta e deve essere definito almeno uno degli elementi figlio: Group, Control, TabGroup o Splitter. È possibile definire più di un elemento figlio.

minOccurs="1"

maxOccurs="unbounded"

Esempio

<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>

Informazioni sull'elemento

Spazio dei nomi	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Nome di schema	Definizione del tipo di elemento di lavoro
File di convalida	WorkItemTypeDefinition.xsd
Tipo di elemento	Tipo complesso LayoutType
Può essere vuoto	No