Form.OwnedForms プロパティ

定義

対象となるフォームによって所有されている全フォームを表す、Form オブジェクトの配列を取得します。Gets an array of Form objects that represent all forms that are owned by this form.

public:
 property cli::array <System::Windows::Forms::Form ^> ^ OwnedForms { cli::array <System::Windows::Forms::Form ^> ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.Form[] OwnedForms { get; }
[<System.ComponentModel.Browsable(false)>]
member this.OwnedForms : System.Windows.Forms.Form[]
Public ReadOnly Property OwnedForms As Form()

プロパティ値

Form[]

対象となるフォームによって所有されているフォームを表す Form 配列。A Form array that represents the owned forms for this form.

属性

次の例では、プロパティを使用し OwnedForms て、所有者フォームが所有するすべてのフォームを変更する方法を示します。The following example demonstrates how to use the OwnedForms property to modify all forms owned by the owner form. この例の最初のメソッドは、所有フォームに関連付けられている所有フォームの配列にフォームを追加します。The first method in the example adds forms to the array of owned forms associated with the owned form. 2番目のメソッドは、所有されているすべてのフォームをループし、キャプションを変更します。The second method loops through all owned forms and changes the caption. この例では、両方のメソッドが、フォームのイベントまたはその他のメソッドによって呼び出される必要があります。This example requires that both methods are called by an event or other method of a form.

private:
   void AddMyOwnedForm()
   {
      // Create form to be owned.
      Form^ ownedForm = gcnew Form;

      // Set the text of the owned form.
      ownedForm->Text = String::Format( "Owned Form {0}", this->OwnedForms->Length );

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

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

   void ChangeOwnedFormText()
   {
      // Loop through all owned forms and change their text.
      for ( int x = 0; x < this->OwnedForms->Length; x++ )
      {
         this->OwnedForms[ x ]->Text = String::Format( "My Owned Form {0}", x );
      }
   }
private void AddMyOwnedForm()
{
   // Create form to be owned.
   Form ownedForm = new Form();
   // Set the text of the owned form.
   ownedForm.Text = "Owned Form " + this.OwnedForms.Length;
   // Add the form to the array of owned forms.
   this.AddOwnedForm(ownedForm);
   // Show the owned form.
   ownedForm.Show();
}

private void ChangeOwnedFormText()
{
   // Loop through all owned forms and change their text.
   for (int x = 0; x < this.OwnedForms.Length; x++)
   {
      this.OwnedForms[x].Text = "My Owned Form " + x.ToString();
   }
}
Private Sub AddMyOwnedForm()
   ' Create form to be owned.
   Dim ownedForm As New Form()
   ' Set the text of the owned form.
   ownedForm.Text = "Owned Form " + Me.OwnedForms.Length.ToString()
   ' Add the form to the array of owned forms.
   Me.AddOwnedForm(ownedForm)
   ' Show the owned form.
   ownedForm.Show()
End Sub


Private Sub ChangeOwnedFormText()
   Dim x As Integer
   ' Loop through all owned forms and change their text.
   For x = 0 To (Me.OwnedForms.Length) - 1
      Me.OwnedForms(x).Text = "My Owned Form " + x.ToString()
   Next x
End Sub

注釈

このプロパティは、このフォームが所有するすべてのフォームを含む配列を返します。This property returns an array that contains all forms that are owned by this form. フォームが別のフォームに所有されるようにするには、メソッドを呼び出し AddOwnedForm ます。To make a form owned by another form, call the AddOwnedForm method. 所有者フォームに割り当てられたフォームは、メソッドが呼び出されるまで所有されたままになり RemoveOwnedForm ます。The form assigned to the owner form will remain 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. たとえば、という名前のフォームに所有されているという名前のフォームがあるとし Form2 Form1 ます。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 will return 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.

適用対象

こちらもご覧ください