ToolboxItem.CreateComponentsCore Método

Definição

Espaço de Nomes:: System.Drawing.Design

Assemblagem:: System.Drawing.dll

Assemblagem:: System.Windows.Forms.Design.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Cria um componente ou um array de componentes quando o item da caixa de ferramentas é invocado.

Sobrecargas

Name	Description
CreateComponentsCore(IDesignerHost)	Cria um componente ou um array de componentes quando o item da caixa de ferramentas é invocado.
CreateComponentsCore(IDesignerHost, IDictionary)	Cria um array de componentes quando o item da caixa de ferramentas é invocado.

CreateComponentsCore(IDesignerHost)

Origem:: ToolboxItem.cs

Origem:: ToolboxItem.cs

Origem:: ToolboxItem.cs

Origem:: ToolboxItem.cs

Origem:: ToolboxItem.cs

Cria um componente ou um array de componentes quando o item da 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);

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

Para IDesignerHost alojar o item da caixa de ferramentas.

Devoluções

IComponent[]

Um conjunto de objetos criados IComponent .

Observações

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

Notas para Herdeiros

Podes sobrescrever o CreateComponentsCore(IDesignerHost) método para devolver o componente ou componentes que um item da caixa de ferramentas cria.

Ver também

IDesignerHost

Aplica-se a

CreateComponentsCore(IDesignerHost, IDictionary)

Origem:: ToolboxItem.cs

Origem:: ToolboxItem.cs

Origem:: ToolboxItem.cs

Origem:: ToolboxItem.cs

Origem:: ToolboxItem.cs

Cria um array de componentes quando o item da 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);

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 hospedeiro designer para usar na criação de componentes.

defaultValues: IDictionary

Um dicionário de pares nome/valor de propriedades de valores padrão com os quais inicializar o componente.

Devoluções

IComponent[]

Um conjunto de objetos criados IComponent .

Exemplos

O exemplo de código seguinte demonstra a utilização do CreateComponentsCore método numa classe derivada de ToolboxItem para a implementação de um item personalizado da caixa de ferramentas. 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())
    {
        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

Observações

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

Aplica-se a

Comentários

Esta página foi útil?