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-

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.

セキュリティ

UIPermission
すべての windows およびユーザー入力イベントを制限なしで使用するためのアクセス許可。for permission to use all windows and user input events without restriction. 関連付けられた列挙型:AllWindowsAssociated enumeration: AllWindows

適用対象

こちらもご覧ください