DesignerRegionとは? わかりやすく解説

DesignerRegion クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文構文

Public Class DesignerRegion
    Inherits DesignerObject
Dim instance As DesignerRegion
public class DesignerRegion : DesignerObject
public ref class DesignerRegion : public
 DesignerObject
public class DesignerRegion extends DesignerObject
public class DesignerRegion extends
 DesignerObject
解説解説

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

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

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

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

継承階層継承階層
System.Object
   System.Web.UI.Design.DesignerObject
    System.Web.UI.Design.DesignerRegion
       System.Web.UI.Design.EditableDesignerRegion
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
DesignerRegion メンバ
System.Web.UI.Design 名前空間
ControlDesigner クラス
Regions
EditableDesignerRegion
TemplatedEditableDesignerRegion
その他の技術情報
デザイン時サポートの拡張
方法 : デザイン モードでコントロールの外観と動作を拡張する

DesignerRegion コンストラクタ (ControlDesigner, String, Boolean)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文構文

Public Sub New ( _
    designer As ControlDesigner, _
    name As String, _
    selectable As Boolean _
)
Dim designer As ControlDesigner
Dim name As String
Dim selectable As Boolean

Dim instance As New DesignerRegion(designer,
 name, selectable)
public DesignerRegion (
    ControlDesigner designer,
    string name,
    bool selectable
)
public:
DesignerRegion (
    ControlDesigner^ designer, 
    String^ name, 
    bool selectable
)
public DesignerRegion (
    ControlDesigner designer, 
    String name, 
    boolean selectable
)
public function DesignerRegion (
    designer : ControlDesigner, 
    name : String, 
    selectable : boolean
)

パラメータ

designer

このデザイナ領域を含むコントロール デザイナ。

name

このデザイナ領域の名前。

selectable

領域を選択する場合は true。それ以外の場合は false。

例外例外
例外の種類条件

ArgumentNullException

designer が null 参照 (Visual Basic では Nothing) です。

または

designer が空の文字列 ("") です。

または

name が null 参照 (Visual Basic では Nothing) です。

または

name が空の文字列 ("") です。

解説解説
.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

DesignerRegion コンストラクタ


DesignerRegion コンストラクタ (ControlDesigner, String)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

コントロール デザイナの指定した名前を使用して、DesignerRegion クラスの新しいインスタンスを初期化します。

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文構文

Public Sub New ( _
    designer As ControlDesigner, _
    name As String _
)
Dim designer As ControlDesigner
Dim name As String

Dim instance As New DesignerRegion(designer,
 name)
public DesignerRegion (
    ControlDesigner designer,
    string name
)
public:
DesignerRegion (
    ControlDesigner^ designer, 
    String^ name
)
public DesignerRegion (
    ControlDesigner designer, 
    String name
)
public function DesignerRegion (
    designer : ControlDesigner, 
    name : String
)

パラメータ

designer

このデザイナ領域を含むコントロール デザイナ。

name

このデザイナ領域の名前。

例外例外
例外の種類条件

ArgumentNullException

designer が null 参照 (Visual Basic では Nothing) です。

または

designer が空の文字列 ("") です。

または

name が null 参照 (Visual Basic では Nothing) です。

または

name が空の文字列 ("") です。

解説解説
.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

DesignerRegion フィールド


パブリック フィールドパブリック フィールド

  名前 説明
パブリック フィールド DesignerRegionAttributeName デザイナ領域の HTML 属性名を定義します。
参照参照

関連項目

DesignerRegion クラス
System.Web.UI.Design 名前空間
ControlDesigner クラス
Regions
EditableDesignerRegion
TemplatedEditableDesignerRegion

その他の技術情報

デザイン時サポートの拡張
方法 : デザイン モードでコントロールの外観と動作を拡張する

DesignerRegion プロパティ


パブリック プロパティパブリック プロパティ

参照参照

関連項目

DesignerRegion クラス
System.Web.UI.Design 名前空間
ControlDesigner クラス
Regions
EditableDesignerRegion
TemplatedEditableDesignerRegion

その他の技術情報

デザイン時サポートの拡張
方法 : デザイン モードでコントロールの外観と動作を拡張する

DesignerRegion メソッド


パブリック メソッドパブリック メソッド

プロテクト メソッドプロテクト メソッド
参照参照

関連項目

DesignerRegion クラス
System.Web.UI.Design 名前空間
ControlDesigner クラス
Regions
EditableDesignerRegion
TemplatedEditableDesignerRegion

その他の技術情報

デザイン時サポートの拡張
方法 : デザイン モードでコントロールの外観と動作を拡張する

DesignerRegion メンバ

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

DesignerRegion データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
パブリック フィールドパブリック フィールド
  名前 説明
パブリック フィールド DesignerRegionAttributeName デザイナ領域の HTML 属性名を定義します。
パブリック プロパティパブリック プロパティ
パブリック メソッドパブリック メソッド
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

DesignerRegion クラス
System.Web.UI.Design 名前空間
ControlDesigner クラス
Regions
EditableDesignerRegion
TemplatedEditableDesignerRegion

その他の技術情報

デザイン時サポートの拡張
方法 : デザイン モードでコントロールの外観と動作を拡張する



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「DesignerRegion」の関連用語

DesignerRegionのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



DesignerRegionのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS