Cenni preliminari sul controllo ProgressBar (Windows Form)

Importante

Benché il controllo ToolStripProgressBar sostituisca il controllo ProgressBar aggiungendovi funzionalità, il controllo ProgressBar viene mantenuto per compatibilità con le versioni precedenti e per un eventuale uso futuro.

Il controllo Windows Form ProgressBar 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 viene 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 ProgressBar controllo può essere orientato solo orizzontalmente nel form.

Proprietà e metodi chiave

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

Il modo più comune per aggiornare il valore di stato corrente consiste nel scrivere codice per impostare la Value proprietà. Nell'esempio di caricamento di un file di grandi dimensioni, è possibile impostare la dimensione massima del file in kilobyte. Ad esempio, se la Maximum proprietà è impostata su 100, la Minimum proprietà è impostata su 10 e la Value proprietà è 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 ProgressBar controllo, a parte impostare direttamente la Value proprietà. La Step proprietà può essere utilizzata per specificare un valore per incrementare la Value proprietà. Quindi, la chiamata al PerformStep metodo incrementerà il valore. Per variare il valore di incremento, è possibile usare il Increment metodo e specificare un valore con cui incrementare la Value proprietà.

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

Importante

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

Vedi anche