docs/latex/wx/eraseevt.tex

   1 \section{\class{wxEraseEvent}}\label{wxeraseevent}
   2
   3 An erase event is sent when a window's background needs to be repainted.
   4
   5 On some platforms, such as GTK+, this event is simulated (simply generated just before the
   6 paint event) and may cause flicker. It is therefore recommended that
   7 you set the text background colour explicitly in order to prevent flicker.
   8 The default background colour under GTK+ is grey.
   9
  10 To intercept this event, use the EVT\_ERASE\_BACKGROUND macro in an event table definition.
  11
  12 You must call wxEraseEvent::GetDC and use the returned device context if it is non-NULL.
  13 If it is NULL, create your own temporary wxClientDC object.
  14
  15 \wxheading{Derived from}
  16
  17 \helpref{wxEvent}{wxevent}\\
  18 \helpref{wxObject}{wxobject}
  19
  20 \wxheading{Include files}
  21
  22 <wx/event.h>
  23
  24 \wxheading{Library}
  25
  26 \helpref{wxCore}{librarieslist}
  27
  28 \wxheading{Event table macros}
  29
  30 To process an erase event, use this event handler macro to direct input to a member
  31 function that takes a wxEraseEvent argument.
  32
  33 \twocolwidtha{7cm}
  34 \begin{twocollist}\itemsep=0pt
  35 \twocolitem{{\bf EVT\_ERASE\_BACKGROUND(func)}}{Process a wxEVT\_ERASE\_BACKGROUND event.}
  36 \end{twocollist}%
  37
  38 \wxheading{Remarks}
  39
  40 Use the device context returned by \helpref{GetDC}{wxeraseeventgetdc} to draw on,
  41 don't create a wxPaintDC in the event handler.
  42
  43 \wxheading{See also}
  44
  45 %\helpref{wxWindow::OnEraseBackground}{wxwindowonerasebackground},
  46 \helpref{Event handling overview}{eventhandlingoverview}
  47
  48 \latexignore{\rtfignore{\wxheading{Members}}}
  49
  50 \membersection{wxEraseEvent::wxEraseEvent}\label{wxeraseeventctor}
  51
  52 \func{}{wxEraseEvent}{\param{int }{id = 0}, \param{wxDC* }{dc = NULL}}
  53
  54 Constructor.
  55
  56 \membersection{wxEraseEvent::GetDC}\label{wxeraseeventgetdc}
  57
  58 \constfunc{wxDC*}{GetDC}{\void}
  59
  60 Returns the device context associated with the erase event to draw on.
  61