Riferimento all'elemento XML Layout

Articolo
08/11/2011

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

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.

Share via