Hinzufügen eines Ereignishandlers

Sie können einen neuen Ereignishandler über den Ressourcen-Editor hinzufügen oder einen vorhandenen Ereignishandler mithilfe des Ereignishandler-Assistenten für ein Dialogfeld-Steuerelement bearbeiten.

Sie können der Klasse, die das Dialogfeld implementiert, mithilfe des Eigenschaftenfensters ein Ereignis hinzufügen. Wenn Sie das Ereignis einer anderen Klasse hinzufügen möchten, verwenden Sie den Ereignishandler-Assistenten.

So fügen Sie einem Dialogfeld-Steuerelement einen Ereignishandler hinzu:

1. Führen Sie einen Doppelklick auf die Dialogfeldressource in der Ressourcenansicht aus, um die Dialogfeldressource zu öffnen, die das Steuerelement im Dialog-Editor enthält.

2. Klicken Sie mit der rechten Maustaste auf das Steuerelement aus, das das Benachrichtigungsereignis verarbeiten soll.

3. Klicken Sie im Kontextmenü auf Ereignishandler hinzufügen, um den Ereignishandler-Assistenten anzuzeigen.

4. Wählen Sie das Ereignis im Feld Nachrichtentyp aus, das der im Feld Klassenliste ausgewählten Klasse hinzugefügt werden soll.

5. Akzeptieren Sie den Standardnamen im Feld Handlerfunktionsname, oder geben Sie einen Namen Ihrer Wahl ein.

6. Klicken Sie auf Hinzufügen und bearbeiten, um den Ereignishandler dem Projekt hinzuzufügen und den Text-Editor bei der neuen Funktion zum Hinzufügen des entsprechenden Ereignishandlercodes zu öffnen.

   Wenn der ausgewählte Nachrichtentyp bereits über einen Ereignishandler für die ausgewählte Klasse verfügt, ist die Option Hinzufügen und bearbeiten nicht verfügbar, jedoch ist die Option Code bearbeiten verfügbar. Klicken Sie auf Code bearbeiten, um den Text-Editor bei der vorhandenen Funktion zu öffnen.

Alternativ können Sie Ereignishandler über das Eigenschaftenfenster hinzufügen. Weitere Informationen finden Sie unter Adding Event Handlers for Dialog Box Controls (Hinzufügen von Ereignishandlern für Dialogfeld-Steuerelemente).

In diesem Abschnitt

• Ereignishandler-Assistent

Ereignishandler-Assistent

Dieser Assistent fügt einer beliebigen Klasse einen Ereignishandler für ein Dialogfeld-Steuerelement hinzu. Wenn Sie einen Ereignishandler über das Eigenschaftenfenster hinzufügen, können Sie ihn nur der Klasse hinzufügen, die das Dialogfeld implementiert. Weitere Informationen finden Sie unter Adding Event Handlers for Dialog Box Controls (Hinzufügen von Ereignishandlern für Dialogfeld-Steuerelemente).

• Befehlsname

  Identifiziert das ausgewählte Steuerelement, für das der Ereignishandler hinzugefügt wird. Dieses Feld ist nicht verfügbar.

• Nachrichtentyp

  Zeigt die Liste der aktuell verfügbaren Meldungshandler für das ausgewählte Steuerelement an.

• Handlerfunktionsname

  Zeigt den Namen der Funktion an, die zur Behandlung des Ereignisses hinzugefügt wird. Der Name basiert standardmäßig auf dem Nachrichtentyp und dem Befehl, und On wird vorangestellt. Beispielsweise zeigt der Nachrichtentyp BN_CLICKED für die Schaltfläche namens IDC_BUTTON1 den Handlerfunktionsnamen OnBnClickedButton1 an.

• Klassenliste

  Zeigt die verfügbaren Klassen an, denen Sie einen Ereignishandler hinzufügen können. Die Klasse für das ausgewählte Dialogfeld wird rot angezeigt.

• Handlerbeschreibung

  Gibt eine Beschreibung für das im Feld Nachrichtentyp ausgewählte Element an. Dieses Feld ist nicht verfügbar.

• Hinzufügen und Bearbeiten

  Fügt den Meldungshandler zu der ausgewählten Klasse oder dem ausgewählten Objekt hinzu. Öffnet außerdem den Text-Editor bei der neuen Funktion, damit Sie den Handlercode für Benachrichtigungen des Steuerelements hinzufügen oder bearbeiten können.

• Code bearbeiten

  Öffnet den Text-Editor bei der ausgewählten vorhandenen Funktion, damit Sie den Handlercode für Benachrichtigungen des Steuerelements hinzufügen oder bearbeiten können.