Form.AddOwnedForm(Form) Form.AddOwnedForm(Form) Form.AddOwnedForm(Form) Form.AddOwnedForm(Form) Method

定義

対象となるフォームに、所有される側のフォームを追加します。Adds an owned form to this form.

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 Form Form

対象となるフォームがこれから所有する FormThe Form that this form will own.

次の例は、 AddOwnedFormメソッドを使用して、フォームを別の形式の所有フォームとして表示する方法を示しています。The following example demonstrates how to use the AddOwnedForm method to display a form as an owned form of another form. 所有するフォームが表示されると、所有者フォームが最小化され、所有しているフォームによってそのフォームが最小化されます。Once the owned form is shown, you can minimize its owner form and the owned form will minimize with it. この例では、例のコードを別のイベントまたはフォームのメソッドから呼び出す必要があります。The example requires that the code in the example is called from another event or method of a form.

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メソッドが呼び出されるまで所有されたままになります。The form assigned to the owner form remains owned until the RemoveOwnedForm method is called. 所有者フォームへの参照を使用してプロパティをOwner設定することによって、他のユーザーが所有するフォームを作成することもできます。You can also make a form owned by another by setting the Owner property with a reference to its owner form.

フォームが別のフォームに所有されている場合は、所有者フォームで閉じられるか、非表示になります。When a form is owned by another form, it is closed or hidden with the owner form. たとえば、という名前のフォームForm2Form1所有されているという名前のフォームがあるとします。For example, consider a form named Form2 that is owned by a form named Form1. Form1閉じているか最小化Form2されている場合は、も閉じられるか、非表示になります。If Form1 is closed or minimized, Form2 is also closed or hidden. 所有フォームは、所有者フォームの背後にも表示されません。Owned forms are also never displayed behind their owner form. 所有しているフォーム ([検索と置換] ウィンドウなど) は、所有者フォームを選択したときに所有者フォームの背後に表示されないようにすることができます。You can use owned forms for windows such as find and replace windows, which should not be displayed behind the owner form when the owner form is selected.

注意

フォームがマルチドキュメントインターフェイス (MDI) 親フォームの場合、このプロパティは、現在開いている MDI 子フォームを除き、表示されるすべてのフォームを返します。If the form is a multiple-document interface (MDI) parent form, this property returns all forms that are displayed with the exception of any MDI child forms that are currently open. Mdi 親フォームで開かれている mdi 子フォームを取得するにMdiChildrenは、プロパティを使用します。To obtain the MDI child forms opened in an MDI parent form, use the MdiChildren property.

適用対象

こちらもご覧ください