The presentation space created by this method is a cache "micro presentation space" present in the system. This can be used for simple drawing operations that do not depend on long-term data being stored in the presentation space.

The initial state of the presentation space is the same as that of a presentation space created using GpiCreatePS. The color table is in default color index mode. The visible region associated with hps depends upon the window and class styles of hwnd:

Style

Visible region of presentation space
WS_CLIPCHILDREN
All child windows of the window are excluded.
WS_CLIPSIBLINGS
All the sibling windows of hwnd are excluded.
CS_PARENTCLIP
Is the same as that of the parent window of the window.

The presentation space origin is established normally, that is, relative to the lower left of the window itself, not its parent.

This style optimizes the use of the presentation space cache by minimizing the calculation of the visible region for child windows.

Any presentation space created by WinGetPS must be released by calling WinReleasePS. This should be done before the application terminates.

Note: This call requires the presence of a message queue and should not be made until after the application's message queue has been created.

---

[Back] [Next]