ToolboxItem.CreateComponentsCore Metodo

Definizione

Spazio dei nomi:

System.Drawing.Design

Assembly:

System.Windows.Forms.Design.dll

Crea un componente o una matrice di componenti quando viene richiamato l'elemento della casella degli strumenti.

Overload

CreateComponentsCore(IDesignerHost)	Crea un componente o una matrice di componenti quando viene richiamato l'elemento della casella degli strumenti.
CreateComponentsCore(IDesignerHost, IDictionary)	Crea una matrice di componenti quando viene richiamato l'elemento della casella degli strumenti.

CreateComponentsCore(IDesignerHost)

Crea un componente o una matrice di componenti quando viene richiamato l'elemento della casella degli strumenti.

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()

Parametri

host

IDesignerHost

Oggetto IDesignerHost in cui inserire l'elemento della casella degli strumenti.

Restituisce

IComponent[]

Matrice di oggetti IComponent creati.

Commenti

Se host non nullè , il CreateComponentsCore metodo aggiunge i nuovi componenti alla finestra di progettazione.

Note per gli eredi

È possibile eseguire l'override del CreateComponentsCore(IDesignerHost) metodo per restituire il componente o i componenti creati da un elemento della casella degli strumenti.

Vedi anche

• IDesignerHost

CreateComponentsCore(IDesignerHost, IDictionary)

Crea una matrice di componenti quando viene richiamato l'elemento della casella degli strumenti.

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()

Parametri

host

IDesignerHost

Host di progettazione da usare quando si creano i componenti.

defaultValues

IDictionary

Dizionario della coppia nome/valore della proprietà dei valori predefiniti con cui inizializzare il componente.

Restituisce

IComponent[]

Matrice di oggetti IComponent creati.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del CreateComponentsCore metodo in una classe derivata da ToolboxItem per un'implementazione personalizzata dell'elemento della casella degli strumenti. Questo esempio di codice fa parte di un esempio più ampio fornito per la ToolboxItem classe .

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

Commenti

Se host non nullè , il CreateComponentsCore metodo aggiunge i nuovi componenti alla finestra di progettazione.