ToolboxService.CreateItemContainer Метод

  • Ссылка

Определение

Пространство имен:
System.Drawing.Design
Сборка:
System.Drawing.Design.dll

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

Перегрузки

CreateItemContainer(IDataObject)

Создает новый контейнер элементов панели инструментов на основе сохраненного объекта данных.
CreateItemContainer(ToolboxItem, IDesignerHost)

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

CreateItemContainer(IDataObject)

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

protected:
 virtual System::Drawing::Design::ToolboxItemContainer ^ CreateItemContainer(System::Windows::Forms::IDataObject ^ dataObject);
protected virtual System.Drawing.Design.ToolboxItemContainer CreateItemContainer (System.Windows.Forms.IDataObject dataObject);
abstract member CreateItemContainer : System.Windows.Forms.IDataObject -> System.Drawing.Design.ToolboxItemContainer
override this.CreateItemContainer : System.Windows.Forms.IDataObject -> System.Drawing.Design.ToolboxItemContainer
Protected Overridable Function CreateItemContainer (dataObject As IDataObject) As ToolboxItemContainer

Параметры

dataObject
IDataObject

Объект данных, содержащий сохраненные данные панели инструментов.

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

ToolboxItemContainer

Новый контейнер элементов панели инструментов.

Исключения

ArgumentNullException

dataObject имеет значение null.

Комментарии

Метод CreateItemContainer дает возможность предоставить производную версию ToolboxItemContainer. По умолчанию ToolboxService класс не поддерживает связанные элементы, поэтому возвращается null для параметров ссылки, которые не nullявляются . Чтобы обеспечить поддержку ссылок, необходимо переопределить этот метод для создания производного ToolboxItemContainer , способного обрабатывать ссылки.

Переданный объект данных должен содержать данные, полученные при предварительном вызове ToolboxItemContainer.ToolboxData свойства в контейнере элементов панели элементов.

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

Связанный элемент панели элементов — это элемент, существование которого привязано к хранилищу определенного узла конструктора. Таким образом, в типичной системе проектов узел конструктора связан с определенным файлом. Элемент панели элементов, связанный с узлом конструктора, будет автоматически удален из панели элементов при удалении исходного файла узла конструктора или удалении из проекта.

Связанные элементы панели элементов позволяют использовать такие сценарии, как отключение элементов панели элементов ASP.NET при открытии конструктора Windows Forms.

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

CreateItemContainer(ToolboxItem, IDesignerHost)

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

protected:
 virtual System::Drawing::Design::ToolboxItemContainer ^ CreateItemContainer(System::Drawing::Design::ToolboxItem ^ item, System::ComponentModel::Design::IDesignerHost ^ link);
protected virtual System.Drawing.Design.ToolboxItemContainer CreateItemContainer (System.Drawing.Design.ToolboxItem item, System.ComponentModel.Design.IDesignerHost link);
abstract member CreateItemContainer : System.Drawing.Design.ToolboxItem * System.ComponentModel.Design.IDesignerHost -> System.Drawing.Design.ToolboxItemContainer
override this.CreateItemContainer : System.Drawing.Design.ToolboxItem * System.ComponentModel.Design.IDesignerHost -> System.Drawing.Design.ToolboxItemContainer
Protected Overridable Function CreateItemContainer (item As ToolboxItem, link As IDesignerHost) As ToolboxItemContainer

Параметры

item
ToolboxItem

Элемент панели инструментов, для которого должен быть создан контейнер элементов.

link
IDesignerHost

Необязательный хост-узел конструктора, который должен быть связан с этим элементом панели инструментов. Этот параметр может иметь значение null.

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

ToolboxItemContainer

Новый контейнер элементов панели инструментов.

Исключения

ArgumentNullException

item имеет значение null.

Комментарии

Метод CreateItemContainer дает возможность предоставить производную версию ToolboxItemContainer. По умолчанию ToolboxService класс не поддерживает связанные элементы, поэтому возвращается null для параметров ссылки, которые не nullявляются . Чтобы обеспечить поддержку ссылок, необходимо переопределить этот метод для создания производного ToolboxItemContainer , способного обрабатывать ссылки.

Если задан предоставленный IDesignerHost параметр link, это означает, что это связанный элемент панели элементов.

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

Связанный элемент панели элементов — это элемент, существование которого привязано к хранилищу определенного узла конструктора. Таким образом, в типичной системе проектов узел конструктора связан с определенным файлом. Элемент панели элементов, связанный с узлом конструктора, будет автоматически удален из панели элементов при удалении исходного файла узла конструктора или удалении из проекта.

Связанные элементы панели элементов позволяют использовать такие сценарии, как отключение элементов панели элементов ASP.NET при открытии конструктора Windows Forms.

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

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