wxruby3 1.3.1 → 1.5.0

data/rakelib/lib/director/event_handler.rb

@@ -29,45 +29,21 @@ module WXRuby3
           # have TryBefore and TryAfter to handle this much cleaner
           spec.no_proxy 'wxEvtHandler::ProcessEvent'
           spec.regard('wxEvtHandler::ProcessEvent', regard_doc: false) # we provide customized docs
+          # Do not see much use for allowing overrides for these either as wxWidgets do not either
+          spec.no_proxy 'wxEvtHandler::QueueEvent',
+                        'wxEvtHandler::AddPendingEvent'
+          # Do not see much point in allowing/supporting these to be overridden
+          spec.no_proxy 'wxEvtHandler::SetNextHandler',
+                        'wxEvtHandler::SetPreviousHandler'
+          # no doc for set_previous_handler
+          spec.regard('wxEvtHandler::SetPreviousHandler', regard_doc: false)
           # make SWIG aware of these
           spec.regard 'wxEvtHandler::TryBefore', 'wxEvtHandler::TryAfter'
           # Special type mapping for wxEvtHandler::QueueEvent which assumes ownership of the C++ event.
-          # We need to create a shallow copy of the Ruby event instance (copying it's Ruby members if any),
-          # pass linkage of the C++ event to the copy and remove it from the original (input) Ruby
-          # instance (so it can not delete/or reference it anymore); also start tracking the copy
-          # (which effectively removes the tracking for the original).
-          # Queued (pending) events are cleaned up (deleted) by wxWidgets after (failing) handling
-          # which will automatically unlink and un-track them releasing the Ruby instance to be GC-ed.
-          spec.map 'wxEvent *event' => 'Wx::Event' do
-            map_in code: <<~__CODE
-              // get the wrapped wxEvent*
-              wxEvent *wx_ev = (wxEvent*)DATA_PTR($input);
-              // check if this a user defined event
-              if ( wx_ev->GetEventType() > wxEVT_USER_FIRST )
-              {
-                // we need to preserve the Ruby state
-                // create a shallow copy of the Ruby object
-                VALUE r_evt_copy = rb_obj_clone($input);
-                // pass the wxEvent* over to the copy
-                DATA_PTR(r_evt_copy) = wx_ev;
-                // unlink the input
-                DATA_PTR($input) = 0;
-                // track the copy (this overwrites the record for the 
-                // original, effectively untracking it)
-                wxRuby_AddTracking( (void*)wx_ev, r_evt_copy);
-              }
-              else
-              {
-                // std wx event; no need to preserve the Ruby state
-                // simply untrack and unlink the input
-                wxRuby_RemoveTracking( (void*)wx_ev);
-                DATA_PTR($input) = 0;
-                // and just pass on the C++ event                
-              }
-              // Queue the C++ event
-              $1 = wx_ev;
-              __CODE
-          end
+          # We need to disown Ruby with respect to the C++ event object but remain tracking the pair to keep
+          # the Ruby event object alive.
+          spec.disown 'wxEvent *event'
+
           # add special mapping for event filters so we can accept the app instance as well
           # although Wx::App is not derived from Wx::EventFilter in wxRuby (no multiple inheritance)
           spec.map 'wxEventFilter*' => 'Wx::EventFilter,Wx::App' do
@@ -225,6 +201,10 @@ module WXRuby3
             }
             __HEREDOC
           spec.add_header_code <<~__HEREDOC
+            static VALUE WxRuby_GetAsyncProcCallEvent_Class();
+            static void GC_mark_AsyncMethodCallEvent(void *ptr);
+            static void free_AsyncMethodCallEvent(void *ptr);
+
             class RbAsyncProcCallEvent : public wxAsyncMethodCallEvent
             {
             public:
@@ -245,7 +225,14 @@ module WXRuby3
   
               virtual wxEvent *Clone() const wxOVERRIDE
               {
-                return new RbAsyncProcCallEvent(*this);
+                RbAsyncProcCallEvent* wx_ev = new RbAsyncProcCallEvent(*this);
+                // Create a new Ruby event object (owned) 
+                VALUE rb_evt = Data_Wrap_Struct(WxRuby_GetAsyncProcCallEvent_Class(), 
+                                                VOIDFUNC(GC_mark_AsyncMethodCallEvent), 
+                                                VOIDFUNC(free_AsyncMethodCallEvent), 
+                                                wx_ev);
+                wxRuby_AddTracking( (void*)wx_ev, rb_evt);
+                return wx_ev;
               }
           
               virtual void Execute() wxOVERRIDE
@@ -257,12 +244,22 @@ module WXRuby3
                 if (TYPE(m_rb_call) == T_ARRAY)
                 {
                   VALUE proc = rb_ary_entry(m_rb_call, 0);
-                  VALUE args = rb_ary_subseq(m_rb_call, 1, RARRAY_LEN(m_rb_call)-1);
-                  rc = wxRuby_Funcall(ex_caught, proc, call_id(), args);
+                  if (RARRAY_LEN(m_rb_call) > 1)
+                  {
+                    VALUE args = rb_ary_subseq(m_rb_call, 1, RARRAY_LEN(m_rb_call)-1);
+                    rc = wxRuby_Funcall(ex_caught, proc, call_id(), args);
+                  }
+                  else
+                  {
+                    rc = wxRuby_Funcall(ex_caught, proc, call_id(), (int)0);
+                  } 
                 }
                 else
                 {
-                  rc = wxRuby_Funcall(ex_caught, m_rb_call, call_id(), (int)0);
+                  // should never happen
+                  VALUE ex = rb_eval_string("x = RuntimeError.new('UNEXPECTED ERROR: Asynchronous Proc Event has invalid call spec!'); x.set_backtrace(caller); x"); 
+                  wxRuby_PrintException(ex);
+                  exit(1);
                 }
                 if (ex_caught)
                 {
@@ -276,9 +273,39 @@ module WXRuby3
                 }
               }
           
+              void GC_Mark()
+              {
+                rb_gc_mark(m_rb_call);
+              }
+
             private:
               VALUE m_rb_call;
             };
+
+            static void GC_mark_AsyncMethodCallEvent(void *ptr)
+            {
+              if (ptr)
+              {
+                RbAsyncProcCallEvent* evt = (RbAsyncProcCallEvent*)ptr;
+                evt->GC_Mark();
+              }
+            }
+
+            static void free_AsyncMethodCallEvent(void *ptr)
+            {
+              RbAsyncProcCallEvent *wx_evt = (RbAsyncProcCallEvent *)ptr;
+              delete wx_evt;
+            }
+
+            static VALUE WxRuby_GetAsyncProcCallEvent_Class()
+            {
+              static VALUE WxRuby_cAsyncProcCallEvent = Qnil;
+              if (WxRuby_cAsyncProcCallEvent == Qnil)
+              {
+                WxRuby_cAsyncProcCallEvent = rb_eval_string("Wx::AsyncProcCallEvent");
+              } 
+              return WxRuby_cAsyncProcCallEvent;
+            }
             __HEREDOC
           spec.add_extend_code 'wxEvtHandler', <<~__HEREDOC
             // This provides the public Ruby 'connect' method
