Window.Owner Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Obtient ou définit le Window propriétaire de ce Windowfichier .

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 ce 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 Owner propriété est définie sur une fenêtre visible affichée à l’aide de ShowDialog()

-ou-

La Owner propriété 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 la fenêtre parente et la fenêtre enfant. Cette relation applique certains comportements, notamment en ce qui concerne la réduction, l’optimisation et la restauration.

Lorsqu’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 Owner propriété 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 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 Showde , et que la fenêtre propriétaire est fermée, l’événement de la Closing fenêtre appartenant n’est pas déclenché.

Lorsque vous ouvrez une fenêtre enfant en appelant ShowDialog, vous devez également définir la Owner propriété 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 Owner propriété sur une fenêtre ouverte en appelant ShowDialog pour garantir un comportement correct avec la fenêtre détenue.

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