Passaggio 3: terminare il gioco

Per terminare il gioco, si aggiunge funzionalità all'etichetta Fine.Si procede aggiungendo un gestore dell'evento per l'evento MouseEnter dell'etichetta.

Nota

Se è stata completata l'esercitazione 1: creare un visualizzatore immagini, si conoscono già i gestori di eventi.La maggior parte dei controlli può generare molti eventi diversi.Per il visualizzatore immagini è stato utilizzato l'evento Click del controllo Button e l'evento CheckChanged del controllo CheckBox.In questa esercitazione si utilizza l'evento MouseEnter del controllo Label, che viene generato ogni volta che il puntatore del mouse accede al controllo.Il controllo Label dispone di più di quaranta eventi.I nomi della maggior parte di essi sono intuitivi, ad esempio DoubleClick, Resize e TextChanged.Un elenco di nomi di eventi verrà visualizzato in un secondo momento in questa esercitazione.

Per terminare il gioco

1. Selezionare il controllo finishLabel, quindi fare clic sull'icona Evento all'inizio della finestra Proprietà, la cui forma è simile a una saetta.Quando si fa clic su di essa, anziché visualizzare le proprietà del controllo vengono visualizzati gli eventi del controllo.È possibile tornare all'elenco di proprietà facendo clic sull'icona Proprietà.Per ora, non modificare la finestra Proprietà, nella quale sono visualizzati tutti gli eventi per il controllo finishLabel.Scorrere verso il basso fino all'evento MouseEnter.Le icone e l'evento MouseEnter vengono visualizzati nel modo seguente.

   Icona Evento

   

   Icona Proprietà

   

   Evento MouseEnter

   

2. Fare doppio clic sulla parola MouseEnter.A questo punto, l'IDE aggiunge automaticamente un metodo del gestore dell'evento al form e lo visualizza nell'editor di codice, come illustrato di seguito.

   Private Sub finishLabel_MouseEnter() Handles finishLabel.MouseEnter
   
   End Sub
   

   private void finishLabel_MouseEnter(object sender, EventArgs e)
   {
   
   }
   

   Questo metodo del gestore dell'evento viene eseguito ogni volta che il puntatore del mouse accede all'etichetta.

3. Si desidera che il programma apra una finestra di messaggio che visualizza "Congratulazioni", quindi si desidera che il programma venga chiuso.A tale scopo, aggiungere righe di codice (con un commento), come segue.

   Private Sub finishLabel_MouseEnter() Handles finishLabel.MouseEnter
   
       ' Show a congratulatory MessageBox, then close the form.
       MessageBox.Show("Congratulations!")
       Close()
   End Sub
   

   private void finishLabel_MouseEnter(object sender, EventArgs e)
   {
       // Show a congratulatory MessageBox, then close the form.
       MessageBox.Show("Congratulations!");
       Close();
   }
   

   Nota

   Il metodo finishLabel_MouseEnter() dispone di due istruzioni.La prima istruzione chiama un metodo denominato Show(), che visualizza una finestra di messaggio contenente il testo inserito all'interno delle parentesi.

4. È possibile ottenere ulteriori informazioni su quanto si sta verificando utilizzando l'IDE per esplorare il codice.Posizionare il puntatore del mouse sulla parola MessageBox.Verrà visualizzata la descrizione comando seguente.

   Descrizione comando

   

   Nota

   L'IDE mostra che esiste una classe denominata System.Windows.Forms.MessageBox e il metodo Show() chiamato si trova all'interno di tale classe.Non è necessaria una conoscenza approfondita per far funzionare la finestra di messaggio, ma alcune informazioni aggiuntive possono rivelarsi utili.

   Riguardo la seconda istruzione, ogni form dispone di un metodo incorporato denominato Close() che causa la chiusura del form.Alcuni programmi hanno diverse finestre tra le quali l'utente può spostarsi.Quando si utilizza un programma di questo tipo, la finestra corrente viene chiusa, ma il resto del programma continua a essere in esecuzione.Ad esempio, se diversi documenti Microsoft Office Word sono aperti contemporaneamente, la chiusura di una finestra di documento causa la chiusura di quel documento, ma Office Word resta aperto. Tuttavia, in un programma di questo tipo, dove esiste una sola finestra, la chiusura della finestra provoca l'arresto dell'esecuzione del programma, pertanto chiudendo il form viene chiuso il programma.

5. Salvare ed eseguire il programma.Spostare il puntatore del mouse sull'etichetta Fine.Viene aperto il messaggio, quindi il programma viene chiuso.

Per continuare o rivedere l'esercitazione

• Per andare al passaggio successivo dell'esercitazione, vedere Passaggio 4: aggiungere un metodo per riavviare il gioco.

• Per tornare al passaggio precedente dell'esercitazione, vedere Passaggio 2: compilare il labirinto utilizzando le etichette.