Condividi tramite


Riferimento all'elemento XML Control

Si utilizza l'elemento Control per definire un campo, un testo, un collegamento ipertestuale o un altro elemento di controllo da visualizzare nel form di un elemento di lavoro.Per esempi su come utilizzare questo elemento, vedere Specificare controlli dei form elemento di lavoro.Per ulteriori informazioni, vedere Progettare e personalizzare un form elemento di lavoro.

Gerarchia dello schema

WITD

   WORKITEMTYPE

       FORM

           Layout

               Gruppo

               Colonna

               Tab

<xs:element name="Control" type="ControlType" minOccurs="0"/>

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" ControlFontSize="FontSize" EmptyText="TextString"
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" >
<LabelText> . . . </LabelText>
<Link> . . . </Link>
<LinksControlOptions> . . . </LinksControlOptions>
<WebpageControlOptions> . . . </WebpageControlOptions>
</Control>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo

Descrizione

FieldName

Attributo Control facoltativo.

Specifica il campo dell'elemento di lavoro al quale è associato il controllo.Il tipo dell'attributo è typelib:ReferenceFieldName.Lunghezza minima: 1; lunghezza massima: 70.

Valore di schema:^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$

Esempio di valore del modello: Company.Division.IssueType

Type

Attributo Control obbligatorio.

Specifica il tipo di dati del controllo.Il tipo dell'attributo è il tipo semplice ValidControlsType.Specificare una stringa da uno dei seguenti tipi incorporati:

  • AttachmentControl: consente di visualizzare gli allegati degli elementi di lavoro.Questo controllo non dispone di un campo associato o di un tipo di campo.

  • DateTimeControl: consente di visualizzare i campi data formattati con il tipo di campo DateTime.

  • FieldControl: consente di visualizzare i campi numerici o di testo normale e gli elenchi di valori per i campi con il tipo di campo String, Identity, Integer, Double e PlainText.

  • HtmlFieldControl: consente di visualizzare il formato RTF su più righe dei campi con il tipo di campo HTML.

  • LabelControl: consente di visualizzare testo non associato a un campo.Il testo può essere testo semplice o con collegamento ipertestuale.È possibile specificare comandi aggiuntivi utilizzando LabelText, Link e gli elementi Text.Vedere Riferimento agli elementi XML LabelText e Text e Riferimento agli elementi XML Link e Param.

  • LinksControl: Utilizzare per visualizzare la barra degli strumenti del controllo collegamenti e gestire relazioni di collegamento tra elementi di lavoro e gli storyboard.Questo controllo non dispone di un campo associato o di un tipo di campo.Specificare i tipi di collegamenti per filtrare e altre opzioni di controllo utilizzando l'elemento LinksControlOptions.Vedere Elementi LinksControlOptions.

  • WebpageControl: consente di visualizzare contenuti basati su HTML definiti da un URI o incorporati all'interno di un tag CDATA.Questo controllo non dispone di un campo associato o di un tipo di campo..Specificare il contenuto e i collegamenti da visualizzare utilizzando l'elemento WebpageControlOptions.Vedere Riferimento agli elementi XML WebpageControlOptions.

  • WorkItemClassificationControl Consente di visualizzare i campi del percorso gerarchico con il tipo di campo TreePath.

    NotaNota
    I campi System.AreaPath e System.IterationPath sono gli unici campi che utilizzano questo tipo di dati.Non è possibile definire un campo personalizzato utilizzando questo tipo di dati.
  • WorkItemLogControl: consente di visualizzare le informazioni cronologiche relative agli elementi di lavoro e i campi con il tipo di campo History.

    NotaNota
    Il campo System.History è l'unico campo che utilizza questo tipo di dati.Non è possibile definire un campo personalizzato utilizzando questo tipo di dati.

Per ulteriori informazioni, vedere Specificare controlli dei form elemento di lavoro.

NotaNota
È possibile utilizzare un controllo personalizzato impostando l'attributo Type su un valore personalizzato.Qualsiasi controllo il cui valore Type non corrisponde al nome di un tipo incorporato viene considerato come un controllo personalizzato.Per ulteriori informazioni, visitare il sito Web Microsoft Controlli personalizzati per tenere traccia degli elementi di lavoro (la pagina potrebbe essere in inglese).

ControlFontSize

Attributo Control facoltativo.

Specifica la dimensione del carattere del nome del campo o dell'etichetta nel form.Valori validi di FontSize: small, normal, large, xlarge, e xxlarge.

EmptyText

Attributo Control facoltativo.

