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. これらのサービスのほとんどは、保護されたで置き換えることによってオーバーライドできますServiceContainerプロパティ。Most of these services can be overridden by replacing them in the protected ServiceContainer property. サービスを置換するコンス トラクターをオーバーライドし、基本をを通じて、保護された変更を加える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 独自の拡張プロバイダーを提供するコンテナーのコンポーネントのコレクションの一部ではないオブジェクトを有効にします。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. このサービスは、拡張プロバイダーは、コンテナーの外部で live ことができます。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クラスでは、コンポーネントのサイトで使用可能な 1 つのサービスも提供します。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. 値を要求: LinkDemandInheritanceDemandします。Demand values: LinkDemand, InheritanceDemand. 関連付けられた状態。Associated state:

適用対象

こちらもご覧ください