DesignSurface DesignSurface DesignSurface DesignSurface Class

定義

コンポーネントをデザインするためのユーザー インターフェイスを提供します。Presents a user interface for designing components.

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

注釈

クラスDesignSurfaceは、ユーザーがデザイナーとして認識する内容を実装します。The DesignSurface class implements what the user perceives as a designer. DesignSurfaceは、ユーザーがデザイン時の機能を変更するために操作するユーザーインターフェイスです。DesignSurface is the user interface the user manipulates to change design-time features. DesignSurface完全に自己完結型のデザインサーフェイスを提供します。DesignSurface provides a completely self-contained design surface.

クラスDesignSurfaceは、スタンドアロンのデザイナーとして使用することも、 DesignSurfaceManagerクラスと組み合わせて使用して、複数DesignSurfaceのオブジェクトをホストするアプリケーションに共通の実装を提供することもできます。The DesignSurface class may be used as a stand-alone designer, or it may be coupled with the DesignSurfaceManager class to provide a common implementation for an application that hosts multiple DesignSurface objects.

DesignSurfaceクラスは、単独で使用することも、ユーザーがそこから新しいクラスを派生させ、動作を拡張することもできます。The DesignSurface class can be used by itself, or the user can derive a new class from it and augment the behavior.

クラスDesignSurfaceは、いくつかのデザイン時サービスを自動的に提供します。The DesignSurface class provides several design-time services automatically. クラスDesignSurfaceは、そのすべてのサービスをコンストラクターに追加します。The DesignSurface class adds all of its services in its constructor. これらのサービスのほとんどは、protected ServiceContainerプロパティで置き換えることによってオーバーライドできます。Most of these services can be overridden by replacing them in the protected ServiceContainer property. サービスを置き換えるには、コンストラクターをオーバーライドして base を呼び出し、protected ServiceContainerプロパティを使用して変更を行います。To replace a service, override the constructor, call base, and make any changes through the protected ServiceContainer property. サービスコンテナーに追加され、を実装IDisposableするすべてのサービスは、デザインサーフェイスが破棄されるときに破棄されます。All services that are added to the service container and that implement IDisposable are disposed when the design surface is disposed. 次の表に、クラスにDesignSurfaceよって提供される置き換え可能なサービスの既定のセットを示します。The default set of replaceable services that the DesignSurface class provides is shown in the following table.

サービスService 説明Description
IExtenderProviderService コンテナーのコンポーネントコレクションに含まれていないオブジェクトが、独自の extender プロバイダーを提供できるようにします。Enables objects that are not part of the container's components collection to provide their own extender providers.
IExtenderListService 拡張プロバイダー TypeDescriptorの一覧を取得するために、によって使用されます。Used by TypeDescriptor to get a list of extender providers. このサービスでは、拡張プロバイダーをコンテナーの外部にライブできます。With this service, extender providers can live outside of the container.
ITypeDescriptorFilterService デザイナーのメタデータフックを提供します。Provides designer metadata hooks. これは、メタデータフィルター処理の主要なインターフェイスです。This is the primary interface for metadata filtering.
ISelectionService デザイナーでコンポーネントを選択する方法を提供します。Provides a way to select components in the designer.
IReferenceService オブジェクトが配置されていない場合でも、オブジェクトの名前を取得する方法を提供します。Provides a way to get a name for objects, even when those objects are not sited.
DesignSurface は、デザインサーフェイス自体をサービスとして提供します。Offers the design surface itself as a service.
DesignerOptionService デザイナーのオプションの値を取得および設定するために使用する基本クラスを提供します。Provides a base class for getting and setting option values for a designer.

次の表は、既定で提供される置換不可能なサービスを示しています。The following table shows the non-replaceable services provided by default.

サービスService 説明Description
IComponentChangeService コンポーネントに変更が加えられたときにイベントを発生させます。Raises events as changes are made to components.
IDesignerHost 型、サービス、およびトランザクションへのアクセスを制御します。Controls access to types, services, and transactions. デザイナーのマスターインターフェイス。Master interface for designers.
IContainer デザイン中のコンポーネントのセットを所有します。Owns the set of components that are being designed. 各デザイナーにはIContainer 、コンポーネントを所有するがあります。Each designer has an IContainer that owns the components.
IServiceContainer はからIServiceProvider派生し、デザイナーからサービスを追加および削除する手段を提供します。Derives from IServiceProvider and provides a way to add and remove services from the designer.

