wxruby3 1.6.0 → 1.7.0

data/rakelib/lib/director/property_grid_manager.rb

@@ -19,6 +19,57 @@ module WXRuby3
       def setup
         super
         spec.override_inheritance_chain('wxPropertyGridManager', %w[wxPanel wxWindow wxEvtHandler wxObject])
+        # need a custom implementation to handle cleaning up tracked objects
+        spec.add_header_code <<~__HEREDOC
+          WXRUBY_EXPORT void GC_SetWindowDeleted(void *ptr);
+
+          class WXRubyPropertyGridManager : public wxPropertyGridManager
+          {
+          public:
+            WXRubyPropertyGridManager() : wxPropertyGridManager() {}
+            WXRubyPropertyGridManager( wxWindow *parent, wxWindowID id = wxID_ANY,
+                           const wxPoint& pos = wxDefaultPosition,
+                           const wxSize& size = wxDefaultSize,
+                           long style = wxPGMAN_DEFAULT_STYLE,
+                           const wxString& name = wxASCII_STR(wxPropertyGridManagerNameStr) )
+              : wxPropertyGridManager(parent, id, pos, size, style, name) {}
+
+            virtual ~WXRubyPropertyGridManager() 
+            {
+              // as the grid will not be deleted by calling Destroy() but
+              // rather by deleting directly handle GC cleanup here 
+              GC_SetWindowDeleted(m_pPropGrid);
+              // also cleanup all page and property instances that will
+              // be deleted by wxPropertyGridManager
+              for( wxPropertyGridPage* page : m_arrPages )
+              {
+                // clean up tracking of all tracked properties
+                wxPGProperty* wx_p = page->GetRoot();
+                if (!NIL_P(SWIG_RubyInstanceFor(wx_p)))
+                {
+                  SWIG_RubyUnlinkObjects(wx_p);
+                  SWIG_RubyRemoveTracking(wx_p);
+                }
+                wxPGVIterator it =
+                    page->GetVIterator(wxPG_ITERATOR_FLAGS_ALL | wxPG_IT_CHILDREN(wxPG_ITERATOR_FLAGS_ALL));
+                // iterate all
+                for ( ; !it.AtEnd(); it.Next() )
+                {
+                  wx_p = it.GetProperty();
+                  if (!RB_NIL_P(SWIG_RubyInstanceFor(wx_p))) 
+                  { 
+                    SWIG_RubyUnlinkObjects(wx_p);
+                    SWIG_RubyRemoveTracking(wx_p);
+                  }
+                }
+                // Disassociate the C++ and Ruby pages (if any association)
+                SWIG_RubyUnlinkObjects(page);
+                SWIG_RubyRemoveTracking(page);
+              }
+            }               
+          };
+          __HEREDOC
+        spec.use_class_implementation 'wxPropertyGridManager', 'WXRubyPropertyGridManager'
         spec.add_swig_code 'typedef const wxPGPropArgCls& wxPGPropArg;'
         # mixin PropertyGridInterface
         spec.include_mixin 'wxPropertyGridManager', 'Wx::PG::PropertyGridInterface'
@@ -29,12 +80,28 @@ module WXRuby3
         spec.ignore 'wxPropertyGridManager::GetVIterator'
         # customize mark function
         spec.add_header_code <<~__HEREDOC
