DesignSurface.CreateDesigner メソッド

.NET Framework クラス ライブラリ リファレンス

DesignSurface.CreateDesigner メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.ComponentModel.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim component As IComponent
Dim rootDesigner As Boolean
Dim returnValue As IDesigner

returnValue = Me.CreateDesigner(component, rootDesigner)

C#

protected internal virtual IDesigner CreateDesigner (
    IComponent component,
    bool rootDesigner
)

C++

protected public:
virtual IDesigner^ CreateDesigner (
    IComponent^ component, 
    bool rootDesigner
)

J#

protected IDesigner CreateDesigner (
    IComponent component, 
    boolean rootDesigner
)

JScript

protected internal function
 CreateDesigner (
    component : IComponent, 
    rootDesigner : boolean
) : IDesigner

パラメータ

component

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

rootDesigner

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

戻り値
要求したデザイナのインスタンス。一致するデザイナが見つからない場合は null 参照 (Visual Basic では Nothing)。

例外

例外の種類	条件
ArgumentNullException	component が null 参照 (Visual Basic では Nothing) です。
ObjectDisposedException	DesignSurface に追加した IDesignerHost は破棄されています。

解説

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

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

このメソッドの既定の実装は、TypeDescriptor に処理を代行させます。ルート デザイナの場合はデザイナの型として IRootDesigner を渡し、通常のデザイナの場合は IDesigner を渡します。このメソッドをオーバーライドして、特定の型のデザイナを要求できます。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DesignSurface クラス
DesignSurface メンバ
System.ComponentModel.Design 名前空間