CWnd::ShowWindow

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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

BOOL ShowWindow(
   int nCmdShow 
);

パラメータ

nCmdShow
CWnd を表示する方法を指定します。次の値のいずれかになります。
- SW_HIDE このウィンドウを非表示にし、他のウィンドウをアクティブにします。
- SW_MINIMIZE ウィンドウを最小化し、システムのリストのトップレベルウィンドウをアクティブにします。
- SW_RESTORE ウィンドウをアクティブにし、表示します。ウィンドウが最小化または最大化されている場合は、Windows によって元のサイズと位置に戻されます。
- SW_SHOW ウィンドウをアクティブにし、現在のサイズと位置で表示します。
- SW_SHOWMAXIMIZED ウィンドウをアクティブにし、最大表示します。
- SW_SHOWMINIMIZED ウィンドウをアクティブにし、最小化して表示します。
- SW_SHOWMINNOACTIVE ウィンドウを最小化して表示します。現在アクティブなウィンドウはアクティブなまま表示します。
- SW_SHOWNA 現在の状態でウィンドウを表示します。現在アクティブなウィンドウはアクティブなまま表示します。
- SW_SHOWNOACTIVATE ウィンドウを直前のサイズと位置で表示します。現在アクティブなウィンドウはアクティブなまま表示します。
- SW_SHOWNORMAL ウィンドウをアクティブにし、表示します。ウィンドウが最小化または最大化されている場合は、Windows によって元のサイズと位置に戻されます。

戻り値

ウィンドウが直前まで表示されていた場合は、0 以外の値を返します。CWnd が非表示であった場合は、0 を返します。

解説

ShowWindow は、CWinApp::m_nCmdShow を使用して、メインウィンドウのアプリケーションごとに一回だけ呼び出される必要があります。その後 ShowWindow を呼び出すには、CWinApp::m_nCmdShow で指定された値ではなく、上記に一覧表示された値を使用する必要があります。