Form.AddOwnedForm メソッド

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

Form.AddOwnedForm メソッド

対象となるフォームに、所有される側のフォームを追加します。

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

Visual Basic (宣言)

Public Sub AddOwnedForm ( _
    ownedForm As Form _
)

Visual Basic (使用法)

Dim instance As Form
Dim ownedForm As Form

instance.AddOwnedForm(ownedForm)

C#

public void AddOwnedForm (
    Form ownedForm
)

C++

public:
void AddOwnedForm (
    Form^ ownedForm
)

J#

public void AddOwnedForm (
    Form ownedForm
)

JScript

public function AddOwnedForm (
    ownedForm : Form
)

パラメータ

ownedForm

対象となるフォームがこれから所有する Form。

解説

所有側のフォームに割り当てられたフォームは、RemoveOwnedForm メソッドが呼び出されるまで所有されたままになります。Owner プロパティに所有側フォームへの参照を設定することでも、フォームを別のフォームによって所有させることができます。

フォームが別のフォームによって所有されている場合は、所有している側のフォームと連動して最小化したり閉じたりします。たとえば、Form2 がフォーム Form1 に所有されている場合、Form1 が閉じられるか最小化されると、Form2 も閉じられるか最小化されます。また、所有される側のフォームを所有する側のフォームの背面に表示することはできません。所有されているフォームは、検索ウィンドウや置換ウィンドウなど、所有側のフォームが選択されているときにその背面に表示できないようにするウィンドウに使用できます。

メモ
フォームがマルチ ドキュメント インターフェイス (MDI) 親フォームである場合、このプロパティは、現在開かれている MDI 子フォームを除き、表示されているすべてのフォームを返します。MDI 親フォームで開かれている MDI 子フォームを取得するには、MdiChildren プロパティを使用します。

使用例

AddOwnedForm メソッドを使用して、あるフォームを、他のフォームの所有されているフォームとして表示する方法を次のコード例に示します。所有される側のフォームが表示されると、所有側のフォームを最小化できるようになります。また、これに伴って所有される側のフォームも最小化されます。この例のコードは、フォームの他のイベントまたはメソッドから呼び出されることを前提にしています。

Visual Basic

Private Sub ShowMyOwnedForm()
   ' Create an instance of the form to be owned.
   Dim ownedForm As New
 Form()
   ' Set the text of the form to identify it is an owned form.
   ownedForm.Text = "Owned Form"
   ' Add ownedForm to array of owned forms.
   Me.AddOwnedForm(ownedForm)

   ' Show the owned form.
   ownedForm.Show()
End Sub

C#

private void ShowMyOwnedForm()
{
   // Create an instance of the form to be owned.
   Form ownedForm = new Form();
   // Set the text of the form to identify it is an owned form.
   ownedForm.Text = "Owned Form";
   // Add ownedForm to array of owned forms.
   this.AddOwnedForm(ownedForm);

   // Show the owned form.
   ownedForm.Show();
}

C++

private:
   void ShowMyOwnedForm()
   {
      // Create an instance of the form to be owned.
      Form^ ownedForm = gcnew Form;

      // Set the text of the form to identify it is an owned form.
      ownedForm->Text = "Owned Form";

      // Add ownedForm to array of owned forms.
      this->AddOwnedForm( ownedForm );

      // Show the owned form.
      ownedForm->Show();
   }

J#

private void ShowMyOwnedForm()
{
    // Create an instance of the form to be owned.
    Form ownedForm = new Form();

    // Set the text of the form to identify it is an owned form.
    ownedForm.set_Text("Owned Form");

    // Add ownedForm to array of owned forms.
    this.AddOwnedForm(ownedForm);

    // Show the owned form.
    ownedForm.Show();
} //ShowMyOwnedForm

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0

参照

関連項目
Form クラス
Form メンバ
System.Windows.Forms 名前空間
OwnedForms
RemoveOwnedForm
Owner