ToolboxItem.CreateComponentsCore Метод

Определение

Создает компонент или массив компонентов при вызове элемента панели инструментов.

Перегрузки

CreateComponentsCore(IDesignerHost)

Создает компонент или массив компонентов при вызове элемента панели инструментов.

CreateComponentsCore(IDesignerHost, IDictionary)

Создает массив компонентов при вызове элемента панели инструментов.

CreateComponentsCore(IDesignerHost)

Создает компонент или массив компонентов при вызове элемента панели инструментов.

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

Параметры

host
IDesignerHost

Интерфейс IDesignerHost для размещения элемента панели инструментов.

Возвращаемое значение

Массив созданных объектов интерфейса IComponent.

Комментарии

Если host значение не nullравно , CreateComponentsCore метод добавляет новые компоненты в конструктор.

Примечания для тех, кто наследует этот метод

Вы можете переопределить CreateComponentsCore(IDesignerHost) метод , чтобы вернуть компонент или компоненты, создаваемые элементом панели элементов.

См. также раздел

Применяется к

CreateComponentsCore(IDesignerHost, IDictionary)

Создает массив компонентов при вызове элемента панели инструментов.

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

Параметры

host
IDesignerHost

Хост-узел конструктора, используемый при создании компонентов.

defaultValues
IDictionary

Словарь пар имя/значение для значений по умолчанию, с использованием которых выполняется инициализация компонента.

Возвращаемое значение

Массив созданных объектов интерфейса IComponent.

Примеры

В следующем примере кода показано использование CreateComponentsCore метода в классе, производном от , ToolboxItem для реализации пользовательского элемента панели элементов. Этот пример входит в состав более крупного примера использования класса ToolboxItem.

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

Комментарии

Если host значение не nullравно , CreateComponentsCore метод добавляет новые компоненты в конструктор.

Применяется к