ToolboxItem.CreateComponentsCore Метод

Определение

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

Перегрузки

CreateComponentsCore(IDesignerHost)

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

CreateComponentsCore(IDesignerHost, IDictionary)

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

CreateComponentsCore(IDesignerHost)

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

protected virtual System.ComponentModel.IComponent[] CreateComponentsCore (System.ComponentModel.Design.IDesignerHost host);
protected virtual System.ComponentModel.IComponent[]? CreateComponentsCore (System.ComponentModel.Design.IDesignerHost? host);

Параметры

host
IDesignerHost

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

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

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

Комментарии

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

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

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

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

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

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

CreateComponentsCore(IDesignerHost, IDictionary)

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

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

Параметры

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;
        }
    }
}

Комментарии

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

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

.NET Framework 4.8.1 и другие версии
Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9