Specifica una stringa di testo tra 1 e 255 caratteri di lunghezza visualizzato quando un campo è vuoto.

Label

Attributo Control facoltativo.

Specifica il testo visibile sul form che identifica il controllo.Specificare una stringa composta da un massimo di 80 caratteri.

LabelFontSize

Specifica la dimensione del carattere dell'etichetta nel form.Valori validi per FontSize: small, normal, large, xlarge, and xxlarge.

LabelPosition

Attributo Control facoltativo.

Specifica la posizione dell'etichetta rispetto ai dati del controllo.Specificare una stringa da uno dei seguenti valori:

  • Top: posiziona l'etichetta sopra i dati del controllo.

  • Bottom: posiziona l'etichetta sotto i dati del controllo.

  • Left: posiziona l'etichetta a sinistra dei dati del controllo.

  • Right: posiziona l'etichetta a destra dei dati del controllo.

Dock

Attributo Control facoltativo.

Allinea il campo al lato specificato del contenitore o estende il campo per riempire il contenitore.Il tipo dell'attributo è DockType.Specificare una stringa da uno dei seguenti valori:

  • Fill: consente di allineare il campo in modo da riempire il contenitore.Questo valore non è un orientamento supportato dell'elemento Splitter.

  • Top: consente di allineare il campo alla parte superiore del contenitore.Questo valore non è un orientamento supportato dell'elemento Splitter.

  • Bottom: consente di allineare il campo alla parte inferiore del contenitore.Questo valore non è un orientamento supportato dell'elemento Splitter.

  • Left: consente di allineare il campo al lato sinistro del contenitore.

  • Right: consente di allineare il campo al lato destro del contenitore.Questo valore non è un orientamento supportato dell'elemento Splitter.

Padding

Attributo Control facoltativo.

Specifica, in pixel, la quantità di spazio intorno al bordo interno del controllo, che corrisponde agli spazi in alto, in basso, a sinistra e a destra.Il tipo dell'attributo è SizeType.

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

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

Margin

Attributo Control facoltativo.

Specifica, in pixel, la quantità di spazio intorno al bordo esterno del controllo, che corrisponde agli spazi in alto, in basso, a sinistra e a destra.Il tipo dell'attributo è SizeType.

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

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

ReadOnly

Attributo Control facoltativo.

Specifica se il campo è di sola lettura.Il tipo dell'attributo è ReadOnlyType.Specificare una stringa da uno dei seguenti valori:

  • True: specifica che i dati del controllo sono di sola lettura.

  • False: specifica che i dati del controllo non sono di sola lettura.

MinimumSize

Attributo Control facoltativo.

Specifica la dimensione minima in pixel che il controllo deve occupare nel form.La sintassi è specificata in (width,height).Il tipo dell'attributo è SizeType.

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

Esempio valore del modello: (100,100)

NotaNota
Se non si dispone di spazio verticale sufficiente, viene visualizzata una barra di scorrimento per occupare le dimensioni minime.Senza questo attributo, i controlli vengono disegnati con le dimensioni predefinite, a meno che i controlli nelle altre schede prendano più spazio.La dimensione complessiva di qualsiasi controllo del form dipende dalla dimensione dell'area del form o della scheda maggiore.

Name

Attributo Control facoltativo.

Identifica un controllo in modo univoco.Name è importante se più di un controllo del form è associato allo stesso campo elemento di lavoro.Il tipo dell'attributo è xs:string.

NotaNota
Utilizzare l'attributo Name per visualizzare lo stesso campo in più percorsi del form.Specificare un valore univoco per l'attributo Name per entrambe le voci del controllo in modo che il sistema identifichi ogni controllo in modo univoco.È utile visualizzare lo stesso controllo in diverse posizioni in base al contesto delle schede.

NumberFormat

Attributo Control facoltativo valido solo quando viene utilizzato con FieldControl.

Specifica i caratteri che è possibile immettere nel controllo del campo.Valori validi che è possibile utilizzare sono i seguenti:

  • WholeNumbers: specifica che sono consentiti i numeri interi.

  • SignedWholeNumbers: specifica che sono consentiti i numeri interi firmati.

  • DecimalNumbers: specifica che sono consentiti i numeri decimali.

  • SignedDecimalNumbers: specifica che sono consentiti i numeri decimali firmati.

MaxLength

Attributo Control facoltativo valido solo quando viene utilizzato con FieldControl.

Specifica la lunghezza massima dei caratteri consentita in un controllo del campo.Il tipo dell'attributo è xs:integer.

