ToolboxItem.CreateComponentsCore Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Tworzy składnik lub tablicę składników po wywołaniu elementu przybornika.
Przeciążenia
CreateComponentsCore(IDesignerHost) |
Tworzy składnik lub tablicę składników po wywołaniu elementu przybornika. |
CreateComponentsCore(IDesignerHost, IDictionary) |
Tworzy tablicę składników po wywołaniu elementu przybornika. |
CreateComponentsCore(IDesignerHost)
Tworzy składnik lub tablicę składników po wywołaniu elementu przybornika.
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
Element IDesignerHost do hostowania elementu przybornika.
Zwraca
Tablica utworzonych IComponent obiektów.
Uwagi
Jeśli host
nie null
jest , CreateComponentsCore metoda dodaje nowe składniki do projektanta.
Uwagi dotyczące dziedziczenia
Możesz zastąpić metodę CreateComponentsCore(IDesignerHost) , aby zwrócić składnik lub składniki tworzone przez element przybornika.
Zobacz też
Dotyczy
CreateComponentsCore(IDesignerHost, IDictionary)
Tworzy tablicę składników po wywołaniu elementu przybornika.
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
Host projektanta do użycia podczas tworzenia składników.
- defaultValues
- IDictionary
Słownik par nazw/wartości właściwości domyślnych, z którymi należy zainicjować składnik.
Zwraca
Tablica utworzonych IComponent obiektów.
Przykłady
Poniższy przykład kodu przedstawia użycie CreateComponentsCore metody w klasie pochodzącej z ToolboxItem implementacji niestandardowego elementu przybornika. Ten przykład kodu jest częścią większego przykładu podanego ToolboxItem dla klasy.
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
Uwagi
Jeśli host
nie null
jest , CreateComponentsCore metoda dodaje nowe składniki do projektanta.