ToolboxItem.CreateComponentsCore Methode

Definition

Namespace:

System.Drawing.Design

Assembly:

System.Windows.Forms.Design.dll

Erstellt beim Aufrufen des Toolboxelements eine Komponente oder ein Array von Komponenten.

Überlädt

CreateComponentsCore(IDesignerHost)	Erstellt beim Aufrufen des Toolboxelements eine Komponente oder ein Array von Komponenten.
CreateComponentsCore(IDesignerHost, IDictionary)	Erstellt beim Aufrufen des Toolboxelements ein Array von Komponenten.

CreateComponentsCore(IDesignerHost)

Erstellt beim Aufrufen des Toolboxelements eine Komponente oder ein Array von Komponenten.

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.

Gibt zurück

IComponent[]

Ein Array von erstellten IComponent-Objekten.

Hinweise

Wenn host nicht nullist, fügt die CreateComponentsCore -Methode dem Designer die neuen Komponenten hinzu.

Hinweise für Vererber

Sie können die CreateComponentsCore(IDesignerHost) -Methode überschreiben, um die Von einem Toolboxelement erstellten Komponenten zurückzugeben.

Weitere Informationen

• IDesignerHost

CreateComponentsCore(IDesignerHost, IDictionary)

Erstellt beim Aufrufen des Toolboxelements ein Array von Komponenten.

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.

defaultValues

IDictionary

Ein Wörterbuch mit Eigenschaftenname-Wert-Paaren der Standardwerte, mit denen die Komponente initialisiert werden soll.

Gibt zurück

IComponent[]

Ein Array von erstellten IComponent-Objekten.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der -Methode in einer Klasse veranschaulicht, die CreateComponentsCore von ToolboxItem für die Implementierung eines benutzerdefinierten Toolboxelements abgeleitet wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ToolboxItem-Klasse bereitgestellt wird.

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 nicht nullist, fügt die CreateComponentsCore -Methode dem Designer die neuen Komponenten hinzu.