DesignSurface クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コンポーネントをデザインするためのユーザー インターフェイスを提供します。
public ref class DesignSurface : IDisposable, IServiceProviderpublic class DesignSurface : IDisposable, IServiceProvider[System.Security.SecurityCritical]
public class DesignSurface : IDisposable, IServiceProvidertype DesignSurface = class
interface IDisposable
interface IServiceProvider[<System.Security.SecurityCritical>]
type DesignSurface = class
interface IDisposable
interface IServiceProviderPublic Class DesignSurface
Implements IDisposable, IServiceProvider- 継承
-
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 に対して呼び出されたときに発生します。 |
