DesignerEventHandler-Delegat

Stellt die Methode dar, die das DesignerCreated-Ereignis und das DesignerDisposed-Ereignis behandelt, die ausgelöst werden, wenn ein Dokument erstellt oder freigegeben wird.

Namespace: System.ComponentModel.Design
Assembly: System (in system.dll)

Syntax

'Declaration
Public Delegate Sub DesignerEventHandler ( _
    sender As Object, _
    e As DesignerEventArgs _
)
'Usage
Dim instance As New DesignerEventHandler(AddressOf HandlerMethod)

public delegate void DesignerEventHandler (
    Object sender,
    DesignerEventArgs e
)

public delegate void DesignerEventHandler (
    Object^ sender, 
    DesignerEventArgs^ e
)

/** @delegate */
public delegate void DesignerEventHandler (
    Object sender, 
    DesignerEventArgs e
)

JScript unterstützt die Verwendung von Delegaten, aber nicht die Deklaration von neuen Delegaten.

Parameter

• sender
  Die Quelle des Ereignisses.

• e
  Ein DesignerEventArgs, das die Ereignisdaten enthält.

Hinweise

Beim Erstellen eines DesignerEventHandler-Delegaten bestimmen Sie die Methode für die Ereignisbehandlung. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Der Ereignishandler wird bei jedem Eintreten des Ereignisses aufgerufen, sofern der Delegat nicht entfernt wird. Weitere Informationen über Ereignishandlerdelegaten finden Sie unter Ereignisse und Delegaten.

Hinweis

Das auf diese Klasse angewendete HostProtectionAttribute-Attribut besitzt den Resources-Eigenschaftenwert SharedState. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder eines URL in einem Browser gestartet werden). Weitere Informationen finden Sie unter der HostProtectionAttribute-Klasse oder unter SQL Server-Programmierung und Hostschutzattribute.

Beispiel

Im folgenden Beispiel wird die Registrierung eines DesignerEventHandler sowie die Behandlung des DesignerCreated-Ereignisses und des DesignerDisposed-Ereignisses veranschaulicht.

Public Sub LinkDesignerEvent(ByVal eventService As IDesignerEventService)
    ' Registers an event handler for the DesignerCreated and DesignerDisposed events.
    AddHandler eventService.DesignerCreated, AddressOf Me.OnDesignerEvent
    AddHandler eventService.DesignerDisposed, AddressOf Me.OnDesignerEvent
End Sub

Private Sub OnDesignerEvent(ByVal sender As Object, ByVal e As DesignerEventArgs)
    ' Displays designer event information on the console.
    Console.WriteLine(("Name of the root component of the created or disposed designer: " + e.Designer.RootComponentClassName))
End Sub

public void LinkDesignerEvent(IDesignerEventService eventService)
{                                   
    // Registers an event handler for the DesignerCreated and DesignerDisposed events.
    eventService.DesignerCreated += new DesignerEventHandler(this.OnDesignerEvent);
    eventService.DesignerDisposed += new DesignerEventHandler(this.OnDesignerEvent);            
}

private void OnDesignerEvent(object sender, DesignerEventArgs e)
{
    // Displays designer event information on the console.
    Console.WriteLine("Name of the root component of the created or disposed designer: "+e.Designer.RootComponentClassName);
}

public:
   void LinkDesignerEvent( IDesignerEventService^ eventService )
   {
      // Registers an event handler for the DesignerCreated and DesignerDisposed events.
      eventService->DesignerCreated += gcnew DesignerEventHandler(
         this, &DesignerEventHandlerExample::OnDesignerEvent );
      eventService->DesignerDisposed += gcnew DesignerEventHandler(
         this, &DesignerEventHandlerExample::OnDesignerEvent );
   }

private:
   void OnDesignerEvent( Object^ sender, DesignerEventArgs^ e )
   {
      // Displays designer event information on the console.
      Console::WriteLine( "Name of the root component of the created or disposed designer: " +
         e->Designer->RootComponentClassName );
   }

public void LinkDesignerEvent(IDesignerEventService eventService)
{
    // Registers an event handler for the DesignerCreated and
    // DesignerDisposed events.
    eventService.add_DesignerCreated(new DesignerEventHandler(
        this.OnDesignerEvent));
    eventService.add_DesignerDisposed(new DesignerEventHandler(
        this.OnDesignerEvent));
} //LinkDesignerEvent

private void OnDesignerEvent(Object sender, DesignerEventArgs e)
{
    // Displays designer event information on the console.
    Console.WriteLine("Name of the root component of the created "
        + "or disposed designer: " + e.get_Designer().
        get_RootComponentClassName());
} //OnDesignerEvent

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

System.ComponentModel.Design-Namespace
DesignerEventArgs-Klasse