Window.Owner Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Obtient ou définit l'Window qui possède cette Window.

public:
 property System::Windows::Window ^ Owner { System::Windows::Window ^ get(); void set(System::Windows::Window ^ value); };

public System.Windows.Window Owner { get; set; }

member this.Owner : System.Windows.Window with get, set

Public Property Owner As Window

Valeur de propriété

Window

Objet Window qui représente le propriétaire de cette Window.

Exceptions

ArgumentException

Une fenêtre essaie de se posséder elle-même

-ou-

Deux fenêtres essaient de se posséder.

InvalidOperationException

La propriété Owner est définie sur une fenêtre visible affichée à l’aide de ShowDialog()

-ou-

La propriété Owner est définie avec une fenêtre qui n’a pas été affichée précédemment.

Exemples

L’exemple suivant montre comment établir la relation propriétaire/propriété.

// Create a window and make this window its owner
Window ownedWindow = new Window();
ownedWindow.Owner = this;
ownedWindow.Show();

' Create a window and make this window its owner
Dim ownedWindow As New Window()
ownedWindow.Owner = Me
ownedWindow.Show()

Remarques

Lorsqu’une fenêtre enfant est ouverte par une fenêtre parente en appelant ShowDialog, une relation implicite est établie entre les fenêtres parent et enfant. Cette relation applique certains comportements, notamment en ce qui concerne la réduction, l’optimisation et la restauration.

Quand une fenêtre enfant est créée par une fenêtre parente en appelant Show, toutefois, la fenêtre enfant n’a pas de relation avec la fenêtre parente. Cela signifie que :

• La fenêtre enfant n’a pas de référence à la fenêtre parente.

• Le comportement de la fenêtre enfant n’est pas dépendant du comportement de la fenêtre parente ; l’une ou l’autre fenêtre peut couvrir l’autre, ou être réduite, agrandie et restaurée indépendamment de l’autre.

Pour vous permettre de créer une relation entre une fenêtre enfant et une fenêtre parente, Window prend en charge la notion de propriété. La propriété est établie lorsque la propriété Owner d’une fenêtre (la fenêtre appartenant) est définie avec une référence à une autre fenêtre (fenêtre propriétaire).

Une fois cette relation établie, les comportements suivants sont exposés :

• Si une fenêtre propriétaire est réduite, toutes ses fenêtres détenues sont également réduites.

• Si une fenêtre détenue est réduite, son propriétaire n’est pas réduit.

• Si une fenêtre propriétaire est agrandie, la fenêtre propriétaire et ses fenêtres détenues sont restaurées.

• Une fenêtre propriétaire ne peut jamais couvrir une fenêtre détenue.

• Les fenêtres détenues qui n’ont pas été ouvertes à l’aide de ShowDialog ne sont pas modales. L’utilisateur peut toujours interagir avec la fenêtre propriétaire.

• Si vous fermez une fenêtre propriétaire, ses fenêtres détenues sont également fermées.

• Si une fenêtre appartenant a été ouverte par sa fenêtre propriétaire à l’aide de Showet que la fenêtre propriétaire est fermée, l’événement de Closing de la fenêtre détenue n’est pas déclenché.

Lorsque vous ouvrez une fenêtre enfant en appelant ShowDialog, vous devez également définir la propriété Owner de la fenêtre enfant. Si ce n’est pas le cas, vos utilisateurs ne pourront pas restaurer à la fois la fenêtre enfant et la fenêtre parente en appuyant sur le bouton de la barre des tâches. Au lieu de cela, appuyer sur le bouton de la barre des tâches génère une liste de fenêtres, y compris la fenêtre enfant et parente, pour qu’elles sélectionnent ; seule la fenêtre sélectionnée est restaurée.

Important

Vous devez également définir la propriété Owner sur une fenêtre ouverte en appelant ShowDialog pour garantir un comportement correct avec la fenêtre appartenant.

Note

Vous ne pouvez pas définir ou obtenir cette propriété lorsqu’une fenêtre est hébergée dans un navigateur.

Voir aussi

• OwnedWindows