windows_programming_notes.nbk: Home | Index | Next Page: KillTimer | Previous Page: IsWindowEnabled

 IsWindowVisible

The IsWindowVisible function retrieves the visibility state of the specified window.

Syntax

    BOOL IsWindowVisible(
        HWND hWnd
        );

Parameters

• hWnd
  [in] Handle to the window to test.

Return Value

If the specified window, its parent window, its parent's parent window, and so forth, have the WS_VISIBLE style, the return value is nonzero. Otherwise, the return value is zero.

Because the return value specifies whether the window has the WS_VISIBLE style, it may be nonzero even if the window is totally obscured by other windows.

Remarks

The visibility state of a window is indicated by the WS_VISIBLE style bit. When WS_VISIBLE is set, the window is displayed and subsequent drawing into it is displayed as long as the window has the WS_VISIBLE style.

Any drawing to a window with the WS_VISIBLE style will not be displayed if the window is obscured by other windows or is clipped by its parent window.

Function Information

• Minimum DLL Version user32.dll
• Header Declared in Winuser.h, include Windows.h
• Import library User32.lib
• Minimum operating systems Windows 95, Windows NT 3.1
• Unicode Implemented as Unicode version.

windows_programming_notes.nbk: Home | Index | Next Page: KillTimer | Previous Page: IsWindowEnabled

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time