]> git.saurik.com Git - wxWidgets.git/blame_incremental - docs/latex/wx/notifevt.tex
define _HPUX_SOURCE under HP-UX, otherwise many things are not defined in standard...
[wxWidgets.git] / docs / latex / wx / notifevt.tex
... / ...
CommitLineData
1\section{\class{wxNotifyEvent}}\label{wxnotifyevent}
2
3This class is not used by the event handlers by itself, but is a base class
4for other event classes (such as \helpref{wxNotebookEvent}{wxnotebookevent}).
5
6It (or an object of a derived class) is sent when the controls state is being
7changed and allows the program to \helpref{Veto()}{wxnotifyeventveto} this
8change if it wants to prevent it from happening.
9
10\wxheading{Derived from}
11
12\helpref{wxCommandEvent}{wxcommandevent}\\
13\helpref{wxEvent}{wxevent}\\
14\helpref{wxEvtHandler}{wxevthandler}\\
15\helpref{wxObject}{wxobject}
16
17\wxheading{Include files}
18
19<wx/event.h>
20
21\wxheading{Event table macros}
22
23None
24
25\wxheading{See also}
26
27\helpref{wxNotebookEvent}{wxnotebookevent}
28
29\latexignore{\rtfignore{\wxheading{Members}}}
30
31\membersection{wxNotifyEvent::wxNotifyEvent}\label{wxnotifyeventconstr}
32
33\func{}{wxNotifyEvent}{\param{wxEventType}{ eventType = wxEVT\_NULL}, \param{int}{ id = 0}}
34
35Constructor (used internally by wxWidgets only).
36
37\membersection{wxNotifyEvent::Allow}\label{wxnotifyeventallow}
38
39\func{void}{Allow}{\void}
40
41This is the opposite of \helpref{Veto()}{wxnotifyeventveto}: it explicitly
42allows the event to be processed. For most events it is not necessary to call
43this method as the events are allowed anyhow but some are forbidden by default
44(this will be mentioned in the corresponding event description).
45
46\membersection{wxNotifyEvent::IsAllowed}\label{wxnotifyeventisallowed}
47
48\constfunc{bool}{IsAllowed}{\void}
49
50Returns true if the change is allowed (\helpref{Veto()}{wxnotifyeventveto}
51hasn't been called) or false otherwise (if it was).
52
53\membersection{wxNotifyEvent::Veto}\label{wxnotifyeventveto}
54
55\func{void}{Veto}{\void}
56
57Prevents the change announced by this event from happening.
58
59It is in general a good idea to notify the user about the reasons for vetoing
60the change because otherwise the applications behaviour (which just refuses to
61do what the user wants) might be quite surprising.
62