DesignSurface.CreateDesigner(IComponent, Boolean) メソッド

定義

名前空間:

System.ComponentModel.Design

アセンブリ:

System.Windows.Forms.Design.dll

ソース:

DesignSurface.cs

コンポーネントがコンテナーに追加されたときにデザイナーを作成します。

protected public:
 virtual System::ComponentModel::Design::IDesigner ^ CreateDesigner(System::ComponentModel::IComponent ^ component, bool rootDesigner);

protected internal virtual System.ComponentModel.Design.IDesigner? CreateDesigner(System.ComponentModel.IComponent component, bool rootDesigner);

abstract member CreateDesigner : System.ComponentModel.IComponent * bool -> System.ComponentModel.Design.IDesigner
override this.CreateDesigner : System.ComponentModel.IComponent * bool -> System.ComponentModel.Design.IDesigner

Protected Friend Overridable Function CreateDesigner (component As IComponent, rootDesigner As Boolean) As IDesigner

パラメーター

component

IComponent

デザイナーを作成する必要があるコンポーネント。

rootDesigner

Boolean

true ルート デザイナーを作成する場合。通常のデザイナーを作成 false 。

返品

IDesigner

要求されたデザイナーのインスタンス。一致するデザイナーが見つからない場合は null 。

例外

ArgumentNullException

component は nullです。

ObjectDisposedException

IDesignerHostにアタッチされているDesignSurfaceは破棄されています。

注釈

CreateDesigner メソッドは、コンポーネントがコンテナーに追加されるときに、デザイン サーフェイスのIContainerによって呼び出されます。 このメソッドはデザイナーを作成しますが、初期化しません。 デザイナーが返されると、デザイナーはコンテナーによって初期化されます。

CreateDesigner では、ルート デザイナーと通常のデザイナーという 2 種類のデザイナーを作成できます。 ルート デザイナーは、設計サーフェイスのルート コンポーネントのデザイナーであり、定義上はコンテナーに追加された最初のコンポーネントです。 ルート デザイナーは、エンド ユーザーに表示されるユーザー インターフェイスを担当するため、通常のデザイナーとは異なります。 ルート デザイナーは、通常、このインターフェイスを提供するために、デザインサーフェイス上の他のデザイナーと連携します。

このメソッドの既定の実装は、 TypeDescriptorに委任し、ルート デザイナーのデザイナー型として IRootDesigner を渡すか、通常のデザイナーに対して IDesigner します。 このメソッドをオーバーライドして、特定の種類のデザイナーを要求できます。