@@ -333,18 +360,23 @@ module WXRuby3
             void call_after(VALUE call)
             {
               // valid call object?
-              VALUE proc;
-              if (TYPE(call) == T_ARRAY && 
-                    (rb_obj_is_kind_of(proc = rb_ary_entry(call, 0), rb_cProc)
+              VALUE proc = TYPE(call) == T_ARRAY ? rb_ary_entry(call, 0) : Qnil;
+              if (!NIL_P(proc) && 
+                    (rb_obj_is_kind_of(proc, rb_cProc)
                      ||
                      rb_obj_is_kind_of(proc, rb_cMethod)))
               {
                 // create C++ event
                 RbAsyncProcCallEvent * evt = new RbAsyncProcCallEvent(self, call);
+                // Create a new Ruby event object (leave ownership to wxWidgets C++) 
+                VALUE rb_evt = Data_Wrap_Struct(WxRuby_GetAsyncProcCallEvent_Class(), 
+                                                VOIDFUNC(GC_mark_AsyncMethodCallEvent), 
+                                                0, 
+                                                evt);
                 // track it and the call object
-                wxRuby_AddTracking( (void*)evt, call);
-                // queue it
-                self->QueueEvent(evt);
+                wxRuby_AddTracking( (void*)evt, rb_evt);
+                // queue it (wxWidgets takes ownership of C++ event object)
+                self->wxEvtHandler::QueueEvent(evt);
               }
             }
             __HEREDOC
@@ -371,6 +403,10 @@ module WXRuby3
             def_item = defmod.find_item(citem)
             if Extractor::ClassDef === def_item && spec.is_derived_from?(def_item, 'wxEvtHandler')
               spec.no_proxy "#{spec.class_name(citem)}::ProcessEvent"
+              spec.no_proxy "#{spec.class_name(citem)}::QueueEvent"
+              spec.no_proxy "#{spec.class_name(citem)}::AddPendingEvent"
+              spec.no_proxy "#{spec.class_name(citem)}::SetNextHandler"
+              spec.no_proxy "#{spec.class_name(citem)}::SetPreviousHandler"
               is_evt_handler = true
             end
           end

data/rakelib/lib/director/events.rb

@@ -23,10 +23,12 @@ module WXRuby3
           wxSizeEvent wxMoveEvent wxPaintEvent wxEraseEvent wxFocusEvent wxActivateEvent
           wxInitDialogEvent wxMenuEvent wxCloseEvent wxShowEvent wxIconizeEvent wxMaximizeEvent
           wxFullScreenEvent wxJoystickEvent wxDropFilesEvent wxUpdateUIEvent wxSysColourChangedEvent
-          wxMouseCaptureChangedEvent wxMouseCaptureLostEvent wxDisplayChangedEvent wxDPIChangedEvent
-          wxPaletteChangedEvent wxQueryNewPaletteEvent wxNavigationKeyEvent wxWindowCreateEvent
-          wxWindowDestroyEvent wxHelpEvent wxClipboardTextEvent wxContextMenuEvent wxChildFocusEvent
+          wxDPIChangedEvent wxPaletteChangedEvent wxQueryNewPaletteEvent wxNavigationKeyEvent
+          wxWindowCreateEvent wxWindowDestroyEvent wxHelpEvent wxClipboardTextEvent wxContextMenuEvent wxChildFocusEvent
           ])
+        if Config.instance.features_set?('WXMSW')
+          spec.items.concat %w[wxMouseCaptureChangedEvent wxMouseCaptureLostEvent wxDisplayChangedEvent]
+        end
         spec.fold_bases('wxMouseEvent' => %w[wxMouseState wxKeyboardState], 'wxKeyEvent' => 'wxKeyboardState')
         spec.ignore 'wxShowEvent::GetShow', 'wxIconizeEvent::Iconized'
         spec.ignore 'wxKeyEvent::GetPosition(wxCoord *,wxCoord *) const'

data/rakelib/lib/director/functions.rb

@@ -204,9 +204,6 @@ module WXRuby3
         spec.add_interface_code <<~__HEREDOC
           bool wxSafeYield(wxWindow* win = NULL, bool onlyIfNeeded = false);
           
