ToolboxItem.CreateComponentsCore Methode

Definition

Erstellt beim Aufrufen des Toolboxelements eine Komponente oder ein Array von Komponenten.Creates a component or an array of components when the toolbox item is invoked.

Überlädt

CreateComponentsCore(IDesignerHost)

Erstellt beim Aufrufen des Toolboxelements eine Komponente oder ein Array von Komponenten.Creates a component or an array of components when the toolbox item is invoked.

CreateComponentsCore(IDesignerHost, IDictionary)

Erstellt beim Aufrufen des Toolboxelements ein Array von Komponenten.Creates an array of components when the toolbox item is invoked.

CreateComponentsCore(IDesignerHost)

Erstellt beim Aufrufen des Toolboxelements eine Komponente oder ein Array von Komponenten.Creates a component or an array of components when the toolbox item is invoked.

protected:
 virtual cli::array <System::ComponentModel::IComponent ^> ^ CreateComponentsCore(System::ComponentModel::Design::IDesignerHost ^ host);
protected virtual System.ComponentModel.IComponent[] CreateComponentsCore (System.ComponentModel.Design.IDesignerHost host);
abstract member CreateComponentsCore : System.ComponentModel.Design.IDesignerHost -> System.ComponentModel.IComponent[]
override this.CreateComponentsCore : System.ComponentModel.Design.IDesignerHost -> System.ComponentModel.IComponent[]
Protected Overridable Function CreateComponentsCore (host As IDesignerHost) As IComponent()

Parameter

host
IDesignerHost

Der IDesignerHost, in dem das Toolboxelement bereitgestellt wird.The IDesignerHost to host the toolbox item.

Gibt zurück

Ein Array von erstellten IComponent-Objekten.An array of created IComponent objects.

Hinweise

Wenn host CreateComponentsCore nicht nullist, fügt die Methode dem Designer die neuen Komponenten hinzu.If host is not null, the CreateComponentsCore method adds the new components to the designer.

Hinweise für Vererber

Sie können die CreateComponentsCore(IDesignerHost) -Methode überschreiben, um die Komponente oder Komponenten zurückzugeben, die von einem Toolbox Element erstellt werden.You can override the CreateComponentsCore(IDesignerHost) method to return the component or components that a toolbox item creates.

Siehe auch

CreateComponentsCore(IDesignerHost, IDictionary)

Erstellt beim Aufrufen des Toolboxelements ein Array von Komponenten.Creates an array of components when the toolbox item is invoked.

protected:
 virtual cli::array <System::ComponentModel::IComponent ^> ^ CreateComponentsCore(System::ComponentModel::Design::IDesignerHost ^ host, System::Collections::IDictionary ^ defaultValues);
protected virtual System.ComponentModel.IComponent[] CreateComponentsCore (System.ComponentModel.Design.IDesignerHost host, System.Collections.IDictionary defaultValues);
abstract member CreateComponentsCore : System.ComponentModel.Design.IDesignerHost * System.Collections.IDictionary -> System.ComponentModel.IComponent[]
override this.CreateComponentsCore : System.ComponentModel.Design.IDesignerHost * System.Collections.IDictionary -> System.ComponentModel.IComponent[]
Protected Overridable Function CreateComponentsCore (host As IDesignerHost, defaultValues As IDictionary) As IComponent()

Parameter

host
IDesignerHost

Der Designerhost, der beim Erstellen von Komponenten verwendet werden soll.The designer host to use when creating components.

defaultValues
IDictionary

Ein Wörterbuch mit Eigenschaftenname-Wert-Paaren der Standardwerte, mit denen die Komponente initialisiert werden soll.A dictionary of property name/value pairs of default values with which to initialize the component.

Gibt zurück

Ein Array von erstellten IComponent-Objekten.An array of created IComponent objects.

Beispiele

Im folgenden Codebeispiel wird die Verwendung CreateComponentsCore der-Methode in einer Klasse veranschaulicht, die von ToolboxItem für eine benutzerdefinierte Toolbox Element Implementierung abgeleitet wurde.The following code example demonstrates the use of the CreateComponentsCore method in a class derived from ToolboxItem for a custom toolbox item implementation. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ToolboxItem -Klasse bereitgestellt wird.This code example is part of a larger example provided for the ToolboxItem class.

protected override IComponent[] CreateComponentsCore(
    System.ComponentModel.Design.IDesignerHost host, 
    System.Collections.IDictionary defaultValues)
{
    // Get the string we want to fill in the custom
    // user control.  If the user cancels out of the dialog,
    // return null or an empty array to signify that the 
    // tool creation was canceled.
    using (ToolboxItemDialog d = new ToolboxItemDialog())
    {
        if (d.ShowDialog() == DialogResult.OK)
        {
            string text = d.CreationText;

            IComponent[] comps =
                base.CreateComponentsCore(host, defaultValues);
            // comps will have a single component: our data type.
            ((UserControl1)comps[0]).LabelText = text;
            return comps;
        }
        else
        {
            return null;
        }
    }
}
Protected Overrides Function CreateComponentsCore( _
    ByVal host As System.ComponentModel.Design.IDesignerHost, _
    ByVal defaultValues As System.Collections.IDictionary) _
    As IComponent()
    ' Get the string we want to fill in the custom
    ' user control.  If the user cancels out of the dialog,
    ' return null or an empty array to signify that the 
    ' tool creation was canceled.
    Using d As New ToolboxItemDialog()
        If d.ShowDialog() = DialogResult.OK Then
            Dim [text] As String = d.CreationText
            Dim comps As IComponent() = _
                MyBase.CreateComponentsCore(host, defaultValues)
            ' comps will have a single component: our data type.
            CType(comps(0), UserControl1).LabelText = [text]
            Return comps
        Else
            Return Nothing
        End If
    End Using
End Function

Hinweise

Wenn host CreateComponentsCore nicht nullist, fügt die Methode dem Designer die neuen Komponenten hinzu.If host is not null, the CreateComponentsCore method adds the new components to the designer.

Gilt für: