X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/dce5c1dbe1eefd05837f5da615c76de90d92a5c1..65baafba0e8cd74f2264b7e2f7625ff5bea84864:/docs/latex/wx/eraseevt.tex diff --git a/docs/latex/wx/eraseevt.tex b/docs/latex/wx/eraseevt.tex index 0eee070ab1..18dfe5c574 100644 --- a/docs/latex/wx/eraseevt.tex +++ b/docs/latex/wx/eraseevt.tex @@ -2,6 +2,16 @@ 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}\\ @@ -23,30 +33,25 @@ function that takes a wxEraseEvent argument. \wxheading{Remarks} -Use the {\bf m\_DC} device context to draw into, don't create wxPaintDC in -the event handler. +Use the device context returned by \helpref{GetDC}{wxeraseeventgetdc} to draw on, +don't create a 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}}} -\membersection{wxEraseEvent::wxEraseEvent} +\membersection{wxEraseEvent::wxEraseEvent}\label{wxeraseeventctor} \func{}{wxEraseEvent}{\param{int }{id = 0}, \param{wxDC* }{dc = NULL}} Constructor. -\membersection{wxEraseEvent::m\_dc} - -\member{wxDC*}{m\_dc} - -The device context associated with the erase event. - \membersection{wxEraseEvent::GetDC}\label{wxeraseeventgetdc} \constfunc{wxDC*}{GetDC}{\void} -Returns the device context to draw into. +Returns the device context associated with the erase event to draw on.