ToolboxItem.CreateComponentsCore Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vytvoří součást nebo pole komponent při vyvolání položky panelu nástrojů.
Přetížení
CreateComponentsCore(IDesignerHost) |
Vytvoří součást nebo pole komponent při vyvolání položky panelu nástrojů. |
CreateComponentsCore(IDesignerHost, IDictionary) |
Vytvoří pole komponent při vyvolání položky panelu nástrojů. |
CreateComponentsCore(IDesignerHost)
Vytvoří součást nebo pole komponent při vyvolání položky panelu nástrojů.
protected:
virtual cli::array <System::ComponentModel::IComponent ^> ^ CreateComponentsCore(System::ComponentModel::Design::IDesignerHost ^ host);
protected virtual 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()
Parametry
- host
- IDesignerHost
K IDesignerHost hostování položky panelu nástrojů.
Návraty
Pole vytvořených IComponent objektů.
Poznámky
Pokud host
není null
, CreateComponentsCore metoda přidá nové komponenty do návrháře.
Poznámky pro dědice
Můžete přepsat metodu CreateComponentsCore(IDesignerHost) vrátit komponentu nebo komponenty, které vytvoří položka panelu nástrojů.
Viz také
Platí pro
CreateComponentsCore(IDesignerHost, IDictionary)
Vytvoří pole komponent při vyvolání položky panelu nástrojů.
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);
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()
Parametry
- host
- IDesignerHost
Hostitel návrháře, který se má použít při vytváření komponent.
- defaultValues
- IDictionary
Slovník dvojice název vlastnosti/hodnota výchozích hodnot, pomocí kterých se má inicializovat komponenta.
Návraty
Pole vytvořených IComponent objektů.
Příklady
Následující příklad kódu ukazuje použití CreateComponentsCore metody ve třídě odvozené z ToolboxItem pro vlastní implementaci položky panelu nástrojů. Tento příklad kódu je součástí většího příkladu ToolboxItem pro třídu .
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
Poznámky
Pokud host
není null
, CreateComponentsCore metoda přidá nové komponenty do návrháře.