Riferimento all'elemento XML Layout

Articolo
03/05/2013

È possibile utilizzare 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.

L'elemento Layout è un elemento figlio obbligatorio dell'elemento FORM.Per ulteriori informazioni su come utilizzare l'elemento Layout, vedere Progettare il layout del form elemento di lavoro.

Gerarchia dello schema

WITD

WORKITEMTYPE

FORM

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 >

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 seguenti stringhe: 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 (width, height).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	Opzionale.Definisce un gruppo di elementi da visualizzare insieme nel form.
Controllo	Opzionale.Definisce un campo, un testo, un collegamento ipertestuale o un altro elemento di controllo da visualizzare nel form di un elemento di lavoro.
TabGroup	Opzionale.Contiene uno o più elementi Tab.
Splitter	Opzionale.Definisce una barra di divisione e il relativo orientamento nel form tra elementi di pari livello del form.

Elementi padre

Elemento	Descrizione
FORM	Necessario.Contiene l'elemento Layout che definisce la modalità di visualizzazione degli elementi sul 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

Vedere anche

Riferimenti

Riferimento all'elemento XML Control

Concetti

Riferimento a tutti gli elementi XML FORM

Progettare e personalizzare un form elemento di lavoro

Condividi tramite