これらのサービスに加えて、 DesignSurfaceクラスは、コンポーネントのサイトを介して使用できる単一のサービスも提供します。In addition to these services, the DesignSurface class also provides a single service that is available through a component's site. このサービスは、コンポーネントごとに一意です。This service is unique for each component. 次の表に、置き換えることができないサービスを示します。The following table shows the services that cannot be replaced.

サービスService 説明Description
IDictionaryService コンポーネントに関する任意のデータを格納するために使用できるキーと値のペアのジェネリックディクショナリ。A generic dictionary of key/value pairs that can be used to store arbitrary data about a component.
INestedContainer コンポーネントがデザイナーに子コンポーネントを追加できるようにするコンテナー。A container that enables a component to add additional child components to the designer. これらのコンポーネントはデザインサーフェイスの一部になりますが、シリアル化には関与しません。These components will be part of the design surface, but will not participate in serialization. これは、デザイナーで自身の領域を公開できるコントロールをデザインするときに、その領域をシリアル化に参加させたくない場合に便利です。This is useful when you want to design a control that is capable of exposing a region of itself in a designer, but you do not want the region to participate in serialization.

ISite加えて、サイトには次のインターフェイスも実装されています。In addition to ISite, the site also implements the following interfaces.

注意事項

他のサイト実装で実装されていない可能性があるため、区別キャストを使用するのではなく、これらのインターフェイスが存在するかどうかを確認してください。Check for the existence of these interfaces, rather than use indiscriminate casting, because other site implementations may not implement them.

サービスService 説明Description
IServiceContainer サイト固有のサービスのコンテナーにアクセスする方法を提供します。Provides a way to get to the container of site-specific services. たとえば、 IDictionaryServiceはサイト固有のサービスです。For example, IDictionaryService is a site-specific service. このサービスを使用すると、サイト固有のサービスを追加できます。With this service, you can add additional site-specific services.

コンストラクター

DesignSurface() DesignSurface() DesignSurface() DesignSurface()

DesignSurface クラスの新しいインスタンスを初期化します。Initializes a new instance of the DesignSurface class.

DesignSurface(IServiceProvider) DesignSurface(IServiceProvider) DesignSurface(IServiceProvider) DesignSurface(IServiceProvider)

DesignSurface クラスの新しいインスタンスを初期化します。Initializes a new instance of the DesignSurface class.

DesignSurface(IServiceProvider, Type) DesignSurface(IServiceProvider, Type) DesignSurface(IServiceProvider, Type) DesignSurface(IServiceProvider, Type)

DesignSurface クラスの新しいインスタンスを初期化します。Initializes a new instance of the DesignSurface class.

DesignSurface(Type) DesignSurface(Type) DesignSurface(Type) DesignSurface(Type)

DesignSurface クラスの新しいインスタンスを初期化します。Initializes a new instance of the DesignSurface class.

プロパティ

ComponentContainer ComponentContainer ComponentContainer ComponentContainer

デザイン サーフェイス内の IContainer 実装を取得します。Gets the IContainer implementation within the design surface.

DtelLoading DtelLoading DtelLoading DtelLoading

デザイン時エラー一覧が読み込まれているかどうかを示す値を取得します。Gets a value indicating whether the Design-time Error List is loading.

IsLoaded IsLoaded IsLoaded IsLoaded

デザイン サーフェイスが現在読み込まれているかどうかを示す値を取得します。Gets a value indicating whether the design surface is currently loaded.

LoadErrors LoadErrors LoadErrors LoadErrors

読み込みエラーのコレクションまたは void コレクションを返します。Returns a collection of loading errors or a void collection.

ServiceContainer ServiceContainer ServiceContainer ServiceContainer

サービス コンテナーを取得します。Gets the service container.

View View View View

ルート デザイナーのビューを取得します。Gets the view for the root designer.

メソッド

BeginLoad(DesignerLoader) BeginLoad(DesignerLoader) BeginLoad(DesignerLoader) BeginLoad(DesignerLoader)

指定したデザイナー ローダーを使用して、読み込みプロセスを開始します。Begins the loading process with the given designer loader.

