DesignSurface クラス

定義

名前空間:

System.ComponentModel.Design

アセンブリ:

System.Windows.Forms.Design.dll

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

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

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

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

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

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

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

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

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

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

注意事項

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

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

コンストラクター

DesignSurface()	DesignSurface クラスの新しいインスタンスを初期化します。
DesignSurface(IServiceProvider)	DesignSurface クラスの新しいインスタンスを初期化します。
DesignSurface(IServiceProvider, Type)	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)	コントロールまたはコンポーネントの入れ子に適したコンテナーを作成します。
CreateNestedContainer(IComponent, String)	コントロールまたはコンポーネントの入れ子に適したコンテナーを作成します。
Dispose()	DesignSurface で使用したリソースを解放します。
Dispose(Boolean)	DesignSurface で使用したリソースを解放します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
Flush()	デザイン サーフェイスへの変更をシリアル化します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetService(Type)	サービス コンテナーからサービスを取得します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
OnLoaded(LoadedEventArgs)	Loaded イベントを発生させます。
OnLoading(EventArgs)	Loading イベントを発生させます。
OnUnloaded(EventArgs)	Unloaded イベントを発生させます。
OnUnloading(EventArgs)	Unloading イベントを発生させます。
OnViewActivate(EventArgs)	ViewActivated イベントを発生させます。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

イベント

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

こちらもご覧ください

• IDesignerHost
• IServiceProvider
• DesignerLoader
• IDesignerLoaderService