Format

Attributo Control facoltativo valido solo quando viene utilizzato con DateTimeControl.

Specifica il formato per il campo di data e ora che corrisponde a uno dei valori dell'enumerazione DateTimePickerFormat.Valori validi che è possibile utilizzare sono i seguenti:

  • Custom: visualizza il valore di data/ora in un formato personalizzato.È possibile impostare il formato personalizzato specificando 'Personalizzato' come valore per l'attributo Formato e impostando un altro attributo denominato CustomFormat per una stringa con formato personalizzato.Ad esempio:

    Format="Custom"

    CustomFormat = "MMM gg, 'dell'anno' aaaa "

    Per ulteriori informazioni, vedere il sito Web Microsoft: Proprietà DateTimePicker.CustomFormat.

  • Long: visualizza il valore di data/ora nel formato data esteso impostato dal sistema operativo dell'utente.

  • Short: visualizza il valore di data/ora nel formato data breve impostato dal sistema operativo dell'utente.

  • Time: visualizza il valore di data/ora nel formato ora impostato dal sistema operativo dell'utente.

Per ulteriori informazioni, vedere il sito Web Microsoft: Enumerazione DateTimePickerFormat.

CustomFormat

Attributo Control facoltativo valido solo quando viene utilizzato con DateTimeControl e l'attributo Format.

Specifica il formato personalizzato per il campo di data e ora che corrisponde alla sintassi definita per la proprietà DateTimePicker.CustomFormat.Per ulteriori informazioni, vedere il sito Web Microsoft: Proprietà DateTimePicker.CustomFormat.

Elementi figlio

Elemento

Descrizione

LabelText

Elemento facoltativo.È possibile specificare questo elemento quando l'attributo Type viene specificato come FieldControl o LabelControl.

Elemento del contenitore per specificare il testo, il collegamento ipertestuale e la posizione di un campo o di un'etichetta il cui testo è associato in parte a un collegamento ipertestuale.

Per ulteriori informazioni, vedere Riferimento agli elementi XML LabelText e Text e Fornire il testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro.

Link

Elemento facoltativo.È possibile specificare questo elemento quando l'attributo Type viene specificato come FieldControl o LabelControl.

Definisce il collegamento ipertestuale di un campo o un'etichetta.

Per ulteriori informazioni, vedere Riferimento agli elementi XML Link e Param e Fornire il testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro.

LinksControlOptions

Elemento facoltativo.È possibile specificare questo elemento quando l'attributo Type viene specificato come LinksControl.

Definisce i filtri dei collegamenti e il layout dei campi colonna per visualizzare l'elenco di collegamenti.

Per ulteriori informazioni, vedere Definire i controlli dei collegamenti per limitare le relazioni di collegamento.

WebpageControlOptions

Elemento facoltativo.È possibile specificare questo elemento quando l'attributo Type viene specificato come WebpageControl.

Specifica i controlli che regolano il caricamento della destinazione della pagina Web nel form elemento di lavoro.

Per ulteriori informazioni, vedere Riferimento agli elementi XML WebpageControlOptions e Fornire il testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro.

anyAttribute

Elemento facoltativo.

Opzionale.Control è estensibile tramite l'utilizzo dell'elemento anyAttribute.

Elementi padre

Elemento

Descrizione

Layout

Necessario.Definisce la modalità di visualizzazione degli elementi nel form dell'elemento di lavoro.

ElementoColumn

Necessario.Definisce colonne per il form.

Elemento Tab

Necessario.Definisce una scheda per il form.

Note

Control è un elemento figlio facoltativo degli elementi Layout, Column e Tab.

Indicatori Layout e Column:

minOccurs = "0"

maxOccurs = "1"

Indicatori Tab:

minOccurs = "0"

maxOccurs = "unbounded"

Per implementare un controllo personalizzato, è necessario specificare il nome del controllo per l'attributo Type.Per ulteriori informazioni, visitare il sito Web Microsoft Controlli personalizzati per tenere traccia degli elementi di lavoro (la pagina potrebbe essere in inglese).

Per un esempio di ogni tipo di controllo, vedere Specificare controlli dei form elemento di lavoro.

Esempio

<Control Type=" WorkItemClassificationControl " FieldName="System.AreaPath"
  Label="Area" LabelPosition="Left" />

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 ControlType

Può essere vuoto

Non applicabile

Vedere anche

Concetti

Progettare e personalizzare un form elemento di lavoro

Riferimento a tutti gli elementi XML FORM

Specificare controlli dei form elemento di lavoro