wxruby 1.9.2-i686-darwin8.8.2

data/lib/wx/classes/artprovider.rb

@@ -0,0 +1,31 @@
+# Class which can supply icons and bitmaps
+class Wx::ArtProvider
+  # Keep a note of supplied ArtProviders to prevent them being GC'd
+  @__art_provs = []
+
+  class << self 
+    wx_insert = instance_method(:insert)
+    define_method(:insert) do | art_prov |
+      wx_insert.bind(self).call(art_prov)
+      @__art_provs.unshift(art_prov)
+    end
+
+    wx_pop = instance_method(:pop)
+    define_method(:pop) do
+      wx_pop.bind(self).call
+      @__art_provs.pop
+    end
+
+    wx_push = instance_method(:push)
+    define_method(:push) do | art_prov |
+      wx_push.bind(self).call(art_prov)
+      @__art_provs.push(art_prov)
+    end
+
+    wx_remove = instance_method(:remove)
+    define_method(:remove) do | art_prov |
+      wx_push.bind(self).call(art_prov)
+      @__art_provs.delete(art_prov)
+    end
+  end
+end

data/lib/wx/classes/bitmap.rb

@@ -0,0 +1,23 @@
+class Wx::Bitmap
+  # Redefine the initialize method so it raises an exception if a
+  # non-existent file is given to the constructor; otherwise, wx Widgets
+  # just carries on with an empty bitmap, which may cause faults later
+  wx_init = self.instance_method(:initialize)
+  define_method(:initialize) do | *args |
+    if args[0].kind_of? String
+      if not File.exist?( File.expand_path(args[0]) )
+        Kernel.raise(ArgumentError, "Bitmap file does not exist: #{args[0]}")
+      end
+    end
+    wx_init.bind(self).call(*args)
+  end
+
+  # Accepts a block, which will be passed a device context which can be
+  # used to draw upon the Bitmap
+  def draw
+    dc = Wx::MemoryDC.new
+    dc.select_object(self)
+    yield dc
+    dc.select_object( Wx::NULL_BITMAP )
+  end
+end

data/lib/wx/classes/checklistbox.rb

@@ -0,0 +1,30 @@
+# Display a listbox with a checkbox for each item
+class Wx::CheckListBox < Wx::ListBox
+
+  # According to the wxWidgets documentation: "wxCheckListBox uses
+  # client data in its implementation, and therefore this is not
+  # available to the application."   
+  #
+  # So, rather than crashing, raise an Exception if this is attempted
+  def append(*args)
+    if args.length == 2 
+      Kernel.raise "Cannot use item data with Wx::CheckListBox"
+    else 
+      super
+    end
+  end
+
+  # As above
+  def insert(*args)
+    if args.length == 3
+      Kernel.raise "Cannot use item data with Wx::CheckListBox"
+    else 
+      super
+    end
+  end
+
+  # As above
+  def set_item_data(index, data)
+    Kernel.raise "Cannot use item data with Wx::CheckListBox"
+  end
+end

data/lib/wx/classes/choice.rb

@@ -0,0 +1,4 @@
+class Wx::Choice
+  alias :get_item_data :get_client_data
+  alias :set_item_data :set_client_data
+end

data/lib/wx/classes/clientdc.rb

@@ -0,0 +1,13 @@
+# Device Context to paint on a window outside an on_paint handler. It is
+# recommended that PaintDC is used in preference to this class.
+class Wx::ClientDC
+  # This class should not be instantiated directly in wxRuby; it should
+  # always be used via Window#paint, which takes a block receiving the
+  # DC. This ensures that the DC is cleaned up at the correct time,
+  # avoiding errors and segfaults on exit.
+  define_method(:initialize) do | *args |
+    Kernel.raise RuntimeError,
+                 "Do not instantiate ClientDC directly; use Window#paint",
+                 caller[1..-1]
+  end
+end

data/lib/wx/classes/colour.rb

@@ -0,0 +1,47 @@
+class Wx::Colour
+  # Redefine the initialize method so it raises an exception if an
+  # invalid colour value is given. This might be an unknown colour
+  # string (eg 'dark blue') or out-of-bounds integer values (<0 or >255)
+  wx_init = self.instance_method(:initialize)
+  define_method(:initialize) do | *args |
+    begin
+      wx_init.bind(self).call(*args)
+    # Invalid integer values raise SWIG 'no matching func'
+    rescue ArgumentError 
+      Kernel.raise ArgumentError, "Invalid colour values #{args.inspect}"
+    end
+
+    if not is_ok
+      Kernel.raise ArgumentError, "Invalid colour values #{args.inspect}"
+    end
+  end
+
+  # Standard colours, corresponding to WxWidgets stock colours.
+  Wx::WHITE = new(255, 255, 255)
+  Wx::BLACK = new(0, 0, 0)
+
+  Wx::RED   = new(255, 0, 0)
+  Wx::GREEN = new(0, 255, 0)
+  Wx::BLUE  = new(0, 0, 255)
+
+  Wx::YELLOW  = new(255, 255, 0)
+  Wx::MAGENTA = new(255, 0, 255)
+  Wx::CYAN    = new(0, 255, 255)
+
+  Wx::LIGHT_GREY = new(192, 192, 192)
+
+  # Colours are equal to one another if they have the same red, green
+  # and blue intensity, and the same alpha
+  def ==(other)
+    if not other.is_a?(self.class)
+      raise ArgumentError, "No comparison of #{self} to #{other}"
+    end
+    [ red, green, blue, alpha ] == 
+      [ other.red, other.green, other.blue, other.alpha ]
+  end
+
+  # More informative output for inspect etc
+  def to_s
+    "#<Wx::Colour: (#{red}, #{green}, #{blue} *#{alpha})>"
+  end
+end

data/lib/wx/classes/combobox.rb

@@ -0,0 +1,4 @@
+class Wx::ComboBox
+  alias :get_item_data :get_client_data
+  alias :set_item_data :set_client_data
+end

data/lib/wx/classes/commandevent.rb

@@ -0,0 +1,7 @@
+# Class representing interactions with controls such as ListBox
+class Wx::CommandEvent
+  # get_int and get_selection are already synonyms, but neither name
+  # accurately describes what the method does as the event may be a
+  # (de)selection or a check in a CheckListBox
+  alias :get_index :get_int
+end

