Procedura dettagliata: gestione di eventi

Articolo
09/12/2008

Aggiornamento: novembre 2007

In questo argomento viene illustrato l'utilizzo degli eventi. In un argomento precedente, Procedura dettagliata: dichiarazione e generazione di eventi, sono fornite informazioni sulla dichiarazione e sulla generazione di eventi. In questa sezione il form e la classe creati nella prima procedura dettagliata verranno utilizzati per descrivere la gestione degli eventi nel momento in cui si verificano.

Nella classe Widget dell'esempio vengono utilizzate le istruzioni di gestione degli eventi tradizionali. In Visual Basic sono tuttavia disponibili altre tecniche di elaborazione degli eventi. Come esercitazione è possibile modificare questo esempio utilizzando le istruzioni AddHandler e Handles.

Digitare il codice riportato di seguito in Form1:
```
Private WithEvents mWidget As Widget
Private mblnCancel As Boolean
```
Utilizzando la parola chiave WithEvents è possibile specificare che la variabile mWidget viene utilizzata per la gestione degli eventi di un oggetto. Per specificare il tipo di oggetto è necessario fornire il nome della classe da cui l'oggetto verrà creato.

La variabile mWidget viene dichiarata in Form1 perché le variabili WithEvents possono essere solo di livello classe, indipendentemente dal tipo di classe in cui sono contenute.

La variabile mblnCancel viene utilizzata per annullare il metodo LongTask.

Scrittura di codice per la gestione di un evento

Non appena una variabile viene dichiarata tramite WithEvents, il nome della variabile viene visualizzato nella casella di riepilogo a discesa sinistra dell'editor di codice della classe. Quando si seleziona mWidget, gli eventi della classe Widget vengono visualizzati nella casella di riepilogo a discesa destra. Se si seleziona un evento, verrà visualizzata la corrispondente routine evento, con il prefisso mWidget e un carattere di sottolineatura. A tutte le routine evento associate alla variabile WithEvents viene assegnato come prefisso il nome della variabile.

Per gestire un evento

Selezionare mWidget dalla casella di riepilogo a discesa sinistra nell'editor di codice.

Selezionare l'evento PercentDone dalla casella di riepilogo a discesa destra. Verrà aperta la routine dell'evento mWidget_PercentDone.

Nota:
L'editor di codice è utile ma non obbligatorio per l'inserimento di nuovi gestori eventi. Nella seguente procedura dettagliata, è più semplice copiare i gestori eventi direttamente nel codice.

Aggiungere il codice seguente al gestore eventi mWidget_PercentDone:
```
Private Sub mWidget_PercentDone( _
    ByVal Percent As Single, _
    ByRef Cancel As Boolean _
) Handles mWidget.PercentDone
    lblPercentDone.Text = CInt(100 * Percent) & "%"
    My.Application.DoEvents()
    If mblnCancel Then Cancel = True
End Sub
```
Ogni volta che viene generato l'evento PercentDone, la percentuale di completamento in un controllo Labelviene visualizzato dalla routine dell'evento. Il metodo DoEvents consente di ridisegnare l'etichetta e di fare clic sul pulsante Annulla.

Aggiungere il codice seguente al gestore eventi Button2_Click:

Private Sub Button2_Click( _
    ByVal sender As Object, _
    ByVal e As System.EventArgs _
) Handles Button2.Click
    mblnCancel = True
End Sub

Se l'utente fa clic sul pulsante Annulla durante l'esecuzione di LongTask, l'evento Button2_Click viene eseguito non appena l'istruzione DoEvents consente l'elaborazione degli eventi. La variabile a livello di classe mblnCancel viene impostata su True. L'evento mWidget_PercentDone verifica tale variabile, quindi imposta l'argomento ByRef Cancel su True.

Collegamento di una variabile WithEvents a un oggetto

Form1 è stato impostato per la gestione degli eventi dell'oggetto Widget. È ora necessario individuare Widget.

Quando si dichiara una variabile utilizzando WithEvents in fase di progettazione, a tale variabile non è associato alcun oggetto. Una variabile WithEvents non si differenzia dalle altre variabili oggetto. È necessario creare un oggetto e assegnare il relativo riferimento alla variabile WithEvents.

Per creare un oggetto e assegnare un riferimento a tale oggetto

Selezionare (Form1 Events) dalla casella di riepilogo a discesa sinistra nell'editor di codice.
Selezionare l'evento Load dalla casella di riepilogo a discesa destra. Verrà aperta la routine dell'evento mWidget_PercentDone.

Aggiungere il seguente codice per la routine dell'evento Form1_Load in modo da creare Widget:

Private Sub Form1_Load( _
    ByVal sender As System.Object, _
    ByVal e As System.EventArgs _
) Handles MyBase.Load
    mWidget = New Widget
