DesignSurface クラス

定義

名前空間:

System.ComponentModel.Design

アセンブリ:

System.Windows.Forms.Design.dll

ソース:

DesignSurface.cs

コンポーネントを設計するためのユーザー インターフェイスを示します。

public ref class DesignSurface : IDisposable, IServiceProvider

public class DesignSurface : IDisposable, IServiceProvider

type DesignSurface = class
    interface IDisposable
    interface IServiceProvider

Public Class DesignSurface
Implements IDisposable, IServiceProvider

継承

Object

DesignSurface

注釈

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

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

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

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

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

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

Service	説明
IComponentChangeService	コンポーネントに対する変更が行われると、イベントを発生させます。
IDesignerHost	型、サービス、トランザクションへのアクセスを制御します。 デザイナーのプライマリ インターフェイス。
IContainer	設計されているコンポーネントのセットを所有します。 各デザイナーには、コンポーネントを所有する IContainer があります。
IServiceContainer	IServiceProviderから派生し、デザイナーからサービスを追加および削除する方法を提供します。

これらのサービスに加えて、 DesignSurface クラスは、コンポーネントのサイトを介して使用できる 1 つのサービスも提供します。 このサービスは、コンポーネントごとに一意です。 次の表に、置き換えることができないサービスを示します。

Service	説明
IDictionaryService	コンポーネントに関する任意のデータを格納するために使用できるキーと値のペアのジェネリック ディクショナリ。
INestedContainer	コンポーネントがデザイナーに子コンポーネントを追加できるようにするコンテナー。 これらのコンポーネントはデザイン サーフェイスの一部ですが、シリアル化には含まれません。 これは、デザイナーでそれ自体の領域を公開できるコントロールを設計する場合に、その領域をシリアル化に参加させたくない場合に便利です。

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

注意事項

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

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

コンストラクター

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

プロパティ

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

メソッド

名前	説明
BeginLoad(DesignerLoader)	指定されたデザイナー ローダーを使用して読み込みプロセスを開始します。
BeginLoad(Type)	読み込みプロセスを開始します。
CreateComponent(Type)	古い. コンポーネントのインスタンスを作成します。
CreateDesigner(IComponent, Boolean)	コンポーネントがコンテナーに追加されたときにデザイナーを作成します。
CreateInstance(Type)	指定された型のインスタンスを作成します。
CreateNestedContainer(IComponent, String)	コントロールまたはコンポーネントの入れ子に適したコンテナーを作成します。
CreateNestedContainer(IComponent)	コントロールまたはコンポーネントの入れ子に適したコンテナーを作成します。
Dispose()	DesignSurfaceによって使用されるリソースを解放します。
Dispose(Boolean)	DesignSurfaceによって使用されるリソースを解放します。
Flush()	デザイン サーフェイスに対する変更をシリアル化します。
GetService(Type)	サービス コンテナーからサービスを取得します。
OnLoaded(LoadedEventArgs)	Loaded イベントを発生させます。
OnLoading(EventArgs)	Loading イベントを発生させます。
OnUnloaded(EventArgs)	Unloaded イベントを発生させます。
OnUnloading(EventArgs)	Unloading イベントを発生させます。
OnViewActivate(EventArgs)	ViewActivated イベントを発生させます。

イベント

名前	説明
Disposed	デザイン サーフェイスが配置されるときに発生します。
Flushed	DesignSurfaceのFlush() メソッドに対して呼び出しが行われたときに発生します。
Loaded	デザイナーの読み込みが完了したときに発生します。
Loading	デザイナーが読み込まれようとしているときに発生します。
Unloaded	デザイナーのアンロードが完了したときに発生します。
Unloading	デザイナーがアンロードしようとしているときに発生します。
ViewActivated	IDesignerHostでActivate() メソッドが呼び出されたときに発生します。

こちらもご覧ください

• IDesignerHost
• IServiceProvider
• DesignerLoader
• IDesignerLoaderService