ToolboxItem.CreateComponentsCore Метод

Определение

Пространство имен:

System.Drawing.Design

Сборка:

System.Windows.Forms.Design.dll

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

Перегрузки

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

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[]

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

Комментарии

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

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

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

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

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

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[]

Массив созданных объектов интерфейса 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 метод добавляет новые компоненты в конструктор.