Marks a window as full-screen.

Syntax

HRESULT MarkFullscreenWindow(      
    HWND hwnd,
    BOOL fFullscreen
);

Parameters

hwnd

[in] The handle of the window to be marked.

fFullscreen

[in] A Boolean value marking the desired full-screen status of the window.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

Setting the value of fFullscreen to TRUE, the Shell treats this window as a full-screen window, and the taskbar is moved to the bottom of the z-order when this window is active. Setting the value of fFullscreen to FALSE removes the full-screen marking, but does not cause the Shell to treat the window as though it were definitely not full-screen. With a FALSEfFullscreen value, the Shell depends on its automatic detection facility to specify how the window should be treated, possibly still flagging the window as full-screen.

See Also

ITaskbarList