BeginLoad(Type) BeginLoad(Type) BeginLoad(Type) BeginLoad(Type)

読み込みプロセスを開始します。Begins the loading process.

CreateComponent(Type) CreateComponent(Type) CreateComponent(Type) CreateComponent(Type)

コンポーネントのインスタンスを作成します。Creates an instance of a component.

CreateDesigner(IComponent, Boolean) CreateDesigner(IComponent, Boolean) CreateDesigner(IComponent, Boolean) CreateDesigner(IComponent, Boolean)

コンテナーにコンポーネントが追加されたときに、デザイナーを作成します。Creates a designer when a component is added to the container.

CreateInstance(Type) CreateInstance(Type) CreateInstance(Type) CreateInstance(Type)

指定された型のインスタンスを作成します。Creates an instance of the given type.

CreateNestedContainer(IComponent) CreateNestedContainer(IComponent) CreateNestedContainer(IComponent) CreateNestedContainer(IComponent)

コントロールまたはコンポーネントの入れ子に適したコンテナーを作成します。Creates a container suitable for nesting controls or components.

CreateNestedContainer(IComponent, String) CreateNestedContainer(IComponent, String) CreateNestedContainer(IComponent, String) CreateNestedContainer(IComponent, String)

コントロールまたはコンポーネントの入れ子に適したコンテナーを作成します。Creates a container suitable for nesting controls or components.

Dispose() Dispose() Dispose() Dispose()

DesignSurface で使用したリソースを解放します。Releases the resources used by the DesignSurface.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

DesignSurface で使用したリソースを解放します。Releases the resources used by the DesignSurface.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Flush() Flush() Flush() Flush()

デザイン サーフェイスへの変更をシリアル化します。Serializes changes to the design surface.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

サービス コンテナーからサービスを取得します。Gets a service from the service container.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
OnLoaded(LoadedEventArgs) OnLoaded(LoadedEventArgs) OnLoaded(LoadedEventArgs) OnLoaded(LoadedEventArgs)

Loaded イベントを発生させます。Raises the Loaded event.

OnLoading(EventArgs) OnLoading(EventArgs) OnLoading(EventArgs) OnLoading(EventArgs)

Loading イベントを発生させます。Raises the Loading event.

OnUnloaded(EventArgs) OnUnloaded(EventArgs) OnUnloaded(EventArgs) OnUnloaded(EventArgs)

Unloaded イベントを発生させます。Raises the Unloaded event.

OnUnloading(EventArgs) OnUnloading(EventArgs) OnUnloading(EventArgs) OnUnloading(EventArgs)

Unloading イベントを発生させます。Raises the Unloading event.

OnViewActivate(EventArgs) OnViewActivate(EventArgs) OnViewActivate(EventArgs) OnViewActivate(EventArgs)

ViewActivated イベントを発生させます。Raises the ViewActivated event.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

イベント

Disposed Disposed Disposed Disposed

デザイン サーフェイスが破棄されたときに発生します。Occurs when the design surface is disposed.

Flushed Flushed Flushed Flushed

Flush()DesignSurface メソッドが呼び出されたときに発生します。Occurs when a call is made to the Flush() method of DesignSurface.

Loaded Loaded Loaded Loaded

デザイナーの読み込みが完了したときに発生します。Occurs when the designer load has completed.

Loading Loading Loading Loading

デザイナーの読み込みを開始する直前に発生します。Occurs when the designer is about to be loaded.

Unloaded Unloaded Unloaded Unloaded

デザイナーのアンロードを終了したときに発生します。Occurs when a designer has finished unloading.

Unloading Unloading Unloading Unloading

デザイナーのアンロードを開始する直前に発生します。Occurs when a designer is about to unload.

ViewActivated ViewActivated ViewActivated ViewActivated

Activate() メソッドが IDesignerHost に対して呼び出されたときに発生します。Occurs when the Activate() method has been called on IDesignerHost.

セキュリティ

NamedPermissionSet
システムリソースにフルアクセスできます。for full access to system resources. 要求の値LinkDemand: InheritanceDemand、。Demand values: LinkDemand, InheritanceDemand. 関連付けられた状態:Associated state:

適用対象

こちらもご覧ください