DesignerRegion クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
関連するコントロールのためのデザイン時マークアップ内の内容の領域を定義します。
public ref class DesignerRegion : System::Web::UI::Design::DesignerObjectpublic class DesignerRegion : System.Web.UI.Design.DesignerObjecttype DesignerRegion = class
inherit DesignerObjectPublic Class DesignerRegion
Inherits DesignerObject- 継承
- 派生
注釈
オブジェクトは 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) |
拡張メソッド
適用対象
こちらもご覧ください
.NET