Version: 3.0.3
event.h File Reference

Classes

class  wxEvent
 An event is a structure holding information about an event passed to a callback or member function. More...
 
class  wxEventBlocker
 This class is a special event handler which allows to discard any event (or a set of event types) directed to a specific window. More...
 
class  wxPropagationDisabler
 Helper class to temporarily change an event to not propagate. More...
 
class  wxPropagateOnce
 Helper class to temporarily lower propagation level. More...
 
class  wxEvtHandler
 A class that can handle events from the windowing system. More...
 
class  wxKeyEvent
 This event class contains information about key press and release events. More...
 
class  wxJoystickEvent
 This event class contains information about joystick events, particularly events received by windows. More...
 
class  wxScrollWinEvent
 A scroll event holds information about events sent from scrolling windows. More...
 
class  wxSysColourChangedEvent
 This class is used for system colour change events, which are generated when the user changes the colour settings using the control panel. More...
 
class  wxCommandEvent
 This event class contains information about command events, which originate from a variety of simple controls. More...
 
class  wxWindowCreateEvent
 This event is sent just after the actual window associated with a wxWindow object has been created. More...
 
class  wxPaintEvent
 A paint event is sent when a window's contents needs to be repainted. More...
 
class  wxMaximizeEvent
 An event being sent when a top level window is maximized. More...
 
class  wxUpdateUIEvent
 This class is used for pseudo-events which are called by wxWidgets to give an application the chance to update various user interface elements. More...
 
class  wxClipboardTextEvent
 This class represents the events generated by a control (typically a wxTextCtrl but other windows can generate these events as well) when its content gets copied or cut to, or pasted from the clipboard. More...
 
class  wxMouseEvent
 This event class contains information about the events generated by the mouse: they include mouse buttons press and release events and mouse move events. More...
 
class  wxDropFilesEvent
 This class is used for drop files events, that is, when files have been dropped onto the window. More...
 
class  wxActivateEvent
 An activate event is sent when a window or application is being activated or deactivated. More...
 
class  wxContextMenuEvent
 This class is used for context menu events, sent to give the application a chance to show a context (popup) menu for a wxWindow. More...
 
class  wxEraseEvent
 An erase event is sent when a window's background needs to be repainted. More...
 
class  wxFocusEvent
 A focus event is sent when a window's focus changes. More...
 
class  wxChildFocusEvent
 A child focus event is sent to a (parent-)window when one of its child windows gains focus, so that the window could restore the focus back to its corresponding child if it loses it now and regains later. More...
 
class  wxMouseCaptureLostEvent
 A mouse capture lost event is sent to a window that had obtained mouse capture, which was subsequently lost due to an "external" event (for example, when a dialog box is shown or if another application captures the mouse). More...
 
class  wxDisplayChangedEvent
 
class  wxPaletteChangedEvent
 
class  wxQueryNewPaletteEvent
 
class  wxNotifyEvent
 This class is not used by the event handlers by itself, but is a base class for other event classes (such as wxBookCtrlEvent). More...
 
class  wxThreadEvent
 This class adds some simple functionality to wxEvent to facilitate inter-thread communication. More...
 
class  wxHelpEvent
 A help event is sent when the user has requested context-sensitive help. More...
 
class  wxScrollEvent
 A scroll event holds information about events sent from stand-alone scrollbars (see wxScrollBar) and sliders (see wxSlider). More...
 
class  wxIdleEvent
 This class is used for idle events, which are generated when the system becomes idle. More...
 
class  wxInitDialogEvent
 A wxInitDialogEvent is sent as a dialog or panel is being initialised. More...
 
class  wxWindowDestroyEvent
 This event is sent as early as possible during the window destruction process. More...
 
class  wxNavigationKeyEvent
 This event class contains information about navigation events, generated by navigation keys such as tab and page down. More...
 
class  wxMouseCaptureChangedEvent
 An mouse capture changed event is sent to a window that loses its mouse capture. More...
 
