Supported Browsers Home   
MGL_vecFontEngine Previous   
MGL_wmCaptureEvents Next   
External Functions Up   

MGL_wmBeginPaint

Creates DC suitable for painting on window

Declaration

MGLDC* MGLAPI MGL_wmBeginPaint(
    window_t *wnd)

Prototype In

mgraph.h

Parameters

wnd

the window to paint on

 

Return Value

Returns device context that you can paint on.

Description

If you can't use painter function to paint on a window for some reason, MGL provides this fuction. It returns a DC prepared for drawing on it (specifically, clipping region is set to clip off anything that is not in window's visible part and coordinate system is changed to be local to the window).

You must call MGL_wmEndPaint when you're done with painting on the window.

Note:    Avoid setting clipping region on returned DC. If you must do so, make sure you intersect your clipping region with current clipping region of the DC!

Note:    This function automatically hides mouse pointer if neccessary to avoid occurence rendering artifacts.

Note:    The effect of MGL_wmBeginPaint/MGL_wmEndPaint drawing is temporary, MGL_wmUpdateDC may (and probably will) redraw it using the painter later.

See Also

MGL_wmUpdateDC, MGL_wmSetWindowPainter, MGL_wmEndPaint

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com