ShowWindow

指定されたウィンドウの表示状態を設定します。

BOOL ShowWindow(
    HWND hWnd,     // window handle
    int  nCmdShow  // show state
);

USER32.DLL

引数

hWnd

表示状態を変更するウィンドウのハンドルを指定します。

nCmdShow

ウィンドウの表示状態を指定します。アプリケーションを起動したプロセスが、起動時にSTARTUPINFO構造体を提供していた場合には、アプリケーションが最初に呼び出すShowWindow関数ではこのパラメータは無視されます。それ以外の場合においても、アプリケーションが最初に呼び出すShowWindow関数には、WinMain関数のnCmdShowパラメータの値を指定するべきです。その後の呼び出しでは、以下の値のいずれかを指定することができます。

0 (SW_HIDE): ウィンドウを非表示にして、他のウィンドウをアクティブにします。
1 (SW_SHOWNORMAL): ウィンドウをアクティブにして表示します。ウィンドウが最小化または最大化されている場合は、ウィンドウの位置とサイズを元に戻します。アプリケーションは、最初にウィンドウを表示させるときにこのフラグを指定するべきです。
2 (SW_SHOWMINIMIZED): ウィンドウをアクティブにして、最小化されたウィンドウとして表示します。
3 (SW_SHOWMAXIMIZED, SW_MAXIMIZE): ウィンドウをアクティブにして、最大化されたウィンドウとして表示します。
4 (SW_SHOWNOACTIVATE): ウィンドウをアクティブにはせずに表示します。
5 (SW_SHOW): ウィンドウをアクティブにして、現在の位置とサイズで表示します。
6 (SW_MINIMIZE): 指定されたウィンドウを最小化して、次のZオーダーにあるトップレベルウィンドウをアクティブにします。
7 (SW_SHOWMINNOACTIVE): ウィンドウを最小化されたウィンドウとして表示します。ウィンドウはアクティブ化されません。
8 (SW_SHOWNA): ウィンドウを現在の位置とサイズで表示します。ウィンドウはアクティブ化されません。
9 (SW_RESTORE): ウィンドウをアクティブにして表示します。ウィンドウが最小化または最大化されている場合は、ウィンドウの位置とサイズを元に戻します。アプリケーションは、最小化されたウィンドウの位置とサイズを元に戻すときにこのフラグを指定するべきです。
10 (SW_SHOWDEFAULT): アプリケーションを起動したプログラムがCreateProcess関数にパラメータとして渡したSTARTUPINFO構造体で指定されているSW_値に基づいて表示状態が設定されます。
11 (SW_FORCEMINIMIZE): Windows 2000/XP：ウィンドウを所有しているスレッドがハングしている状態であっても、ウィンドウを最小化します。他のスレッドからウィンドウを最小化させる場合にのみ、このフラグを使用するべきです。

戻り値

それまでウィンドウが表示されていた場合には0以外の値が返ります。

それまでウィンドウが表示されていなかった場合には0が返ります。

解説

ウィンドウが表示または非表示になる際の特定の特殊効果を表示させるには、AnimateWindow関数を使用します

対応情報

Windows 95 以降 / Windows NT 3.1 以降