Difficoltà: 3 / 5

Il controllo FBI Graph Progress Bar prende spunto dal controllo FBI Shape Progress Bar realizzando una barra di avanzamento diventata famosa nei programmi di installazione, con la possibilità di invertire il colore del testo man mano che questo viene raggiunto dal colore di riempimento.

Prende il nome di barra di avanzamento grafica perché utilizza alcune istruzioni grafiche proprie di Visual Basic e non utilizza alcun controllo per effettuare tali operazioni; la barra di fatto consiste nella sola superficie del controllo utente.

Proprietà

Utilizzabile in fase di progettazione

Accessibile in lettura in fase di esecuzione

Accessibile in scrittura in fase di esecuzione

• Alignment As AlignmentConstants
  Restituisce o imposta il valore dell'allineamento del testo all'interno della barra di avanzamento.
  Determina la posizione del testo all'interno della barra colorata utilizzando un valore dell'enumerazione AlignmentConstants.
  
  
• BackColor As OLE_COLOR
  Restituisce o imposta il colore di sfondo utilizzato per la visualizzazione di testo e grafica in un oggetto.
  Utilizzato soltanto quando la proprietà DefaultColorMode è impostata su False.
  
  
• Caption As String
  Restituisce il testo contenuto nella barra di avanzamento.
  
  
• DefaultColorMode As Boolean
  Restituisce o imposta un valore corrispondente alla modalità di colorazione della barra.
  Se impostata su True utilizza i colori predefiniti della barra (bianco e blu) mentre se impostata su False utilizza i valori delle proprietà BackColor, FillColor e ForeColor.
  
  
• FillColor As OLE_COLOR
  Restituisce o imposta il colore utilizzato per applicare riempimenti a forme, cerchi e caselle.
  Utilizzato soltanto quando la proprietà DefaultColorMode è impostata su False.
  
  
• Font As StdFont
  Restituisce ed imposta il tipo di carattere utilizzato per la Caption della barra di avanzamento.
  
  
• ForeColor As OLE_COLOR
  Restituisce o imposta il colore di primo piano utilizzato per la visualizzazione di testo e grafica in un oggetto.
  Corrisponde al colore del testo visualizzato sulla barra di avanzamento. Utilizzato soltanto quando la proprietà DefaultColorMode è impostata su False.
  
  
• Format As String
  Definisce la regola per la visualizzazione del testo nella barra di avanzamento.
  Consente la personalizzazione del testo contenuto nella barra di avanzamento mediante l'utilizzo di particolari token corrispondenti ai valori della barra.
  
  
• hDC As Long
  Restituisce un handle fornito in Microsoft Windows al contesto di periferica di un oggetto.
  
  
• hWnd As Long
  Restituisce un handle (da Microsoft Windows) alla finestra di un oggetto.
  
  
• Max As Double
  Restituisce ed imposta il valore massimo per la barra di avanzamento.
  
  
• Min As Double
  Restituisce ed imposta il valore minimo per la barra di avanzamento.
  
  
• MouseIcon As StdPicture
  Restituisce ed imposta un puntatore personalizzato per la barra di avanzamento.
  
  
• MousePointer As MousePointerConstants
  Restituisce ed imposta il tipo di puntatore visualizzato sulla barra di avanzamento.
  
  
• Value As Double
  Restituisce o imposta il valore corrente della proprietà Value di un controllo.
  
  

Metodi

• AboutBox
  

  Tipo di metodo:	Sub
  Parametri richiesti:	(nessuno)
  Definizione:	Sub AboutBox()

  Informazioni sul controllo.
  
  
• Refresh
  

  Tipo di metodo:	Sub
  Parametri richiesti:	(nessuno)
  Definizione:	Sub Refresh()

  Aggiorna l'aspetto grafico del controllo.
  
  

Eventi

• Changed
  

  Parametri richiesti:	ByVal oldValue As Long
  Definizione:	Event Changed(ByVal oldValue As Long)

  Generato ogni volta che il valore della barra viene modificato.
  
  
• Click
  

  Parametri richiesti:	(nessuno)
  Definizione:	Event Click()

  Viene generato quando si preme e quindi si rilascia un pulsante del mouse su un oggetto.
  
  
