docs/latex/wx/destroyevt.tex

   1 \section{\class{wxWindowDestroyEvent}}\label{wxwindowdestroyevent}
   2
   3 % Note: the original description is still here commented out in case those
   4 %       semantics are restored to this event.
   5
   6 %This event is sent just before the actual window associated with a wxWindow object
   7 %is destroyed. Since it is derived from wxCommandEvent, the event propagates up
   8 %the window hierarchy.
   9
  10 This event is sent from the wxWindow destructor wxWindow::~wxWindow() when a
  11 window is destroyed.
  12
  13 When a class derived from wxWindow is destroyed its destructor will have
  14 already run by the time this event is sent. Therefore this event will not
  15 usually be received at all.
  16
  17 To receive this event \helpref{wxEvtHandler::Connect}{wxevthandlerconnect}
  18 must be used (using an event table macro will not work). Since it is
  19 received after the destructor has run, an object should not handle its
  20 own wxWindowDestroyEvent, but it can be used to get notification of the
  21 destruction of another window.
  22
  23 \wxheading{Derived from}
  24
  25 \helpref{wxCommandEvent}{wxevent}\\
  26 \helpref{wxEvent}{wxevent}\\
  27 \helpref{wxObject}{wxobject}
  28
  29 \wxheading{Include files}
  30
  31 <wx/event.h>
  32
  33 \wxheading{Library}
  34
  35 \helpref{wxCore}{librarieslist}
  36
  37 \wxheading{Event table macros}
  38
  39 %To process a window destruction event, use this event handler macro to direct input to a member
  40 %function that takes a wxWindowDestroyEvent argument.
  41 %
  42 %\twocolwidtha{7cm}
  43 %\begin{twocollist}\itemsep=0pt
  44 %\twocolitem{{\bf EVT\_WINDOW\_DESTROY(func)}}{Process a wxEVT\_DESTROY event.}
  45 %\end{twocollist}%
  46
  47 It is not possible to receive this event using an event table macro.
  48
  49 \wxheading{See also}
  50
  51 \helpref{Event handling overview}{eventhandlingoverview},\rtfsp
  52 \helpref{wxWindowCreateEvent}{wxwindowcreateevent}
  53
  54 \latexignore{\rtfignore{\wxheading{Members}}}
  55
  56 \membersection{wxWindowDestroyEvent::wxWindowDestroyEvent}\label{wxwindowdestroyeventctor}
  57
  58 \func{}{wxWindowDestroyEvent}{\param{wxWindow* }{win = NULL}}
  59
  60 Constructor.
  61