Window.Show メソッド

定義

ウィンドウを開き、開いたウィンドウが閉じるのを待機せずに制御を戻します。Opens a window and returns without waiting for the newly opened window to close.

public:
 void Show();
public void Show ();
member this.Show : unit -> unit
Public Sub Show ()

例外

閉じている途中 (Show()) または閉じた (Closing) ウィンドウに対して Closed が呼び出されている。Show() is called on a window that is closing (Closing) or has been closed (Closed).

次のサンプルは、モードレスウィンドウを開く方法を示しています。The following sample demonstrates how to open a modeless window.

// Initialize window
Window window = new Window();

// Show window modelessly
// NOTE: Returns without waiting for window to close
window.Show();
' Initialize window
Dim window As New Window()

' Show window modelessly
' NOTE: Returns without waiting for window to close
window.Show()

注釈

Window クラスがインスタンス化されると、既定では表示されません。When the Window class is instantiated, it is not visible by default. Show ウィンドウを表示し、ウィンドウが閉じられるのを待たずにすぐに制御を戻します。Show shows a window and returns immediately, without waiting for the window to be closed. そのため、開いているウィンドウでは、ユーザーがアプリケーション内の他のウィンドウと対話できないようにすることはできません。Consequently, the opened window does not prevent users from interacting with other windows in the application. この種類のウィンドウは、モードレスウィンドウと呼ばれます。This type of window is called a modeless window. モードレスウィンドウの一般的な例として、ウィンドウ、ツールボックス、およびパレットがあります。Common examples of modeless windows are properties windows, toolboxes, and palettes. 特定のウィンドウとの対話をユーザーに制限するには、ShowDialogを呼び出すことによってウィンドウを開く必要があります。To restrict a user to interacting with a specific window, the window must be opened by calling ShowDialog.

Show を呼び出すことによって開かれたウィンドウは、そのウィンドウを開いたウィンドウと自動的に関係がありません。具体的には、開いているウィンドウに、どのウィンドウが開いているかがわかりません。A window that is opened by calling Show does not automatically have a relationship with the window that opened it; specifically, the opened window does not know which window opened it. このリレーションシップは、Owner プロパティを使用して確立し、OwnedWindows プロパティを使用して管理できます。This relationship can be established using the Owner property and managed using the OwnedWindows property.

Show を呼び出すと、Window オブジェクトの Visibility プロパティを Visibleに設定した場合と同じ結果が得られます。Calling Show achieves the same end result as setting Visibility property of the Window object to Visible. ただし、タイミングの観点からは2つの違いがあります。However, there is a difference between the two from a timing perspective.

Show の呼び出しは、子ウィンドウの Loaded イベントが発生した後にのみを返す同期操作です。Calling Show is a synchronous operation that returns only after the Loaded event on the child window has been raised:

Window w = new Window();
w.Loaded += delegate { System.Console.WriteLine("This is written first."); };
w.Show();
System.Console.WriteLine("This is written last.");
Dim w As New Window()
AddHandler w.Loaded, Sub() System.Console.WriteLine("This is written first.")
w.Show()
System.Console.WriteLine("This is written last.")

ただし Visibilityの設定は、すぐにを返す非同期操作です。Setting Visibility, however, is an asynchronous operation that returns immediately:

Window w2 = new Window();
w2.Loaded += delegate { System.Console.WriteLine("This is written last."); };
w2.Visibility = Visibility.Visible;
System.Console.WriteLine("This is written first.");
Dim w2 As New Window()
AddHandler w2.Loaded, Sub() System.Console.WriteLine("This is written last.")
w2.Visibility = Visibility.Visible
System.Console.WriteLine("This is written first.")

Visibilityを設定すると、Visibility を設定する前に登録したウィンドウイベントは、Visibility を設定したメソッドが実行を完了するまで発生しない可能性があります。When setting Visibility, any window events you register before you set Visibility may not be raised until after the method in which you set Visibility has completed execution.

適用対象

こちらもご覧ください