Creare un nuovo metodo del gestore dell'evento

Quando si utilizza un progetto di Windows Presentation Foundation, o di Silverlight 2, Microsoft Expression Blend consente di generare codice per metodi del gestore dell'evento vuoti per agevolare le operazioni iniziali.

[!NOTA]

Per ulteriori informazioni sulla gestione degli eventi di Microsoft Silverlight 1.0, vedere Cenni preliminari su Silverlight 1.0 e Creare un pulsante che controlla uno storyboard in un'applicazione Silverlight. Vedere inoltre Script ed eventi mouse di Silverlight.

Se è installato Microsoft Visual Studio 2008 Standard Edition o versione successiva, il progetto verrà avviato automaticamente in Visual Studio 2008, quindi verrà aperto il file code-behind e vi verrà incollato il metodo del gestore dell'evento vuoto. Se invece non è installato Visual Studio 2008 Standard Edition o versione successiva, il metodo del gestore dell'evento vuoto verrà copiato automaticamente negli Appunti e sarà possibile aprire manualmente il file code-behind e incollarvi il codice.

Per ulteriori informazioni sui gestori degli eventi nel codice, vedere Gestione degli eventi e interattività dell'utente in questo Manuale dell'utente. Per ulteriori informazioni sulla creazione di interattività in un'applicazione Expression Blend senza utilizzare codice, vedere Trigger e interattività dell'utente in questo Manuale dell'utente.

Per creare un nuovo metodo del gestore dell'evento

1. Aprire il progetto in Expression Blend.

2. Aprire il documento, ad esempio Window1.xaml, facendo doppio clic su di esso in File, nel pannello Progetto. Il documento verrà aperto per la modifica. Verificare che sia attiva la visualizzazione Progettazione, facendo clic sulla scheda Progettazione sul lato destro della tavola da disegno.

3. In Oggetti e sequenza temporale del pannello Interazione selezionare l'elemento che si desidera collegare a un metodo del gestore dell'evento esistente. Se ad esempio si desidera che un elemento rettangolo si sposti quando viene fatto clic su un pulsante, selezionare l'elemento pulsante. Lo sfondo del nome dell'elemento verrà evidenziato per indicare che l'elemento è selezionato.

4. Nel pannello Proprietà fare clic sul pulsante Eventi. Verrà visualizzato un elenco alfabetico di tutti gli eventi disponibili per l'elemento selezionato.

   Attenzione:

   Gli eventi non verranno visualizzati se lo stato del progetto è temporaneo. Un progetto appena creato, ad esempio, rimane archiviato in un percorso temporaneo finché non si sceglie Salva tutto dal menu File. Dopo il salvataggio del progetto, sarà possibile visualizzare e selezionare eventi nel pannello Eventi. Gli eventi non verranno inoltre visualizzati se sono stati selezionati più oggetti contemporaneamente in Oggetti e sequenza temporale, ad esempio tenendo premuto CTRL.

   Suggerimento:
   Per visualizzare una breve descrizione di un evento spostare il puntatore del mouse sul nome dell'evento stesso. Verrà visualizzata una descrizione dell'evento. Per un elenco degli eventi disponibili e le relative descrizioni, vedere Guida di riferimento rapido agli eventi.

5. Individuare l'evento a cui si desidera aggiungere la logica di programmazione. Nel caso del rettangolo e del pulsante sopra indicati, è necessario individuare ad esempio l'evento MouseDown.

6. Per generare il metodo del gestore dell'evento vuoto è possibile procedere in due modi:

   • Fare doppio clic nella casella di testo accanto al nome dell'evento. Verrà generato automaticamente un nome predefinito per il metodo, verrà inserito tale nome nella casella di testo e quindi verrà quindi generato il codice per il metodo vuoto.

   • Digitare un nome nella casella di testo accanto al nome dell'evento e quindi premere INVIO o fare clic in un altro punto per spostare lo stato attivo dalla casella di testo. I nomi dei metodi relativi agli eventi devono iniziare con una lettera. Se il nome del metodo non esiste ancora nel file code-behind, verrà generato il codice per il metodo vuoto e verrà utilizzato il nome digitato.

   Suggerimento:
   È possibile configurare Expression Blend in modo da utilizzare gli Appunti anche se è installato Visual Studio 2008. Scegliere Opzioni dal menu Strumenti e quindi fare clic su Gestore eventi. In Opzioni di modifica fare clic su Solo Appunti.