class  wxCloseEvent
 This event class contains information about window and session close events. More...
 
class  wxMenuEvent
 This class is used for a variety of menu-related events. More...
 
class  wxShowEvent
 An event being sent when the window is shown or hidden. More...
 
class  wxIconizeEvent
 An event being sent when the frame is iconized (minimized) or restored. More...
 
class  wxMoveEvent
 A move event holds information about wxTopLevelWindow move change events. More...
 
class  wxSizeEvent
 A size event holds information about size change events of wxWindow. More...
 
class  wxSetCursorEvent
 A wxSetCursorEvent is generated from wxWindow when the mouse cursor is about to be set as a result of mouse motion. More...
 

Macros

#define wxDEFINE_EVENT(name, cls)   const wxEventTypeTag< cls > name(wxNewEventType())
 Define a new event type associated with the specified event class. More...
 
#define wxDECLARE_EVENT(name, cls)   wxDECLARE_EXPORTED_EVENT(wxEMPTY_PARAMETER_VALUE, name, cls)
 Declares a custom event type. More...
 
#define wxDECLARE_EXPORTED_EVENT(expdecl, name, cls)   extern const expdecl wxEventTypeTag< cls > name;
 Variant of wxDECLARE_EVENT() used for event types defined inside a shared library. More...
 
#define wxEVENT_HANDLER_CAST(functype, func)   (&func)
 Helper macro for definition of custom event table macros. More...
 
#define wx__DECLARE_EVT1(evt, id, fn)   wx__DECLARE_EVT2(evt, id, wxID_ANY, fn)
 This macro is used to define event table macros for handling custom events. More...
 
#define wx__DECLARE_EVT2(evt, id1, id2, fn)   DECLARE_EVENT_TABLE_ENTRY(evt, id1, id2, fn, NULL),
 Generalized version of the wx__DECLARE_EVT1() macro taking a range of IDs instead of a single one. More...
 
#define wx__DECLARE_EVT0(evt, fn)   wx__DECLARE_EVT1(evt, wxID_ANY, fn)
 Simplified version of the wx__DECLARE_EVT1() macro, to be used when the event type must be handled regardless of the ID associated with the specific event instances. More...
 
#define wxDECLARE_EVENT_TABLE()
 Use this macro inside a class declaration to declare a static event table for that class. More...
 
#define wxBEGIN_EVENT_TABLE(theClass, baseClass)
 Use this macro in a source file to start listing static event handlers for a specific class. More...
 
#define wxEND_EVENT_TABLE()
 Use this macro in a source file to end listing static event handlers for a specific class. More...
 

Typedefs

typedef int wxEventType
 A value uniquely identifying the type of the event. More...
 

Enumerations

enum  wxEventPropagation {
  wxEVENT_PROPAGATE_NONE = 0,
  wxEVENT_PROPAGATE_MAX = INT_MAX
}
 The predefined constants for the number of times we propagate event upwards window child-parent chain. More...
 
enum  wxEventCategory {
  wxEVT_CATEGORY_UI = 1,
  wxEVT_CATEGORY_USER_INPUT = 2,
  wxEVT_CATEGORY_SOCKET = 4,
  wxEVT_CATEGORY_TIMER = 8,
  wxEVT_CATEGORY_THREAD = 16,
  wxEVT_CATEGORY_ALL
}
 The different categories for a wxEvent; see wxEvent::GetEventCategory. More...
 
enum  wxKeyCategoryFlags {
  WXK_CATEGORY_ARROW,
  WXK_CATEGORY_PAGING,
  WXK_CATEGORY_JUMP,
  WXK_CATEGORY_TAB,
  WXK_CATEGORY_CUT,
  WXK_CATEGORY_NAVIGATION
}
 Flags for categories of keys. More...
 
enum  {
  wxJOYSTICK1,
  wxJOYSTICK2
}
 
enum  {
  wxJOY_BUTTON_ANY = -1,
  wxJOY_BUTTON1 = 1,
  wxJOY_BUTTON2 = 2,
  wxJOY_BUTTON3 = 4,
  wxJOY_BUTTON4 = 8
}
 
