ToolboxService.CreateItemContainer Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Drawing.Design
Assembly:
System.Drawing.Design.dll

Crea un nuovo contenitore di elementi della casella degli strumenti da un elemento della casella degli strumenti o da un oggetto dati salvato.

Overload

CreateItemContainer(IDataObject)

Crea un nuovo contenitore di elementi della casella degli strumenti da un oggetto dati salvato.
CreateItemContainer(ToolboxItem, IDesignerHost)

Crea un nuovo contenitore di elementi della casella degli strumenti da un elemento della casella degli strumenti.

CreateItemContainer(IDataObject)

Crea un nuovo contenitore di elementi della casella degli strumenti da un oggetto dati salvato.

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

Parametri

dataObject
IDataObject

Oggetto dati contenente dati della casella degli strumenti salvati.

Restituisce

ToolboxItemContainer

Nuovo contenitore di elementi della casella degli strumenti.

Eccezioni

ArgumentNullException

dataObject è null.

Commenti

Il CreateItemContainer metodo offre l'opportunità di fornire una versione derivata di un ToolboxItemContaineroggetto . Per impostazione predefinita, la ToolboxService classe non supporta gli elementi collegati, quindi restituisce null per i parametri di collegamento che non nullsono . Per fornire il supporto dei collegamenti, è necessario eseguire l'override di questo metodo per creare un oggetto derivato ToolboxItemContainer in grado di gestire i collegamenti.

L'oggetto ToolboxItemContainer.ToolboxData dati passato deve contenere dati ottenuti da una chiamata precedente alla proprietà in un contenitore di elementi della casella degli strumenti.

Note per gli eredi

Un elemento della casella degli strumenti collegato è uno dei quali è legato all'archiviazione di un determinato host di progettazione. Quindi, in un tipico sistema di progetto, un host di progettazione è associato a un determinato file. Un elemento della casella degli strumenti collegato a un host di progettazione verrà automaticamente eliminato dalla casella degli strumenti quando il file di origine dell'host di progettazione viene eliminato o rimosso dal progetto.

Gli elementi della casella degli strumenti collegati consentono di disabilitare gli elementi della casella degli strumenti ASP.NET quando la finestra di progettazione Windows Forms è aperta.

Si applica a

CreateItemContainer(ToolboxItem, IDesignerHost)

Crea un nuovo contenitore di elementi della casella degli strumenti da un elemento della casella degli strumenti.

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

Parametri

item
ToolboxItem

Elemento della casella degli strumenti per il quale creare un contenitore di elementi.

link
IDesignerHost

Host di progettazione facoltativo che deve essere collegato a questo elemento della casella degli strumenti. Questo parametro può essere null.

Restituisce

ToolboxItemContainer

Nuovo contenitore di elementi della casella degli strumenti.

Eccezioni

ArgumentNullException

item è null.

Commenti

Il CreateItemContainer metodo offre l'opportunità di fornire una versione derivata di un ToolboxItemContaineroggetto . Per impostazione predefinita, la ToolboxService classe non supporta gli elementi collegati, quindi restituisce null per i parametri di collegamento che non nullsono . Per fornire il supporto dei collegamenti, è necessario eseguire l'override di questo metodo per creare un oggetto derivato ToolboxItemContainer in grado di gestire i collegamenti.

Se viene assegnato il parametro di collegamento specificato IDesignerHost , indica che si tratta di un elemento della casella degli strumenti collegato.

Note per gli eredi

Un elemento della casella degli strumenti collegato è uno dei quali è legato all'archiviazione di un determinato host di progettazione. Quindi, in un tipico sistema di progetto, un host di progettazione è associato a un determinato file. Un elemento della casella degli strumenti collegato a un host di progettazione verrà automaticamente eliminato dalla casella degli strumenti quando il file di origine dell'host di progettazione viene eliminato o rimosso dal progetto.

Gli elementi della casella degli strumenti collegati consentono di disabilitare gli elementi della casella degli strumenti ASP.NET quando la finestra di progettazione Windows Forms è aperta.

Vedi anche

Si applica a