Form.MdiParent プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

Form.MdiParent プロパティ

対象となるフォームの現在のマルチドキュメントインターフェイス (MDI) 親フォームを取得または設定します。

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

Visual Basic (宣言)

Public Property MdiParent As
 Form

Visual Basic (使用法)

Dim instance As Form
Dim value As Form

value = instance.MdiParent

instance.MdiParent = value

public Form MdiParent { get; set;
 }

C++

public:
property Form^ MdiParent {
    Form^ get ();
    void set (Form^ value);
}

/** @property */
public Form get_MdiParent ()

/** @property */
public void set_MdiParent (Form value)

JScript

public function get MdiParent
 () : Form

public function set MdiParent
 (value : Form)

プロパティ値
MDI 親フォームを表す Form。

例外

例外の種類	条件
Exception	このプロパティに割り当てられた Form が MDI コンテナとしてマークされていません。またはこのプロパティに割り当てられた Form が子フォームと MDI コンテナフォームの両方を表しています。またはこのプロパティに割り当てられた Form が別のスレッドにあります。

例外の種類

条件

Exception

このプロパティに割り当てられた Form が MDI コンテナとしてマークされていません。

または

このプロパティに割り当てられた Form が子フォームと MDI コンテナフォームの両方を表しています。

または

このプロパティに割り当てられた Form が別のスレッドにあります。

解説

MDI 子フォームを作成するには、MDI 親フォームになる Form を子フォームの MdiParent プロパティに割り当てます。このプロパティを MDI 子フォームから使用すると、すべての子フォームに必要なグローバル情報を取得したり、すべての子フォームに対してアクションを実行するメソッドを呼び出すことができます。

使用例

MDI アプリケーションに子フォームを作成する方法を次のコード例に示します。このコード例では、子フォームを特定するための一意のテキストを持つフォームを作成します。そして、MdiParent プロパティを使用して、フォームが子フォームであることを指定します。この例は、IsMdiContainer プロパティが true に設定されたフォームからコードが呼び出されていること、および、フォームが childCount というプライベートなクラスレベルの整数変数を持つことを前提にしています。

Visual Basic

Private Sub CreateMyChildForm()
   ' Create a new form to represent the child form.
   Dim child As New Form()
   ' Increment the private child count.
   childCount += 1
   ' Set the text of the child form using the count of child forms.
   Dim formText As String
 = "Child " + childCount.ToString()
   child.Text = formText

   ' Make the new form a child form.
   child.MdiParent = Me
   ' Display the child form.
   child.Show()
End Sub

private void CreateMyChildForm ()
{
   // Create a new form to represent the child form.
   Form child = new Form();
   // Increment the private child count.
   childCount++;
   // Set the text of the child form using the count of child forms.
   String formText = "Child " + childCount;
   child.Text = formText;

   // Make the new form a child form.
   child.MdiParent = this;
   // Display the child form.
   child.Show();
}

C++

private:
   void CreateMyChildForm()
   {
      // Create a new form to represent the child form.
      Form^ child = gcnew Form;

      // Increment the private child count.
      childCount++;

      // Set the text of the child form using the count of child forms.
      String^ formText = String::Format( "Child {0}", childCount );
      child->Text = formText;

      // Make the new form a child form.
      child->MdiParent = this;

      // Display the child form.
      child->Show();
   }

private void CreateMyChildForm()
{
    // Create a new form to represent the child form.
    Form child = new Form();

    // Increment the private child count.
    childCount++;

    // Set the text of the child form using the count of child forms.
    String formText = "Child " + childCount;
    child.set_Text(formText);

    // Make the new form a child form.
    child.set_MdiParent(this);

    // Display the child form.
    child.Show();
} //CreateMyChildForm