ActiveDesignerEventHandler-Delegat

Artikel
08/20/2007

Stellt die Methode dar, die das ActiveDesignerChanged-Ereignis behandelt.

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

Syntax

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

public delegate void ActiveDesignerEventHandler (
    Object sender,
    ActiveDesignerEventArgs e
)

public delegate void ActiveDesignerEventHandler (
    Object^ sender, 
    ActiveDesignerEventArgs^ e
)

/** @delegate */
public delegate void ActiveDesignerEventHandler (
    Object sender, 
    ActiveDesignerEventArgs e
)

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

Parameter

sender
Die Quelle des Ereignisses.

e
Ein ActiveDesignerEventArgs, das die Ereignisdaten enthält.

Hinweise

Das ActiveDesignerChanged-Ereignis wird ausgelöst, nachdem das derzeit aktive Dokument geändert wurde.

Beim Erstellen eines ActiveDesignerEventHandler-Delegaten geben Sie die Methode für die Ereignisbehandlung an. 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 ActiveDesignerEventHandler sowie die Behandlung eines ActiveDesignerChanged-Ereignisses veranschaulicht.

Public Sub LinkActiveDesignerEvent(ByVal eventService As IDesignerEventService)
    ' Registers an event handler for the ActiveDesignerChanged event.
    AddHandler eventService.ActiveDesignerChanged, AddressOf Me.OnActiveDesignerEvent
End Sub

Private Sub OnActiveDesignerEvent(ByVal sender As Object, ByVal e As ActiveDesignerEventArgs)
    ' Displays changed designer information on the console.            
    If Not (e.NewDesigner.RootComponent.Site Is Nothing) Then
        Console.WriteLine(("Name of the component of the new active designer: " + e.NewDesigner.RootComponent.Site.Name))
    End If
    Console.WriteLine(("Type of the component of the new active designer: " + e.NewDesigner.RootComponentClassName))
    If Not (e.OldDesigner.RootComponent.Site Is Nothing) Then
        Console.WriteLine(("Name of the component of the previously active designer: " + e.OldDesigner.RootComponent.Site.Name))
    End If
    Console.WriteLine(("Type of the component of the previously active designer: " + e.OldDesigner.RootComponentClassName))
End Sub

public void LinkActiveDesignerEvent(IDesignerEventService eventService)
{
    // Registers an event handler for the ActiveDesignerChanged event.
    eventService.ActiveDesignerChanged += new ActiveDesignerEventHandler(this.OnActiveDesignerEvent);
}

private void OnActiveDesignerEvent(object sender, ActiveDesignerEventArgs e)
{
    // Displays changed designer information on the console.
    if( e.NewDesigner.RootComponent.Site != null )
        Console.WriteLine("Name of the component of the new active designer: "+e.NewDesigner.RootComponent.Site.Name);            
    Console.WriteLine("Type of the component of the new active designer: "+e.NewDesigner.RootComponentClassName);
    if( e.OldDesigner.RootComponent.Site != null )
        Console.WriteLine("Name of the component of the previously active designer: "+e.OldDesigner.RootComponent.Site.Name);
    Console.WriteLine("Type of the component of the previously active designer: "+e.OldDesigner.RootComponentClassName);
}

public:
   void LinkActiveDesignerEvent( IDesignerEventService^ eventService )
   {
      // Registers an event handler for the ActiveDesignerChanged event.
      eventService->ActiveDesignerChanged += gcnew ActiveDesignerEventHandler( this, &MiscCompModSamples::ActiveDesignerEventHandlerExample::OnActiveDesignerEvent );
   }

private:
   void OnActiveDesignerEvent( Object^ /*sender*/, ActiveDesignerEventArgs^ e )
   {
      // Displays changed designer information on the console.
      if ( e->NewDesigner->RootComponent->Site != nullptr )
      {
         Console::WriteLine( "Name of the component of the new active designer: {0}", e->NewDesigner->RootComponent->Site->Name );
      }
      Console::WriteLine( "Type of the component of the new active designer: {0}", e->NewDesigner->RootComponentClassName );
      if ( e->OldDesigner->RootComponent->Site != nullptr )
      {
         Console::WriteLine( "Name of the component of the previously active designer: {0}", e->OldDesigner->RootComponent->Site->Name );
      }
      Console::WriteLine( "Type of the component of the previously active designer: {0}", e->OldDesigner->RootComponentClassName );
   }

public void LinkActiveDesignerEvent(IDesignerEventService eventService)
{
    // Registers an event handler for the ActiveDesignerChanged event.
    eventService.add_ActiveDesignerChanged(new ActiveDesignerEventHandler(
        this.OnActiveDesignerEvent));
} //LinkActiveDesignerEvent

private void OnActiveDesignerEvent(Object sender, ActiveDesignerEventArgs e)
{
    // Displays changed designer information on the console.
    if (e.get_NewDesigner().get_RootComponent().get_Site() != null) {
        Console.WriteLine("Name of the component of the new active designer: " 
            + e.get_NewDesigner().get_RootComponent().get_Site().get_Name());
    }
    Console.WriteLine("Type of the component of the new active designer: " 
        + e.get_NewDesigner().get_RootComponentClassName());
    if (e.get_OldDesigner().get_RootComponent().get_Site() != null) {
        Console.WriteLine("Name of the component of the previously active" 
            + " designer: " + e.get_OldDesigner().get_RootComponent().
            get_Site().get_Name());
    }
    Console.WriteLine("Type of the component of the previously active " 
        + " designer: " + e.get_OldDesigner().get_RootComponentClassName());
} //OnActiveDesignerEvent

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
ActiveDesignerEventArgs-Klasse
ActiveDesignerChanged

Freigeben über