DesignSurface

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

DesignSurface イベント

パブリック イベント

	名前	説明
	Disposed	デザイン サーフェイスが破棄されたときに発生します。
	Flushed	DesignSurface の Flush メソッドが呼び出されたときに発生します。
	Loaded	デザイナの読み込みが完了したときに発生します。
	Loading	デザイナの読み込みを開始する直前に発生します。
	Unloaded	デザイナのアンロードを終了したときに発生します。
	Unloading	デザイナのアンロードを開始する直前に発生します。
	ViewActivated	Activate メソッドが IDesignerHost に対して呼び出されたときに発生します。

参照

関連項目

DesignSurface クラス
System.ComponentModel.Design 名前空間
IDesignerHost
IServiceProvider
DesignerLoader
IDesignerLoaderService

DesignSurface クラス

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

コンポーネントをデザインするためのユーザー インターフェイスを提供します。

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

Visual Basic (宣言)

Public Class DesignSurface
    Implements IDisposable, IServiceProvider

Visual Basic (使用法)

Dim instance As DesignSurface

C#

public class DesignSurface : IDisposable, IServiceProvider

C++

public ref class DesignSurface : IDisposable,
 IServiceProvider

J#

public class DesignSurface implements IDisposable,
 IServiceProvider

JScript

public class DesignSurface implements IDisposable,
 IServiceProvider

解説

DesignSurface クラスは、ユーザーがデザイナとして認識しているものを実装します。DesignSurface は、ユーザーがデザイン時の機能を変更する際に操作するユーザー インターフェイスです。DesignSurface は、完全に独立したデザイン サーフェイスを提供します。

DesignSurface クラスは、スタンドアロンのデザイナとして使用できます。また、DesignSurfaceManager クラスと組み合わせて、複数の DesignSurface オブジェクトをホストするアプリケーションの共通の実装を提供することもできます。

DesignSurface クラスは単独で使用することも、ユーザーがこのクラスから新しいクラスを派生し、動作を強化することもできます。

DesignSurface クラスは、複数のデザイン時サービスを自動的に提供します。DesignSurface クラスでは、コンストラクタにすべてのサービスを追加します。これらのサービスのほとんどは、プロテクト プロパティ ServiceContainer 内で置き換えることによってオーバーライドできます。サービスを置き換えるには、コンストラクタをオーバーライドし、基本クラスを呼び出し、プロテクト プロパティ ServiceContainer を使用して変更を加えます。デザイン サーフェイスが破棄されると、サービス コンテナに追加された、IDisposable を実装するすべてのサービスが破棄されます。DesignSurface クラスに用意されている置き換え可能なサービスの既定のセットを次の表に示します。

サービス	説明
IExtenderProviderService	コンテナのコンポーネントのコレクションに含まれていないオブジェクトが、独自の拡張プロバイダを提供できるようにします。
IExtenderListService	拡張プロバイダのリストを取得するために、TypeDescriptor によって使用されます。このサービスでは、拡張プロバイダはコンテナに格納されていなくてもかまいません。
ITypeDescriptorFilterService	デザイナのメタデータのフックを提供します。これは、メタデータのフィルタ処理に使用する主要インターフェイスです。
ISelectionService	デザイナでコンポーネントを選択できるようにします。
IReferenceService	オブジェクトが配置されていない場合でも、オブジェクトの名前を取得できるようにします。
DesignSurface	デザイン サーフェイス自体をサービスとして提供します。
DesignerOptionService	デザイナのオプションの値を取得および設定するために使用する基本クラスを提供します。

既定で用意されている置き換え不可能なサービスを次の表に示します。

サービス	説明
IComponentChangeService	コンポーネントに変更が加えられたときに、イベントを発生させます。
IDesignerHost	型、サービス、およびトランザクションへのアクセスを制御します。デザイナのマスター インターフェイスです。
IContainer	デザインするコンポーネントのセットを所有します。各デザイナは、コンポーネントを所有する IContainer を保持します。
IServiceContainer	IServiceProvider から派生し、デザイナからサービスの追加や削除を実行できるようにします。

これらのサービスに加え、DesignSurface クラスには、コンポーネントのサイトを通じて利用できる単一のサービスも用意されています。このサービスは、各コンポーネントに固有のサービスです。このサービスを次の表に示します。このサービスを置き換えることはできません。

サービス	説明
IDictionaryService	コンポーネントに関する任意のデータの格納に使用できる、キーと値のペアの汎用ディクショナリ。
INestedContainer	コンポーネントがデザイナに子コンポーネントを追加できるようにするコンテナ。これらのコンポーネントはデザイン サーフェイスに含まれますが、シリアル化には関与しません。デザイナ内で領域を公開できるコントロールをデザインする必要があり、その領域をシリアル化には関与させたくない場合に、このサービスが役立ちます。

ISite に加え、サイトは次のインターフェイスも実装します。

