Condividi tramite

Riferimento a tutti gli elementi XML FORM

  • Articolo

È possibile utilizzare le informazioni fornite in questo argomento come riferimento rapido relativo a tutti gli elementi e gli attributi principali che controllano il form per un tipo di elemento di lavoro. Questi elementi vengono specificati nel contenitore dell'elemento FORM, la terza e ultima sezione principale della definizione del tipo di elemento di lavoro. Molti elementi sono annidati all'interno di altri per formare gruppi, sezioni o schede in un form elemento di lavoro. Per ulteriori informazioni su come raggruppare questi elementi, vedere Progettazione del layout del form elemento di lavoro.

In questo argomento

  • Esempio di FORM

  • Sintassi per gli elementi FORM

  • Attributi specificati dagli elementi FORM

  • Elementi che specificano etichette autonome, collegamenti ipertestuali, pagine Web o contenuto HTML

  • Elementi che filtrano e visualizzano relazioni di collegamento

Esempio di FORM

Nell'esempio seguente viene mostrata la struttura generale dell'elemento FORM. Specificare il layout di un form utilizzando l'elemento Layout. È possibile specificare layout diversi destinati a client diversi. Ad esempio, è possibile specificare un layout per client Windows e un layout diverso per Team Web Access. Un layout è costituito in genere dalla parte superiore del form e quindi da un gruppo di schede. La sequenza nella quale si definiscono gli elementi all'interno del layout determina la sequenza nella quale gli elementi vengono visualizzati sul form.

Raggruppare gli elementi per la visualizzazione all'interno delle colonne tramite gli elementi Group e Column. Si utilizza un elemento Control per definire ogni campo che si desidera visualizzare nel form. L'elemento Tab viene utilizzato per supportare aree funzionali diverse dei gruppi del campo.

<FORM>
      <Layout>
        <Group>
          <Column PercentWidth="70">
            <Group>
              <Column PercentWidth="100">
                <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
                <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />
                <Control FieldName="System.IterationPath" Type="WorkItemClassificationControl" Label="&amp;Iteration Path:" LabelPosition="Left" />
                <Group>
                  <Column PercentWidth="50">
                    <Control FieldName="Microsoft.VSTS.Common.ProductUnit" Type="FieldControl" Label="PU (Use Area Path)" LabelPosition="Left" />
                  </Column>
                  <Column PercentWidth="50">
                    <Control FieldName="Microsoft.VSTS.Common.Priority" Type="FieldControl" Label="Priority" LabelPosition="Left" />
                  </Column>
                </Group>
              </Column>
            </Group>
          </Column>
          <Column PercentWidth="30">
            <Group Label="Status">
              <Column PercentWidth="100">
                <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
                <Control FieldName="System.State" Type="FieldControl" Label="State" LabelPosition="Left" />
                <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assigned To" LabelPosition="Left" />
              </Column>
            </Group>
          </Column>
        </Group>

. . .
</Layout>
</FORM>

Elementi form

È possibile specificare il modo in cui le informazioni e i campi degli elementi di lavoro sono raggruppati e visualizzati in un form di elemento di lavoro utilizzando gli elementi descritti nella tabella che segue.

Nota

Per ottenere risultati migliori, occorre annidare gli elementi Control in un oggetto Group e annidare gli elementi Group in un oggetto Column, anche se la larghezza della colonna è uguale alla larghezza del form. Inoltre, occorre annidare ciascuna sezione Column in un elemento Group, anche se il gruppo non dispone di etichette o limiti visibili.

Elemento

Descrizione

Obbligatorio?

Column

Divide le aree di un form in colonne.

<Column PercentWidth="WidthPerceOfContainingElement" FixedWidth="WidthInPixels">
   <Group> . . . </Group
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Column >

Consigliato

Control

Definisce un campo, un testo, un collegamento ipertestuale o un altro elemento di controllo da visualizzare nel form dell'elemento di lavoro.

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" Label="LabelText" LabelPosition="Top | Bottom | Left | Right" 
Dock="Fill | Top | Bottom | Left | Right" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ReadOnly="True | False" MinimumSize="(Width,Height)" 
Name="InstanceName" />

Per ulteriori informazioni, vedere Riferimento all'elemento XML Control.

Obbligatorio

FORM

Definisce l'elemento del form di livello superiore.

<FORM>
   <Layout> . . . </Layout>
</FORM>

Obbligatorio

Group

Fornisce un raggruppamento visivo di elementi, simile al controllo GroupBox di Windows.

<Group Label="LabelText" Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Column> . . . </Column>
</Group >

Consigliato

Layout

Definisce il layout del form dell'elemento di lavoro.

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

Obbligatorio

Splitter

Divide un form in due aree per supportare il layout di due elementi del form di pari livello.

Splitter Dock="Left" />

Facoltativo

Tab

Definisce il layout di una singola scheda in un gruppo di schede.

<Tab Label="LabelText" Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Group> . . . </Group
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Tab>

Facoltativo

TabGroup

Definisce uno o più schede per il form.

<TabGroup Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Tab> . . . </Tab>
</TabGroup>

Facoltativo

Torna all'inizio

Attributi utilizzati per formattare elementi FORM

È possibile controllare la spaziatura e la dimensione di molti elementi su un form elemento di lavoro specificando gli attributi descritti nella seguente tabella. Per ulteriori informazioni, vedere Progettazione del layout del form elemento di lavoro.

Attributo

Descrizione

Elementi applicabili

ControlSpacing

Facoltativo. Specifica l'offset verticale dei controlli. Integer.

Layout

Dock

Facoltativo. Estende un controllo di campo o una barra di divisione fino a riempire il resto del contenitore. I valori di ancoraggio validi del campo sono i seguenti: Riempi, Superiore, Inferiore, Sinistra, e Destra.

  • Fill: consente di allineare il campo in modo da riempire il contenitore.

  • Top: consente di allineare il campo alla parte superiore del contenitore.

  • Bottom: consente di allineare il campo alla parte inferiore del contenitore.

  • Left: consente di allineare il campo o il separatore al lato sinistro del contenitore. Questo valore è l'unico orientamento supportato per l'elemento SPLITTER.

  • Right: consente di allineare il campo o il separatore al lato sinistro del contenitore.

Control

Splitter

FixedWidth

Facoltativo. Larghezza della colonna in pixel. PercentWidth e FixedWidth si escludono a vicenda.

Column

Label

Facoltativo. Testo da visualizzare per un controllo o un gruppo. Se viene specificata un'etichetta, questa sostituisce qualsiasi etichetta associata al campo nei metadati per il controllo.

Obbligatorio per l'elemento Tab. Testo da visualizzare per una scheda.

LabelText: stringa di testo di lunghezza compresa tra 1 e 80 caratteri.

Control

Group

Tab

LabelPosition

Facoltativo. Posizione dell'etichetta rispetto ai dati del campo. I valori possibili sono Superiore, Inferiore, Sinistro e Destro.

Control

LabelSpacing

Facoltativo. Specifica il numero di pixel tra l'etichetta e l'area di modifica del controllo.

Layout

Margin

Facoltativo. Stringa del form (a sinistra, in alto, a destra, in basso) che specifica, in pixel, la quantità di spazio intorno al controllo e tra il controllo e gli elementi adiacenti. La quantità di spazio su ciascun lato può essere variata.

Valore di schema: ^\(\d+\,\d+\,\d+\,\d+\)$

Esempio valore del modello: (2,0,2,0)

Control

Group

Layout

Tab

TabGroup

MinimumSize

Facoltativo. Stringa del form (larghezza, altezza). Questo valore specifica la dimensione minima dello stesso form. Se le dimensioni del controllo contenitore sono minori, vengono visualizzate le barre di scorrimento orizzontale e verticale.

Control

Layout

Name

Facoltativo. Nome del controllo. Se non viene specificato, viene adottato il nome relativo a FieldName.

Control

Padding

Facoltativo. Stringa del form (a sinistra, in alto, a destra, in basso) che specifica, in pixel, la quantità di spazio intorno al bordo esterno del controllo e intorno al bordo interno. La quantità di spazio su ciascun lato può essere variata.

Control

Group

Layout

Tab

TabGroup

PercentWidth

Facoltativo. Larghezza della colonna espressa come percentuale della larghezza dell'elemento che la contiene. PercentWidth e FixedWidth si escludono a vicenda.

Column

ReadOnly