-          // Mouse / keyboard information
-          wxWindow * wxGetActiveWindow();
-          
           // Dialog shortcuts
           wxString wxFileSelector (const wxString &message,
                                    const wxString &default_path=wxEmptyString,

data/rakelib/lib/director/grid_ctrl.rb

@@ -554,9 +554,33 @@ module WXRuby3
                            '%constant char* wxGRID_VALUE_DATE = "date";',
                            '%constant char* wxGRID_VALUE_TEXT = "string";',
                            '%constant char* wxGRID_VALUE_LONG = "long";'
+        # fix naming mismatch with #evt_grid_cmd_col_size
+        spec.add_swig_code '%constant int EVT_GRID_CMD_COL_SIZE = wxEVT_GRID_COL_SIZE;',
+                           '%constant int EVT_GRID_CMD_ROW_SIZE = wxEVT_GRID_ROW_SIZE;',
+                           '%constant int EVT_GRID_CMD_EDITOR_CREATED = wxEVT_GRID_EDITOR_CREATED;',
+                           '%constant int EVT_GRID_CMD_RANGE_SELECTING = wxEVT_GRID_RANGE_SELECTING;',
+                           '%constant int EVT_GRID_CMD_RANGE_SELECTED = wxEVT_GRID_RANGE_SELECTED;'
+      end
+
+      def doc_generator
+        GridCtrlDocGenerator.new(self)
       end
     end # class GridCtrl
 
   end # class Director
 
+  class GridCtrlDocGenerator < DocGenerator
+
+    protected def gen_constants_doc(fdoc)
+      super
+      xref_table = package.all_modules.reduce(DocGenerator.constants_db) { |db, mod| db[mod] }
+      gen_constant_doc(fdoc, 'EVT_GRID_CMD_COL_SIZE', xref_table['EVT_GRID_COL_SIZE'], 'wxRuby specific alias for Wx::EVT_GRID_COL_SIZE')
+      gen_constant_doc(fdoc, 'EVT_GRID_CMD_ROW_SIZE', xref_table['EVT_GRID_ROW_SIZE'], 'wxRuby specific alias for Wx::EVT_GRID_ROW_SIZE')
+      gen_constant_doc(fdoc, 'EVT_GRID_CMD_EDITOR_CREATED', xref_table['EVT_GRID_EDITOR_CREATED'], 'wxRuby specific alias for Wx::EVT_GRID_EDITOR_CREATED')
+      gen_constant_doc(fdoc, 'EVT_GRID_CMD_RANGE_SELECTING', xref_table['EVT_GRID_RANGE_SELECTING'], 'wxRuby specific alias for Wx::wxEVT_GRID_RANGE_SELECTING')
+      gen_constant_doc(fdoc, 'EVT_GRID_CMD_RANGE_SELECTED', xref_table['EVT_GRID_RANGE_SELECTED'], 'wxRuby specific alias for Wx::wxEVT_GRID_RANGE_SELECTED')
+    end
+
+  end
+
 end # module WXRuby3

data/rakelib/lib/director/html_printout.rb

@@ -12,6 +12,8 @@ module WXRuby3
 
     class HtmlPrintout < Director
 
+      include Typemap::PrintPageRange
+
       def setup
         super
         spec.override_inheritance_chain('wxHtmlPrintout', {'wxPrintout' => 'wxPrinter'}, 'wxObject')

data/rakelib/lib/director/list_ctrl.rb

@@ -148,7 +148,7 @@ module WXRuby3
             
             wxListCtrl* wx_lc = (wxListCtrl*) ptr;
             
-            // First check if there's ImageLists and mark if found
+            // First check if there are ImageLists and mark if found
             wxImageList* img_list;
             img_list= wx_lc->GetImageList(wxIMAGE_LIST_NORMAL);
             if ( img_list ) rb_gc_mark(SWIG_RubyInstanceFor(img_list));
@@ -161,18 +161,22 @@ module WXRuby3
             if ( wx_lc->GetWindowStyle() & wxLC_VIRTUAL )
               return;
             
-            int count = wx_lc->GetItemCount();
-            if ( count == 0 ) return;
-            
-            for (int i = 0; i < count; ++i)
+            // only mark items if window fully created
+            if (wx_lc->GetId() != wxID_ANY)
             {
-              wxUIntPtr data = wx_lc->GetItemData(i);
-              VALUE object = reinterpret_cast<VALUE> (data);
-              if ( object && object != Qnil ) 
+              int count = wx_lc->GetItemCount();
+              if ( count == 0 ) return;
+              
+              for (int i = 0; i < count; ++i)
               {
-                rb_gc_mark(object);
+                wxUIntPtr data = wx_lc->GetItemData(i);
+                VALUE object = reinterpret_cast<VALUE> (data);
+                if ( object && object != Qnil ) 
+                {
+                  rb_gc_mark(object);
+                }
               }
-            }
+            } 
           }
           __HEREDOC
         spec.add_extend_code 'wxListCtrl', <<~__HEREDOC

data/rakelib/lib/director/locale.rb

@@ -29,6 +29,8 @@ module WXRuby3
           wxLanguageInfo::LayoutDirection
           ]
         spec.ignore_unless('WXMSW', 'wxLanguageInfo::WinLang', 'wxLanguageInfo::WinSublang')
+        # implemented in Ruby
+        spec.ignore 'wxLocale::GetSystemEncodingName'
       end
     end # class Locale
 

data/rakelib/lib/director/num_validator.rb

