DesignSurface クラス

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

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