WinGetClipPS

This method obtains a clipped cache presentation space.

Syntax

WinGetClipPS(hwnd, hwndClipWindow, ulClipflags)

Parameter

hwnd (HWND)

Handle of window for which the presentation space is required.

hwndClipWindow (HWND)

Handle of window for clipping.

HWND_BOTTOM - Clip the last window in the sibling chain and continue clipping until the next window is hwnd or NULLHANDLE.

HWND_TOP - Clip the first window in the sibling chain and continue clipping until the next window is hwnd or NULLHANDLE.

NULLHANDLE - Clip all siblings to the window hwnd.

ulClipflags (ULONG)

Clipping control flags.

PSF_CLIPSIBLINGS - Clip out all siblings of hwnd.

PSF_CLIPCHILDREN - Clip out all children of hwnd.

PSF_CLIPUPWARDS - Taking hwndClipWindow as a reference window, clip out all sibling windows before hwndClipWindow. This value may not be used with PSF_CLIPDOWNWARDS.

PSF_CLIPDOWNWARDS - Taking hwndClipWindow as a reference window, clip out all sibling windows after hwndClipWindow. This value may not be used with PSF_CLIPUPWARDS.

PSF_LOCKWINDOWUPDATE - Calculate a presentation space that keeps a visible region even though output may be locked by the WinLockWindowUpdate function.

PSF_PARENTCLIP - Calculate a presentation space that uses the visible region of the parent of hwnd but with an origin calculated for hwnd.

Returns

hps (HPS)

Presentation-space handle that can be used for drawing.