+          WXRUBY_TRACE_GUARD(WxRubyTraceMarkPropGridMgr, "GC_MARK_PROPGRID_MGR")
+
+          static bool __wxr_In_GC_mark_wxPropertyGridManager = false;
+
+          extern void WXRuby_Set_In_GC_mark_wxPropertyGridManager(bool f)
+          {
+            __wxr_In_GC_mark_wxPropertyGridManager = f;
+          }
+
+          extern bool WXRuby_Is_In_GC_mark_wxPropertyGridManager()
+          {
+            return __wxr_In_GC_mark_wxPropertyGridManager;
+          }
+
+          extern void WXRuby_GC_mark_wxPropertyGridPage(wxPropertyGridPage* wx_pgp);
+
           static void GC_mark_wxPropertyGridManager(void* ptr) 
           {
-          #ifdef __WXRB_DEBUG__
-            if (wxRuby_TraceLevel()>1)
-              std::wcout << "> GC_mark_wxPropertyGridManager : " << ptr << std::endl;
-          #endif
+            WXRUBY_TRACE_IF(WxRubyTraceMarkPropGridMgr, 2)
+              WXRUBY_TRACE("> GC_mark_wxPropertyGridManager : " << ptr)
+            WXRUBY_TRACE_END
+
             if ( GC_IsWindowDeleted(ptr) )
             {
               return;
@@ -42,46 +109,39 @@ module WXRuby3
             // Do standard marking routines as for all wxWindows
             GC_mark_wxWindow(ptr);
             
-            wxPropertyGridManager* wx_pg = (wxPropertyGridManager*) ptr;
+            WXRuby_Set_In_GC_mark_wxPropertyGridManager(true);
+
+            wxPropertyGridManager* wx_pgm = (wxPropertyGridManager*) ptr;
 
-            // mark all properties of all pages
-          #ifdef __WXRB_DEBUG__
-            long l = 0;
-          #endif
-            for (size_t i=0; i < wx_pg->GetPageCount() ;++i)
+            // mark the property grid
+            wxPropertyGrid* wx_pg = wx_pgm->GetGrid();
+            VALUE rb_pg = SWIG_RubyInstanceFor(wx_pg);
+            if (!NIL_P(rb_pg))
             {
-              wxPGVIterator it =
-                  wx_pg->GetPage(i)->GetVIterator(wxPG_ITERATOR_FLAGS_ALL | wxPG_IT_CHILDREN(wxPG_ITERATOR_FLAGS_ALL));
-              // iterate all
-              for ( ; !it.AtEnd(); it.Next() )
+              rb_gc_mark(rb_pg);   
+            }
+
+            // mark all properties of all pages 
+            for (size_t i=0; i < wx_pgm->GetPageCount() ;++i)
+            {
+              wxPropertyGridPage* wx_pgp = wx_pgm->GetPage(i);
+              // check if this page is wrapped in Ruby
+              VALUE rb_pgp = SWIG_RubyInstanceFor(wx_pgp);
+              if (NIL_P(rb_pgp))    // if not just iterate and mark it's properties
               {
-          #ifdef __WXRB_DEBUG__
-                ++l;
-          #endif
-                wxPGProperty* p = it.GetProperty();
-                VALUE rb_p = SWIG_RubyInstanceFor(p);
-                if (NIL_P(rb_p))
-                {
-                  VALUE object = (VALUE) p->GetClientData();
-                  if ( object && !NIL_P(object))
-                  {
-          #ifdef __WXRB_DEBUG__
-                    if (wxRuby_TraceLevel()>2)
-                      std::wcout << "*** marking property data " << p << ":" << p->GetName() << std::endl;
-          #endif
-                    rb_gc_mark(object);
-                  }
-                }
-                else
-                {
-                  rb_gc_mark(rb_p);
-                }
+                WXRuby_GC_mark_wxPropertyGridPage(wx_pgp);
+              }
+              else  // but a tracked Ruby page instance we can simply mark and it will mark it's properties itself 
+              {
+                rb_gc_mark(rb_pgp);
               }
             }
-          #ifdef __WXRB_DEBUG__
-            if (wxRuby_TraceLevel()>1)
-              std::wcout << "*** iterated " << l << " properties" << std::endl;
-          #endif
+
+            WXRuby_Set_In_GC_mark_wxPropertyGridManager(false);
+
+            WXRUBY_TRACE_IF(WxRubyTraceMarkPropGridMgr, 2)
+              WXRUBY_TRACE(" GC_mark_wxPropertyGridManager : " << ptr)
+            WXRUBY_TRACE_END
           }
         __HEREDOC
         spec.add_swig_code '%markfunc wxPropertyGridManager "GC_mark_wxPropertyGridManager";'

data/rakelib/lib/director/property_grid_page.rb

@@ -71,6 +71,66 @@ module WXRuby3
           map_in ignore: true, code: '$1= true;'
         end
         spec.suppress_warning(473, 'wxPropertyGridPage::DoInsert')
+        # customize mark function
+        spec.add_header_code <<~__HEREDOC
+          WXRUBY_TRACE_GUARD(WxRubyTraceGCMarkPropGridPage, "GC_MARK_PROPGRID_PAGE")
+
+          extern void WXRuby_GC_mark_wxPropertyGridPage(wxPropertyGridPage* wx_pgp)
+          {
+            WXRUBY_TRACE_IF(WxRubyTraceGCMarkPropGridPage, 2)
+              WXRUBY_TRACE("> WXRuby_GC_mark_wxPropertyGridPage : " << wx_pgp)
+            WXRUBY_TRACE_END
+            
+          #ifdef __WXRB_DEBUG__
+            long l = 0, n = 0;
+          #endif
+            VALUE rb_root_prop = SWIG_RubyInstanceFor(wx_pgp->GetRoot());
+            if (!NIL_P(rb_root_prop))
+            {
+              rb_gc_mark(rb_root_prop);
+          #ifdef __WXRB_DEBUG__
+              ++n;
+          #endif
+            }
+            // mark all properties
+            wxPGVIterator it =
+                wx_pgp->GetVIterator(wxPG_ITERATOR_FLAGS_ALL | wxPG_IT_CHILDREN(wxPG_ITERATOR_FLAGS_ALL));
+            // iterate all
+            for ( ; !it.AtEnd(); it.Next() )
+            {
+          #ifdef __WXRB_DEBUG__
+              ++l;
+          #endif
+              wxPGProperty* wx_p = it.GetProperty();
+              VALUE rb_prop = SWIG_RubyInstanceFor(wx_p);
+              if (!RB_NIL_P(rb_prop)) 
+              { 
+                rb_gc_mark(rb_prop);
+          #ifdef __WXRB_DEBUG__
+                ++n;
+          #endif
+              }
+            }
+
+            WXRUBY_TRACE_IF(WxRubyTraceGCMarkPropGridPage, 2)
+              WXRUBY_TRACE("< WXRuby_GC_mark_wxPropertyGridPage: iterated " << l << " properties; marked " << n)
+            WXRUBY_TRACE_END
+          } 
+
+          static void GC_mark_wxPropertyGridPage(void* ptr) 
+          {
+            WXRUBY_TRACE_IF(WxRubyTraceGCMarkPropGridPage, 2)
+              WXRUBY_TRACE("> GC_mark_wxPropertyGridPage : " << ptr)
+            WXRUBY_TRACE_END
+            
+            WXRuby_GC_mark_wxPropertyGridPage((wxPropertyGridPage*) ptr);
+
+            WXRUBY_TRACE_IF(WxRubyTraceGCMarkPropGridPage, 2)
+              WXRUBY_TRACE("< GC_mark_wxPropertyGridPage : " << ptr)
+            WXRUBY_TRACE_END
+          }
+          __HEREDOC
+        spec.add_swig_code '%markfunc wxPropertyGridPage "GC_mark_wxPropertyGridPage";'
       end
     end # class PropertyGridPage
 

data/rakelib/lib/director/rich_tooltip.rb

@@ -0,0 +1,22 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+
+###
+# wxRuby3 wxWidgets interface director
+###
+
+module WXRuby3
+
+  class Director
+
+    class RichToolTip < Director
+
+      def setup
+        super
+      end
+    end # class RichToolTip
+
+  end # class Director
+
+end # module WXRuby3

data/rakelib/lib/director/richtext_ctrl.rb

@@ -101,9 +101,14 @@ module WXRuby3
           wxRichTextCtrl::KeyboardNavigate
           wxRichTextCtrl::PositionToXY
           wxRichTextCtrl::XYToPosition
+          wxRichTextCtrl::PrepareContextMenu
           ]
         # this method contains worrisome code and is unclearly documented so I doubt it's usefulness
         spec.ignore 'wxRichTextCtrl::FindContainerAtPoint'
