DesignerRegion クラス

リファレンス

定義

名前空間:: System.Web.UI.Design

アセンブリ:: System.Design.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

関連するコントロールのためのデザイン時マークアップ内の内容の領域を定義します。

public ref class DesignerRegion : System::Web::UI::Design::DesignerObject

public class DesignerRegion : System.Web.UI.Design.DesignerObject

type DesignerRegion = class
    inherit DesignerObject

Public Class DesignerRegion
Inherits DesignerObject

継承: Object

DesignerObject
DesignerRegion

派生: System.Web.UI.Design.EditableDesignerRegion

注釈

オブジェクトは DesignerRegion 、実装によって生成されるデザイン時マークアップ内のコンテンツの領域を ControlDesigner 表します。コントロール開発者は、カスタム ControlDesigner 実装のデザイナー領域を使用して、関連付けられたコントロールのデザイン時マークアップ内の個別の領域を定義し、その領域の編集とイベント処理を提供します。 Visual Studio 2005 などのビジュアルデザイナーでは、デザイナー領域を使用して、デザインサーフェイスにコントロールの個別の領域を表示し、その領域のユーザーイベントをコントロールデザイナーに発生させることができます。デザイナー領域では、基本デザイナークラスとビジュアルデザイナーによって多くの領域ベースの機能が提供されるため、コントロールデザイナーの実装を簡略化できます。

クラスは DesignerRegion 、デザイン画面で領域をクリック、選択、強調表示する機能など、デザイナー領域の基本機能を提供します。 DesignerRegionコントロールデザイナーの実装でオブジェクトを使用して、編集を必要としない領域を定義します。デザイン時に編集可能なコンテンツを含む領域を定義するには、コントロールデザイナーの実装で派生 EditableDesignerRegion クラスを使用します。コントロールデザイナーの実装で派生 TemplatedEditableDesignerRegion クラスを使用して、コントロール内のテンプレートを表す編集可能な領域を定義します。

から ControlDesigner派生したクラス内の領域をサポートするには、メソッドを GetDesignTimeHtml オーバーライドし、1 つ以上の初期化された DesignerRegion オブジェクトをコレクションに DesignerRegionCollection 追加します。必要に応じて、メソッドをオーバーライドすることで、デザインサーフェイス上の領域でのマウスクリックを OnClick 処理できます。

ビジュアルデザイナーによる領域の表示方法を DesignerRegion 決定するには、オブジェクトのプロパティを使用します。プロパティを Selectable オーバーライドして、デザインサーフェイスでユーザーが領域を選択できることを示します。ビジュアルデザイナーで Highlight デザイナー領域を強調表示するには、プロパティを使用します。たとえば、ユーザーがクリックして選択した後で領域を強調表示できます。プロパティと Description プロパティをDisplayName使用して、リージョンに関する追加の詳細を格納または取得します。特に、プロパティは、 Description ユーザーがデザイナー領域の上にマウスポインターを移動したときにツールヒント情報を表示するために、ビジュアルデザイナーによって使用されます。デザイナー領域を Designer 含むコントロールデザイナーオブジェクトのメソッドとプロパティにアクセスするには、プロパティを使用します。

コンストラクター

DesignerRegion(ControlDesigner, String)	コントロールデザイナーの指定した名前を使用して、DesignerRegion クラスの新しいインスタンスを初期化します。
DesignerRegion(ControlDesigner, String, Boolean)	コントロールデザイナーの指定した名前を使用して、DesignerRegion クラスの新しいインスタンスを初期化します。オプションで、インスタンスをデザイナー内で選択可能な領域として設定します。

フィールド

DesignerRegionAttributeName

デザイナー領域の HTML 属性名を定義します。

プロパティ

Description	デザイナー領域の説明を取得または設定します。
Designer	関連付けられたデザイナーコンポーネントを取得します。 (継承元 DesignerObject)
DisplayName	デザイナー領域の表示名を取得または設定します。
EnsureSize	デザインホストで領域サイズをデザイナー領域に明示的に設定するかどうかを示す値を取得または設定します。
Highlight	デザインサーフェイス上でデザイナー領域を強調表示するかどうかを示す値を取得または設定します。
Name	オブジェクトの名前を取得します。 (継承元 DesignerObject)
Properties	オブジェクトのプロパティを取得します。 (継承元 DesignerObject)
Selectable	デザインサーフェイス上でユーザーがデザイナー領域を選択できるかどうかを示す値を取得または設定します。
Selected	デザインサーフェイス上でデザイナー領域が現在選択されているかどうかを示す値を取得または設定します。
UserData	デザイナー領域に関連付けるオプションのユーザーデータを取得または設定します。

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetBounds()	デザインサーフェイス上のデザイナー領域のサイズを取得します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetService(Type)	指定した型で識別されるサービスをデザインホストから取得します。 (継承元 DesignerObject)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

明示的なインターフェイスの実装

IServiceProvider.GetService(Type)

このメンバーの詳細については、「GetService(Type)」をご覧ください。

(継承元 DesignerObject)

適用対象