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

定義

子コントロールに対するデザイン時の機能を有効にします。Enables design time functionality for a child control.

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

デザイン モードを有効にする子コントロール。The child control for which design mode will be enabled.

name
String

エンド ユーザーに公開する child の名前。The name of child as exposed to the end user.

戻り値

デザイン時に子コントロールを有効にできる場合は true です。ホストのインフラストラクチャがサポートしていない場合は false です。true if the child control could be enabled for design time; false if the hosting infrastructure does not support it.

例外

child または namenull です。child or name is null.

注釈

child によって指定された子コントロールは、このコントロールデザイナーのコントロールの子です。The child control specified by child is a child of this control designer's control. 子は永続化に直接参加しませんが、メインコントロールのプロパティとして公開されている場合は、この子は永続化されます。The child does not directly participate in persistence, but it will if it is exposed as a property of the main control. SplitContainerのようなコントロールを考えてみます。 Panel1Panel2の2つのパネルがあります。Consider a control like the SplitContainer: it has two panels, Panel1 and Panel2. これらのパネルは、SplitContainer コントロールの読み取り専用の Panel1Panel2 プロパティを使用して公開されます。These panels are exposed through read only Panel1 and Panel2 properties on the SplitContainer control. SplitContainer コントロールのデザイナーは、各パネルの EnableDesignMode を呼び出します。これにより、他のコンポーネントをドロップできます。The SplitContainer control's designer calls EnableDesignMode for each panel, which allows other components to be dropped on them. ただし、Panel1Panel2 の内容を保存するためには、SplitContainer コントロール自体が、パネルをパブリックプロパティとして公開する必要があります。But, in order for the contents of Panel1 and Panel2 to be saved, the SplitContainer control itself must expose the panels as public properties.

コントロール名はコントロールデザイナー内で一意である必要がありますが、他のコントロールデザイナーの子に対して一意である必要はありません。Control names must be unique within a control designer, but they are not required to be unique with respect to the children of other control designers.

この機能をサポートするには、ホスティングインフラストラクチャで、サイトを介して INestedContainer クラスをサービスとして公開する必要があります。To support this feature, the hosting infrastructure must expose the INestedContainer class as a service through the site.

適用対象