Facoltativo. È possibile visualizzare un campo di sola lettura in un controllo. I diversi controlli rispondono a questo attributo in modi leggermente differenti.

Control

Target

Facoltativo. Stringa che specifica a quale client viene applicato il layout. In Visual Studio questo tipo di elemento di lavoro viene visualizzato in questo layout se l'attributo Target viene omesso o è impostato su Windows Form. I client esterni possono specificare layout aggiuntivi utilizzando attributi Target personalizzati che in Visual Studio sono ignorati.

Di seguito vengono illustrati i valori validi.

  • WinForms: applica il form a Team Explorer e Team Explorer Everywhere.

  • Web: applica il form a Team Web Access.

Layout

Type

Obbligatorio. Tipo del controllo. Per ulteriori informazioni, vedere Riferimento all'elemento XML Control.

Control

Torna all'inizio

Elementi che specificano etichette autonome, collegamenti ipertestuali, pagine Web o contenuto HTML

L'elemento WebpageControlOptions e gli elementi figlio dispongono della struttura della sintassi seguente:

<WebpageControlOptions AllowScript="true | false" ReloadOnParamChange="true | false" >
   <Link UrlRoot="UrlRoot" UrlPath ="UrlPathWithParameters">
      <Param index="IndexValue" value="ParamValue" type ="Original | Current"/>
   </Link>
   <Content>
      <![CDATA[Contents of HTML]]>
   </Content>
</WebpageControlOptions>

Gli elementi descritti nella tabella seguente possono essere utilizzati per definire etichette in testo normale o con collegamento ipertestuale, aggiungere collegamenti ipertestuali a un campo o visualizzare il contenuto di una pagina Web in un form dell'elemento di lavoro. Per ulteriori informazioni, vedere Fornitura di Testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro.

Elemento

Obbligatorio?

Descrizione

Content

Elemento WebpageControlOptions facoltativo.

Specifica il contenuto basato su HTML CDATA da visualizzare in un form dell'elemento di lavoro.

<Content>
   <![CDATA[Contents of HTML]]>
</Content>

Per ulteriori informazioni vedere Riferimento agli elementi XML WebpageControlOptions.

LabelText

Elemento Control facoltativo quando type="LabelControl".

Definisce un'etichetta semplice o con collegamento ipertestuale.

Per ulteriori informazioni, vedere Riferimento agli elementi XML LabelText e Text.

Link

Elemento Control facoltativo quando type="FieldControl".

Elemento Text facoltativo.

Elemento WebpageControl facoltativo.

Elemento WebpageControlOptions facoltativo.

Definisce il collegamento ipertestuale per un campo, un'etichetta o un contenuto del browser Web da visualizzare in un form dell'elemento di lavoro.

<Link URLRoot="URLRoot" URLPath ="URLPathWithParameters">
   <Param />
</Link>

Per ulteriori informazioni, vedere Riferimento agli elementi XML Link e Param.

Param

Elemento Link facoltativo.

Specifica un valore per determinare l'URL del collegamento ipertestuale quando viene specificato URLPath per l'elemento Link.

<Param index="IndexValue " value="ParamValue " type ="Original | Current"/>

Per ulteriori informazioni, vedere Riferimento agli elementi XML Link e Param.

Text

Elemento LabelText facoltativo.

Elemento del contenitore per le informazioni o l'etichetta da visualizzare nel form dell'elemento di lavoro.

<Text>
   <Link >
      <Param />
   </Link>
   LabelText
</Text>

Per ulteriori informazioni, vedere Riferimento agli elementi XML LabelText e Text.

WebpageControlOptions

Elemento Control facoltativo quando type="WebpageControl"

Elemento del contenitore che specifica le opzioni per il controllo pagina Web.

Per ulteriori informazioni vedere Riferimento agli elementi XML WebpageControlOptions.

Torna all'inizio

Elementi che filtrano e visualizzano relazioni di collegamento

Si utilizza l'elemento LinksControlOptions per definire le opzioni per controllare quali collegamenti è possibile aggiungere a un elemento di lavoro e le colonne predefinite che si desidera visualizzare per l'elenco di collegamenti in un elemento di lavoro. Quando si aggiunge il controllo collegamento a un form dell'elemento di lavoro, è possibile specificare dei filtri che limitino i tipi di collegamenti che gli utenti possono creare e i tipi di elementi di lavoro tra i quali gli utenti possono creare dei collegamenti. L'elemento LinksControlOptions e gli elementi figlio dispongono della seguente struttura:

<LinksControlOptions>
   <WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
       <Filter LinkType="linkTypeRefName" FilterOn="reverseName | forwardName" />
   </WorkItemLinkFilters>
   <ExternalLinkFilters FilterType ="include | exclude | includeAll | excludeAll">
       <Filter LinkType="externalLinkName"/>
   </ExternalLinkFilters>
   <WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" />
       <Filter WorkItemType="workItemTypeReferenceName"/>
   </WorkItemTypeFilters>
   <LinkColumns>
      <LinkColumn RefName="referenceName" | LinkAttribute="linkAttributeName"/>
   </LinkColumns>
</LinksControlOptions>

In particolare, si utilizzano gli elementi riepilogati nella tabella seguente. Per ulteriori informazioni su come utilizzare questi elementi, vedere Definizione dei controlli dei collegamenti per limitare le relazioni di collegamento e Elementi LinksControlOptions.

Elemento

Obbligatorio?

Descrizione

LinksControlOptions

Elemento Control facoltativo quando type="LinksControl"

Fornisce un contenitore per elementi che definiscono le opzioni per controllare quali collegamenti è possibile aggiungere a un elemento di lavoro e le colonne predefinite che si desidera visualizzare per l'elenco di collegamenti in un elemento di lavoro.

WorkItemLinkFilters

Elemento LinksControlOptions facoltativo

Fornisce un contenitore per uno o più elementi Filter che specificano i criteri di filtro del collegamento da utilizzare per i tipi di collegamento definiti per l'insieme di progetti team.

ExternalLinkFilters

Elemento LinksControlOptions facoltativo

Fornisce un contenitore per uno o più elementi Filter che specificano i criteri di filtro del collegamento da utilizzare per i tipi di collegamento definiti in altri progetti team.

WorkItemTypeFilters

Elemento LinksControlOptions facoltativo

Fornisce un contenitore per uno o più elementi Filter che specificano i criteri di filtro da applicare ai tipi di elemento di lavoro.

Filter (tipi di collegamento)

Elemento WorkItemLinkFilters necessario quando l'attributo FilterType è exclude o include.

Elemento ExternalLinkFilters necessario quando l'attributo FilterType è exclude o include.

Specifica i tipi di collegamenti da includere o escludere dal set di collegamenti che possono essere creati per l'elemento di lavoro.

Filter (tipi di elemento di lavoro)

Elemento WorkItemTypeFilters facoltativo quando l'attributo FilterType è exclude o include.

Specifica i tipi di elementi di lavoro da includere o escludere dal set di tipi di elementi di lavoro tra i quali gli utenti possono creare collegamenti.

LinkColumns

Elemento LinksControlOptions facoltativo

Fornisce un contenitore per uno o più tag LinkColumn.

LinkColumn

Elemento LinkColumns obbligatorio

Specifica i campi dell'elemento di lavoro e gli attributi del tipo del collegamento da visualizzare nel form dell'elemento di lavoro per l'elenco di collegamenti.

Torna all'inizio

Vedere anche

Concetti

Progettazione del layout del form elemento di lavoro

Progettazione e personalizzazione di un form elemento di lavoro

Altre risorse

Indice delle definizioni degli elementi XML per i tipi di elementi di lavoro

Cronologia delle modifiche

Data

Cronologia

Motivo

Maggio 2011

Corretta la distinzione tra maiuscole e minuscole di vari elementi e attributi della sintassi XML. La definizione dello schema per la gestione degli elementi di lavoro definisce tutti gli elementi figlio dell'elemento FORM come maiuscole-minuscole camel e tutti gli altri elementi come tutto scritto in maiuscolo.

Correzione di bug nel contenuto.

Gennaio 2011

Aggiunti esempio e sintassi per tutti gli elementi FORM. Rimosso collegamenti a argomenti rimossi.

Miglioramento delle informazioni.

Luglio 2010

Aggiunta di collegamenti a argomenti che sono stati aggiunti nell'aggiornamento precedente.

Miglioramento delle informazioni.