Form.AddOwnedForm(Form) メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

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

public:
 void AddOwnedForm(System::Windows::Forms::Form ^ ownedForm);

public void AddOwnedForm (System.Windows.Forms.Form ownedForm);

public void AddOwnedForm (System.Windows.Forms.Form? ownedForm);

member this.AddOwnedForm : System.Windows.Forms.Form -> unit

Public Sub AddOwnedForm (ownedForm As Form)

パラメーター

ownedForm

Form

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

例

次の例では、メソッドを使用して、フォームを AddOwnedForm 別のフォームの所有フォームとして表示する方法を示します。 所有フォームが表示されたら、その所有者フォームを最小限に抑えることができます。所有フォームは、そのフォームで最小限に抑えられます。 この例では、この例のコードをフォームの別のイベントまたはメソッドから呼び出す必要があります。

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();
   }

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();
}

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

注釈

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

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

注意

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

こちらもご覧ください

• OwnedForms
• RemoveOwnedForm(Form)
• Owner