ToolboxItem.CreateComponentsCore Método

Definição

Namespace:

System.Drawing.Design

Assembly:

System.Windows.Forms.Design.dll

Cria um componente ou uma matriz de componentes quando o item de caixa de ferramentas é invocado.

Sobrecargas

CreateComponentsCore(IDesignerHost)	Cria um componente ou uma matriz de componentes quando o item de caixa de ferramentas é invocado.
CreateComponentsCore(IDesignerHost, IDictionary)	Cria uma matriz de componentes quando o item de caixa de ferramentas é invocado.

CreateComponentsCore(IDesignerHost)

Cria um componente ou uma matriz de componentes quando o item de caixa de ferramentas é invocado.

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

Parâmetros

host

IDesignerHost

O IDesignerHost para hospedar o item de caixa de ferramentas.

Retornos

IComponent[]

Uma matriz de objetos IComponent criados.

Comentários

Se host não nullfor , o CreateComponentsCore método adicionará os novos componentes ao designer.

Notas aos Herdeiros

Você pode substituir o CreateComponentsCore(IDesignerHost) método para retornar o componente ou os componentes que um item de caixa de ferramentas cria.

Confira também

• IDesignerHost

CreateComponentsCore(IDesignerHost, IDictionary)

Cria uma matriz de componentes quando o item de caixa de ferramentas é invocado.

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

Parâmetros

host

IDesignerHost

O host de designer a ser usado ao criar componentes.

defaultValues

IDictionary

Um dicionário de pares nome-valor da propriedade dos valores padrão com os quais inicializar o componente.

Retornos

IComponent[]

Uma matriz de objetos IComponent criados.

Exemplos

O exemplo de código a seguir demonstra o uso do CreateComponentsCore método em uma classe derivada de ToolboxItem para uma implementação de item de caixa de ferramentas personalizada. Este exemplo de código faz parte de um exemplo maior fornecido para a 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

Comentários

Se host não nullfor , o CreateComponentsCore método adicionará os novos componentes ao designer.