ToolboxComponentsCreatingEventHandler-Delegat

Artikel
08/20/2007

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

Namespace: System.Drawing.Design
Assembly: System.Drawing (in system.drawing.dll)

Syntax

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

public delegate void ToolboxComponentsCreatingEventHandler (
    Object sender,
    ToolboxComponentsCreatingEventArgs e
)

public delegate void ToolboxComponentsCreatingEventHandler (
    Object^ sender, 
    ToolboxComponentsCreatingEventArgs^ e
)

/** @delegate */
public delegate void ToolboxComponentsCreatingEventHandler (
    Object sender, 
    ToolboxComponentsCreatingEventArgs e
)

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

Parameter

sender
Die Quelle des Ereignisses.

e
Ein ToolboxComponentsCreatingEventArgs, das Daten für das Ereignis bereitstellt.

Hinweise

Beim Erstellen eines ToolboxComponentsCreatingEventHandler-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.

Beispiel

Im folgenden Codebeispiel wird eine Methode bereitgestellt, die einen Ereignishandler für das ComponentsCreating-Ereignis von ToolboxItem anfügt, sowie eine Methode für den ToolboxComponentsCreatingEventHandler-Ereignishandler, die den Namen des Typs der Komponente, die die neue Komponente bzw. die neuen Komponenten empfangen soll, in Console schreibt, wenn der Ereignishandler durch das ComponentsCreating-Ereignis ausgelöst wird.

Public Sub LinkToolboxComponentsCreatingEvent(ByVal item As ToolboxItem)
    AddHandler item.ComponentsCreating, AddressOf Me.OnComponentsCreating
End Sub

Private Sub OnComponentsCreating(ByVal sender As Object, ByVal e As ToolboxComponentsCreatingEventArgs)
    ' Displays ComponentsCreating event information on the Console.
    Console.WriteLine(("Name of the class of the root component of the designer host receiving new components: " + e.DesignerHost.RootComponentClassName))
End Sub

public void LinkToolboxComponentsCreatingEvent(ToolboxItem item)
{
    item.ComponentsCreating += new ToolboxComponentsCreatingEventHandler(this.OnComponentsCreating);
}

private void OnComponentsCreating(object sender, ToolboxComponentsCreatingEventArgs e)
{
    // Displays ComponentsCreating event information on the Console.
    Console.WriteLine("Name of the class of the root component of " +
    "the designer host receiving new components: " +
    e.DesignerHost.RootComponentClassName);
}

public:
   [PermissionSetAttribute(SecurityAction::Demand, Name="FullTrust")]
   void LinkToolboxComponentsCreatingEvent( ToolboxItem^ item )
   {
      item->ComponentsCreating +=
         gcnew ToolboxComponentsCreatingEventHandler( this, &Form1::OnComponentsCreating );
   }

private:
   void OnComponentsCreating( Object^ sender, ToolboxComponentsCreatingEventArgs^ e )
   {
      // Displays ComponentsCreating event information on the Console.
      Console::WriteLine( "Name of the class of the root component of " +
         "the designer host receiving new components: " +
         e->DesignerHost->RootComponentClassName );
   }

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.Drawing.Design-Namespace
ToolboxComponentsCreatingEventArgs-Klasse
ComponentsCreating

Freigeben über