Form.AddOwnedForm メソッド
対象となるフォームに、所有される側のフォームを追加します。
Public Sub AddOwnedForm( _
ByVal ownedForm As Form _)
[C#]
public void AddOwnedForm(FormownedForm);
[C++]
public: void AddOwnedForm(Form* ownedForm);
[JScript]
public function AddOwnedForm(
ownedForm : Form);
パラメータ
- ownedForm
対象となるフォームがこれから所有する Form 。
解説
所有側のフォームに割り当てられたフォームは、 RemoveOwnedForm メソッドが呼び出されるまで所有されたままになります。 Owner プロパティに所有側フォームへの参照を設定することでも、フォームを別のフォームによって所有させることができます。
フォームが別のフォームによって所有されている場合は、所有している側のフォームと連動して最小化したり閉じたりします。たとえば、 Form2
がフォーム Form1
に所有されている場合、 Form1
が閉じられるか最小化されると、 Form2
も閉じられるか最小化されます。また、所有される側のフォームを所有する側のフォームの背面に表示することはできません。所有されているフォームは、検索ウィンドウや置換ウィンドウなど、所有側のフォームが選択されているときにその背面に表示できないようにするウィンドウに使用できます。
メモ フォームがマルチ ドキュメント インターフェイス (MDI) 親フォームである場合、このプロパティは、現在開かれている MDI 子フォームを除き、表示されているすべてのフォームを返します。MDI 親フォームで開かれている MDI 子フォームを取得するには、 MdiChildren プロパティを使用します。
使用例
[Visual Basic, C#, C++] AddOwnedForm メソッドを使用して、あるフォームを、他のフォームの所有されているフォームとして表示する方法の例を次に示します。所有される側のフォームが表示されると、所有側のフォームを最小化できるようになります。また、これに伴って所有される側のフォームも最小化されます。この例のコードは、フォームの他のイベントまたはメソッドから呼び出されることを前提にしています。
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 = new Form();
// Set the text of the form to identify it is an owned form.
ownedForm->Text = S"Owned Form";
// Add ownedForm to array of owned forms.
this->AddOwnedForm(ownedForm);
// Show the owned form.
ownedForm->Show();
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
Form クラス | Form メンバ | System.Windows.Forms 名前空間 | OwnedForms | RemoveOwnedForm | Owner