@@ -370,6 +370,13 @@ module WXRuby3
         spec.new_object 'WXIntegerValidator::Clone',
                         'WXUnsignedValidator::Clone',
                         'WXFloatValidator::Clone'
+        %w[WXIntegerValidator WXUnsignedValidator WXFloatValidator].each do |klass|
+          spec.no_proxy "#{klass}::ProcessEvent"
+          spec.no_proxy "#{klass}::QueueEvent"
+          spec.no_proxy "#{klass}::AddPendingEvent"
+          spec.no_proxy "#{klass}::SetNextHandler"
+          spec.no_proxy "#{klass}::SetPreviousHandler"
+        end
         spec.suppress_warning(473,
                               'WXIntegerValidator::Clone',
                               'WXUnsignedValidator::Clone',

data/rakelib/lib/director/print_data.rb

@@ -12,6 +12,8 @@ module WXRuby3
 
     class PrintData < Director
 
+      include Typemap::PrintPageRange
+
       def setup
         super
         spec.gc_as_untracked
@@ -21,6 +23,11 @@ module WXRuby3
         # only keep the const version
         spec.ignore 'wxPageSetupDialogData::GetPrintData'
         spec.regard 'wxPageSetupDialogData::GetPrintData() const'
+        if Config.instance.wx_version >= '3.3.0'
+          # new since 3.3.0
+          spec.items << 'wxPrintPageRange'
+          spec.regard 'wxPrintPageRange::fromPage', 'wxPrintPageRange::toPage' # include public attributes
+        end
         # for GetPrintData methods
         spec.map 'wxPrintData&' => 'Wx::PrintData' do
           map_out code: '$result = SWIG_NewPointerObj(SWIG_as_voidptr(new wxPrintData(*$1)), SWIGTYPE_p_wxPrintData, SWIG_POINTER_OWN);'

data/rakelib/lib/director/printer.rb

@@ -12,6 +12,8 @@ module WXRuby3
 
     class Printer < Director
 
+      include Typemap::PrintPageRange
+
       def setup
         super
         spec.items << 'wxPrintout' << 'wxPrintPreview'

data/rakelib/lib/director/richtext_printing.rb

@@ -12,6 +12,8 @@ module WXRuby3
 
     class RichTextPrinting < Director
 
+      include Typemap::PrintPageRange
+
       def setup
         spec.items << 'wxRichTextPrintout'
         super

data/rakelib/lib/director/splitter_window.rb

@@ -20,9 +20,26 @@ module WXRuby3
         # is missing from the XML docs
         spec.extend_interface('wxSplitterWindow', 'virtual void OnInternalIdle()')
         super
+        # fix naming mismatch with #evt_splitter_dclick
+        spec.add_swig_code '%constant int EVT_SPLITTER_DCLICK = wxEVT_SPLITTER_DOUBLECLICKED;'
       end
+
+      def doc_generator
+        SplitterWindowDocGenerator.new(self)
+      end
+
     end # class SplitterWindow
 
   end # class Director
 
+  class SplitterWindowDocGenerator < DocGenerator
+
+    protected def gen_constants_doc(fdoc)
+      super
+      xref_table = package.all_modules.reduce(DocGenerator.constants_db) { |db, mod| db[mod] }
+      gen_constant_doc(fdoc, 'EVT_SPLITTER_DCLICK', xref_table['EVT_SPLITTER_DOUBLECLICKED'], 'wxRuby specific alias for Wx::EVT_SPLITTER_DOUBLECLICKED')
+    end
+
+  end
+
 end # module WXRuby3

data/rakelib/lib/director/textctrl.rb

@@ -24,11 +24,28 @@ module WXRuby3
           spec.ignore 'wxTextCtrl::GTKGetTextBuffer',
                       'wxTextCtrl::GTKGetEditable'
         end
-        if Config.instance.wx_version >= '3.3.0' && Config.instance.wx_port == :wxmsw
+        if Config.instance.wx_version >= '3.3.0'
           spec.items << 'wxTextSearch' << 'wxTextSearchResult'
-          spec.regard 'wxTextSearchResult::m_start', 'wxTextSearchResult::m_end'
-          spec.make_readonly 'wxTextSearchResult::m_start', 'wxTextSearchResult::m_end'
-          spec.rename_for_ruby 'start' => 'wxTextSearchResult::m_start',
+          spec.regard 'wxTextSearch::m_searchValue',
+                      'wxTextSearch::m_startingPosition',
+                      'wxTextSearch::m_matchCase',
+                      'wxTextSearch::m_wholeWord',
+                      'wxTextSearch::m_direction',
+                      'wxTextSearchResult::m_start',
+                      'wxTextSearchResult::m_end'
+          spec.make_readonly 'wxTextSearch::m_searchValue',
+                             'wxTextSearch::m_startingPosition',
+                             'wxTextSearch::m_matchCase',
+                             'wxTextSearch::m_wholeWord',
+                             'wxTextSearch::m_direction',
+                             'wxTextSearchResult::m_start',
+                             'wxTextSearchResult::m_end'
+          spec.rename_for_ruby 'get_search_value' => 'wxTextSearch::m_searchValue',
+                               'get_starting_position' => 'wxTextSearch::m_startingPosition',
+                               'match_case?' => 'wxTextSearch::m_matchCase',
+                               'whole_word?' => 'wxTextSearch::m_wholeWord',
+                               'get_direction' => 'wxTextSearch::m_direction',
+                               'start' => 'wxTextSearchResult::m_start',
                                'end' => 'wxTextSearchResult::m_end'
         end
         if Config.instance.wx_port == :wxqt

data/rakelib/lib/director/tip_window.rb

@@ -0,0 +1,34 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+
+###
+# wxRuby3 wxWidgets interface director
+###
+
+require_relative './window'
+
+module WXRuby3
+
+  class Director
+
+    class TipWindow < Window
+
+      def setup
+        super
+        spec.disable_proxies
+        spec.ignore 'wxTipWindow::SetTipWindowPtr'
+        spec.ignore 'wxTipWindow::wxTipWindow'
+        spec.add_extend_code 'wxTipWindow', <<~__HEREDOC
+          wxTipWindow(wxWindow* parent, const wxString& text, wxCoord maxLength = 100)
+          {
+            return new wxTipWindow(parent, text, maxLength);
+          }   
+          __HEREDOC
+      end
+
+    end
+
+  end
+
+end

data/rakelib/lib/director/window.rb

@@ -66,7 +66,6 @@ module WXRuby3
             __CODE
           end
           spec.ignore [
-            'wxWindow::PopEventHandler',
             'wxWindow::SetConstraints',
             'wxWindow::GetHandle',
             'wxWindow::GetSize(int *,int *) const', # no need; prefer the wxSize version
@@ -83,6 +82,15 @@ module WXRuby3
             'wxWindow::Raise',
             'wxWindow::Lower'
           ]
+
+          # Event handler chaining methods; pushed handlers always remain owned by Ruby
+          # wxRuby3 will automatically pop any remaining handlers when windows get deleted
+          # also ignore this
+          spec.ignore 'wxWindow::PopEventHandler', ignore_doc: false
+          # and instead add an argument-less version (will use default argument of C++ impl)
+          # as we do want C++ side to delete any popped handler
+          spec.extend_interface 'wxWindow', 'wxEvtHandler *PopEventHandler()'
+
           # no real docs and can't find actual examples of usage; ignore
           spec.ignore 'wxWindow::GetConstraints', 'wxWindow::SetConstraints'
           # redefine these so a nil parent is accepted

data/rakelib/lib/director.rb

@@ -6,7 +6,6 @@
 # wxRuby3 interface Director class
 ###
 
-require 'ostruct'
 require 'set'
 require 'pathname'
 require 'tempfile'

data/rakelib/lib/generate/doc/evt_handler.yaml

@@ -6,23 +6,42 @@
         - :pattern: !ruby/regexp /.*/
           :replace: ''
     :post:
-      - :pattern: !ruby/regexp /This\s+implies\s+that\s+the\s+event\s+should\s+be\s+allocated\s+on\s+the\s+heap\s+and/
-        :subst: 'This implies'
-      - :pattern: !ruby/regexp /\{Wx::EvtHandler#queue_event\}.*For\s+example:/
+      - :pattern: !ruby/regexp /\,\s+i\.e\.\s+it\s+will\s+delete\s+it\s+itself/
         :subst: ''
-      - :pattern: !ruby/regexp /Note.*problem:/
+      - :pattern: !ruby/regexp /This\s+implies\s+that\s+the\s+event\s+should\s+be\s+allocated.*deleted\s+at\s+any\s+moment\)/
+        :subst: "This implies that the event (or any of it's member objects) should not be used/changed after the function returns (as it can be handled and subsequently discarded at any moment)"
+      - :pattern: !ruby/regexp /\{Wx::EvtHandler#queue_event\}.*not\s+used\s+by\s+the\s+calling\s+thread\s+any\s+more\./
+        :subst: ''
+      - :pattern: !ruby/regexp /Care\s+should\s+still\s+be\s+taken\s+to\s+avoid\s+that\s+some\s+fields.*/
+        :subst: ''
+      - :pattern: !ruby/regexp /Example:/
+        :subst: ''
+      - :pattern: !ruby/regexp /Note\s+that\s+if\s+you\s+want\s+to\s+pass\s+more\s+data.*/
+        :subst: ''
+      - :pattern: !ruby/regexp /Reimplemented\s+in.*/
+        :subst: ''
+:wxEvtHandler.AddPendingEvent:
+  :detail:
+    :post:
+      - :pattern: !ruby/regexp /This\s+function\s+is\s+similar\s+to\s+\{Wx::EvtHandler#queue_event\}.*/
+        :subst: 'This function is similar to {Wx::EvtHandler#queue_event}.'
+      - :pattern: !ruby/regexp /A\s+copy\s+of\s+event\s+is\s+made\s+by\s+the\s+function,.*/
+        :subst: 'Other than {Wx::EvtHandler#queue_event} this method creates a (shallow) copy of event before queueing the copied event. In case (user defined) event classes require deep copying of Ruby member object these classes should override the #initialize_clone method (**NOT** #clone as wxRuby3 does not currently support overriding event class #clone methods).'
+      - :pattern: !ruby/regexp /Reimplemented\s+in.*/
         :subst: ''
 :wxEvtHandler.SetNextHandler:
+  :brief:
+    :post:
+      - :pattern: !ruby/regexp /Sets\s+the\s+pointer\s+to\s+the\s+next\s+handler\./
+        :subst: 'Inserts the given handler as the next handler in the chain.'
   :detail:
     :pre:
-      :programlisting:
-        - :pattern: !ruby/regexp /.*/
-          :replace: |
-            
-            ```ruby
-              handlerA.set_next_handler(handlerB)
-              handlerB.set_previous_handler(handlerA)
-            ```
+      :para:
+        - :pattern: !ruby/regexp /See.*ProcessEvent\(\)/
+          :replace:  |
+            In wxRuby this fully handles double linking, i.e. wxRuby will take care of pointing the handler given
+            back to this handler as well. There is no need to call set_previous_handler so this method is not supported 
+            in wxRuby3.
 :wxEvtHandler.TryBefore:
   :detail:
     :pre:

data/rakelib/lib/specs/interfaces.rb

@@ -8,6 +8,14 @@
 
 module WXRuby3
 
+  Director::Package.ignored_event_handlers.merge(%w[
+    EVT_SCROLL
+    EVT_COMMAND_SCROLL
+    EVT_SCROLLWIN
+    EVT_MOUSE_EVENTS
+    EVT_JOYSTICK_EVENTS
+  ])
+
   Director.Package('Wx') { |pkg|
     Director.Spec(pkg, 'wxDefs')
     Director.Spec(pkg, 'wxFunctions')
@@ -201,6 +209,7 @@ module WXRuby3
     Director.Spec(pkg, 'wxDragDrop', requirements: %w[USE_DRAG_AND_DROP])
     Director.Spec(pkg, 'wxContextHelpButton', requirements: %w[USE_HELP])
     Director.Spec(pkg, 'wxHelpProvider', requirements: %w[USE_HELP])
+    Director.Spec(pkg, 'wxTipWindow', requirements: %w[USE_HELP])
     Director.Spec(pkg, 'wxHelpController', requirements: %w[USE_HELP])
     Director.Spec(pkg, 'wxExtHelpController', director: Director::HelpController, requirements: %w[USE_HELP])
     Director.Spec(pkg, 'wxTaskBarIconEvent', director: Director::Event, requirements: %w[USE_TASKBARICON])