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 Progettazione del 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">
    <Group> . . . </Group>
    <Control> . . . </Control>
    <TabGroup> . . . </TabGroup>
    <Splitter> . . . </Splitter>
</Layout >

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attributo

Oggetto di descrizione

Target

Attributo LayoutType 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 LayoutType 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 LayoutType 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 LayoutType 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 LayoutType facoltativo.

Specifica l'offset verticale dei controlli definiti nel form. Il tipo è xs:integer.

LabelSpacing

Attributo LayoutType facoltativo.

Specifica il numero di pixel tra l'etichetta e l'area di modifica del controllo. Il tipo è xs:integer.

Elementi figlio

Elemento

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

Oggetto di descrizione

FORM

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

Progettazione e personalizzazione di un form elemento di lavoro

Cronologia delle modifiche

Data

Cronologia

Motivo

Gennaio 2011

Esempio di codice aggiunto e collegamenti rimossi ad argomenti rimossi.

Miglioramento delle informazioni.

Settembre 2010

Aggiunti i valori validi dell'attributo Target.

Commenti e suggerimenti dei clienti.