Window.Owner プロパティ

定義

名前空間:

System.Windows

アセンブリ:

PresentationFramework.dll

この Window を所有する Window を取得または設定します。

public:
 property System::Windows::Window ^ Owner { System::Windows::Window ^ get(); void set(System::Windows::Window ^ value); };

public System.Windows.Window Owner { get; set; }

member this.Owner : System.Windows.Window with get, set

Public Property Owner As Window

プロパティ値

Window

この Window のオーナー ウィンドウを表す Window オブジェクト。

例外

ArgumentException

ウィンドウがそのウィンドウ自体を所有しようとしています。

- または -

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

InvalidOperationException

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 する必要があります。 そうしないと、ユーザーはタスク バー ボタンを押して子ウィンドウと親ウィンドウの両方を復元できなくなります。 代わりに、タスク バー ボタンを押すと、子ウィンドウと親ウィンドウの両方を含むウィンドウの一覧が表示されます。選択したウィンドウのみが復元されます。

重要

また、 を使用して Owner 正しい動作を保証するために、 を呼び出 ShowDialog して開くウィンドウで プロパティを設定する必要があります。

注意

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

こちらもご覧ください

• OwnedWindows