注意
他のサイトの実装でこれらのインターフェイスを実装していない場合があるため、無差別なキャストを使用するのではなく、これらのインターフェイスが存在するかどうかを確認してください。

サービス	説明
IServiceContainer	サイト固有のサービスのコンテナにアクセスできるようにします。たとえば、IDictionaryService はサイト固有のサービスです。このサービスを使用すると、サイト固有の他のサービスを追加できます。

.NET Framework のセキュリティ

• NamedPermissionSet  (システム リソースへのフル アクセス許可)。LinkDemand、InheritanceDemand (要求値)。FullTrust (関連する状態)。

継承階層

System.Object
  System.ComponentModel.Design.DesignSurface

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 メンバ
System.ComponentModel.Design 名前空間
IDesignerHost
IServiceProvider
DesignerLoader
IDesignerLoaderService

DesignSurface コンストラクタ ()

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

DesignSurface クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New DesignSurface

C#

public DesignSurface ()

C++

public:
DesignSurface ()

J#

public DesignSurface ()

JScript

public function DesignSurface ()

例外

例外の種類	条件
ObjectDisposedException	DesignSurface に追加した IDesignerHost は破棄されています。

.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 名前空間

DesignSurface コンストラクタ (Type)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

DesignSurface クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    rootComponentType As Type _
)

Visual Basic (使用法)

Dim rootComponentType As Type

Dim instance As New DesignSurface(rootComponentType)

C#

public DesignSurface (
    Type rootComponentType
)

C++

public:
DesignSurface (
    Type^ rootComponentType
)

J#

public DesignSurface (
    Type rootComponentType
)

JScript

public function DesignSurface (
    rootComponentType : Type
)

パラメータ

rootComponentType

作成するルート コンポーネントの型。

例外

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

解説

DesignSurface コンストラクタを使用すると、指定された型のコンポーネントを作成し、読み込みプロセスを終了する簡単なデザイナ ローダーが作成されます。状態のすべての保存を外部で実行することを想定している場合は、この方法によってデザイナを簡単に作成できます。内部では、このコンストラクタは BeginLoad を呼び出し、ルート コンポーネントの型を渡します。

メモ
DesignSurface オーバーロードは、DesignerOptions によって影響されません。デザイン サーフェイスによる読み込みの前に、DesignerOptions をサービス コンテナに含める必要があります。DesignerOptions にアクセスする必要がある場合は、空のコンストラクタを呼び出して、DesignerOptions を ServiceContainer に追加し、rootComponentType を指定して BeginLoad を呼び出します。

.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 名前空間

DesignSurface コンストラクタ (IServiceProvider, Type)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

DesignSurface クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    parentProvider As IServiceProvider, _
    rootComponentType As Type _
)

Visual Basic (使用法)

Dim parentProvider As IServiceProvider
Dim rootComponentType As Type

Dim instance As New DesignSurface(parentProvider,
 rootComponentType)

C#

public DesignSurface (
    IServiceProvider parentProvider,
    Type rootComponentType
)

C++

public:
DesignSurface (
    IServiceProvider^ parentProvider, 
    Type^ rootComponentType
)

J#

public DesignSurface (
    IServiceProvider parentProvider, 
    Type rootComponentType
)

JScript

public function DesignSurface (
    parentProvider : IServiceProvider, 
    rootComponentType : Type
)

パラメータ

parentProvider

親サービス プロバイダ。サービスの解決に使用する親が存在しない場合は null 参照 (Visual Basic では Nothing)。

rootComponentType

作成するルート コンポーネントの型。

例外

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

解説

DesignSurface コンストラクタを使用すると、指定された型のコンポーネントを作成し、読み込みプロセスを終了する簡単なデザイナ ローダーが作成されます。状態のすべての保存を外部で実行することを想定している場合は、この方法によってデザイナを簡単に作成できます。内部では、このコンストラクタは BeginLoad を呼び出し、ルート コンポーネントの型を渡します。

.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 名前空間
IServiceProvider

DesignSurface コンストラクタ (IServiceProvider)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

DesignSurface クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    parentProvider As IServiceProvider _
)

Visual Basic (使用法)

Dim parentProvider As IServiceProvider

Dim instance As New DesignSurface(parentProvider)

C#

public DesignSurface (
    IServiceProvider parentProvider
)

C++

public:
DesignSurface (
    IServiceProvider^ parentProvider
)

J#

public DesignSurface (
    IServiceProvider parentProvider
)

JScript

public function DesignSurface (
    parentProvider : IServiceProvider
)

パラメータ

parentProvider

親サービス プロバイダ。サービスの解決に使用する親が存在しない場合は null 参照 (Visual Basic では Nothing)。

例外

例外の種類	条件
ObjectDisposedException	DesignSurface に追加した IDesignerHost は破棄されています。

解説

