Window.Owner プロパティ

定義

この 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); };
public System.Windows.Window Owner { get; set; }
[get: System.Security.SecurityCritical]
[set: System.Security.SecurityCritical]
public System.Windows.Window Owner { get; set; }
member this.Owner : System.Windows.Window with get, set
[<get: System.Security.SecurityCritical>]
[<set: System.Security.SecurityCritical>]
member this.Owner : System.Windows.Window with get, set
Public Property Owner As Window

プロパティ値

Window

この Window のオーナー ウィンドウを表す Window オブジェクト。A Window object that represents the owner of this Window.

属性

例外

ウィンドウがそのウィンドウ自体を所有しようとしています。A window tries to own itself

- または --or-

2 つのウィンドウが相互に所有しようとしています。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.

適用対象

こちらもご覧ください