Window.Owner Window.Owner Window.Owner Window.Owner Property

Определение

Возвращает или задает окно Window, которое владеет данным окном Window.Gets or sets the Window that owns this Window.

public:
 property System::Windows::Window ^ Owner { System::Windows::Window ^ get(); void set(System::Windows::Window ^ value); };
[get: System.Security.SecurityCritical]
[set: System.Security.SecurityCritical]
public System.Windows.Window Owner { get; set; }
member this.Owner : System.Windows.Window with get, set
Public Property Owner As Window

Значение свойства

Объект Window, представляющий владельца данного объекта Window.A Window object that represents the owner of this Window.

Исключения

Окно пытается стать владельцем самого себяA window tries to own itself -или--or- Два окна пытаются стать владельцами друг друга.Two windows try to own each other.

Свойство Owner установлено на видимое окно, отображенное методом ShowDialog()The Owner property is set on a visible window shown using ShowDialog()

- или --or- Свойство Owner установлено на окно, которое ранее не отображалось.The Owner property is set with a window that has not been previously shown.

Примеры

В следующем примере показано, как установить отношение "владелец-принадлежащий".The following example shows how to establish the owner/owned relationship.

// 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()

Комментарии

Когда дочернее окно открывается родительским окном путем вызова ShowDialog, между родительским и дочерним окном устанавливается неявная связь.When a child window is opened by a parent window by calling ShowDialog, an implicit relationship is established between both parent and child window. Эта связь обеспечивает определенные режимы работы, в том числе в отношении минимизации, максимизации и восстановления.This relationship enforces certain behaviors, including with respect to minimizing, maximizing, and restoring.

При создании дочернего окна в родительском окне путем вызова Show, однако дочернее окно не имеет связи с родительским окном.When a child window is created by a parent window by calling Show, however, the child window does not have a relationship with the parent window. Это означает следующее.This means that:

  • Дочернее окно не имеет ссылки на родительское окно.The child window does not have a reference to the parent window.

  • Поведение дочернего окна не зависит от поведения родительского окна. любое окно может охватывать другое, или быть сведенным, развернутым и восстанавливаемым независимо от другого.The behavior of the child window is not dependent on the behavior of the parent window; either window can cover the other, or be minimized, maximized, and restored independently of the other.

Чтобы можно было создать связь между дочерним и родительским окнами, Window поддерживает понятие владение.To allow you to create a relationship between a child window and a parent window, Window supports the notion of ownership. Владение устанавливается, когда Owner свойству окна (принадлежащему окну) задана ссылка на другое окно (окно-владелец).Ownership is established when the Owner property of a window (the owned window) is set with a reference to another window (the owner window).

После того как связь установлена, демонстрируются следующие поведения:Once this relationship is established, the following behaviors are exhibited:

  • Если окно-владелец является сведенным, все его собственные окна также будут сведены к минимальному объему.If an owner window is minimized, all its owned windows are minimized as well.

  • Если принадлежащее окно является сведенным, его владелец не уменьшается.If an owned window is minimized, its owner is not minimized.

  • Если окно владельца развернуто, восстанавливаются и окно владельца, и его собственные окна.If an owner window is maximized, both the owner window and its owned windows are restored.

  • Окно владельца не может охватывать собственное окно.An owner window can never cover an owned window.

  • Собственные окна, которые не открывались ShowDialog с помощью, не являются модальными.Owned windows that were not opened using ShowDialog are not modal. Пользователь по-прежнему может взаимодействовать с окном владельца.The user can still interact with the owner window.

  • Если закрыть окно владельца, его собственные окна также будут закрыты.If you close an owner window, its owned windows are also closed.

  • Если принадлежащее окно было открыто окном-владельцем Showс помощью, а окно владельца закрыто, Closing событие принадлежащего окна не вызывается.If an owned window was opened by its owner window using Show, and the owner window is closed, the owned window's Closing event is not raised.

При открытии дочернего окна с помощью ShowDialogметода необходимо также Owner задать свойство дочернего окна.When you open a child window by calling ShowDialog, you should also set the Owner property of the child window. Если этого не сделать, пользователи не смогут восстановить как дочернее окно, так и родительское окно, нажав кнопку панели задач.If you don't, then your users won't be able to restore both child window and parent window by pressing the task bar button. Вместо этого при нажатии кнопки панели задач будет выдаваться список окон, включая дочернее и родительское окна, чтобы они были выбраны. восстанавливается только выбранное окно.Instead, pressing the task bar button will yield a list of windows, including both child and parent window, for them to select; only the selected window is restored.

Важно!

Необходимо также задать Owner свойство в окне, которое открывается с помощью вызова ShowDialog , чтобы обеспечить правильное поведение с.You should also set the Owner property on a window that is opened by calling ShowDialog to ensure correct behavior with .

Примечание

Невозможно задать или получить это свойство, если окно размещается в браузере.You cannot set or get this property when a window is hosted in a browser.

Безопасность

UIPermission
разрешение на использование всех окон и событий ввода данных пользователем без ограничений.for permission to use all windows and user input events without restriction. Связанное перечисление:AllWindowsAssociated enumeration: AllWindows

Применяется к

Дополнительно