+        # redefine for GC specs
+        spec.ignore 'wxRichTextCtrl::SetContextMenu', ignore_doc: false
+        spec.extend_interface 'wxRichTextCtrl', 'void SetContextMenu(wxMenu *new_context_menu)'
+        spec.disown 'wxMenu *new_context_menu'
         # do not think having these proxied is going to bring much for wxRuby and suppressing them
         # prevents code bloat
         spec.no_proxy %w[

data/rakelib/lib/director/richtext_object.rb

@@ -48,17 +48,26 @@ module WXRuby3
                                'wxRichTextSelection',
                                'wxRichTextProperties'
           spec.add_header_code <<~__HEREDOC
+            WXRUBY_TRACE_GUARD(WxRubyTraceFreeRichTextObject, "GC_FREE_RTOBJECT")
+
             extern void GC_RichTextObjectFreeFunc(void* ptr)
             {
+              WXRUBY_TRACE_IF(WxRubyTraceFreeRichTextObject, 2)
+                WXRUBY_TRACE("> GC_RichTextObjectFreeFunc : " << ptr)
+              WXRUBY_TRACE_END
+
               SWIG_RubyRemoveTracking(ptr);
               if (ptr)
               {
-            #ifdef __WXRB_DEBUG__
-                if (wxRuby_TraceLevel()>1)
-                  std::wcout << "GC_RichTextObjectFreeFunc(" << ptr << ")" << std::endl;
-            #endif
+                WXRUBY_TRACE_IF(WxRubyTraceFreeRichTextObject, 3)
+                  WXRUBY_TRACE("| GC_RichTextObjectFreeFunc : dereferencing")
+                WXRUBY_TRACE_END
                 ((wxRichTextObject*)ptr)->Dereference();            
               } 
+
+              WXRUBY_TRACE_IF(WxRubyTraceFreeRichTextObject, 2)
+                WXRUBY_TRACE("< GC_RichTextObjectFreeFunc : " << ptr)
+              WXRUBY_TRACE_END
             }
             __HEREDOC
           spec.make_abstract 'wxRichTextObject'

data/rakelib/lib/director/richtext_style_listbox.rb

@@ -20,9 +20,16 @@ module WXRuby3
       def setup
         super
         spec.items << 'wxRichTextStyleListCtrl' << 'wxRichTextStyleComboCtrl'
+        spec.gc_as_window('wxRichTextStyleListBox')
         spec.include 'wx/odcombo.h'
         spec.add_header_code 'extern VALUE wxRuby_RichTextStyleDefinition2Ruby(const wxRichTextStyleDefinition *wx_rtsd, int own);'
-        spec.override_inheritance_chain('wxRichTextStyleListBox', ['wxHtmlListBox', 'wxVListBox', { 'wxVScrolledWindow' => 'wxHVScrolledWindow' }, 'wxPanel', 'wxWindow', 'wxEvtHandler', 'wxObject'])
+        if Config.instance.wx_version_check('3.3.1') > 0
+          spec.override_inheritance_chain('wxRichTextStyleListBox', ['wxHtmlListBox', 'wxVListBox', 'wxVScrolledCanvas', 'wxWindow', 'wxEvtHandler', 'wxObject'])
+        elsif Config.instance.wx_version_check('3.3.0') > 0
+          spec.override_inheritance_chain('wxRichTextStyleListBox', ['wxHtmlListBox', 'wxVListBox', 'wxVScrolledWindow', 'wxPanel', 'wxWindow', 'wxEvtHandler', 'wxObject'])
+        else
+          spec.override_inheritance_chain('wxRichTextStyleListBox', ['wxHtmlListBox', 'wxVListBox', { 'wxVScrolledWindow' => 'wxHScrolledWindow' }, 'wxPanel', 'wxWindow', 'wxEvtHandler', 'wxObject'])
+        end
         spec.override_inheritance_chain('wxRichTextStyleComboCtrl',
                                         %w[wxComboCtrl
                                            wxControl
@@ -33,7 +40,9 @@ module WXRuby3
         spec.extend_interface 'wxRichTextStyleComboCtrl',
                               'virtual void DoSetPopupControl(wxComboPopup* popup)',
                               visibility: 'protected'
-        spec.no_proxy 'wxVListBox::OnGetRowHeight'
+        # optimize; no need for these virtuals here
+        spec.no_proxy 'wxRichTextStyleListBox::OnGetRowHeight',
+                      'wxRichTextStyleListBox::OnGetRowsHeightHint'
       end
 
     end

data/rakelib/lib/director/scrolled_t.rb

@@ -61,6 +61,9 @@ module WXRuby3
         end
         spec.ignore 'wxScrolled::OnDraw'
         spec.ignore 'wxScrolled::GetViewStart(int *,int *)'
+        if Config.instance.wx_version_check('3.3.2') >= 0
+          spec.ignore 'wxScrolled::GetViewStartPixels(int *,int *) const'
+        end
         spec.map_apply 'int * OUTPUT' => 'int *'
       end
 

data/rakelib/lib/director/searchctrl.rb

@@ -20,6 +20,7 @@ module WXRuby3
         spec.include_mixin 'wxSearchCtrl', { 'Wx::TextEntry' => 'wxTextEntryBase' }
         spec.suppress_warning(473, 'wxSearchCtrl::GetMenu')
         spec.override_inheritance_chain('wxSearchCtrl', %w[wxControl wxWindow wxEvtHandler wxObject])
+        spec.disown 'wxMenu *'
       end
     end # class SearchCtrl
 

data/rakelib/lib/director/task_bar_icon.rb

@@ -35,25 +35,31 @@ module WXRuby3
         # this one is protected so ignored by default but we want it here
         # (we do not want GetPopupMenu available for override in Ruby)
         spec.regard %w[wxTaskBarIcon::CreatePopupMenu]
-        # This is used for CreatePopupMenu, a virtual method which is
-        # overridden in user subclasses of TaskBarIcon to create the menu over
-        # the icon.
-        #
-        # The Wx::Menu needs to be protected from GC so the typemap stores the
+        if Config.instance.wx_version_check('3.1.5') >= 0
+          spec.regard %w[wxTaskBarIcon::GetPopupMenu]
+        end
+        # This is used for CreatePopupMenu and possibly GetPopupMenu, virtual methods which can be
+        # overridden in user subclasses of TaskBarIcon to provide the menu over the icon.
+        # In the case of GetPopupMenu the menu will be used but not deleted so it can be stored in
+        # a member variable and reused.
+        # In the case of CreatePopupMenu the menu is disowned and deleted of use. The Wx::Menu Ruby
+        # instance than needs to be protected from GC so the typemap stores the
         # object returned by the ruby method in an instance variable so it's
         # marked. It also handles the special case where +nil+ is returned, to
         # signal to Wx that no menu is to be shown.
         spec.map 'wxMenu *' do
           map_directorout code: <<~__CODE
-            rb_iv_set(swig_get_self(), "@__popmenu__", $1);
+            static const std::string create_popup_menu("CreatePopupMenu");
+            bool disown = (std::string("$symname") == create_popup_menu);
+            if (disown) rb_iv_set(swig_get_self(), "@__popmenu__", $1);
             if (NIL_P($1))
             {
-              $result = NULL;
+              $result = nullptr;
             }
             else
             {
               void * ptr;
-              int swig_res = SWIG_ConvertPtr(result, &ptr, $1_descriptor, 0 | SWIG_POINTER_DISOWN);
+              int swig_res = SWIG_ConvertPtr(result, &ptr, $1_descriptor, disown ? SWIG_POINTER_DISOWN : 0);
               if (!SWIG_IsOK(swig_res))
               {
                 Swig::DirectorTypeMismatchException::raise(swig_get_self(), "$symname", rb_eTypeError,

data/rakelib/lib/director/text_validator.rb

@@ -32,7 +32,16 @@ module WXRuby3
             }
             virtual ~WXRubyTextValidator() 
             {
+              // All Validators are EvtHandlers, so prevent any pending events being
+              // sent after destruction (otherwise ObjectPreviouslyDeleted errors result)
+              this->SetEvtHandlerEnabled(false);
               wxRuby_ReleaseEvtHandlerProcs(this);
+              // Disassociate the C++ and Ruby objects if not done by Ruby free method
+              if (!NIL_P(SWIG_RubyInstanceFor(this)))
+              {
+                SWIG_RubyUnlinkObjects(this);
+                SWIG_RubyRemoveTracking(this);
+              }
             }
 
             virtual wxObject* Clone() const override

data/rakelib/lib/director/tip_window.rb

@@ -19,12 +19,123 @@ module WXRuby3
         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
+        if Config.instance.wx_version_check('3.3.2') >= 0
+          spec.ignore 'wxTipWindow::Create'
+          # need to re-implement this
+          spec.ignore 'wxTipWindow::New', ignore_doc: false
+          # Rubified version
+          spec.add_extend_code 'wxTipWindow', <<~__HEREDOC
+            static VALUE New(wxWindow* parent, const wxString& text, wxCoord maxLength = 100, wxRect* rectBounds = nullptr)
+            {
+                wxTipWindow::Ref tipRef = wxTipWindow::New(parent, text, maxLength, rectBounds);   
+
+                return SWIG_NewPointerObj((new wxTipWindow::Ref(std::move(tipRef))), SWIGTYPE_p_wxTipWindow__Ref, SWIG_POINTER_OWN |  0 );
+            }
+            __HEREDOC
+          # add Ruby-style methods
+          spec.add_extend_code 'wxTipWindow::Ref', <<~__HEREDOC
+            VALUE is_ok()
+            {
+                return *$self ? Qtrue : Qfalse;
+            }
+ 
+            wxTipWindow* get_tip_window()
+            {
+                return $self->Ref::operator->();
+            }
+            __HEREDOC
+          # and aliases
+          spec.add_swig_code '%alias wxTipWindow::Ref::is_ok "ok?";'
+          spec.add_swig_code '%alias wxTipWindow::Ref::get_tip_window "tip_window";'
+          spec.rename_for_ruby 'TipWindow_Ref' => 'wxTipWindow::Ref'
+          spec.rename_for_ruby 'new_tip' => 'wxTipWindow::New'
+        else
+          spec.make_abstract 'wxTipWindow'
+          # provide custom wxRuby reference class
+          spec.add_header_code <<~__HEREDOC
+            class WXTipWindow_Ref
+            {
+              public:
+                WXTipWindow_Ref() {}
+                WXTipWindow_Ref& operator=(WXTipWindow_Ref&& o)
+                {
+                    if (_ptr != o._ptr)
+                    {
+                        if (_ptr)
+                        {
+                            _ptr->SetTipWindowPtr(nullptr);
+                        }
+                
+                        _ptr = o._ptr;
+                        if (_ptr)
+                        {
+                            o._ptr = nullptr;
+                            _ptr->SetTipWindowPtr(&_ptr);
+                        }
+                    }
+                    return *this;
+                }
+
+                bool is_ok()
+                {
+                    return _ptr ? true : false;
+                }
+     
+                wxTipWindow* get_tip_window()
+                {
+                    return _ptr;
+                }
+
+                wxTipWindow* _ptr = {};  
+            };
+            __HEREDOC
+          spec.add_swig_code <<~__HEREDOC
+            %alias WXTipWindow_Ref::is_ok "ok?";
+            %alias WXTipWindow_Ref::get_tip_window "tip_window";
+
+            class WXTipWindow_Ref
+            {
+              private:
+                WXTipWindow_Ref();
+
+              public:
+                bool is_ok();
+     
+                wxTipWindow* get_tip_window();
+            };
+            __HEREDOC
+          # add constructor method
+          spec.add_extend_code 'wxTipWindow', <<~__HEREDOC
+            static VALUE New_Tip(wxWindow* parent, const wxString& text, wxCoord maxLength = 100, wxRect* rectBounds = nullptr)
+            {
+                std::unique_ptr<WXTipWindow_Ref> retval(new WXTipWindow_Ref);
+                std::unique_ptr<wxTipWindow> temp(new wxTipWindow(parent, text, maxLength, &retval->_ptr, rectBounds));
+                retval->_ptr = temp.release();
+            
+                return SWIG_NewPointerObj(retval.release(), SWIGTYPE_p_WXTipWindow_Ref, SWIG_POINTER_OWN |  0 );
+            }
+            __HEREDOC
+        end
+      end
+
+      def doc_generator
+        TipWindowDocGenerator.new(self)
+      end
+
+    end
+
+    class TipWindowDocGenerator < DocGenerator
+
+      def gen_class_doc_members(fdoc, clsdef, cls_members, alias_methods)
+        super
+        fdoc.doc.puts 'Constructs a new TipWindow object which is immediately shown.'
+        fdoc.doc.puts 'Returns a {Wx::TipWindow::Ref}.'
+        fdoc.doc.puts '@param parent [Wx::Window] parent window (not nil).'
+        fdoc.doc.puts '@param text [String] The text to show, may contain the new line characters.'
+        fdoc.doc.puts '@param maxLength [Integer] The length of each line, in pixels. Set to a very large value to avoid wrapping lines.'
+        fdoc.doc.puts '@param rectBounds [Wx::Rect] If given, passed to {Wx::TipWindow#set_bounding_rect}, please see its documentation for the description of this parameter.'
+        fdoc.doc.puts '@return [Wx::TipWindow::Ref] weak tip window reference'
+        fdoc.puts 'def self.new_tip(parent, text, maxLength = 100, rectBounds = nil) end'
       end
 
     end

data/rakelib/lib/director/tool_bar.rb

@@ -33,6 +33,8 @@ module WXRuby3
           wxToolBarToolBase::Attach
           ]
         spec.no_proxy 'wxToolBarToolBase'
+        # for SetDropdownMenu
+        spec.disown 'wxMenu *'
         # more sensible name to use
         spec.rename_for_ruby('ToolBarTool' => 'wxToolBarToolBase')
         spec.map 'wxToolBarBase *' => 'Wx::ToolBar' do
@@ -73,6 +75,10 @@ module WXRuby3
           'wxToolBar::AddTool(wxToolBarToolBase *)',
           'wxToolBar::InsertTool(size_t,wxToolBarToolBase *)'
           ]
+        if Config.instance.features_set?('WXOSX')
+          spec.extend_interface('wxToolBar',
+                                'virtual bool Destroy() override')
+        end
       end
     end # class Object
 

data/rakelib/lib/director/top_level_window.rb

@@ -78,7 +78,6 @@ module WXRuby3
                           "#{spec.class_name(citem)}::Maximize",
                           "#{spec.class_name(citem)}::Navigate",
                           "#{spec.class_name(citem)}::Refresh",
-                          "#{spec.class_name(citem)}::Reparent",
                           "#{spec.class_name(citem)}::RequestUserAttention",
                           "#{spec.class_name(citem)}::Restore",
                           "#{spec.class_name(citem)}::SetIcon",

data/rakelib/lib/director/utils.rb

@@ -37,11 +37,13 @@ module WXRuby3
           wxMicroSleep
           wxMilliSleep
           wxSleep
-          wxUsleep
           wxNow
           wxDecToHex
           wxHexToDec
           ]
+        if Config.instance.wx_version_check('3.3.0') <= 0
+          spec.ignore 'wxUsleep'
+        end
         # ignore these enum(erator)s
         spec.ignore %w[
           wxSignal

data/rakelib/lib/director/validator.rb

@@ -37,7 +37,16 @@ module WXRuby3
             {}
             wxRubyValidator::~wxRubyValidator ()
             {
+              // All Validators are EvtHandlers, so prevent any pending events being
+              // sent after destruction (otherwise ObjectPreviouslyDeleted errors result)
+              this->SetEvtHandlerEnabled(false);
               wxRuby_ReleaseEvtHandlerProcs(this);
+              // Disassociate the C++ and Ruby objects if not done by Ruby free method
+              if (!NIL_P(SWIG_RubyInstanceFor(this)))
+              {
+                SWIG_RubyUnlinkObjects(this);
+                SWIG_RubyRemoveTracking(this);
+              }
             }
 
             wxObject* wxRubyValidator::Clone() const
@@ -147,6 +156,9 @@ module WXRuby3
           spec.add_swig_code '%markfunc wxValidator "GC_mark_wxValidator";'
           # will be provided as a pure Ruby method
           spec.ignore 'wxValidator::Clone', ignore_doc: false
+          # ignore default ctor docs
+          spec.ignore 'wxValidator::wxValidator'
+          spec.regard 'wxValidator::wxValidator', regard_doc: false # only use interface spec, not docs
           # add wxRuby specifics
           spec.extend_interface 'wxValidator',
                                 'wxValidator(const wxValidator& other)'