Condividi tramite


Specificare controlli dei form elemento di lavoro

È possibile utilizzare le informazioni fornite in questo argomento come un riferimento rapido per l'elemento Control e per gli elementi figlio e gli attributi di tale elemento.Per ogni campo o controllo del form che si desidera visualizzare su un form elemento di lavoro, è necessario aggiungere un elemento Control.È possibile personalizzare un form elemento di lavoro per visualizzare informazioni che consentono al team di utilizzare correttamente il form.È inoltre possibile aggiungere i controlli e i campi elemento di lavoro che consentono di immettere e visualizzare i dati di cui si desidera tenere traccia.L'elemento Control fornisce nove valori per l'attributo Type che possono essere utilizzati per aggiungere campi o per visualizzare testo normale, collegamenti ipertestuali o campi.È inoltre possibile definire controlli speciali per aggiungere collegamenti e allegati, visualizzare contenuto basato su Web o creare un controllo personalizzato e aggiungerlo al form elemento di lavoro.

In questo argomento

  • Aggiunta di campi elemento di lavoro a un form elemento di lavoro

  • Aggiunta di controlli speciali a un form elemento di lavoro

  • Aggiunta di controlli personalizzati a un form elemento di lavoro

Aggiunta di campi elemento di lavoro a un form elemento di lavoro

Quando si personalizza il form elemento di lavoro, si aggiunge in genere un sottoinsieme dei campi elemento di lavoro definito per il tipo di elemento di lavoro che si desidera visualizzare sul form.Le definizioni dei campi controllano molti aspetti relativi ai dati che vengono visualizzati e ai dati che possono essere inseriti nel form.Per ulteriori informazioni, vedere Definire campi elemento di lavoro.

A ogni campo elemento di lavoro è associato un tipo di dati.È possibile utilizzare le informazioni riportate nella tabella seguente per determinare il tipo di campo supportato dall'attributo Type dell'elemento Control.L'attributo Label consente di specificare il testo da visualizzare accanto al controllo.L'attributo LabelPosition correlato consente di specificare la posizione dell'etichetta rispetto al controllo.Per ulteriori informazioni, vedere Controllare la visualizzazione dei campi elemento di lavoro.

[!NOTA]

Non è possibile modificare i valori dei campi di sistema, che vengono aggiornati automaticamente.Ad esempio, i campi Data creazione e Creato Da vengono definiti quando un elemento di lavoro viene salvato la prima volta.È possibile tuttavia utilizzare questi campi nei criteri di ricerca.Per una descrizione di ciascun campo di sistema, vedere Riferimento ai campi degli elementi di lavoro per ALM di Visual Studio.

Tipo di campo

Attributo Type dell'elemento Control

Utilizzo

DateTime

FieldControl

DateTimeControl

Utilizzare FieldControl per fornire un campo di testo per l'input o la visualizzazione di un campo per il tipo di dati DateTime.

<Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" Label="Start Date" LabelPosition="Left" />

Utilizzare DateTimeControl per consentire la selezione di una data del calendario per un campo, come illustrato nella figura seguente.

Campo del calendario
<Control Type="DateTimeControl" FieldName="MyCompany.Group.ScheduleStart" Label="Scheduling Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />

Double

FieldControl

Utilizzare FieldControl per fornire un campo di testo per l'input o la visualizzazione di campi Double.

<Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />

History

WorkItemLogControl

Utilizzare WorkItemLogControl per fornire un campo di controllo per i campi Cronologia che tengono traccia dei thread di discussione e di altre informazioni cronologiche, come illustrato nella figura seguente.

Scheda e campo della cronologia nel form dell'elemento di lavoro.

È possibile utilizzare questo controllo solo per supportare la visualizzazione del campo della cronologia di un elemento di lavoro, ovvero il campo elemento di lavoro System.History.Tramite questo controllo è possibile espandere e comprimere i dettagli relativi alle revisioni cronologiche apportate a un elemento di lavoro.È inoltre possibile formattare il testo che si aggiunge al campo della cronologia.

<Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description
and History" LabelPosition="Top" Dock="Fill" />

HTML

HTMLControl

Utilizzare HTMLControl per fornire un campo di controllo che consente ai campi HTML di acquisire il formato rich text, come illustrato nella figura seguente.

Campo HTML visualizzato nel form dell'elemento di lavoro.
<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />

Integer

FieldControl

Utilizzare FieldControl per fornire un campo di controllo per un campo Integer.

<Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />

PlainText

FieldControl

Utilizzare FieldControl per fornire un campo di controllo per un campo di testo normale come, ad esempio, una casella di testo contenente descrizioni che potrebbero superare i 255 caratteri.

<Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />

String

FieldControl

Utilizzare FieldControl per fornire un campo di controllo per un campo String.I campi String sono limitati a 255 caratteri.

<Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />

TreePath

WorkItemClassificationControl

Utilizzare WorkItemClassificationControl per fornire un campo di controllo per un campo TreePath.

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

ms194985.collapse_all(it-it,VS.110).gifAttributi di campo facoltativi dell'elemento Control per tutti i tipi di controllo

È possibile specificare gli attributi facoltativi riportati di seguito solo per i tipi di controllo elencati:

Attributo

Descrizione

Field

Specifica il controllo associato al campo dell'elemento di lavoro.

Label

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

NotaNota
È possibile associare un collegamento ipertestuale all'etichetta di un campo aggiunto al form elemento di lavoro tramite FieldControl.Questo controllo è utile per fornire un collegamento alle informazioni relative al modo in cui viene utilizzato il campo.Per ulteriori informazioni, vedere Fornire il testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro.

LabelPosition

Specifica la posizione dell'etichetta rispetto ai dati del controllo.Specificare una stringa contenente uno dei valori seguenti: Top, Bottom, Left e Right.

Dock

Specifica l'allineamento dell'etichetta al lato specificato del contenitore o estende il campo per riempire il contenitore.Specificare una stringa contenente uno dei valori seguenti: Fill, Top, Bottom, Left e Right.

Padding

Specifica la quantità di spazio in pixel intorno al bordo interno del controllo.Vengono forniti quattro valori corrispondenti ai margini superiore, inferiore, sinistro e destro.ad esempio 2,0,2,0.

Margin

Specifica la quantità di spazio in pixel intorno al bordo esterno del controllo.Vengono forniti quattro valori corrispondenti ai margini superiore, inferiore, sinistro e destro.ad esempio 2,0,2,0.

ReadOnly

Specifica se il campo è di sola lettura.Specificare True o False.

MinimumSize

Specifica la dimensione minima in pixel che il controllo deve occupare nel form.Vengono specificati due valori corrispondenti alla larghezza e all'altezza.ad esempio 100,100.

Name

Identifica un controllo in modo univoco.L'attributo Name è necessario se più di un controllo del form viene associato allo stesso campo elemento di lavoro.

NotaNota
Utilizzare l'attributo Name per visualizzare lo stesso campo in più aree 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.

ms194985.collapse_all(it-it,VS.110).gifAttributi di campo facoltativi dell'elemento Control per tipi di controllo specifici

È possibile specificare gli attributi facoltativi riportati di seguito solo per i tipi di controllo elencati:

Attributo

Tipi di controllo

Descrizione

NumberFormat

FieldControl

Specifica i caratteri che è possibile immettere nel controllo del campo.Sono validi i seguenti valori: WholeNumbers, SignedWholeNumbers, DecimalNumbers e SignedDecimalNumbers.

MaxLength

FieldControl

Specifica la lunghezza massima dei caratteri consentiti in un controllo del campo.

Format

DateTimeControl

Specifica il formato per il campo data e ora corrispondente a uno dei valori dell'enumerazione DateTimePickerFormat.Sono validi i seguenti valori: Custom, Long, Short, Time.

CustomFormat

DateTimeControl

Specifica il formato personalizzato utilizzato per il campo data e ora corrispondente alla sintassi definita per la proprietà DateTimePicker.CustomFormat.

Aggiunta di controlli speciali a un form elemento di lavoro

Nella tabella riportata di seguito vengono descritti gli attributi Type dell'elemento Control che consentono di gestire allegati di file, creare collegamenti, visualizzare contenuto Web e visualizzare altri dati non associati a un campo elemento di lavoro.

Attributo Type dell'elemento Control

Utilizzo

AttachmentsControl

Consente di allegare file a un form elemento di lavoro.Questo controllo è contenuto generalmente in un gruppo di schede separato, come illustrato nella figura seguente.

AttachmentsControl

Esempio di controllo Attachments

Per ulteriori informazioni, vedere Aggiungere il controllo allegati.

LabelControl

Utilizzare per visualizzare testo normale o testo con collegamento ipertestuale non associato a un campo, come illustrato nella figura seguente.

Esempio di due collegamenti ipertestuali applicati al testo

Utilizzare gli elementi figlio e contenitore, LabelText e Link, 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 Fornire il testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro, Riferimento agli elementi XML LabelText e Text e Riferimento agli elementi XML Link e Param.

LinksControl

Consente di creare e gestire collegamenti tra elementi di lavoro.Questo controllo è contenuto generalmente in un gruppo di schede separato, come illustrato nella figura seguente.

Esempio di controllo dei collegamenti aggiunto a un form di elemento di lavoro

Utilizzare LinksControlOptions per definire i filtri dei collegamenti e il layout dei campi colonna utilizzati per visualizzare l'elenco di collegamenti.Per ulteriori informazioni, vedere Definire i controlli dei collegamenti per limitare le relazioni di collegamento e Elementi LinksControlOptions.

WebpageControl

Consente di visualizzare contenuto Web in un form elemento di lavoro.Questo controllo è in genere contenuto in un gruppo di schede separato.Utilizzare gli elementi figlio WebpageControlOptions e Link per specificare i controlli richiesti per caricare la destinazione della pagina Web nel form elemento di lavoro.

Per ulteriori informazioni, vedere Aggiungere contenuto Web a un form elemento di lavoro, Riferimento agli elementi XML WebpageControlOptions e Riferimento agli elementi XML Link e Param.

Aggiunta di controlli personalizzati a un form elemento di lavoro

Oltre ai controlli incorporati, è possibile aggiungere un controllo personalizzato a un form elemento di lavoro.

È possibile ad esempio aggiungere un controllo personalizzato per acquisire una schermata degli Appunti.Oppure è possibile fornire un controllo per acquisire più valori aggiungendo una casella di controllo per i valori presenti in un elenco o in un menu.

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

Vedere anche

Attività

Aggiungere e personalizzare un tipo di elemento di lavoro

Modificare il layout del form elemento di lavoro

Modificare l'etichetta di un campo

Riferimenti

Riferimento all'elemento XML Control

Concetti

Progettare e personalizzare un form elemento di lavoro

Altre risorse

Aggiungere contenuto Web a un form elemento di lavoro