parentProvide が存在するときには、領域に含まれるデザイナはアプリケーションからサービスを取得できます。

.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 名前空間
IServiceProvider

DesignSurface コンストラクタ

DesignSurface クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
DesignSurface ()	DesignSurface クラスの新しいインスタンスを初期化します。
DesignSurface (IServiceProvider)	DesignSurface クラスの新しいインスタンスを初期化します。
DesignSurface (Type)	DesignSurface クラスの新しいインスタンスを初期化します。
DesignSurface (IServiceProvider, Type)	DesignSurface クラスの新しいインスタンスを初期化します。

参照

関連項目

DesignSurface クラス
DesignSurface メンバ
System.ComponentModel.Design 名前空間

DesignSurface プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	ComponentContainer	デザイン サーフェイス内の IContainer 実装を取得します。
	IsLoaded	デザイン サーフェイスが現在読み込まれているかどうかを示す値を取得します。
	LoadErrors	読み込みエラーのコレクションまたは void コレクションを返します。
	View	ルート デザイナのビューを取得します。

プロテクト プロパティ

	名前	説明
	ServiceContainer	サービス コンテナを取得します。

参照

関連項目

DesignSurface クラス
System.ComponentModel.Design 名前空間
IDesignerHost
IServiceProvider
DesignerLoader
IDesignerLoaderService

DesignSurface メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginLoad	オーバーロードされます。 読み込みプロセスを開始します。
	CreateNestedContainer	オーバーロードされます。 コントロールまたはコンポーネントの入れ子に適したコンテナを作成します。
	Dispose	オーバーロードされます。 DesignSurface によって使用されているリソースを解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Flush	デザイン サーフェイスへの変更をシリアル化します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetService	サービス コンテナからサービスを取得します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	CreateComponent	コンポーネントのインスタンスを作成します。
	CreateDesigner	コンテナにコンポーネントが追加されたときに、デザイナを作成します。
	CreateInstance	指定された型のインスタンスを作成します。
	Dispose	オーバーロードされます。 DesignSurface によって使用されているリソースを解放します。
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	OnLoaded	Loaded イベントを発生させます。
	OnLoading	Loading イベントを発生させます。
	OnUnloaded	Unloaded イベントを発生させます。
	OnUnloading	Unloading イベントを発生させます。
	OnViewActivate	ViewActivated イベントを発生させます。

参照

関連項目

DesignSurface クラス
System.ComponentModel.Design 名前空間
IDesignerHost
IServiceProvider
DesignerLoader
IDesignerLoaderService

DesignSurface メンバ

コンポーネントをデザインするためのユーザー インターフェイスを提供します。

DesignSurface データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	DesignSurface	オーバーロードされます。 DesignSurface クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	ComponentContainer	デザイン サーフェイス内の IContainer 実装を取得します。
	IsLoaded	デザイン サーフェイスが現在読み込まれているかどうかを示す値を取得します。
	LoadErrors	読み込みエラーのコレクションまたは void コレクションを返します。
	View	ルート デザイナのビューを取得します。

プロテクト プロパティ

	名前	説明
	ServiceContainer	サービス コンテナを取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginLoad	オーバーロードされます。 読み込みプロセスを開始します。
	CreateNestedContainer	オーバーロードされます。 コントロールまたはコンポーネントの入れ子に適したコンテナを作成します。
	Dispose	オーバーロードされます。 DesignSurface によって使用されているリソースを解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Flush	デザイン サーフェイスへの変更をシリアル化します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetService	サービス コンテナからサービスを取得します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	CreateComponent	コンポーネントのインスタンスを作成します。
	CreateDesigner	コンテナにコンポーネントが追加されたときに、デザイナを作成します。
	CreateInstance	指定された型のインスタンスを作成します。
	Dispose	オーバーロードされます。 DesignSurface によって使用されているリソースを解放します。
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnLoaded	Loaded イベントを発生させます。
	OnLoading	Loading イベントを発生させます。
	OnUnloaded	Unloaded イベントを発生させます。
	OnUnloading	Unloading イベントを発生させます。
	OnViewActivate	ViewActivated イベントを発生させます。

パブリック イベント

	名前	説明
	Disposed	デザイン サーフェイスが破棄されたときに発生します。
	Flushed	DesignSurface の Flush メソッドが呼び出されたときに発生します。
	Loaded	デザイナの読み込みが完了したときに発生します。
	Loading	デザイナの読み込みを開始する直前に発生します。
	Unloaded	デザイナのアンロードを終了したときに発生します。
	Unloading	デザイナのアンロードを開始する直前に発生します。
	ViewActivated	Activate メソッドが IDesignerHost に対して呼び出されたときに発生します。

参照

関連項目

DesignSurface クラス
System.ComponentModel.Design 名前空間
IDesignerHost
IServiceProvider
DesignerLoader
IDesignerLoaderService