]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/eraseevt.tex
Typo fixed in tsizer.tex; no change to setup0.h
[wxWidgets.git] / docs / latex / wx / eraseevt.tex
index 2c4a559780e1180e9defd6f2f922356ae3c87c8e..eb19bd53ab475184355cd4fe45c78913133aaa42 100644 (file)
@@ -2,11 +2,25 @@
 
 An erase event is sent when a window's background needs to be repainted.
 
 
 An erase event is sent when a window's background needs to be repainted.
 
+On some platforms, such as GTK+, this event is simulated (simply generated just before the
+paint event) and may cause flicker. It is therefore recommended that
+you set the text background colour explicitly in order to prevent flicker.
+The default background colour under GTK+ is grey.
+
+To intercept this event, use the EVT\_ERASE\_BACKGROUND macro in an event table definition.
+
+You must call wxEraseEvent::GetDC and use the returned device context if it is non-NULL.
+If it is NULL, create your own temporary wxClientDC object. 
+
 \wxheading{Derived from}
 
 \helpref{wxEvent}{wxevent}\\
 \helpref{wxObject}{wxobject}
 
 \wxheading{Derived from}
 
 \helpref{wxEvent}{wxevent}\\
 \helpref{wxObject}{wxobject}
 
+\wxheading{Include files}
+
+<wx/event.h>
+
 \wxheading{Event table macros}
 
 To process an erase event, use this event handler macro to direct input to a member
 \wxheading{Event table macros}
 
 To process an erase event, use this event handler macro to direct input to a member
@@ -19,11 +33,13 @@ function that takes a wxEraseEvent argument.
 
 \wxheading{Remarks}
 
 
 \wxheading{Remarks}
 
-If the {\bf m\_DC} member is non-NULL, draw into this device context.
+Use the {\bf m\_DC} device context to draw into, don't create wxPaintDC in 
+the event handler.
 
 \wxheading{See also}
 
 
 \wxheading{See also}
 
-\helpref{wxWindow::OnEraseBackground}{wxwindowonerasebackground}, \helpref{Event handling overview}{eventhandlingoverview}
+%\helpref{wxWindow::OnEraseBackground}{wxwindowonerasebackground},
+\helpref{Event handling overview}{eventhandlingoverview}
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
@@ -37,12 +53,11 @@ Constructor.
 
 \member{wxDC*}{m\_dc}
 
 
 \member{wxDC*}{m\_dc}
 
-The device context associated with the erase event (may be NULL).
+The device context associated with the erase event.
 
 \membersection{wxEraseEvent::GetDC}\label{wxeraseeventgetdc}
 
 \constfunc{wxDC*}{GetDC}{\void}
 
 
 \membersection{wxEraseEvent::GetDC}\label{wxeraseeventgetdc}
 
 \constfunc{wxDC*}{GetDC}{\void}
 
-Returns the device context to draw into. If this is non-NULL, you should draw
-into it to perform the erase operation.
+Returns the device context to draw into.