ToolboxService.CreateItemContainer Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает новый контейнер элементов панели инструментов на основе элемента панели инструментов или сохраненного объекта данных.
Перегрузки
| 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.ToolboxItemContainerProtected Overridable Function CreateItemContainer (dataObject As IDataObject) As ToolboxItemContainerПараметры
- dataObject
- IDataObject
Объект данных, содержащий сохраненные данные панели инструментов.
Возвращаемое значение
Новый контейнер элементов панели инструментов.
Исключения
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.ToolboxItemContainerProtected Overridable Function CreateItemContainer (item As ToolboxItem, link As IDesignerHost) As ToolboxItemContainerПараметры
- item
- ToolboxItem
Элемент панели инструментов, для которого должен быть создан контейнер элементов.
- link
- IDesignerHost
Необязательный хост-узел конструктора, который должен быть связан с этим элементом панели инструментов. Этот параметр может иметь значение null.
Возвращаемое значение
Новый контейнер элементов панели инструментов.
Исключения
item имеет значение null.
Комментарии
Метод CreateItemContainer дает возможность предоставить производную версию ToolboxItemContainer. По умолчанию ToolboxService класс не поддерживает связанные элементы, поэтому возвращается null для параметров ссылки, которые не nullявляются . Чтобы обеспечить поддержку ссылок, необходимо переопределить этот метод для создания производного ToolboxItemContainer , способного обрабатывать ссылки.
Если задан предоставленный IDesignerHost параметр link, это означает, что это связанный элемент панели элементов.
Примечания для тех, кто наследует этот метод
Связанный элемент панели элементов — это элемент, существование которого привязано к хранилищу определенного узла конструктора. Таким образом, в типичной системе проектов узел конструктора связан с определенным файлом. Элемент панели элементов, связанный с узлом конструктора, будет автоматически удален из панели элементов при удалении исходного файла узла конструктора или удалении из проекта.
Связанные элементы панели элементов позволяют использовать такие сценарии, как отключение элементов панели элементов ASP.NET при открытии конструктора Windows Forms.