• DblClick
  

  Parametri richiesti:	(nessuno)
  Definizione:	Event DblClick()

  Viene generato quando si preme e si rilascia due volte in rapida successione un pulsante del mouse su un oggetto.
  
  
• Error
  

  Parametri richiesti:	ByVal Errore As String ByRef Cancel As Boolean
  Definizione:	Event Errore(ByVal Errore As String, ByRef Cancel As Boolean)

  Viene generato quando si verifica un errore.
  
  
• Massimo
  

  Parametri richiesti:	(nessuno)
  Definizione:	Event Massimo()

  Evento generato quando la proprietà Value raggiunge il valore Max.
  
  
• Minimo
  

  Parametri richiesti:	(nessuno)
  Definizione:	Event Minimo()

  Evento generato quando la proprietà Value raggiunge il valore Min.
  
  
• MouseDown
  

  Parametri richiesti:	ByVal Button As Integer ByVal Shift As Integer ByVal X As Single ByVal Y As Single
  Definizione:	Event MouseDown(ByVal Button As Integer, ByVal Shift As Integer, ByVal X As Single, ByVal Y As Single)

  Viene generato quando si preme il pulsante del mouse mentre lo stato attivo si trova su un oggetto.
  
  
• MouseMove
  

  Parametri richiesti:	ByVal Button As Integer ByVal Shift As Integer ByVal X As Single ByVal Y As Single
  Definizione:	Event MouseMove(ByVal Button As Integer, ByVal Shift As Integer, ByVal X As Single, ByVal Y As Single)

  Viene generato quando si sposta il mouse.
  
  
• MouseUp
  

  Parametri richiesti:	ByVal Button As Integer ByVal Shift As Integer ByVal X As Single ByVal Y As Single
  Definizione:	Event MouseUp(ByVal Button As Integer, ByVal Shift As Integer, ByVal X As Single, ByVal Y As Single)

  Viene generato quando si rilascia il pulsante del mouse mentre lo stato attivo si trova su un oggetto.
  
  

Note

La proprietà DefaultColorMode determina l'utilizzo dei colori predefiniti oppure dei colori a scelta dell'utente in base al valore delle proprietà BackColor, ForeColor e FillColor.

La figura a fianco mostra l'utilizzo della barra di avanzamento con la proprietà DefaultColorMode impostata a True. In base a tale impostazione il colore di sfondo è il bianco, il colore di riempimento è il blu mentre il colore del testo è inverso all'area di riempimento ovvero nelle aree già riempite il testo appare in bianco mentre nella zona non ancora riempita il testo è in blu.
Nella stessa figura è possibile vedere parte del numero 3 in bianco e parte in bianco.

Quest'altra figura mostra invece la stessa barra con i medesimi valori ma con la proprietà DefaultColorMode impostata su False. I colori utilizzati sono allora definiti dalle proprietà BackColor (grigio), FillColor (verde scuro), ForeColor (verde chiaro).
Se la proprietà DefaultColorMode è impostata su False l'inversione dei colori in corrispondenza alle aree riempite non avviene.

Per simulare la normale ProgressBardei Common Controls di Windows basterà utilizzare tali valori:

• DefaultColorMode = False
• BackColor = &H8000000F
• FillColor = &H8000000D
• ForeColor = &H8000000E
• Format = ""

La proprietà Format consente la personalizzazione del testo contenuto nella Caption della barra di avanzamento. Utilizza dei Token per assegnare i valori delle proprietà:

• $m = Proprietà Min
• $M = Proprietà Max
• $V = Proprietà Value
• $P = Percentuale intera

La barra qui mostrata, ad esempio, utilizza la proprietà Format definita come "Files copiati: $V di $M".
I token verranno sostituiti con i valori corrispondenti prima della rappresentazione grafica.

La stessa barra con i medesimi valori utilizza, in questa figura, la proprietà Format definita come "Avanzamento: $P".

Quest'ultima figura dimostra invece la combinazione dei due precedenti formati utilizzando la proprietà Format impostata su "Files copiati: $V di $M ($P)".

Fibia FBI
6 Marzo 2002

Scarica il progetto

Scarica il testo dell'articolo

Stampa l'articolo