X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/a660d684eda27638bca0384b2058911a31c8e845..cc20da41278e57396bda09f540fc649663b8ded8:/docs/latex/wx/eraseevt.tex diff --git a/docs/latex/wx/eraseevt.tex b/docs/latex/wx/eraseevt.tex index f7397c2b42..eb19bd53ab 100644 --- a/docs/latex/wx/eraseevt.tex +++ b/docs/latex/wx/eraseevt.tex @@ -2,11 +2,25 @@ 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{Include files} + + + \wxheading{Event table macros} To process an erase event, use this event handler macro to direct input to a member @@ -14,16 +28,18 @@ function that takes a wxEraseEvent argument. \twocolwidtha{7cm} \begin{twocollist}\itemsep=0pt -\twocolitem{{\bf EVT\_ERASE(func)}}{Process a wxEVT\_ERASE\_BACKGROUND event.} +\twocolitem{{\bf EVT\_ERASE\_BACKGROUND(func)}}{Process a wxEVT\_ERASE\_BACKGROUND event.} \end{twocollist}% \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} -\helpref{wxWindow::OnEraseBackground}{wxwindowonerasebackground}, \helpref{Event handling overview}{eventhandlingoverview} +%\helpref{wxWindow::OnEraseBackground}{wxwindowonerasebackground}, +\helpref{Event handling overview}{eventhandlingoverview} \latexignore{\rtfignore{\wxheading{Members}}} @@ -37,12 +53,11 @@ Constructor. \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} -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.