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 Specifica dei controlli dei form elemento di lavoro. Per ulteriori informazioni, vedere Progettazione e personalizzazione di 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" 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 illustrati attributi, elementi figlio e padre.
Attributi
Attribute |
Oggetto di descrizione |
---|---|
FieldName |
Attributo ControlType 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 ControlType 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:
Per ulteriori informazioni, vedere Specifica dei 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).
|
Label |
Attributo ControlType facoltativo. Specifica il testo visibile sul form che identifica il controllo. Specificare una stringa composta da un massimo di 80 caratteri. |
LabelPosition |
Attributo ControlType facoltativo. Specifica la posizione dell'etichetta rispetto ai dati del controllo. Specificare una stringa da uno dei seguenti valori:
|
Dock |
Attributo ControlType 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:
|
Padding |
Attributo ControlType 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 ControlType 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 ControlType facoltativo. Specifica se il campo è di sola lettura. Il tipo dell'attributo è ReadOnlyType. Specificare una stringa da uno dei seguenti valori:
|
MinimumSize |
Attributo ControlType 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 ControlType 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 ControlType 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:
|
MaxLength |
Attributo ControlType 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 ControlType 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:
Per ulteriori informazioni, vedere il sito Web Microsoft: Enumerazione DateTimePickerFormat. |
CustomFormat |
Attributo ControlType 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 |
Oggetto di descrizione |
---|---|
Elemento facoltativo. È possibile specificare questo elemento quando ControlType 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 Fornitura di Testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro. |
|
Elemento facoltativo. È possibile specificare questo elemento quando ControlType 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 Fornitura di Testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro. |
|
Elemento facoltativo. È possibile specificare questo elemento quando ControlType is specified as LinksControl. Definisce i filtri dei collegamenti e il layout dei campi colonna per visualizzare l'elenco di collegamenti. Per ulteriori informazioni, vedere Definizione dei controlli dei collegamenti per limitare le relazioni di collegamento. |
|
Elemento facoltativo. È possibile specificare questo elemento quando ControlType is 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 Fornitura di Testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro. |
|
anyAttribute |
Elemento facoltativo. Facoltativo. ControlType è estensibile tramite l'utilizzo dell'elemento anyAttribute. ProcessContents: ignorare. |
Elementi padre
Elemento |
Oggetto di descrizione |
---|---|
Obbligatoria. Definisce la modalità di visualizzazione degli elementi nel form dell'elemento di lavoro. |
|
ElementoColumn |
Obbligatoria. Definisce colonne per il form. |
Elemento Tab |
Obbligatoria. 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 Specifica dei 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
Progettazione e personalizzazione di un form elemento di lavoro
Riferimento a tutti gli elementi XML FORM
Specifica dei controlli dei form elemento di lavoro
Cronologia delle modifiche
Data |
Cronologia |
Motivo |
---|---|---|
Gennaio 2011 |
Elementi figlio aggiunti alla sintassi, collegamenti rimossi o sostituiti ad argomenti rimossi. |
Miglioramento delle informazioni. |