Riferimento all'elemento XML Control

Articolo
03/05/2013

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

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