DesignerRegionとは何？わかりやすく解説 Weblio辞書

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

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

Public Class DesignerRegion
    Inherits DesignerObject

Visual Basic (使用法)

Dim instance As DesignerRegion

C#

public class DesignerRegion : DesignerObject

C++

public ref class DesignerRegion : public
 DesignerObject

J#

public class DesignerRegion extends DesignerObject

JScript

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) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DesignerRegion メンバ
System.Web.UI.Design 名前空間
ControlDesigner クラス
Regions
EditableDesignerRegion
TemplatedEditableDesignerRegion
その他の技術情報
デザイン時サポートの拡張
方法 : デザインモードでコントロールの外観と動作を拡張する

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim designer As ControlDesigner
Dim name As String
Dim selectable As Boolean

Dim instance As New DesignerRegion(designer,
 name, selectable)

C#

public DesignerRegion (
    ControlDesigner designer,
    string name,
    bool selectable
)

C++

public:
DesignerRegion (
    ControlDesigner^ designer, 
    String^ name, 
    bool selectable
)

J#

public DesignerRegion (
    ControlDesigner designer, 
    String name, 
    boolean selectable
)

JScript

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 が空の文字列 ("") です。

例外の種類

条件

ArgumentNullException

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

または

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

または

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

または

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

解説

DesignerRegion クラスのインスタンスの初期プロパティ値を次の表に示します。

プロパティ	初期値
Description	空の文字列 ("")
Designer	入力 designer オブジェクト
DisplayName	空の文字列 ("")
EnsureSize	false
Highlight	false
Name	入力 name オブジェクト
Properties	空の HybridDictionary オブジェクト
Selectable	入力 selectable 値
Selected	false
UserData	null 参照 (Visual Basic では Nothing)

.NET Framework のセキュリティ

直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DesignerRegion クラス
DesignerRegion メンバ
System.Web.UI.Design 名前空間
その他の技術情報
デザイン時サポートの拡張
方法 : デザインモードでコントロールの外観と動作を拡張する

DesignerRegion クラスの新しいインスタンスを初期化します。デザイン時サポートの拡張方法 : デザインモードでコントロールの外観と動作を拡張する
 オーバーロードの一覧

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

参照

その他の技術情報

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

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim designer As ControlDesigner
Dim name As String

Dim instance As New DesignerRegion(designer,
 name)

C#

public DesignerRegion (
    ControlDesigner designer,
    string name
)

C++

public:
DesignerRegion (
    ControlDesigner^ designer, 
    String^ name
)

J#

public DesignerRegion (
    ControlDesigner designer, 
    String name
)

JScript

public function DesignerRegion (
    designer : ControlDesigner, 
    name : String
)

パラメータ

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

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

例外

例外の種類	条件
ArgumentNullException	designer が null 参照 (Visual Basic では Nothing) です。または designer が空の文字列 ("") です。または name が null 参照 (Visual Basic では Nothing) です。または name が空の文字列 ("") です。

例外の種類

条件

ArgumentNullException

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

または

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

または

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

または

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

解説

DesignerRegion クラスのインスタンスの初期プロパティ値を次の表に示します。

プロパティ	初期値
Description	空の文字列 ("")
Designer	入力 designer オブジェクト
DisplayName	空の文字列 ("")
EnsureSize	false
Highlight	false
Name	入力 name オブジェクト
Properties	空の HybridDictionary オブジェクト
Selectable	false
Selected	false
UserData	null 参照 (Visual Basic では Nothing)

.NET Framework のセキュリティ

直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DesignerRegion クラス
DesignerRegion メンバ
System.Web.UI.Design 名前空間
その他の技術情報
デザイン時サポートの拡張
方法 : デザインモードでコントロールの外観と動作を拡張する
デザイン時サポートの拡張
方法 : デザインモードでコントロールの外観と動作を拡張する

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

	名前	説明
	DesignerRegionAttributeName	デザイナ領域の HTML 属性名を定義します。

参照

その他の技術情報

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

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

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

参照

その他の技術情報

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

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

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetBounds	デザインサーフェイス上のデザイナ領域のサイズを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetService	指定した型で識別されるサービスをデザインホストから取得します。 ( DesignerObject から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

その他の技術情報

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

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

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

パブリックコンストラクタ

	名前	説明
	DesignerRegion	オーバーロードされます。 DesignerRegion クラスの新しいインスタンスを初期化します。

パブリックフィールド

	名前	説明
	DesignerRegionAttributeName	デザイナ領域の HTML 属性名を定義します。

パブリックプロパティ

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

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetBounds	デザインサーフェイス上のデザイナ領域のサイズを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetService	指定した型で識別されるサービスをデザインホストから取得します。 (DesignerObject から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

その他の技術情報

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

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

DesignerRegion クラス

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

DesignerRegion コンストラクタ

関連項目

その他の技術情報

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

DesignerRegion フィールド

関連項目

その他の技術情報

DesignerRegion プロパティ

関連項目

その他の技術情報

DesignerRegion メソッド

関連項目

その他の技術情報

DesignerRegion メンバ

関連項目

その他の技術情報

「DesignerRegion」の関連用語


	© 2025 Microsoft.All rights reserved.

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

DesignerRegion クラス

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

DesignerRegion コンストラクタ

関連項目

その他の技術情報

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

DesignerRegion フィールド

関連項目

その他の技術情報

DesignerRegion プロパティ

関連項目

その他の技術情報

DesignerRegion メソッド

関連項目

その他の技術情報

DesignerRegion メンバ

関連項目

その他の技術情報

急上昇のことば

「DesignerRegion」の関連用語

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