Form.OwnedForms Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient un tableau d’objets Form qui représentent tous les formulaires appartenant à ce formulaire.
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()Valeur de propriété
Tableau Form qui représente les formulaires appartenant à ce formulaire.
- Attributs
Exemples
L’exemple suivant montre comment utiliser la OwnedForms propriété pour modifier tous les formulaires appartenant au formulaire propriétaire. La première méthode de l’exemple ajoute des formulaires au tableau de formulaires appartenant associés au formulaire appartenant. La deuxième méthode effectue une boucle dans tous les formulaires détenus et modifie la légende. Cet exemple nécessite que les deux méthodes soient appelées par un événement ou une autre méthode d’un formulaire.
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
Remarques
Cette propriété retourne un tableau qui contient tous les formulaires appartenant à ce formulaire. Pour créer un formulaire appartenant à un autre formulaire, appelez la AddOwnedForm méthode. Le formulaire affecté au formulaire propriétaire reste détenu jusqu’à ce que la RemoveOwnedForm méthode soit appelée. Vous pouvez également créer un formulaire appartenant à un autre en définissant la Owner propriété avec une référence à son formulaire propriétaire.
Lorsqu’un formulaire appartient à un autre formulaire, il est fermé ou masqué avec le formulaire propriétaire. Par exemple, considérez un formulaire nommé Form2 qui appartient à un formulaire nommé Form1. Si Form1 elle est fermée ou réduite, Form2 elle est également fermée ou masquée. Les formulaires détenus ne sont pas affichés derrière leur formulaire propriétaire. Vous pouvez utiliser des formulaires appartenant à des fenêtres telles que rechercher et remplacer des fenêtres, qui ne doivent pas être affichées derrière le formulaire propriétaire lorsque le formulaire propriétaire est sélectionné.
Note
Si le formulaire est un formulaire parent mDI (multiple document interface), cette propriété retourne tous les formulaires affichés à l’exception de tous les formulaires enfants MDI actuellement ouverts. Pour obtenir les formulaires enfants MDI ouverts dans un formulaire parent MDI, utilisez la MdiChildren propriété.
