Condividi tramite

Panoramica del controllo ProgressBar (Windows Forms)

  • Articolo

Importante

Il controllo ToolStripProgressBar sostituisce e aggiunge funzionalità al controllo ProgressBar; Tuttavia, il controllo ProgressBar viene mantenuto sia per la compatibilità con le versioni precedenti che per l'uso futuro, se si sceglie.

Il controllo ProgressBar Windows Form indica lo stato di avanzamento di un processo visualizzando un numero appropriato di rettangoli disposti in una barra orizzontale. Al termine del processo, la barra è completamente riempita. Le barre di stato vengono comunemente usate per dare all'utente un'idea del tempo di attesa del completamento di un processo; ad esempio, quando viene caricato un file di grandi dimensioni.

Nota

Il controllo ProgressBar può essere orientato solo orizzontalmente nel form.

Proprietà e metodi chiave

Le proprietà chiave del controllo ProgressBar sono Value, Minimume Maximum. Le proprietà Minimum e Maximum impostano i valori massimi e minimi che la barra di stato può visualizzare. La proprietà Value rappresenta lo stato di avanzamento verso il completamento dell'operazione. Poiché la barra visualizzata nel controllo è costituita da blocchi, il valore visualizzato dal controllo ProgressBar approssima solo il valore corrente della proprietà Value. In base alle dimensioni del controllo ProgressBar, la proprietà Value determina quando visualizzare il blocco successivo.

Il modo più comune per aggiornare il valore di stato corrente consiste nel scrivere codice per impostare la proprietà Value. Nell'esempio di caricamento di un file di grandi dimensioni, è possibile impostare la dimensione massima del file in kilobyte. Ad esempio, se la proprietà Maximum è impostata su 100, la proprietà Minimum è impostata su 10 e la proprietà Value è impostata su 50, verranno visualizzati 5 rettangoli. Si tratta della metà del numero che può essere visualizzato.

Esistono tuttavia altri modi per modificare il valore visualizzato dal controllo ProgressBar, oltre a impostare direttamente la proprietà Value. La proprietà Step può essere utilizzata per specificare un valore per incrementare la proprietà Value. Quindi, la chiamata al metodo PerformStep incrementerà il valore. Per variare il valore di incremento, è possibile utilizzare il metodo Increment e specificare un valore con cui incrementare la proprietà Value.

Un altro controllo che informa graficamente l'utente di un'azione corrente è il controllo StatusBar.

Importante

I controlli StatusStrip e ToolStripStatusLabel sostituiscono e aggiungono funzionalità ai controlli StatusBar e StatusBarPanel; Tuttavia, i controlli StatusBar e StatusBarPanel vengono mantenuti sia per la compatibilità con le versioni precedenti che per l'uso futuro, se si sceglie.

Vedere anche