ControlDesigner.EnableDesignMode メソッド

.NET Framework クラス ライブラリ リファレンス

ControlDesigner.EnableDesignMode メソッド

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

子コントロールに対するデザイン時の機能を有効にします。

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

Visual Basic (宣言)

Protected Function EnableDesignMode ( _
    child As Control, _
    name As String _
) As Boolean

Visual Basic (使用法)

Dim child As Control
Dim name As String
Dim returnValue As Boolean

returnValue = Me.EnableDesignMode(child, name)

C#

protected bool EnableDesignMode (
    Control child,
    string name
)

C++

protected:
bool EnableDesignMode (
    Control^ child, 
    String^ name
)

J#

protected boolean EnableDesignMode (
    Control child, 
    String name
)

JScript

protected function EnableDesignMode (
    child : Control, 
    name : String
) : boolean

パラメータ

child

デザイン モードを有効にする子コントロール。

name

エンド ユーザーに公開する child の名前。

戻り値
デザイン時に子コントロールを有効にできる場合は true です。ホストのインフラストラクチャがサポートしていない場合は false です。

例外

例外の種類	条件
ArgumentNullException	child または name が null 参照 (Visual Basic では Nothing) です。

解説

child で指定された子コントロールは、このコントロール デザイナのコントロールの子です。子コントロールは永続的に直接関与することはありませんが、メイン コントロールのプロパティとして公開される場合は関与します。SplitContainer のようなコントロールを例に説明します。このコントロールには、Panel1 と Panel2 の 2 つのパネルがあります。これらのパネルは、SplitContainer コントロールの読み取り専用の Panel1 プロパティと Panel2 プロパティを介して公開されます。SplitContainer コントロールのデザイナがそれぞれのパネルに対して EnableDesignMode を呼び出し、これによって他のコンポーネントをパネルにドロップできます。ただし、Panel1 と Panel2 のコンテンツを保存するには、SplitContainer コントロール自体でパネルをパブリック プロパティとして公開する必要があります。

コントロール名は 1 つのコントロール デザイナ内で一意にする必要がありますが、他のコントロール デザイナの子に対して一意にする必要はありません。

この機能をサポートするには、ホストのインフラストラクチャで、サイトを介するサービスとして INestedContainer クラスを公開する必要があります。

.NET Framework のセキュリティ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
ControlDesigner クラス
ControlDesigner メンバ
System.Windows.Forms.Design 名前空間