enum  wxUpdateUIMode {
  wxUPDATE_UI_PROCESS_ALL,
  wxUPDATE_UI_PROCESS_SPECIFIED
}
 The possibles modes to pass to wxUpdateUIEvent::SetMode(). More...
 
enum  wxMouseWheelAxis {
  wxMOUSE_WHEEL_VERTICAL,
  wxMOUSE_WHEEL_HORIZONTAL
}
 Possible axis values for mouse wheel scroll events. More...
 
enum  wxIdleMode {
  wxIDLE_PROCESS_ALL,
  wxIDLE_PROCESS_SPECIFIED
}
 See wxIdleEvent::SetMode() for more info. More...
 

Functions

wxEventType wxNewEventType ()
 Generates a new unique event type. More...
 
void wxPostEvent (wxEvtHandler *dest, const wxEvent &event)
 In a GUI application, this function posts event to the specified dest object using wxEvtHandler::AddPendingEvent(). More...
 
void wxQueueEvent (wxEvtHandler *dest, wxEvent *event)
 Queue an event for processing on the given object. More...
 

Variables

wxEventType wxEVT_NULL
 A special event type usually used to indicate that some wxEvent has yet no type assigned. More...
 
wxEventType wxEVT_ANY
 
wxEventType wxEVT_BUTTON
 
wxEventType wxEVT_CHECKBOX
 
wxEventType wxEVT_CHOICE
 
wxEventType wxEVT_LISTBOX
 
wxEventType wxEVT_LISTBOX_DCLICK
 
wxEventType wxEVT_CHECKLISTBOX
 
wxEventType wxEVT_MENU
 
wxEventType wxEVT_SLIDER
 
wxEventType wxEVT_RADIOBOX
 
wxEventType wxEVT_RADIOBUTTON
 
wxEventType wxEVT_SCROLLBAR
 
wxEventType wxEVT_VLBOX
 
wxEventType wxEVT_COMBOBOX
 
wxEventType wxEVT_TOOL_RCLICKED
 
wxEventType wxEVT_TOOL_DROPDOWN
 
wxEventType wxEVT_TOOL_ENTER
 
wxEventType wxEVT_COMBOBOX_DROPDOWN
 
wxEventType wxEVT_COMBOBOX_CLOSEUP
 
wxEventType wxEVT_THREAD
 
wxEventType wxEVT_LEFT_DOWN
 
wxEventType wxEVT_LEFT_UP
 
wxEventType wxEVT_MIDDLE_DOWN
 
wxEventType wxEVT_MIDDLE_UP
 
wxEventType wxEVT_RIGHT_DOWN
 
wxEventType wxEVT_RIGHT_UP
 
wxEventType wxEVT_MOTION
 
wxEventType wxEVT_ENTER_WINDOW
 
wxEventType wxEVT_LEAVE_WINDOW
 
wxEventType wxEVT_LEFT_DCLICK
 
wxEventType wxEVT_MIDDLE_DCLICK
 
wxEventType wxEVT_RIGHT_DCLICK
 
wxEventType wxEVT_SET_FOCUS
 
wxEventType wxEVT_KILL_FOCUS
 
wxEventType wxEVT_CHILD_FOCUS
 
wxEventType wxEVT_MOUSEWHEEL
 
wxEventType wxEVT_AUX1_DOWN
 
wxEventType wxEVT_AUX1_UP
 
wxEventType wxEVT_AUX1_DCLICK
 
wxEventType wxEVT_AUX2_DOWN
 
wxEventType wxEVT_AUX2_UP
 
wxEventType wxEVT_AUX2_DCLICK
 
wxEventType wxEVT_CHAR
 
wxEventType wxEVT_CHAR_HOOK
 
wxEventType wxEVT_NAVIGATION_KEY
 
wxEventType wxEVT_KEY_DOWN
 
wxEventType wxEVT_KEY_UP
 
