Form.OwnedForms Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft ein Array von Form Objekten ab, die alle Formulare darstellen, die diesem Formular gehören.
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()Eigenschaftswert
Ein Form Array, das die eigenen Formulare für dieses Formular darstellt.
- Attribute
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie OwnedForms die Eigenschaft zum Ändern aller Formulare verwendet wird, die dem Besitzerformular gehören. Die erste Methode im Beispiel fügt dem Array der eigenen Formulare, die dem eigenen Formular zugeordnet sind, Formulare hinzu. Die zweite Methode durchläuft alle eigenen Formulare und ändert die Beschriftung. Dieses Beispiel erfordert, dass beide Methoden von einem Ereignis oder einer anderen Methode eines Formulars aufgerufen werden.
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
Hinweise
Diese Eigenschaft gibt ein Array zurück, das alle Formulare enthält, die diesem Formular gehören. Rufen Sie die AddOwnedForm Methode auf, um ein Formular im Besitz eines anderen Formulars zu erstellen. Das formular, das dem Besitzerformular zugewiesen ist, verbleibt im Besitz, bis die RemoveOwnedForm Methode aufgerufen wird. Sie können ein Formular auch im Besitz eines anderen Formulars machen, indem Sie die Owner Eigenschaft mit einem Verweis auf das Besitzerformular festlegen.
Wenn ein Formular im Besitz eines anderen Formulars ist, wird es mit dem Besitzerformular geschlossen oder ausgeblendet. Ziehen Sie z. B. ein Formular mit dem Namen Form2 in Betracht, das im Besitz eines Formulars mit dem Namen ist Form1. Wenn Form1 sie geschlossen oder minimiert ist, Form2 wird sie auch geschlossen oder ausgeblendet. Eigene Formulare werden auch nie hinter ihrem Besitzerformular angezeigt. Sie können eigene Formulare für Fenster verwenden, z. B. Fenster suchen und ersetzen, die beim Auswählen des Besitzerformulars nicht hinter dem Besitzerformular angezeigt werden sollen.
Hinweis
Wenn es sich bei dem Formular um ein übergeordnetes MDI-Formular (Multiple-Document Interface, MDI) handelt, gibt diese Eigenschaft alle Formulare zurück, die mit Ausnahme aller derzeit geöffneten untergeordneten MDI-Formulare angezeigt werden. Verwenden Sie die MdiChildren Eigenschaft, um die untergeordneten MDI-Formulare abzurufen, die in einem übergeordneten MDI-Formular geöffnet wurden.