End Sub

All'esecuzione del codice verrà creato un oggetto Widget e i relativi eventi verranno collegati alle routine evento associate a mWidget. Da quel momento in poi la routine evento mWidget_PercentDone verrà eseguita ad ogni generazione dell'evento PercentDone da parte dell'oggetto Widget.

Per chiamare il metodo LongTask

Aggiungere il codice seguente al gestore eventi Button1_Click:

Private Sub Button1_Click( _
    ByVal sender As Object, _
    ByVal e As System.EventArgs _
) Handles Button1.Click
    mblnCancel = False
    lblPercentDone.Text = "0%"
    lblPercentDone.Refresh()
    mWidget.LongTask(12.2, 0.33)
    If Not mblnCancel Then lblPercentDone.Text = CStr(100) & "%"
End Sub

Prima che venga chiamato il metodo LongTask è necessario inizializzare l'etichetta che riporta la percentuale di completamento e impostare su False il flag Boolean a livello di classe per l'annullamento del metodo.

Il metodo LongTask viene chiamato con una durata di attività pari a 12,2 secondi. L'evento PercentDone viene generato con intervalli pari a un terzo di secondo. A ogni generazione dell'evento viene eseguita la routine mWidget_PercentDone.

Una volta completato il metodo LongTask, mblnCancel viene verificato per controllare se LongTask è stato completato correttamente o se è stato arrestato perché mblnCancel è stato impostato su True. La percentuale di completamento viene aggiornata solo nel primo caso.

Per eseguire il programma

Premere F5 per mettere il progetto in modalità di esecuzione.
Fare clic sul pulsante Inizia attività. A ogni generazione dell'evento PercentDone, la percentuale di completamento dell'attività riportata sull'etichetta viene aggiornata.

Fare clic sul pulsante Annulla per arrestare l'attività. Si noti che l'aspetto del pulsante Annulla non viene modificato nel momento stesso in cui si fa clic su di esso. L'evento Click si verifica solo dopo che l'istruzione My.Application.DoEvents consente l'elaborazione dell'evento.

Nota:
Per l'elaborazione degli eventi, il metodo My.Application.DoEvents si comporta in modo leggermente diverso rispetto al form. Nella procedura dettagliata, ad esempio, è necessario fare clic due volte sul pulsante Annulla. Per consentire al form di gestire gli eventi direttamente, è possibile ricorrere al multithreading. Per ulteriori informazioni, vedere Multithreading in Visual Basic.

È possibile premere F11 e scorrere il codice una riga alla volta. Si può chiaramente notare come a ogni generazione dell'evento PercentDone viene immesso LongTask, quindi viene velocemente reimmesso Form1.

Se il metodo LongTask viene chiamato a ogni generazione dell'evento e viene richiamato mentre l'esecuzione è ancora nel codice di Form1, nella peggiore delle ipotesi è possibile che si verifichi un overflow dello stack.

Al nuovo oggetto Widget è possibile assegnare un riferimento a mWidget in modo che la variabile mWidget gestisca eventi per un oggetto Widget diverso. È infatti possibile impostare il codice in Button1_Click in modo che questa operazione venga eseguita ogni volta che si fa clic sul pulsante.

Aggiungere la seguente riga di codice alla routine Button1_Click, che precede direttamente la riga mWidget.LongTask(12.2, 0.33):
```
mWidget = New Widget
' Create a new Widget object.
```

Utilizzando questo codice è possibile creare un nuovo oggetto Widget ogni volta che si fa clic sul pulsante. Non appena il metodo LongTask viene completato, il riferimento all'oggetto Widget viene rilasciato e tale oggetto viene eliminato.

Una variabile WithEvents è in grado di contenere un solo riferimento oggetto alla volta. Se quindi si assegna un oggetto Widget diverso a mWidget, gli eventi del precedente oggetto Widget non verranno più gestiti. Se mWidget è l'unica variabile oggetto che contiene un riferimento all'oggetto Widget precedente, tale oggetto verrà eliminato. Se si desidera gestire eventi da svariati oggetti Widget, è necessario utilizzare l'istruzione AddHandler per elaborare separatamente gli eventi relativi a ogni oggetto.

Nota:
È possibile dichiarare tutte le variabili WithEvents necessarie. Tuttavia, le matrici di variabili WithEvents non sono supportate.

Vedere anche

Condividi tramite

Procedura dettagliata: gestione di eventi

Per gestire l'evento PercentDone della classe Widget

Scrittura di codice per la gestione di un evento

Per gestire un evento

Collegamento di una variabile WithEvents a un oggetto

Per creare un oggetto e assegnare un riferimento a tale oggetto

Per chiamare il metodo LongTask

Per eseguire il programma

Per gestire eventi per un oggetto Widget diverso

Vedere anche

Attività

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive