Window.Owner プロパティ

定義

この Windowを所有する 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

プロパティ値

この Windowの所有者を表す Window オブジェクト。

属性

例外

ウィンドウがそれ自体を所有しようとします

-又は-

2 つのウィンドウが互いを所有しようとします。

Owner プロパティは、ShowDialog() を使用して表示される表示ウィンドウに設定されます。

-又は-

Owner プロパティは、以前に表示されていないウィンドウで設定されます。

次の例は、所有者/所有関係を確立する方法を示しています。

// 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を呼び出して親ウィンドウによって子ウィンドウを開くと、親ウィンドウと子ウィンドウの間に暗黙的なリレーションシップが確立されます。 この関係により、最小化、最大化、復元など、特定の動作が適用されます。

ただし、Showを呼び出して親ウィンドウによって子ウィンドウが作成された場合、子ウィンドウは親ウィンドウとのリレーションシップを持っていません。 これは、次のことを意味します。

  • 子ウィンドウには、親ウィンドウへの参照がありません。

  • 子ウィンドウの動作は、親ウィンドウの動作に依存しません。どちらのウィンドウも、他のウィンドウをカバーすることも、他のウィンドウとは別に最小化、最大化、復元することもできます。

子ウィンドウと親ウィンドウの間にリレーションシップを作成できるようにするには、Window は所有権の概念をサポートします。 所有権は、別のウィンドウ (所有者ウィンドウ) への参照を使用してウィンドウ (所有ウィンドウ) の Owner プロパティが設定されたときに確立されます。

この関係が確立されると、次の動作が表示されます。

  • 所有者ウィンドウが最小化されている場合は、所有されているすべてのウィンドウも最小化されます。

  • 所有ウィンドウが最小化されている場合、その所有者は最小化されません。

  • 所有者ウィンドウが最大化されると、所有者ウィンドウと所有ウィンドウの両方が復元されます。

  • 所有者ウィンドウが所有するウィンドウをカバーすることはできません。

  • ShowDialog を使用して開かなかった所有ウィンドウはモーダルではありません。 ユーザーは引き続き所有者ウィンドウと対話できます。

  • 所有者ウィンドウを閉じると、その所有者ウィンドウも閉じられます。

  • 所有ウィンドウが Showを使用して所有者ウィンドウによって開かれた場合、所有者ウィンドウが閉じている場合、所有ウィンドウの Closing イベントは発生しません。

ShowDialogを呼び出して子ウィンドウを開く場合は、子ウィンドウの Owner プロパティも設定する必要があります。 そうしないと、ユーザーはタスク バー ボタンを押して子ウィンドウと親ウィンドウの両方を復元できなくなります。 代わりに、タスク バー ボタンを押すと、子ウィンドウと親ウィンドウの両方を含むウィンドウの一覧が表示され、選択できます。選択したウィンドウのみが復元されます。

大事な

また、ShowDialog を呼び出して開いたウィンドウで Owner プロパティを設定し、所有しているウィンドウで正しい動作を確認する必要があります。

手記

ウィンドウがブラウザーでホストされている場合、このプロパティを設定または取得することはできません。

適用対象

こちらもご覧ください