Window.Owner Propriété

  • Référence

Définition

Espace de noms:
System.Windows
Assembly:
PresentationFramework.dll

Obtient ou définit la 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 { [System.Security.SecurityCritical] get; [System.Security.SecurityCritical] set; }
public System.Windows.Window Owner { get; set; }
[<get: System.Security.SecurityCritical>]
[<set: System.Security.SecurityCritical>]
member this.Owner : System.Windows.Window with 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.

Attributs
SecurityCriticalAttribute

Exceptions

ArgumentException

Une fenêtre essaie d'être son propre propriétaire.

- ou -

Deux fenêtres essaient de se posséder l'une l'autre.

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 auparavant.

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 ne dépend pas du comportement de la fenêtre parente ; les deux fenêtres peuvent couvrir l’autre ou être réduites, agrandies et restaurées 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 propriétaire) est définie avec une référence à une autre fenêtre (la 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 les fenêtres qui lui appartiennent sont également réduites.

  • Si une fenêtre appartenant 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 propriétaires sont restaurées.

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

  • Les fenêtres détenues qui n’ont pas été ouvertes à l’aide ShowDialog de 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 sont également fermées.

  • Si une fenêtre propriétaire 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 Closing la fenêtre propriétaire 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 fenêtre enfant et la fenêtre parente en appuyant sur le bouton de la barre des tâches. Au lieu de cela, le fait d’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 la fenêtre parente, qu’ils peuvent sélectionner ; seule la fenêtre sélectionnée est restaurée.

Important

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

Notes

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

S’applique à

Voir aussi