These are hints for the window manager that indicate what type of function
the window has. The window manager can use this when determining decoration
and behaviour of the window. The hint must be set before mapping the window.

See the extended window manager hints specification for more details about
window types.

Scroll both, pixels and children, by the given amount.
DrawWindow itself does not move. Portions of the window that the
scroll operation brings inm from offscreen areas are invalidated. The
invalidated region may be bigger than what would strictly be necessary. (For
X11, a minimum area will be invalidated if the window has no subwindows, or
if the edges of the window's parent do not extend beyond the edges of the
drawWindow. In other cases, a multi-step process is used to scroll the window
which may produce temporary visual artifacts and unnecessary invalidations.)

Raises DrawWindow to the top of the Z-order (stacking order), so that other
drawWindows with the same parent drawWindow appear below DrawWindow. This is true
whether or not the drawWindows are visible.

If DrawWindow is a toplevel, the window manager may choose to deny the
request to move the drawWindow in the Z-order, drawWindowRaise only requests the
restack, does not guarantee it.

A
backing store (offscreen buffer) large enough to contain region will be
created. The backing store will be initialized with the background color or
background pixmap for DrawWindow. Then, all drawing operations performed on
DrawWindow will be diverted to the backing store. When you call
drawWindowEndPaint, the backing store will be copied to DrawWindow, making it
visible onscreen. Only the part of DrawWindow contained in region will be
modified; that is, drawing operations are clipped to region.

The net result of all this is to remove flicker, because the user sees
the finished product appear all at once when you call drawWindowEndPaint. If
you draw to DrawWindow directly without calling drawWindowBeginPaintRegion, the
user may see flicker as individual drawing operations are performed in
sequence. The clipping and background-initializing features of
drawWindowBeginPaintRegion are conveniences for the programmer, so you can
avoid doing that work yourself.

When using GTK+, the widget system automatically places calls to
drawWindowBeginPaintRegion and drawWindowEndPaint around emissions of the
expose_event signal. That is, if you're writing an expose event handler,
you can assume that the exposed area in eventRegion has already been
cleared to the window background, is already set as the clip region, and
already has a backing store. Therefore in most cases, application code need
not call drawWindowBeginPaintRegion. (You can disable the automatic calls
around expose events on a widget-by-widget basis by calling
widgetSetDoubleBuffered.)

If you call this function multiple times before calling the matching
drawWindowEndPaint, the backing stores are pushed onto a stack.
drawWindowEndPaint copies the topmost backing store onscreen, subtracts the
topmost region from all other regions in the stack, and pops the stack. All
drawing operations affect only the topmost backing store in the stack. One
matching call to drawWindowEndPaint is required for each call to
drawWindowBeginPaintRegion.

Adds region to the update area for DrawWindow. The update area is the
region that needs to be redrawn, or "dirty region.". During the
next idle period of the main look, an expose even for this region
will be created. An application would normally redraw
the contents of DrawWindow in response to those expose events.

The invalidateChildren parameter controls whether the region of each
child drawWindow that intersects region will also be invalidated. If False,
then the update area for child drawWindows will remain unaffected.

Transfers ownership of the update area from DrawWindow to the caller of the
function. That is, after calling this function, DrawWindow will no longer have
an invalid/dirty region; the update area is removed from DrawWindow and
handed to you. If this window has no update area, drawWindowGetUpdateArea returns Nothing.

The areas in each expose
event will cover the entire update area for the window (see
drawWindowInvalidateRegion for details). Normally Gtk calls
drawWindowProcessUpdates on your behalf, so there's no need to call this
function unless you want to force expose events to be delivered immediately
and synchronously (vs. the usual case, where Gtk delivers them in an idle
handler). Occasionally this is useful to produce nicer scrolling behavior,
for example.

Applies a shape mask to window. Pixels in window corresponding to set
bits in the mask will be visible; pixels in window corresponding to
unset bits in the mask will be transparent. This gives a non-rectangular
window.

If mask is Nothing, the shape mask will be unset, and the x/y parameters
are not used. The mask must be a bitmap, that is, a Pixmap of depth
one.

On the X11 platform, this uses an X server extension which is widely
available on most common platforms, but not available on very old
X servers, and occasionally the implementation will be buggy.
On servers without the shape extension, this function will do nothing.
On the Win32 platform the functionality is always present.

Makes pixels in DrawWindow outside shapeRegion transparent, so that
the window may be nonrectangular.

If shapeRegion is Nothing, the shape will be unset, so the whole
DrawWindow will be opaque again. The parameters offsetX and offsetY
are ignored if shapeRegion is Nothing.

On the X11 platform, this uses an X server extension which is widely
available on most common platforms, but not available on very old X servers,
and occasionally the implementation will be buggy. On servers without the
shape extension, this function will do nothing.

Sets the shape mask of DrawWindow to the union of shape masks for all
children of DrawWindow, ignoring the shape mask of DrawWindow itself. Contrast
with drawWindowMergeChildShapes which includes the shape mask of DrawWindow in
the masks to be merged.

Merges the shape masks for any child drawWindows into the shape mask for
DrawWindow. i.e. the union of all masks for DrawWindow and its children will
become the new mask for DrawWindow. See drawWindowShapeCombineMask.

This function is distinct from drawWindowSetChildShapes because it includes
DrawWindow's shape mask in the set of shapes to be merged.