CWnd::IsWindowVisible

[アーティクル]
08/09/2011

指定されたウィンドウが可視状態かどうかを調べます。

BOOL IsWindowVisible( ) const;

戻り値

CWnd が可視状態 (WS_VISIBLE スタイルビットが設定されている場合、または親ウィンドウが可視状態) の場合は 0 以外を返します。戻り値は WS_VISIBLE スタイルビットなので、CWnd がほかのウィンドウで覆われていても 0 以外を返す場合もあります。

解説

可視状態にあるウィンドウは、WS_VISIBLE スタイルビットで示されます。このスタイルビットが ShowWindow メンバー関数の呼び出しで設定された場合は、ウィンドウが表示され、ウィンドウのスタイルビットが設定されている間ウィンドウへの描画も表示されます。

WS_VISIBLE スタイルを持つウィンドウへのあらゆる描画は、ウィンドウがほかのウィンドウに覆われていたり、親ウィンドウによってクリップされている場合は表示されません。

使用例

// This example uses the CWnd::IsWindowVisible() function to
// determine if a dialog box is visible. If it is not, it calls
// CWnd::ShowWindow with the SW_SHOWNORMAL command.
void CMainFrame::DisplayModeless()
{
   if(!m_Modeless.IsWindowVisible())
   {
      m_Modeless.ShowWindow(SW_SHOWNORMAL);
   }
}

// This example uses the CWnd::IsWindowVisible() function to
// determine if a dialog box is visible. If it is, it calls
// CWnd::ShowWindow with the SW_HIDE command.
void CMainFrame::HideModeless()
{
   if(m_Modeless.IsWindowVisible())
   {
      m_Modeless.ShowWindow(SW_HIDE);
   }
}