7. A questo punto, verrà eseguita una delle operazioni seguenti:

   • Se è installato Visual Studio 2008 Standard Edition o versione successiva, il progetto verrà avviato automaticamente in Visual Studio 2008, quindi verrà aperto il file code-behind e vi verrà incollato il metodo del gestore dell'evento vuoto.

   • Se non è installato Visual Studio 2008 Standard Edition o versione successiva, il metodo del gestore dell'evento vuoto verrà copiato automaticamente negli Appunti e verrà visualizzata una finestra popup in cui sono descritte le possibili operazioni da effettuare. In questo caso sarà possibile aprire manualmente il file code-behind per incollare il metodo nella definizione di classe per la finestra, come indicato di seguito:

     public partial class Window1
     {
         public Window1()
         {
             this.InitializeComponent();
   
             // Insert code required on object creation below this point.
         }
   
         private void Button_MouseDown(object sender, RoutedEventArgs e)      {      }
     }
   

   [!NOTA]

   Se ai file con estensione cs o vb è associata un'applicazione, ad esempio il Blocco note, sarà possibile aprire manualmente il file code-behind facendo doppio clic sul relativo nome in File del pannello Progetto. Il file verrà aperto nell'applicazione associata.

   Se invece ai file cs o vb non è associata alcuna applicazione, non sarà possibile aprire il file esternamente. Per aprire il file, individuarlo in Esplora risorse oppure, se il progetto è stato salvato in Expression Blend, scegliere Esploraprogetto dal menu Progetto. Fare clic con il pulsante destro del mouse sul file con estensione cs o vb che si desidera modificare, scegliere Apri con e quindi selezionare Blocco note o un'altra applicazione di modifica. A questo punto, sarà possibile aprire i file code-behind manualmente dal pannello Progetto in Expression Blend.

8. Dopo aver aperto il file code-behind e avervi incollato il metodo del gestore dell'evento, è possibile iniziare ad aggiungere codice al metodo. Ai fini di questa procedura è possibile aggiungere la seguente riga di codice in rosso per far comparire una finestra di messaggio quando viene fatto clic sul pulsante:

     private void Button_MouseDown(object sender, RoutedEventArgs e)
     {
         MessageBox.Show("Hello!");
     }
   

   Per esempi di metodi di gestori di eventi in file code-behind, vedere gli esempi a cui è possibile accedere dalla schermata iniziale. Per visualizzare la schermata iniziale, scegliere Schermata iniziale dal menu ?.

   [!NOTA]

   In Expression Blend verrà visualizzato un errore di generazione se si fa riferimento a un metodo del gestore dell'evento del pannello Eventi che non esiste nel file code-behind. Se viene visualizzato questo tipo di errore, verificare che il nome del metodo sia stato digitato correttamente oppure fare doppio clic nella casella di testo relativa all'evento per creare un nuovo metodo del gestore dell'evento vuoto.

   Quando si elimina o rinomina un metodo del gestore dell'evento in una casella di testo del pannello Eventi, il metodo originale non viene rimosso dal file code-behind. Ciò avviene perché l'evento potrebbe ancora essere in uso in un altro punto. Non verrà visualizzato un errore di generazione se nel file code-behind è definito un metodo del gestore dell'evento a cui non viene fatto riferimento nel file xaml.

   [!NOTA]

   Se si desidera fare riferimento a un elemento del file con estensione xaml da un file code-behind, sarà necessario assegnare un nome all'elemento nel file xaml. Per impostazione predefinita, gli elementi creati in Expression Blend non sono denominati. È possibile assegnare un nome a un elemento in Oggetti e sequenza temporale del pannello Interazione facendo clic con il pulsante destro del mouse e quindi scegliendo Rinomina.