Cenni preliminari sul controllo ProgressBar (Windows Form)
.gif "Nota importante") Importante |
|---|
Benché il controllo ToolStripProgressBar sostituisca il controllo ProgressBar delle versioni precedenti aggiungendo funzionalità, il controllo ProgressBar viene mantenuto per compatibilità con le versioni precedenti e per utilizzo futuro se lo si desidera. |
Il controllo ProgressBar Windows Form indica lo stato di avanzamento di un processo visualizzando un numero appropriato di rettangoli in una barra orizzontale. Quando l'operazione è stata completata, la barra appare piena. Gli indicatori di stato sono in genere utilizzati per dare all'utente l'idea del tempo necessario per il completamento di un processo, ad esempio il caricamento di un file di grandi dimensioni.
Nota
Il controllo ProgressBar può essere orientato solo in orizzontale sul form.
Proprietà e metodi principali
Le proprietà principali del controllo ProgressBar sono Value, Minimum e Maximum. Le proprietà Minimum e Maximum consentono di impostare i valori massimo e minimo visualizzabili sull'indicatore di stato. La proprietà Value rappresenta l'avanzamento compiuto verso il completamento dell'operazione. Poiché la barra visualizzata nel controllo è composta da blocchi, il valore visualizzato dal controllo ProgressBar rappresenta solo un'approssimazione del valore corrente della proprietà Value. In base alle dimensioni del controllo ProgressBar, la proprietà Value determina quando visualizzare il blocco successivo.
Il metodo più comune per aggiornare il valore corrente dell'avanzamento prevede la creazione di codice per impostare la proprietà Value. Nell'esempio del caricamento di un file di grandi dimensioni, si potrebbe impostare il valore massimo sulle dimensioni del file in kilobyte. Se ad esempio la proprietà Maximum è impostata su 100, la proprietà Minimum su 10 e la proprietà Value su 50, verranno visualizzati 5 rettangoli, ovvero la metà del numero di rettangoli visualizzabili.
Esistono tuttavia altri modi per modificare il valore visualizzato dal controllo ProgressBar, oltre all'impostazione diretta della proprietà Value. È infatti possibile utilizzare la proprietà Step per specificare il valore di cui incrementare la proprietà Value, quindi incrementare il valore chiamando il metodo PerformStep. Per modificare il valore dell'incremento, è possibile utilizzare il metodo Increment e specificare il valore di cui incrementare la proprietà Value.
Un altro controllo che informa graficamente l'utente su un'operazione in corso è il controllo StatusBar.
| Importante |
|---|
Benché i controlli StatusStrip e ToolStripStatusLabel sostituiscano i controlli StatusBar e StatusBarPanel delle versioni precedenti aggiungendo funzionalità, i controlli StatusBar e StatusBarPanel vengono mantenuti per compatibilità con le versioni precedenti e per utilizzo futuro se lo si desidera. |