wxEventType wxEVT_HOTKEY
 
wxEventType wxEVT_SET_CURSOR
 
wxEventType wxEVT_SCROLL_TOP
 
wxEventType wxEVT_SCROLL_BOTTOM
 
wxEventType wxEVT_SCROLL_LINEUP
 
wxEventType wxEVT_SCROLL_LINEDOWN
 
wxEventType wxEVT_SCROLL_PAGEUP
 
wxEventType wxEVT_SCROLL_PAGEDOWN
 
wxEventType wxEVT_SCROLL_THUMBTRACK
 
wxEventType wxEVT_SCROLL_THUMBRELEASE
 
wxEventType wxEVT_SCROLL_CHANGED
 
wxEventType wxEVT_SPIN_UP
 
wxEventType wxEVT_SPIN_DOWN
 
wxEventType wxEVT_SPIN
 
wxEventType wxEVT_SCROLLWIN_TOP
 
wxEventType wxEVT_SCROLLWIN_BOTTOM
 
wxEventType wxEVT_SCROLLWIN_LINEUP
 
wxEventType wxEVT_SCROLLWIN_LINEDOWN
 
wxEventType wxEVT_SCROLLWIN_PAGEUP
 
wxEventType wxEVT_SCROLLWIN_PAGEDOWN
 
wxEventType wxEVT_SCROLLWIN_THUMBTRACK
 
wxEventType wxEVT_SCROLLWIN_THUMBRELEASE
 
wxEventType wxEVT_SIZE
 
wxEventType wxEVT_MOVE
 
wxEventType wxEVT_CLOSE_WINDOW
 
wxEventType wxEVT_END_SESSION
 
wxEventType wxEVT_QUERY_END_SESSION
 
wxEventType wxEVT_ACTIVATE_APP
 
wxEventType wxEVT_ACTIVATE
 
wxEventType wxEVT_CREATE
 
wxEventType wxEVT_DESTROY
 
wxEventType wxEVT_SHOW
 
wxEventType wxEVT_ICONIZE
 
wxEventType wxEVT_MAXIMIZE
 
wxEventType wxEVT_MOUSE_CAPTURE_CHANGED
 
wxEventType wxEVT_MOUSE_CAPTURE_LOST
 
wxEventType wxEVT_PAINT
 
wxEventType wxEVT_ERASE_BACKGROUND
 
wxEventType wxEVT_NC_PAINT
 
wxEventType wxEVT_MENU_OPEN
 
wxEventType wxEVT_MENU_CLOSE
 
wxEventType wxEVT_MENU_HIGHLIGHT
 
wxEventType wxEVT_CONTEXT_MENU
 
wxEventType wxEVT_SYS_COLOUR_CHANGED
 
wxEventType wxEVT_DISPLAY_CHANGED
 
wxEventType wxEVT_QUERY_NEW_PALETTE
 
wxEventType wxEVT_PALETTE_CHANGED
 
wxEventType wxEVT_JOY_BUTTON_DOWN
 
wxEventType wxEVT_JOY_BUTTON_UP
 
wxEventType wxEVT_JOY_MOVE
 
wxEventType wxEVT_JOY_ZMOVE
 
wxEventType wxEVT_DROP_FILES
 
wxEventType wxEVT_INIT_DIALOG
 
wxEventType wxEVT_IDLE
 
wxEventType wxEVT_UPDATE_UI
 
wxEventType wxEVT_SIZING
 
wxEventType wxEVT_MOVING
 
wxEventType wxEVT_MOVE_START
 
wxEventType wxEVT_MOVE_END
 
wxEventType wxEVT_HIBERNATE
 
wxEventType wxEVT_TEXT_COPY
 
wxEventType wxEVT_TEXT_CUT
 
wxEventType wxEVT_TEXT_PASTE
 
wxEventType wxEVT_COMMAND_LEFT_CLICK
 
wxEventType wxEVT_COMMAND_LEFT_DCLICK
 
