ControlDesigner.EnableDesignMode(Control, String) メソッド

定義

名前空間:

System.Windows.Forms.Design

アセンブリ:

System.Windows.Forms.Design.dll

ソース:

ControlDesigner.cs

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

protected:
 bool EnableDesignMode(System::Windows::Forms::Control ^ child, System::String ^ name);

protected bool EnableDesignMode(System.Windows.Forms.Control child, string name);

member this.EnableDesignMode : System.Windows.Forms.Control * string -> bool

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

パラメーター

child

Control

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

name

String

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

返品

Boolean

true 子コントロールをデザイン時に有効にできる場合。ホスティング インフラストラクチャでサポートされていない場合は false します。

例外

ArgumentNullException

child または name が null。

注釈

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

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

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