]> git.saurik.com Git - wxWidgets.git/blob - docs/latex/wx/paintdc.tex
second merge of the 2.2 branch (RL)
[wxWidgets.git] / docs / latex / wx / paintdc.tex
1 \section{\class{wxPaintDC}}\label{wxpaintdc}
2
3 A wxPaintDC must be constructed if an application wishes to paint on the
4 client area of a window from within an {\bf OnPaint} event.
5 This should normally be constructed as a temporary stack object; don't store
6 a wxPaintDC object. If you have an OnPaint handler, you {\it must} create a wxPaintDC
7 object within it even if you don't actually use it.
8
9 Using wxPaintDC within OnPaint is important because it automatically
10 sets the clipping area to the damaged area of the window. Attempts to draw
11 outside this area do not appear.
12
13 To draw on a window from outside {\bf OnPaint}, construct a \helpref{wxClientDC}{wxclientdc} object.
14
15 To draw on the whole window including decorations, construct a \helpref{wxWindowDC}{wxwindowdc} object
16 (Windows only).
17
18 \wxheading{Derived from}
19
20 \helpref{wxWindowDC}{wxwindowdc}\\
21 \helpref{wxDC}{wxdc}
22
23 \wxheading{Include files}
24
25 <wx/dcclient.h>
26
27 \wxheading{See also}
28
29 \helpref{wxDC}{wxdc}, \helpref{wxMemoryDC}{wxmemorydc}, \helpref{wxPaintDC}{wxpaintdc},\rtfsp
30 \helpref{wxWindowDC}{wxwindowdc}, \helpref{wxScreenDC}{wxscreendc}
31
32 \latexignore{\rtfignore{\wxheading{Members}}}
33
34 \membersection{wxPaintDC::wxPaintDC}
35
36 \func{}{wxPaintDC}{\param{wxWindow*}{ window}}
37
38 Constructor. Pass a pointer to the window on which you wish to paint.
39
40
41