wxEventType wxEVT_COMMAND_RIGHT_CLICK
 
wxEventType wxEVT_COMMAND_RIGHT_DCLICK
 
wxEventType wxEVT_COMMAND_SET_FOCUS
 
wxEventType wxEVT_COMMAND_KILL_FOCUS
 
wxEventType wxEVT_COMMAND_ENTER
 
wxEventType wxEVT_HELP
 
wxEventType wxEVT_DETAILED_HELP
 
wxEventType wxEVT_TOOL
 
wxEventType wxEVT_WINDOW_MODAL_DIALOG_CLOSED
 

Enumeration Type Documentation

anonymous enum
Enumerator
wxJOYSTICK1 
wxJOYSTICK2 
anonymous enum
Enumerator
wxJOY_BUTTON_ANY 
wxJOY_BUTTON1 
wxJOY_BUTTON2 
wxJOY_BUTTON3 
wxJOY_BUTTON4 

The different categories for a wxEvent; see wxEvent::GetEventCategory.

Note
They are used as OR-combinable flags by wxEventLoopBase::YieldFor.
Enumerator
wxEVT_CATEGORY_UI 

This is the category for those events which are generated to update the appearance of the GUI but which (usually) do not comport data processing, i.e.

which do not provide input or output data (e.g. size events, scroll events, etc). They are events NOT directly generated by the user's input devices.

wxEVT_CATEGORY_USER_INPUT 

This category groups those events which are generated directly from the user through input devices like mouse and keyboard and usually result in data to be processed from the application (e.g.

mouse clicks, key presses, etc).

wxEVT_CATEGORY_SOCKET 

This category is for wxSocketEvent.

wxEVT_CATEGORY_TIMER 

This category is for wxTimerEvent.

wxEVT_CATEGORY_THREAD 

This category is for any event used to send notifications from the secondary threads to the main one or in general for notifications among different threads (which may or may not be user-generated).

See e.g. wxThreadEvent.

wxEVT_CATEGORY_ALL 

This mask is used in wxEventLoopBase::YieldFor to specify that all event categories should be processed.

The predefined constants for the number of times we propagate event upwards window child-parent chain.

Enumerator
wxEVENT_PROPAGATE_NONE 

don't propagate it at all

wxEVENT_PROPAGATE_MAX 

propagate it until it is processed

enum wxIdleMode

See wxIdleEvent::SetMode() for more info.

Enumerator
wxIDLE_PROCESS_ALL 

Send idle events to all windows.

wxIDLE_PROCESS_SPECIFIED 

Send idle events to windows that have the wxWS_EX_PROCESS_IDLE flag specified.

Flags for categories of keys.

These values are used by wxKeyEvent::IsKeyInCategory(). They may be combined via the bitwise operators |, &, and ~.

Since
2.9.1
Enumerator
WXK_CATEGORY_ARROW 

arrow keys, on and off numeric keypads

WXK_CATEGORY_PAGING 

page up and page down keys, on and off numeric keypads

WXK_CATEGORY_JUMP 

home and end keys, on and off numeric keypads

WXK_CATEGORY_TAB 

tab key, on and off numeric keypads

WXK_CATEGORY_CUT 

backspace and delete keys, on and off numeric keypads

WXK_CATEGORY_NAVIGATION 

union of WXK_CATEGORY_ARROW, WXK_CATEGORY_PAGING, and WXK_CATEGORY_JUMP categories

Possible axis values for mouse wheel scroll events.

Since
2.9.4
Enumerator
wxMOUSE_WHEEL_VERTICAL 

Vertical scroll event.

wxMOUSE_WHEEL_HORIZONTAL 

Horizontal scroll event.

The possibles modes to pass to wxUpdateUIEvent::SetMode().

Enumerator
wxUPDATE_UI_PROCESS_ALL 

Send UI update events to all windows.

wxUPDATE_UI_PROCESS_SPECIFIED 

Send UI update events to windows that have the wxWS_EX_PROCESS_UI_UPDATES flag specified.