Riferimento all'elemento XML Control

Articolo
06/09/2015

Si usa l'elemento Control per definire un campo elemento di lavoro, un testo, un collegamento ipertestuale o un altro elemento di controllo da visualizzare nel form di un elemento di lavoro. Per esempi su come usare questo elemento, vedere Specificare i controlli dei form elemento di lavoro e Progettare il 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" 
Padding="(top, bottom, left, right)" 
Margin="(top, bottom, left, right)" 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 elemento di lavoro a cui è 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 tipi incorporati riportati di seguito. AttachmentControl: viene usato per visualizzare gli allegati degli elementi di lavoro. Questo controllo non dispone di un campo associato né di un tipo di campo. DateTimeControl: viene usato per visualizzare i campi data formattati con il tipo di campo DateTime. FieldControl: viene usato per 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: viene usato per visualizzare il formato di testo RTF su più righe dei campi con il tipo di campo HTML. LabelControl: viene usato per visualizzare il testo non associato a un campo. Il testo può essere testo semplice o con collegamento ipertestuale. È possibile specificare controlli aggiuntivi usando gli elementi LabelText, Link e Text. Vedere Riferimento agli elementi XML LabelText e Text e Riferimento agli elementi XML Link e Param. LinksControl: viene usato per visualizzare la barra degli strumenti del controllo collegamenti e gestire le relazioni di collegamento tra gli elementi di lavoro e gli storyboard. Questo controllo non dispone di un campo associato né di un tipo di campo. È possibile specificare i tipi di collegamenti per filtrare e altre opzioni di controllo usando l'elemento LinksControlOptions. Vedere Elementi LinksControlOptions. WebpageControl: viene usato per 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 né di un tipo di campo. . Specificare il contenuto e i collegamenti da visualizzare usando l'elemento WebpageControlOptions. Vedere Riferimento agli elementi XML WebpageControlOptions. WorkItemClassificationControl: viene usato per 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 usando questo tipo di dati. WorkItemLogControl: viene usato per visualizzare le informazioni sulla cronologia degli elementi di lavoro e i campi con il tipo di campo History. Nota Il campo System.History è l'unico campo che usa questo tipo di dati.Non è possibile definire un campo personalizzato usando questo tipo di dati. Per altre informazioni, vedere Specificare i controlli dei form elemento di lavoro. Nota È possibile usare 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 un controllo personalizzato.Per altre informazioni, vedere il sito Web Microsoft relativo ai controlli personalizzati di gestione elementi di lavoro.
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 con lunghezza compresa tra 1 e 255 caratteri visualizzata 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 e xxlarge.
LabelPosition	Attributo Control facoltativo. Specifica la posizione dell'etichetta rispetto ai dati del controllo. Specificare una stringa da uno dei valori riportati di seguito. Top: l'etichetta viene posizionata sopra i dati del controllo. Bottom: l'etichetta viene posizionata sotto i dati del controllo. Left: l'etichetta viene posizionata a sinistra dei dati del controllo. Right: l'etichetta viene posizionata a destra dei dati del controllo.
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 valori riportati di seguito. 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 deve essere occupata dal controllo 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 mantenere la dimensione minima.Senza questo attributo, i controlli vengono disegnati con le dimensioni predefinite, a meno che non venga occupato più spazio dai controlli nelle altre schede.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 Usare 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 usato con FieldControl. Specifica i caratteri che è possibile immettere nel controllo del campo. Di seguito sono riportati i valori validi che è possibile usare. 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 usato con FieldControl. Specifica la lunghezza massima dei caratteri consentiti per un controllo del campo. Il tipo dell'attributo è xs:integer.
Format	Attributo Control facoltativo valido solo quando viene usato con DateTimeControl. Specifica il formato per il campo di data e ora corrispondente a uno dei valori dell'enumerazione DateTimePickerFormat. Di seguito sono riportati i valori validi che è possibile usare. Custom: viene visualizzato il valore di data/ora in un formato personalizzato. È possibile impostare il formato personalizzato specificando "Custom" come valore per l'attributo Format e impostando un altro attributo denominato CustomFormat per una stringa con formato personalizzato. Ad esempio: Format="Custom" CustomFormat = "MMM gg, 'dell'anno' aaaa" Per altre informazioni, vedere il sito Web Microsoft Proprietà DateTimePicker.CustomFormat. Long: viene visualizzato il valore di data/ora nel formato data estesa impostato dal sistema operativo dell'utente. Short: vene visualizzato il valore di data/ora nel formato data breve impostato dal sistema operativo dell'utente. Time: viene visualizzato il valore di data/ora nel formato dell'ora impostato dal sistema operativo dell'utente. Per altre informazioni, vedere il sito Web Microsoft Enumerazione DateTimePickerFormat.
CustomFormat	Attributo Control facoltativo valido solo quando viene usato con DateTimeControl e l'attributo Format. Specifica il formato personalizzato per il campo di data e ora corrispondente alla sintassi definita per la proprietà DateTimePicker.CustomFormat. Per altre 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 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 altre informazioni, vedere Riferimento agli elementi XML LabelText e Text e Fornire testo della Guida, collegamenti ipertestuali o contenuto Web su un form elemento di lavoro.
Collegamento	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 altre informazioni, vedere Riferimento agli elementi XML Link e Param e Fornire testo della Guida, collegamenti ipertestuali o contenuto Web su 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 altre informazioni, vedere Definire i controlli dei collegamenti per limitare le relazioni di collegamento.
WebpageControlOptions	Elemento facoltativo. È possibile specificare questo elemento quando l'attributo Type è WebpageControl. Specifica i controlli mediante i quali viene regolato il caricamento della destinazione della pagina Web nel form dell'elemento di lavoro. Per altre informazioni, vedere Riferimento agli elementi XML WebpageControlOptions e Fornire testo della Guida, collegamenti ipertestuali o contenuto Web su un form elemento di lavoro.
anyAttribute	Elemento facoltativo. Facoltativo. Control è estensibile tramite l'utilizzo dell'elemento anyAttribute.

Elementi padre

Elemento	Descrizione
Layout	Obbligatorio. Definisce la modalità di visualizzazione degli elementi nel form dell'elemento di lavoro.
Elemento Column	Obbligatorio. Definisce colonne per il form.
Elemento Tab	Obbligatorio. Definisce una scheda per il form.

Note

Control è un elemento figlio facoltativo di 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 altre informazioni, vedere il sito Web Microsoft relativo ai controlli personalizzati di gestione elementi di lavoro.

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

Esempio

<Control Type=" WorkItemClassificationControl " FieldName="System.AreaPath"
  Label="Area" LabelPosition="Left" Padding="(2,0,2,0)" Margin="(2,2,2,2)" />

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