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

重要

また、ShowDialog を呼び出して開いたウィンドウの Owner プロパティを設定して、との正しい動作を確認する必要があります。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.

適用対象

こちらもご覧ください