Condividi tramite


Riferimento all'elemento XML Layout

È 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