DesignSurface クラス

定義

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

public ref class DesignSurface : IDisposable, IServiceProvider
public class DesignSurface : IDisposable, IServiceProvider
[System.Security.SecurityCritical]
public class DesignSurface : IDisposable, IServiceProvider
type DesignSurface = class
    interface IDisposable
    interface IServiceProvider
[<System.Security.SecurityCritical>]
type DesignSurface = class
    interface IDisposable
    interface IServiceProvider
Public Class DesignSurface
Implements IDisposable, IServiceProvider
継承
DesignSurface
属性
実装

注釈

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

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

クラスは 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 に対して呼び出されたときに発生します。

適用対象

こちらもご覧ください