data/lib/wx/classes/controlwithitems.rb

@@ -0,0 +1,10 @@
+# Superclass of a variety of controls that display lists of items (eg
+# Choice, ListBox, CheckListBox)
+class Wx::ControlWithItems
+  # Make these ruby enumerables so find, find_all, map etc are available 
+  include Enumerable
+  # Passes each valid item index into the passed block
+  def each
+    0.upto(count - 1) { | i | yield i }
+  end
+end

data/lib/wx/classes/evthandler.rb

@@ -0,0 +1,884 @@
+# All classes which are capable of handling events inherit from
+# EvtHandler. This includes all Wx::Window subclasses and Wx::App.
+
+class Wx::EvtHandler
+  # EventType is an internal class that's used to set up event handlers
+  # and mappings. 
+  # * 'name' is the name of the event handler method in ruby
+  # * 'arity' is the number of id arguments that method should accept
+  # * 'const' is the Wx EventType constant that identifies the event
+  # * 'evt_class' is the WxRuby event class which is passed to the event
+  #    handler block
+  # 
+  # NB: Some event types currently pass a Wx::Event into the event
+  # handler block; when the appropriate classes are added to wxRuby, the
+  # binding can be updated here.
+  EventType = Struct.new(:name, :arity, :const, :evt_class)
+
+  # Fast look-up hash to map event type ids to ruby event classes
+  EVENT_TYPE_CLASS_MAP = {}
+  # Hash to look up EVT constants from symbol names of evt handler
+  # methods; used internally by disconnect (see EvtHandler.i)
+  EVENT_NAME_TYPE_MAP = {}
+
+  # Given a Wx EventType id (eg Wx::EVT_MENU), returns a WxRuby Event
+  # class which should be passed to event handler blocks. The actual
+  # EVT_XXX constants themselves are in the compiled library, defined in
+  # swig/classes/Event.i
+  def self.event_class_for_type(id)
+    if evt_klass = EVENT_TYPE_CLASS_MAP[id]
+      return evt_klass
+    else
+      warn "No event class defined for event type #{id}"
+      return Wx::Event
+    end
+  end
+
+  # Given the symbol name of an evt_xxx handler method, returns the
+  # Integer Wx::EVT_XXX constant associated with that handler.
+  def self.event_type_for_name(name)
+    EVENT_NAME_TYPE_MAP[name]
+  end
+
+  # Given the Integer constant Wx::EVT_XXX, returns the convenience
+  # handler method name associated with that type of event.
+
+  def self.event_name_for_type(name)
+    EVENT_NAME_TYPE_MAP.index(name)
+  end
+
+  # Public method to register the mapping of a custom event type
+  # +konstant+ (which should be a unique integer; one will be created if
+  # not supplied) to a custom event class +klass+. If +meth+ and +arity+
+  # are given, a convenience evt_handler method called +meth+ will be
+  # created, which accepts +arity+ arguments.
+  def self.register_class( klass, konstant = nil, 
+                           meth = nil, arity = nil)
+    konstant ||= Wx::Event.new_event_type
+    unless klass < Wx::Event
+      Kernel.raise TypeError, "Event class should be a subclass of Wx::Event"
+    end
+    ev_type = EventType.new(meth, arity, konstant, klass)
+    register_event_type(ev_type)
+    return konstant
+  end
+
+  # Registers the event type +ev_type+, which should be an instance of
+  # the Struct class +Wx::EvtHandler::EventType+. This sets up the
+  # mapping of events of that type (identified by integer id) to the
+  # appropriate ruby event class, and defines a convenience evt_xxx
+  # instance method in the class EvtHandler.
+  def self.register_event_type(ev_type)
+    # set up the event type mapping
+    EVENT_TYPE_CLASS_MAP[ev_type.const] = ev_type.evt_class
+    EVENT_NAME_TYPE_MAP[ev_type.name.intern] = ev_type.const
+
+    unless ev_type.arity and ev_type.name
+      return 
+    end
+
+    # set up the evt_xxx method
+    case ev_type.arity
+    when 0 # events without an id
+      class_eval %Q| 
+        def #{ev_type.name}(meth = nil, &block)
+          handler = acquire_handler(meth, block)
+          connect(Wx::ID_ANY, Wx::ID_ANY, #{ev_type.const}, &handler)
+        end |
+    when 1 # events with an id
+      class_eval %Q|
+        def #{ev_type.name}(id, meth = nil, &block)
+          handler = acquire_handler(meth, block)
+          id  = acquire_id(id)
+          connect(id, Wx::ID_ANY, #{ev_type.const}, &handler)
+        end |
+    when 2 # events with id range
+      class_eval %Q|
+        def #{ev_type.name}(first_id, last_id, meth = nil, &block)
+          handler  = acquire_handler(meth, block)
+          first_id = acquire_id(first_id)
+          last_id  = acquire_id(last_id)
+          connect( first_id, last_id, #{ev_type.const}, &handler)
+        end |
+    end
+  end
+
+  # Not for external use; determines whether to use a block or call a
+  # method in self to handle an event, passed to connect. Makes evt_xxx
+  # liberal about what it accepts - aside from a block, it can be a
+  # method name (as Symbol or String), a (bound) method object, or a
+  # Proc object
+  def acquire_handler(meth, block)
+    if block and not meth
+      return block
+    elsif meth and not block
+      h_meth = case meth
+        when Symbol, String : self.method(meth)
+        when Proc : meth
+        when Method : meth.to_proc
+      end
+      if h_meth.arity == 1
+        return lambda { | evt | h_meth.call(evt) }
+      else
+        return lambda { h_meth.call }
+      end
+    else
+      Kernel.raise ArgumentError,
+                  "Specify event handler with a method, name, proc OR block"
+                  caller
+    end
+  end
+
+  # Not for external use; acquires an id either from an explicit Fixnum
+  # parameter or by calling the wx_id method of a passed Window.
+  def acquire_id(window_or_id)
+    case window_or_id
+    when Fixnum : window_or_id
+    when Wx::Window, Wx::MenuItem : window_or_id.wx_id
+    else Kernel.raise ArgumentError, 
+                     "Must specify Wx::Window event source or its Wx id, " +
+                     "not '#{window_or_id.inspect}'",
+                      caller
+    end
+  end
+  private :acquire_id, :acquire_handler
+
+  # Definitions for all event types that are part by core wxRuby. Events
+  # that are mapped to class Wx::Event are TODO as they are not
+  # currently wrapped by the correct class. All StyledTextCtrl
+  # (Scintilla) events with prefix EVT_STC are dealt with in the
+  # separate styledtextctrl.rb file.
+  EVENT_DEFINITIONS = [ 
+    EventType['evt_activate', 0,
+              Wx::EVT_ACTIVATE, 
+              Wx::ActivateEvent],
+    EventType['evt_activate_app', 0,
+              Wx::EVT_ACTIVATE_APP, 
+              Wx::ActivateEvent],
+    EventType['evt_auinotebook_allow_dnd', 1,
+              Wx::EVT_COMMAND_AUINOTEBOOK_ALLOW_DND, 
+              Wx::AuiNotebookEvent],
+    EventType['evt_auinotebook_begin_drag', 1,
+              Wx::EVT_COMMAND_AUINOTEBOOK_BEGIN_DRAG, 
+              Wx::AuiNotebookEvent],
+    EventType['evt_auinotebook_button', 1,
+              Wx::EVT_COMMAND_AUINOTEBOOK_BUTTON, 
+              Wx::AuiNotebookEvent],
+    EventType['evt_auinotebook_drag_motion', 1,
+              Wx::EVT_COMMAND_AUINOTEBOOK_DRAG_MOTION, 
+              Wx::AuiNotebookEvent],
+    EventType['evt_auinotebook_end_drag', 1,
+              Wx::EVT_COMMAND_AUINOTEBOOK_END_DRAG, 
+              Wx::AuiNotebookEvent],
+    EventType['evt_auinotebook_page_changed', 1,
+              Wx::EVT_COMMAND_AUINOTEBOOK_PAGE_CHANGED, 
+              Wx::AuiNotebookEvent],
+    EventType['evt_auinotebook_page_changing', 1,
+              Wx::EVT_COMMAND_AUINOTEBOOK_PAGE_CHANGING, 
+              Wx::AuiNotebookEvent],
+    EventType['evt_auinotebook_page_close', 1,
+              Wx::EVT_COMMAND_AUINOTEBOOK_PAGE_CLOSE, 
+              Wx::AuiNotebookEvent],
+    EventType['evt_aui_find_manager', 0,
+              Wx::EVT_AUI_FIND_MANAGER, 
+              Wx::AuiManagerEvent],
+    EventType['evt_aui_pane_button', 0,
+              Wx::EVT_AUI_PANE_BUTTON, 
+              Wx::AuiManagerEvent],
+    EventType['evt_aui_pane_close', 0,
+              Wx::EVT_AUI_PANE_CLOSE, 
+              Wx::AuiManagerEvent],
+    EventType['evt_aui_pane_maximize', 0,
+              Wx::EVT_AUI_PANE_MAXIMIZE, 
+              Wx::AuiManagerEvent],
+    EventType['evt_aui_pane_restore', 0,
+              Wx::EVT_AUI_PANE_RESTORE, 
+              Wx::AuiManagerEvent],
+    EventType['evt_aui_render', 0,
+              Wx::EVT_AUI_RENDER, 
+              Wx::AuiManagerEvent],
+    EventType['evt_button', 1,
+              Wx::EVT_COMMAND_BUTTON_CLICKED, 
+              Wx::CommandEvent],
+    EventType['evt_calculate_layout', 0,
+              Wx::EVT_CALCULATE_LAYOUT, 
+              Wx::Event],
+    EventType['evt_calendar', 1,
+              Wx::EVT_CALENDAR_DOUBLECLICKED, 
+              Wx::CalendarEvent],
+    EventType['evt_calendar_day', 1,
+              Wx::EVT_CALENDAR_DAY_CHANGED, 
+              Wx::CalendarEvent],
+    EventType['evt_calendar_month', 1,
+              Wx::EVT_CALENDAR_MONTH_CHANGED, 
+              Wx::CalendarEvent],
+    EventType['evt_calendar_sel_changed', 1,
+              Wx::EVT_CALENDAR_SEL_CHANGED, 
+              Wx::CalendarEvent],
+    EventType['evt_calendar_weekday_clicked', 1,
+              Wx::EVT_CALENDAR_WEEKDAY_CLICKED, 
+              Wx::CalendarEvent],
+    EventType['evt_calendar_year', 1,
+              Wx::EVT_CALENDAR_YEAR_CHANGED, 
+              Wx::CalendarEvent],
+    EventType['evt_char', 0,
+              Wx::EVT_CHAR, 
+              Wx::KeyEvent],
+    EventType['evt_char_hook', 0,
+              Wx::EVT_CHAR_HOOK, 
+              Wx::KeyEvent],
+    EventType['evt_checkbox', 1,
+              Wx::EVT_COMMAND_CHECKBOX_CLICKED, 
+              Wx::CommandEvent],
+    EventType['evt_checklistbox', 1,
+              Wx::EVT_COMMAND_CHECKLISTBOX_TOGGLED, 
+              Wx::CommandEvent],
+    EventType['evt_child_focus', 0,
+              Wx::EVT_CHILD_FOCUS, 
+              Wx::ChildFocusEvent],
+    EventType['evt_choice', 1,
+              Wx::EVT_COMMAND_CHOICE_SELECTED, 
+              Wx::CommandEvent],
+    EventType['evt_choicebook_page_changed', 1,
+              Wx::EVT_COMMAND_CHOICEBOOK_PAGE_CHANGED, 
+              Wx::ChoicebookEvent],
+    EventType['evt_choicebook_page_changing', 1,
+              Wx::EVT_COMMAND_CHOICEBOOK_PAGE_CHANGING, 
+              Wx::ChoicebookEvent],
+    EventType['evt_close', 0,
+              Wx::EVT_CLOSE_WINDOW, 
+              Wx::CloseEvent],
+    EventType['evt_collapsiblepane_changed', 1,
+              Wx::EVT_COMMAND_COLLPANE_CHANGED, 
+              Wx::CollapsiblePaneEvent],
+    EventType['evt_combobox', 1,
+              Wx::EVT_COMMAND_COMBOBOX_SELECTED, 
+              Wx::CommandEvent],
+    EventType['evt_command', 0,
+              Wx::EVT_NULL, 
+              Wx::Event],
+    EventType['evt_command_enter', 1,
+              Wx::EVT_COMMAND_ENTER, 
+              Wx::Event],
+    EventType['evt_command_kill_focus', 1,
+              Wx::EVT_COMMAND_KILL_FOCUS, 
+              Wx::Event],
+    EventType['evt_command_left_click', 1,
+              Wx::EVT_COMMAND_LEFT_CLICK, 
+              Wx::Event],
+    EventType['evt_command_left_dclick', 1,
+              Wx::EVT_COMMAND_LEFT_DCLICK, 
+              Wx::Event],
+    EventType['evt_command_range', 2,
+              Wx::EVT_NULL, 
+              Wx::Event],
+    EventType['evt_command_right_click', 1,
+              Wx::EVT_COMMAND_RIGHT_CLICK, 
+              Wx::Event],
+    EventType['evt_command_set_focus', 1,
+              Wx::EVT_COMMAND_SET_FOCUS, 
+              Wx::Event],
+    EventType['evt_context_menu', 0,
+              Wx::EVT_CONTEXT_MENU, 
+              Wx::ContextMenuEvent],
+    EventType['evt_drop_files', 0,
+              Wx::EVT_DROP_FILES, 
+              Wx::Event],
+    EventType['evt_end_process', 1,
+              Wx::EVT_END_PROCESS, 
+              Wx::Event],
+    EventType['evt_end_session', 0,
+              Wx::EVT_END_SESSION, 
+              Wx::Event],
+    EventType['evt_enter_window', 0,
+              Wx::EVT_ENTER_WINDOW, 
+              Wx::MouseEvent],
+    EventType['evt_erase_background', 0,
+              Wx::EVT_ERASE_BACKGROUND, 
+              Wx::EraseEvent],
+    EventType['evt_find', 1,
+              Wx::EVT_COMMAND_FIND, 
+              Wx::FindDialogEvent],
+    EventType['evt_find_close', 1,
+              Wx::EVT_COMMAND_FIND_CLOSE, 
+              Wx::FindDialogEvent],
+    EventType['evt_find_next', 1,
+              Wx::EVT_COMMAND_FIND_NEXT, 
+              Wx::FindDialogEvent],
+    EventType['evt_find_replace', 1,
+              Wx::EVT_COMMAND_FIND_REPLACE, 
+              Wx::FindDialogEvent],
+    EventType['evt_find_replace_all', 1,
+              Wx::EVT_COMMAND_FIND_REPLACE_ALL, 
+              Wx::FindDialogEvent],
+    EventType['evt_grid_cell_change', 0,
+              Wx::EVT_GRID_CELL_CHANGE, 
+              Wx::GridEvent],
+    EventType['evt_grid_cell_left_click', 0,
+              Wx::EVT_GRID_CELL_LEFT_CLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_cell_left_dclick', 0,
+              Wx::EVT_GRID_CELL_LEFT_DCLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_cell_right_click', 0,
+              Wx::EVT_GRID_CELL_RIGHT_CLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_cell_right_dclick', 0,
+              Wx::EVT_GRID_CELL_RIGHT_DCLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_cmd_cell_change', 1,
+              Wx::EVT_GRID_CELL_CHANGE, 
+              Wx::GridEvent],
+    EventType['evt_grid_cmd_cell_left_click', 1,
+              Wx::EVT_GRID_CELL_LEFT_CLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_cmd_cell_left_dclick', 1,
+              Wx::EVT_GRID_CELL_LEFT_DCLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_cmd_cell_right_click', 1,
+              Wx::EVT_GRID_CELL_RIGHT_CLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_cmd_cell_right_dclick', 1,
+              Wx::EVT_GRID_CELL_RIGHT_DCLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_cmd_col_size', 1,
+              Wx::EVT_GRID_COL_SIZE, 
+              Wx::GridSizeEvent],
+    EventType['evt_grid_cmd_editor_created', 1,
+              Wx::EVT_GRID_EDITOR_CREATED, 
+              Wx::GridEditorCreatedEvent],
+    EventType['evt_grid_cmd_editor_hidden', 1,
+              Wx::EVT_GRID_EDITOR_HIDDEN, 
+              Wx::GridEvent],
+    EventType['evt_grid_cmd_editor_shown', 1,
+              Wx::EVT_GRID_EDITOR_SHOWN, 
+              Wx::GridEvent],
+    EventType['evt_grid_cmd_label_left_click', 1,
+              Wx::EVT_GRID_LABEL_LEFT_CLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_cmd_label_left_dclick', 1,
+              Wx::EVT_GRID_LABEL_LEFT_DCLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_cmd_label_right_click', 1,
+              Wx::EVT_GRID_LABEL_RIGHT_CLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_cmd_label_right_dclick', 1,
+              Wx::EVT_GRID_LABEL_RIGHT_DCLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_cmd_range_select', 1,
+              Wx::EVT_GRID_RANGE_SELECT, 
+              Wx::GridRangeSelectEvent],
+    EventType['evt_grid_cmd_row_size', 1,
+              Wx::EVT_GRID_ROW_SIZE, 
+              Wx::GridSizeEvent],
+    EventType['evt_grid_cmd_select_cell', 1,
+              Wx::EVT_GRID_SELECT_CELL, 
+              Wx::GridEvent],
+    EventType['evt_grid_col_size', 0,
+              Wx::EVT_GRID_COL_SIZE, 
+              Wx::GridSizeEvent],
+    EventType['evt_grid_editor_created', 0,
+              Wx::EVT_GRID_EDITOR_CREATED, 
+              Wx::GridEditorCreatedEvent],
+    EventType['evt_grid_editor_hidden', 0,
+              Wx::EVT_GRID_EDITOR_HIDDEN, 
+              Wx::GridEvent],
+    EventType['evt_grid_editor_shown', 0,
+              Wx::EVT_GRID_EDITOR_SHOWN, 
+              Wx::GridEvent],
+    EventType['evt_grid_label_left_click', 0,
+              Wx::EVT_GRID_LABEL_LEFT_CLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_label_left_dclick', 0,
+              Wx::EVT_GRID_LABEL_LEFT_DCLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_label_right_click', 0,
+              Wx::EVT_GRID_LABEL_RIGHT_CLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_label_right_dclick', 0,
+              Wx::EVT_GRID_LABEL_RIGHT_DCLICK, 
+              Wx::GridEvent],
+    EventType['evt_grid_range_select', 0,
+              Wx::EVT_GRID_RANGE_SELECT, 
+              Wx::GridRangeSelectEvent],
+    EventType['evt_grid_row_size', 0,
+              Wx::EVT_GRID_ROW_SIZE, 
+              Wx::GridSizeEvent],
+    EventType['evt_grid_select_cell', 0,
+              Wx::EVT_GRID_SELECT_CELL, 
+              Wx::GridEvent],
+    EventType['evt_help', 1,
+              Wx::EVT_HELP, 
+              Wx::Event],
+    EventType['evt_help_range', 2,
+              Wx::EVT_HELP, 
+              Wx::Event],
+    EventType['evt_hyperlink', 1,
+              Wx::EVT_COMMAND_HYPERLINK, 
+              Wx::HyperlinkEvent],
+    EventType['evt_iconize', 0,
+              Wx::EVT_ICONIZE, 
+              Wx::IconizeEvent],
+    EventType['evt_idle', 0,
+              Wx::EVT_IDLE, 
+              Wx::IdleEvent],
+    EventType['evt_init_dialog', 0,
+              Wx::EVT_INIT_DIALOG, 
+              Wx::Event],
+    EventType['evt_joy_button_down', 0,
+              Wx::EVT_JOY_BUTTON_DOWN, 
+              Wx::Event],
+    EventType['evt_joy_button_up', 0,
+              Wx::EVT_JOY_BUTTON_UP, 
+              Wx::Event],
+    EventType['evt_joy_move', 0,
+              Wx::EVT_JOY_MOVE, 
+              Wx::Event],
+    EventType['evt_joy_zmove', 0,
+              Wx::EVT_JOY_ZMOVE, 
+              Wx::Event],
+    EventType['evt_key_down', 0,
+              Wx::EVT_KEY_DOWN, 
+              Wx::KeyEvent],
+    EventType['evt_key_up', 0,
+              Wx::EVT_KEY_UP, 
+              Wx::KeyEvent],
+    EventType['evt_kill_focus', 0,
+              Wx::EVT_KILL_FOCUS, 
+              Wx::FocusEvent],
+    EventType['evt_leave_window', 0,
+              Wx::EVT_LEAVE_WINDOW, 
+              Wx::MouseEvent],
+    EventType['evt_left_dclick', 0,
+              Wx::EVT_LEFT_DCLICK, 
+              Wx::MouseEvent],
+    EventType['evt_left_down', 0,
+              Wx::EVT_LEFT_DOWN, 
+              Wx::MouseEvent],
+    EventType['evt_left_up', 0,
+              Wx::EVT_LEFT_UP, 
+              Wx::MouseEvent],
+    EventType['evt_listbook_page_changed', 1,
+              Wx::EVT_COMMAND_LISTBOOK_PAGE_CHANGED, 
+              Wx::ListbookEvent],
+    EventType['evt_listbook_page_changing', 1,
+              Wx::EVT_COMMAND_LISTBOOK_PAGE_CHANGING, 
+              Wx::ListbookEvent],
+    EventType['evt_listbox', 1,
+              Wx::EVT_COMMAND_LISTBOX_SELECTED, 
+              Wx::CommandEvent],
+    EventType['evt_listbox_dclick', 1,
+              Wx::EVT_COMMAND_LISTBOX_DOUBLECLICKED, 
+              Wx::CommandEvent],
+    EventType['evt_list_begin_drag', 1,
+              Wx::EVT_COMMAND_LIST_BEGIN_DRAG, 
+              Wx::ListEvent],
+    EventType['evt_list_begin_label_edit', 1,
+              Wx::EVT_COMMAND_LIST_BEGIN_LABEL_EDIT, 
+              Wx::ListEvent],
+    EventType['evt_list_begin_rdrag', 1,
+              Wx::EVT_COMMAND_LIST_BEGIN_RDRAG, 
+              Wx::ListEvent],
+    EventType['evt_list_cache_hint', 1,
+              Wx::EVT_COMMAND_LIST_CACHE_HINT, 
+              Wx::ListEvent],
+    EventType['evt_list_col_begin_drag', 1,
+              Wx::EVT_COMMAND_LIST_COL_BEGIN_DRAG, 
+              Wx::ListEvent],
+    EventType['evt_list_col_click', 1,
+              Wx::EVT_COMMAND_LIST_COL_CLICK, 
+              Wx::ListEvent],
+    EventType['evt_list_col_dragging', 1,
+              Wx::EVT_COMMAND_LIST_COL_DRAGGING, 
+              Wx::ListEvent],
+    EventType['evt_list_col_end_drag', 1,
+              Wx::EVT_COMMAND_LIST_COL_END_DRAG, 
+              Wx::ListEvent],
+    EventType['evt_list_col_right_click', 1,
+              Wx::EVT_COMMAND_LIST_COL_RIGHT_CLICK, 
+              Wx::ListEvent],
+    EventType['evt_list_delete_all_items', 1,
+              Wx::EVT_COMMAND_LIST_DELETE_ALL_ITEMS, 
+              Wx::ListEvent],
+    EventType['evt_list_delete_item', 1,
+              Wx::EVT_COMMAND_LIST_DELETE_ITEM, 
+              Wx::ListEvent],
+    EventType['evt_list_end_label_edit', 1,
+              Wx::EVT_COMMAND_LIST_END_LABEL_EDIT, 
+              Wx::ListEvent],
+    EventType['evt_list_insert_item', 1,
+              Wx::EVT_COMMAND_LIST_INSERT_ITEM, 
+              Wx::ListEvent],
+    EventType['evt_list_item_activated', 1,
+              Wx::EVT_COMMAND_LIST_ITEM_ACTIVATED, 
+              Wx::ListEvent],
+    EventType['evt_list_item_deselected', 1,
+              Wx::EVT_COMMAND_LIST_ITEM_DESELECTED, 
+              Wx::ListEvent],
+    EventType['evt_list_item_focused', 1,
+              Wx::EVT_COMMAND_LIST_ITEM_FOCUSED, 
+              Wx::ListEvent],
+    EventType['evt_list_item_middle_click', 1,
+              Wx::EVT_COMMAND_LIST_ITEM_MIDDLE_CLICK, 
+              Wx::ListEvent],
+    EventType['evt_list_item_right_click', 1,
+              Wx::EVT_COMMAND_LIST_ITEM_RIGHT_CLICK, 
+              Wx::ListEvent],
+    EventType['evt_list_item_selected', 1,
+              Wx::EVT_COMMAND_LIST_ITEM_SELECTED, 
+              Wx::ListEvent],
+    EventType['evt_list_key_down', 1,
+              Wx::EVT_COMMAND_LIST_KEY_DOWN, 
+              Wx::ListEvent],
+    EventType['evt_maximize', 0,
+              Wx::EVT_MAXIMIZE, 
+              Wx::Event],
+    EventType['evt_menu', 1,
+              Wx::EVT_COMMAND_MENU_SELECTED, 
+              Wx::CommandEvent],
+    EventType['evt_menu_close', 0,
+              Wx::EVT_MENU_CLOSE, 
+              Wx::MenuEvent],
+    EventType['evt_menu_highlight', 1,
+              Wx::EVT_MENU_HIGHLIGHT, 
+              Wx::MenuEvent],
+    EventType['evt_menu_highlight_all', 0,
+              Wx::EVT_MENU_HIGHLIGHT, 
+              Wx::MenuEvent],
+    EventType['evt_menu_open', 0,
+              Wx::EVT_MENU_OPEN, 
+              Wx::MenuEvent],
+    EventType['evt_menu_range', 2,
+              Wx::EVT_COMMAND_MENU_SELECTED, 
+              Wx::CommandEvent],
+    EventType['evt_middle_dclick', 0,
+              Wx::EVT_MIDDLE_DCLICK, 
+              Wx::MouseEvent],
+    EventType['evt_middle_down', 0,
+              Wx::EVT_MIDDLE_DOWN, 
+              Wx::MouseEvent],
+    EventType['evt_middle_up', 0,
+              Wx::EVT_MIDDLE_UP, 
+              Wx::MouseEvent],
+    EventType['evt_motion', 0,
+              Wx::EVT_MOTION, 
+              Wx::MouseEvent],
+    EventType['evt_mousewheel', 0,
+              Wx::EVT_MOUSEWHEEL, 
+              Wx::MouseEvent],
+    EventType['evt_mouse_capture_changed', 0,
+              Wx::EVT_MOUSE_CAPTURE_CHANGED, 
+              Wx::Event],
+    EventType['evt_move', 0,
+              Wx::EVT_MOVE, 
+              Wx::MoveEvent],
+    EventType['evt_nc_paint', 0,
+              Wx::EVT_NC_PAINT, 
+              Wx::Event],
+    EventType['evt_notebook_page_changed', 1,
+              Wx::EVT_COMMAND_NOTEBOOK_PAGE_CHANGED, 
+              Wx::NotebookEvent],
+    EventType['evt_notebook_page_changing', 1,
+              Wx::EVT_COMMAND_NOTEBOOK_PAGE_CHANGING, 
+              Wx::NotebookEvent],
+    EventType['evt_paint', 0,
+              Wx::EVT_PAINT, 
+              Wx::PaintEvent],
+    EventType['evt_query_end_session', 0,
+              Wx::EVT_QUERY_END_SESSION, 
+              Wx::Event],
+    EventType['evt_query_layout_info', 0,
+              Wx::EVT_QUERY_LAYOUT_INFO, 
+              Wx::Event],
+    EventType['evt_radiobox', 1,
+              Wx::EVT_COMMAND_RADIOBOX_SELECTED, 
+              Wx::CommandEvent],
+    EventType['evt_radiobutton', 1,
+              Wx::EVT_COMMAND_RADIOBUTTON_SELECTED, 
+              Wx::CommandEvent],
+    EventType['evt_right_dclick', 0,
+              Wx::EVT_RIGHT_DCLICK, 
+              Wx::MouseEvent],
+    EventType['evt_right_down', 0,
+              Wx::EVT_RIGHT_DOWN, 
+              Wx::MouseEvent],
+    EventType['evt_right_up', 0,
+              Wx::EVT_RIGHT_UP, 
+              Wx::MouseEvent],
+    EventType['evt_sash_dragged', 1,
+              Wx::EVT_SASH_DRAGGED, 
+              Wx::SashEvent],
+    EventType['evt_sash_dragged_range', 2,
+              Wx::EVT_SASH_DRAGGED, 
+              Wx::SashEvent],
+    EventType['evt_scrollbar', 1,
+              Wx::EVT_COMMAND_SCROLLBAR_UPDATED, 
+              Wx::CommandEvent],
+    EventType['evt_scrollwin_bottom', 0,
+              Wx::EVT_SCROLLWIN_TOP, 
+              Wx::ScrollWinEvent],
+    EventType['evt_scrollwin_linedown', 0,
+              Wx::EVT_SCROLLWIN_LINEDOWN, 
+              Wx::ScrollWinEvent],
+    EventType['evt_scrollwin_lineup', 0,
+              Wx::EVT_SCROLLWIN_LINEUP, 
+              Wx::ScrollWinEvent],
+    EventType['evt_scrollwin_pagedown', 0,
+              Wx::EVT_SCROLLWIN_PAGEDOWN, 
+              Wx::ScrollWinEvent],
+    EventType['evt_scrollwin_pageup', 0,
+              Wx::EVT_SCROLLWIN_PAGEUP, 
+              Wx::ScrollWinEvent],
+    EventType['evt_scrollwin_thumbrelease', 0,
+              Wx::EVT_SCROLLWIN_THUMBRELEASE, 
+              Wx::ScrollWinEvent],
+    EventType['evt_scrollwin_thumbtrack', 0,
+              Wx::EVT_SCROLLWIN_THUMBTRACK, 
+              Wx::ScrollWinEvent],
+    EventType['evt_scrollwin_top', 0,
+              Wx::EVT_SCROLLWIN_TOP, 
+              Wx::ScrollWinEvent],
+    EventType['evt_scroll_bottom', 0,
+              Wx::EVT_SCROLL_BOTTOM, 
+              Wx::ScrollEvent],
+    EventType['evt_scroll_linedown', 0,
+              Wx::EVT_SCROLL_LINEDOWN, 
+              Wx::ScrollEvent],
+    EventType['evt_scroll_lineup', 0,
+              Wx::EVT_SCROLL_LINEUP, 
+              Wx::ScrollEvent],
+    EventType['evt_scroll_pagedown', 0,
+              Wx::EVT_SCROLL_PAGEDOWN, 
+              Wx::ScrollEvent],
+    EventType['evt_scroll_pageup', 0,
+              Wx::EVT_SCROLL_PAGEUP, 
+              Wx::ScrollEvent],
+    EventType['evt_scroll_thumbrelease', 0,
+              Wx::EVT_SCROLL_THUMBRELEASE, 
+              Wx::ScrollEvent],
+    EventType['evt_scroll_thumbtrack', 0,
+              Wx::EVT_SCROLL_THUMBTRACK, 
+              Wx::ScrollEvent],
+    EventType['evt_scroll_top', 0,
+              Wx::EVT_SCROLL_TOP, 
+              Wx::ScrollEvent],
+    EventType['evt_set_cursor', 0,
+              Wx::EVT_SET_CURSOR, 
+              Wx::SetCursorEvent],
+    EventType['evt_set_focus', 0,
+              Wx::EVT_SET_FOCUS, 
+              Wx::FocusEvent],
+    EventType['evt_size', 0,
+              Wx::EVT_SIZE, 
+              Wx::SizeEvent],
+    EventType['evt_sizing', 0,
+              Wx::EVT_SIZING, 
+              Wx::SizeEvent],
+    EventType['evt_slider', 1,
+              Wx::EVT_COMMAND_SLIDER_UPDATED, 
+              Wx::CommandEvent],
+    EventType['evt_socket', 1,
+              Wx::EVT_SOCKET, 
+              Wx::Event],
+    EventType['evt_spin', 1,
+              Wx::EVT_SCROLL_THUMBTRACK, 
+              Wx::ScrollEvent],
+    EventType['evt_spinctrl', 1,
+              Wx::EVT_COMMAND_SPINCTRL_UPDATED, 
+              Wx::SpinEvent],
+    EventType['evt_spin_down', 1,
+              Wx::EVT_SCROLL_LINEDOWN, 
+              Wx::ScrollEvent],
+    EventType['evt_spin_up', 1,
+              Wx::EVT_SCROLL_LINEUP, 
+              Wx::ScrollEvent],
+    EventType['evt_splitter_dclick', 1,
+              Wx::EVT_COMMAND_SPLITTER_DOUBLECLICKED, 
+              Wx::SplitterEvent],
+    EventType['evt_splitter_sash_pos_changed', 1,
+              Wx::EVT_COMMAND_SPLITTER_SASH_POS_CHANGED, 
+              Wx::SplitterEvent],
+    EventType['evt_splitter_sash_pos_changing', 1,
+              Wx::EVT_COMMAND_SPLITTER_SASH_POS_CHANGING, 
+              Wx::SplitterEvent],
+    EventType['evt_splitter_unsplit', 1,
+              Wx::EVT_COMMAND_SPLITTER_UNSPLIT, 
+              Wx::SplitterEvent],
+    EventType['evt_sys_colour_changed', 0,
+              Wx::EVT_SYS_COLOUR_CHANGED, 
+              Wx::Event],
+    EventType['evt_taskbar_left_dclick', 0,
+              Wx::EVT_TASKBAR_LEFT_DCLICK, 
+              Wx::Event],
+    EventType['evt_taskbar_left_down', 0,
+              Wx::EVT_TASKBAR_LEFT_DOWN, 
+              Wx::Event],
+    EventType['evt_taskbar_left_up', 0,
+              Wx::EVT_TASKBAR_LEFT_UP, 
+              Wx::Event],
+    EventType['evt_taskbar_move', 0,
+              Wx::EVT_TASKBAR_MOVE, 
+              Wx::Event],
+    EventType['evt_taskbar_right_dclick', 0,
+              Wx::EVT_TASKBAR_RIGHT_DCLICK, 
+              Wx::Event],
+    EventType['evt_taskbar_right_down', 0,
+              Wx::EVT_TASKBAR_RIGHT_DOWN, 
+              Wx::Event],
+    EventType['evt_taskbar_right_up', 0,
+              Wx::EVT_TASKBAR_RIGHT_UP, 
+              Wx::Event],
+    EventType['evt_text', 1,
+              Wx::EVT_COMMAND_TEXT_UPDATED, 
+              Wx::CommandEvent],
+    EventType['evt_text_enter', 1,
+              Wx::EVT_COMMAND_TEXT_ENTER, 
+              Wx::CommandEvent],
+    EventType['evt_text_maxlen', 1,
+              Wx::EVT_COMMAND_TEXT_MAXLEN, 
+              Wx::CommandEvent],
+    EventType['evt_text_url', 1,
+              Wx::EVT_COMMAND_TEXT_URL, 
+              Wx::TextUrlEvent],
+    EventType['evt_timer', 1,
+              Wx::EVT_TIMER, 
+              Wx::TimerEvent],
+    EventType['evt_togglebutton', 1,
+              Wx::EVT_COMMAND_TOGGLEBUTTON_CLICKED, 
+              Wx::Event],
+    EventType['evt_tool', 1,
+              Wx::EVT_COMMAND_TOOL_CLICKED, 
+              Wx::CommandEvent],
+    EventType['evt_tool_enter', 1,
+              Wx::EVT_COMMAND_TOOL_ENTER, 
+              Wx::CommandEvent],
+    EventType['evt_tool_range', 2,
+              Wx::EVT_COMMAND_TOOL_CLICKED, 
+              Wx::CommandEvent],
+    EventType['evt_tool_rclicked', 1,
+              Wx::EVT_COMMAND_TOOL_RCLICKED, 
+              Wx::CommandEvent],
+    EventType['evt_tool_rclicked_range', 2,
+              Wx::EVT_COMMAND_TOOL_RCLICKED, 
+              Wx::CommandEvent],
+    EventType['evt_tree_begin_drag', 1,
+              Wx::EVT_COMMAND_TREE_BEGIN_DRAG, 
+              Wx::TreeEvent],
+    EventType['evt_tree_begin_label_edit', 1,
+              Wx::EVT_COMMAND_TREE_BEGIN_LABEL_EDIT, 
+              Wx::TreeEvent],
+    EventType['evt_tree_begin_rdrag', 1,
+              Wx::EVT_COMMAND_TREE_BEGIN_RDRAG, 
+              Wx::TreeEvent],
+    EventType['evt_tree_delete_item', 1,
+              Wx::EVT_COMMAND_TREE_DELETE_ITEM, 
+              Wx::TreeEvent],
+    EventType['evt_tree_end_drag', 1,
+              Wx::EVT_COMMAND_TREE_END_DRAG, 
+              Wx::TreeEvent],
+    EventType['evt_tree_end_label_edit', 1,
+              Wx::EVT_COMMAND_TREE_END_LABEL_EDIT, 
+              Wx::TreeEvent],
+    EventType['evt_tree_get_info', 1,
+              Wx::EVT_COMMAND_TREE_GET_INFO, 
+              Wx::TreeEvent],
+    EventType['evt_tree_item_activated', 1,
+              Wx::EVT_COMMAND_TREE_ITEM_ACTIVATED, 
+              Wx::TreeEvent],
+    EventType['evt_tree_item_collapsed', 1,
+              Wx::EVT_COMMAND_TREE_ITEM_COLLAPSED, 
+              Wx::TreeEvent],
+    EventType['evt_tree_item_collapsing', 1,
+              Wx::EVT_COMMAND_TREE_ITEM_COLLAPSING, 
+              Wx::TreeEvent],
+    EventType['evt_tree_item_expanded', 1,
+              Wx::EVT_COMMAND_TREE_ITEM_EXPANDED, 
+              Wx::TreeEvent],
+    EventType['evt_tree_item_expanding', 1,
+              Wx::EVT_COMMAND_TREE_ITEM_EXPANDING, 
+              Wx::TreeEvent],
+    EventType['evt_tree_item_middle_click', 1,
+              Wx::EVT_COMMAND_TREE_ITEM_MIDDLE_CLICK, 
+              Wx::TreeEvent],
+    EventType['evt_tree_item_right_click', 1,
+              Wx::EVT_COMMAND_TREE_ITEM_RIGHT_CLICK, 
+              Wx::TreeEvent],
+    EventType['evt_tree_key_down', 1,
+              Wx::EVT_COMMAND_TREE_KEY_DOWN, 
+              Wx::TreeEvent],
+    EventType['evt_tree_sel_changed', 1,
+              Wx::EVT_COMMAND_TREE_SEL_CHANGED, 
+              Wx::TreeEvent],
+    EventType['evt_tree_sel_changing', 1,
+              Wx::EVT_COMMAND_TREE_SEL_CHANGING, 
+              Wx::TreeEvent],
+    EventType['evt_tree_set_info', 1,
+              Wx::EVT_COMMAND_TREE_SET_INFO, 
+              Wx::TreeEvent],
+    EventType['evt_update_ui', 1,
+              Wx::EVT_UPDATE_UI, 
+              Wx::UpdateUIEvent],
+    EventType['evt_update_ui_range', 2,
+              Wx::EVT_UPDATE_UI, 
+              Wx::UpdateUIEvent],
+    EventType['evt_window_create', 0,
+              Wx::EVT_CREATE, 
+              Wx::WindowCreateEvent],
+    EventType['evt_window_destroy', 0,
+              Wx::EVT_DESTROY, 
+              Wx::WindowDestroyEvent],
+    EventType['evt_wizard_cancel', 1,
+              Wx::EVT_WIZARD_CANCEL, 
+              Wx::WizardEvent],
+    EventType['evt_wizard_finished', 1,
+              Wx::EVT_WIZARD_FINISHED, 
+              Wx::WizardEvent],
+    EventType['evt_wizard_help', 1,
+              Wx::EVT_WIZARD_HELP, 
+              Wx::WizardEvent],
+    EventType['evt_wizard_page_changed', 1,
+              Wx::EVT_WIZARD_PAGE_CHANGED, 
+              Wx::WizardEvent],
+    EventType['evt_wizard_page_changing', 1,
+              Wx::EVT_WIZARD_PAGE_CHANGING, 
+              Wx::WizardEvent]
+  ]
+
+  # Loop over the event definitions to set up two things: 
+  # 1) A hash mapping Event Type ids to event classes, used when events
+  #    are fired to quickly look up the right type to yield
+  # 2) EvtHandler instance methods like evt_xxx to conveniently set 
+  #    up event handlers
+  EVENT_DEFINITIONS.each { | ev_type | register_event_type(ev_type) }
+
+
+  # convenience evt_handler to listen to all mouse events
+  def evt_mouse_events(&block)
+    evt_left_down(&block)
+    evt_left_up(&block)
+    evt_middle_down(&block)
+    evt_middle_up(&block)
+    evt_right_down(&block)
+    evt_right_up(&block)
+    evt_motion(&block)
+    evt_left_dclick(&block)
+    evt_middle_dclick(&block)
+    evt_right_dclick(&block)
+    evt_leave_window(&block)
+    evt_enter_window(&block)
+    evt_mousewheel(&block)
+  end
+
+  # convenience evt handler to listen to all scrollwin events
+  def evt_scrollwin(&block)
+    evt_scrollwin_top(&block)
+    evt_scrollwin_bottom(&block)
+    evt_scrollwin_lineup(&block)
+    evt_scrollwin_linedown(&block)
+    evt_scrollwin_pageup(&block)
+    evt_scrollwin_pagedown(&block)
+    evt_scrollwin_thumbtrack(&block)
+    evt_scrollwin_thumbrelease(&block)
+  end
+end
+