CWnd::IsWindowVisible

Artikel
02/26/2013

Bestimmt den Sichtbarkeitszustand des angegebenen Fensters.

BOOL IsWindowVisible( ) const;

Rückgabewert

Ungleich 0 (null), wenn CWnd sichtbar ist (hat das WS_VISIBLE Stilbit, das so festgelegt werden, und das übergeordnete Fenster ist sichtbar).Da der Rückgabewert den Zustand des WS_VISIBLE Stilbits widerspiegelt, ist der Rückgabewert ungleich 0 (null), obwohl CWnd vollständig von anderen Fenstern verdeckt wird.

Hinweise

Ein Fenster besitzt einen Sichtbarkeitszustand, der durch das WS_VISIBLE Stilbit angegeben wird.Wenn dieses Stilbit mit einem Aufruf der Memberfunktion ShowWindow festgelegt ist, wird das Fenster angezeigt und folgende Zeichnung dem Fenster angezeigt wird, solange das Fenster den festgelegten Stilbit verfügt.

Keine Zeichnung zu einem Fenster, das das WS_VISIBLE Format verfügt, nicht angezeigt, wenn das Fenster durch andere Fenster abgedeckt wird oder durch das übergeordnete Fenster abgeschnitten wird.

Beispiel

// 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);
   }
}