wxruby3 0.9.4 → 0.9.7

data/rakelib/lib/core/package.rb

@@ -604,55 +604,53 @@ module WXRuby3
       def generate_core_doc
         script = <<~__SCRIPT
           require 'wx'
-          Wx::App.run do 
-            STDOUT.puts \<<~__HEREDOC
-              # ----------------------------------------------------------------------------
-              # This file is automatically generated by the WXRuby3 documentation 
-              # generator. Do not alter this file.
-              # ----------------------------------------------------------------------------
-  
-  
-              module Wx
-              
-                # wxRuby version string
-                Wx::WXRUBY_VERSION = '\#{Wx::WXRUBY_VERSION}'
-              
-                # wxRuby version release type (alpha, beta, rc)
-                Wx::WXRUBY_RELEASE_TYPE = '\#{Wx::WXRUBY_RELEASE_TYPE}'
-                # wxRuby major version number
-                Wx::WXRUBY_MAJOR = \#{Wx::WXRUBY_MAJOR}
-                # wxRuby minor version number
-                Wx::WXRUBY_MINOR = \#{Wx::WXRUBY_MINOR}
-                # wxRuby release number
-                Wx::WXRUBY_RELEASE = \#{Wx::WXRUBY_RELEASE}
-              
-                # Convenience string for WxWidgets version info
-                WXWIDGETS_VERSION = '\#{Wx::WXWIDGETS_VERSION}'
-              
-                # Integer constant reflecting the major version of the wxWidgets release used to build wxRuby
-                WXWIDGETS_MAJOR_VERSION = \#{Wx::WXWIDGETS_MAJOR_VERSION}
-              
-                # Integer constant reflecting the minor version of the wxWidgets release used to build wxRuby
-                WXWIDGETS_MINOR_VERSION = \#{Wx::WXWIDGETS_MINOR_VERSION}
-              
-                # Integer constant reflecting the release number of the wxWidgets release used to build wxRuby
-                WXWIDGETS_RELEASE_NUMBER = \#{Wx::WXWIDGETS_RELEASE_NUMBER}
-              
-                # Integer constant reflecting the sub-release number of the wxWidgets release used to build wxRuby
-                WXWIDGETS_SUBRELEASE_NUMBER = \#{Wx::WXWIDGETS_SUBRELEASE_NUMBER}
-              
-                # Integer constant reflecting the wxWidgets wxDEBUG_LEVEL
-                WXWIDGETS_DEBUG_LEVEL = \#{Wx::WXWIDGETS_DEBUG_LEVEL}
-
-                # Boolean constant indicating if wxRuby was build in debug (true) or release (false) mode
-                DEBUG = \#{Wx::DEBUG}
-              
-                # Platform id of the wxWidgets port used to build wxRuby
-                PLATFORM = '\#{Wx::PLATFORM}'
-              
-              end
-              __HEREDOC
-          end
+          STDOUT.puts \<<~__HEREDOC
+            # ----------------------------------------------------------------------------
+            # This file is automatically generated by the WXRuby3 documentation 
+            # generator. Do not alter this file.
+            # ----------------------------------------------------------------------------
+
+
+            module Wx
+            
+              # wxRuby version string
+              WXRUBY_VERSION = '\#{Wx::WXRUBY_VERSION}'
+            
+              # wxRuby version release type (alpha, beta, rc)
+              WXRUBY_RELEASE_TYPE = '\#{Wx::WXRUBY_RELEASE_TYPE}'
+              # wxRuby major version number
+              WXRUBY_MAJOR = \#{Wx::WXRUBY_MAJOR}
+              # wxRuby minor version number
+              WXRUBY_MINOR = \#{Wx::WXRUBY_MINOR}
+              # wxRuby release number
+              WXRUBY_RELEASE = \#{Wx::WXRUBY_RELEASE}
+            
+              # Convenience string for WxWidgets version info
+              WXWIDGETS_VERSION = '\#{Wx::WXWIDGETS_VERSION}'
+            
+              # Integer constant reflecting the major version of the wxWidgets release used to build wxRuby
+              WXWIDGETS_MAJOR_VERSION = \#{Wx::WXWIDGETS_MAJOR_VERSION}
+            
+              # Integer constant reflecting the minor version of the wxWidgets release used to build wxRuby
+              WXWIDGETS_MINOR_VERSION = \#{Wx::WXWIDGETS_MINOR_VERSION}
+            
+              # Integer constant reflecting the release number of the wxWidgets release used to build wxRuby
+              WXWIDGETS_RELEASE_NUMBER = \#{Wx::WXWIDGETS_RELEASE_NUMBER}
+            
+              # Integer constant reflecting the sub-release number of the wxWidgets release used to build wxRuby
+              WXWIDGETS_SUBRELEASE_NUMBER = \#{Wx::WXWIDGETS_SUBRELEASE_NUMBER}
+            
+              # Integer constant reflecting the wxWidgets wxDEBUG_LEVEL
+              WXWIDGETS_DEBUG_LEVEL = \#{Wx::WXWIDGETS_DEBUG_LEVEL}
+
+              # Boolean constant indicating if wxRuby was build in debug (true) or release (false) mode
+              DEBUG = \#{Wx::DEBUG}
+            
+              # Platform id of the wxWidgets port used to build wxRuby
+              PLATFORM = '\#{Wx::PLATFORM}'
+            
+            end
+            __HEREDOC
           __SCRIPT
         begin
           tmpfile = Tempfile.new('script')

data/rakelib/lib/director/comboctrl.rb

@@ -14,9 +14,10 @@ module WXRuby3
 
     class ComboCtrl < Window
 
+      include Typemap::ComboPopup
+
       def setup
         super
-        spec.items << 'wxComboPopup'
         # mixin TextEntry
         spec.include_mixin 'wxComboCtrl', { 'Wx::TextEntry' => 'wxTextEntryBase' }
         spec.override_inheritance_chain('wxComboCtrl',
@@ -29,8 +30,108 @@ module WXRuby3
           wxComboCtrl::DoSetPopupControl
           wxComboCtrl::DoShowPopup
         ]
-        # turn wxComboPopup into a mixin module
-        spec.make_mixin 'wxComboPopup'
+        spec.add_header_code <<~__HEREDOC
+          #include "wxruby-ComboPopup.h"
+
+          static VALUE g_rb_mWxComboPopup = Qnil;
+          static VALUE g_rb_cComboPopupWx = Qnil;
+
+          WXRUBY_EXPORT wxComboPopup* wxRuby_ComboPopupFromRuby(VALUE popup)
+          {
+            if (!NIL_P(popup) && !rb_obj_is_kind_of(popup, g_rb_mWxComboPopup))
+            {
+              rb_raise(rb_eArgError, "Expected a Wx::ComboPopup or nil for 1");
+              return nullptr;
+            }
+
+            wxComboPopup* cpp = nullptr; 
+            if (!NIL_P(popup))
+            {
+              VALUE rb_cp_proxy = rb_iv_get(popup, "@_wx_combo_popup_proxy");
+              if (NIL_P(rb_cp_proxy))
+              {
+                cpp = new WxRubyComboPopup(popup);
+                rb_cp_proxy = Data_Wrap_Struct(rb_cObject, 0, 0, cpp);
+                rb_iv_set(popup, "@_wx_combo_popup_proxy", rb_cp_proxy);
+              }
+              else
+              {
+                Data_Get_Struct(rb_cp_proxy, wxComboPopup, cpp);
+              }
+            }
+            return cpp;
+          }
+
+          WXRUBY_EXPORT VALUE wxRuby_ComboPopupToRuby(wxComboPopup* cpp)
+          {
+            VALUE rb_cpp = Qnil;
+            if (cpp)
+            {
+              WxRubyComboPopup *wxrb_cpp = dynamic_cast<WxRubyComboPopup*> (cpp);
+              if (wxrb_cpp)
+              {
+                rb_cpp = wxrb_cpp->GetRubyComboPopup();
+              }
+              else
+              {
+                // in this case we're probably working for a wxOwnerDrawnComboBox or wxRichTextListbox 
+                // with default popup control which is a C++ implemented class without any Ruby linkage.
+                // wrap this in the Wx::ComboPopupWx class to provide a Ruby interface
+                rb_cpp = Data_Wrap_Struct(g_rb_cComboPopupWx, 0, 0, cpp); // do not own or track
+              }
+            }
+            return rb_cpp;
+          }
+
+          static void wxRuby_markComboPopups()
+          {
+            WxRubyComboPopup::GC_mark_combo_popups();
+          }
+          __HEREDOC
+        # ignore these
+        spec.ignore 'wxComboCtrl::SetPopupControl',
+                    'wxComboCtrl::GetPopupControl',
+                    ignore_doc: false
+        # for GetPopupControl docs only
+        spec.map 'wxComboPopup*' => 'Wx::ComboPopup', swig: false do
+          map_out code: ''
+        end
+        # and replace
+        spec.add_extend_code 'wxComboCtrl', <<~__HEREDOC
+          void SetPopupControl(VALUE popup)
+          {
+            wxComboPopup* cpp = wxRuby_ComboPopupFromRuby(popup);
+            $self->SetPopupControl(cpp);
+          }
+      
+          VALUE GetPopupControl()
+          {
+            return wxRuby_ComboPopupToRuby($self->GetPopupControl());
+          }
+          __HEREDOC
+        spec.add_init_code <<~__HEREDOC
+          wxRuby_AppendMarker(wxRuby_markComboPopups);
+
+          g_rb_mWxComboPopup = rb_define_module_under(mWxCore, "ComboPopup");
+          rb_define_method(g_rb_mWxComboPopup, "get_combo_ctrl", VALUEFUNC(wx_combo_popup_get_combo_ctrl), -1);
+
+          g_rb_cComboPopupWx = rb_define_class_under(mWxCore, "ComboPopupWx", rb_cObject);
+          rb_undef_alloc_func(g_rb_cComboPopupWx);
+          rb_define_method(g_rb_cComboPopupWx, "lazy_create", VALUEFUNC(combo_popup_wx_lazy_create), -1);
+          rb_define_method(g_rb_cComboPopupWx, "create", VALUEFUNC(combo_popup_wx_create), -1);
+          rb_define_method(g_rb_cComboPopupWx, "get_combo_ctrl", VALUEFUNC(combo_popup_wx_get_combo_ctrl), -1);
+          rb_define_method(g_rb_cComboPopupWx, "find_item", VALUEFUNC(combo_popup_wx_find_item), -1);
+          rb_define_method(g_rb_cComboPopupWx, "get_adjusted_size", VALUEFUNC(combo_popup_wx_get_adjusted_size), -1);
+          rb_define_method(g_rb_cComboPopupWx, "get_control", VALUEFUNC(combo_popup_wx_get_control), -1);
+          rb_define_method(g_rb_cComboPopupWx, "set_string_value", VALUEFUNC(combo_popup_wx_set_string_value), -1);
+          rb_define_method(g_rb_cComboPopupWx, "get_string_value", VALUEFUNC(combo_popup_wx_get_string_value), -1);
+          rb_define_method(g_rb_cComboPopupWx, "on_combo_double_click", VALUEFUNC(combo_popup_wx_on_combo_double_click), -1);
+          rb_define_method(g_rb_cComboPopupWx, "on_combo_key_event", VALUEFUNC(combo_popup_wx_on_combo_key_event), -1);
+          rb_define_method(g_rb_cComboPopupWx, "on_combo_char_event", VALUEFUNC(combo_popup_wx_on_combo_char_event), -1);
+          rb_define_method(g_rb_cComboPopupWx, "on_dismiss", VALUEFUNC(combo_popup_wx_on_dismiss), -1);
+          rb_define_method(g_rb_cComboPopupWx, "on_popup", VALUEFUNC(combo_popup_wx_on_popup), -1);
+          rb_define_method(g_rb_cComboPopupWx, "paint_combo_control", VALUEFUNC(combo_popup_wx_paint_combo_control), -1);
+          __HEREDOC
       end
 
     end # class ComboCtrl

data/rakelib/lib/director/defs.rb

@@ -32,9 +32,7 @@ module WXRuby3
           wxDELETEA
           wxSwap
         }
-        if Config.instance.wx_version >= '3.3.0'
-          spec.ignore 'wxOVERRIDE'
-        end
+        spec.ignore 'wxOVERRIDE'
         super
       end
 

data/rakelib/lib/director/gdicommon.rb

@@ -49,6 +49,11 @@ module WXRuby3
           'wxRect::Intersect(const wxRect &)',
           'wxRect::Union(const wxRect &)'
         ]
+        if Config.instance.wx_version >= '3.3.0'
+          # ignore these as they are supposed to specify unary minus but confuse
+          # SWIG
+          spec.ignore 'wxPoint::operator-(const wxPoint&)'
+        end
         spec.regard 'wxRect::Offset', regard_doc: false
         # overrule common wxPoint mapping for wxRect ctor to fix ctor ambiguities here wrt wxSize
         spec.map 'const wxPoint& topLeft', 'const wxPoint& bottomRight', as: 'Wx::Point' do

data/rakelib/lib/director/menu_item.rb

@@ -24,7 +24,7 @@ module WXRuby3
         spec.ignore_unless('USE_ACCEL', 'wxMenuItem::GetAccel')
         spec.no_proxy 'wxMenuItem::GetAccel'
         spec.ignore 'wxMenuItem::GetBitmap(bool)' # not portable
-        if Config.instance.wx_version >= '3.3.0'
+        if Config.instance.wx_version > '3.2.4'
           spec.ignore_unless('WXMSW', 'wxMenuItem::SetBackgroundColour','wxMenuItem::SetFont','wxMenuItem::SetTextColour')
         end
         super

data/rakelib/lib/director/num_validator.rb

@@ -383,13 +383,11 @@ module WXRuby3
         # hardcoded interface declarations
         spec.add_interface_code <<~__HEREDOC
           // Bit masks used for numeric validator styles.
-          enum wxNumValidatorStyle
-          {
-              wxNUM_VAL_DEFAULT               = 0x0,
-              wxNUM_VAL_THOUSANDS_SEPARATOR   = 0x1,
-              wxNUM_VAL_ZERO_AS_BLANK         = 0x2,
-              wxNUM_VAL_NO_TRAILING_ZEROES    = 0x4
-          };
+          enum wxNumValidatorStyle;
+          %constant int NumValidatorStyle_wxNUM_VAL_DEFAULT             = 0x0;
+          %constant int NumValidatorStyle_wxNUM_VAL_THOUSANDS_SEPARATOR = 0x1;
+          %constant int NumValidatorStyle_wxNUM_VAL_ZERO_AS_BLANK       = 0x2;
+          %constant int NumValidatorStyle_wxNUM_VAL_NO_TRAILING_ZEROES  = 0x4;
 
           %alias WXIntegerValidator::GetMin "min";
           %alias WXIntegerValidator::SetMin "min=";

data/rakelib/lib/director/owner_drawn_combobox.rb

@@ -15,6 +15,7 @@ module WXRuby3
     class OwnerDrawnComboBox < Window
 
       include Typemap::ClientData
+      include Typemap::ComboPopup
 
       def setup
         super

data/rakelib/lib/director/persistent_window.rb

@@ -14,8 +14,8 @@ module WXRuby3
 
       def setup
         spec.items << 'wxPersistentTLW' << 'wxPersistentBookCtrl' << 'wxPersistentTreeBookCtrl'
-        if Config.instance.wx_version >= '3.3.0'
-          # before 3.3.0 this was not properly available
+        if Config.instance.wx_version > '3.2.4'
+          # only after 3.2.4 properly available
           spec.items << 'wxPersistentComboBox'
         end
         super

data/rakelib/lib/director/pgeditor.rb

@@ -17,7 +17,7 @@ module WXRuby3
         spec.items.concat %w[wxPGCheckBoxEditor wxPGChoiceEditor wxPGChoiceAndButtonEditor wxPGComboBoxEditor
                              wxPGTextCtrlEditor wxPGSpinCtrlEditor wxPGTextCtrlAndButtonEditor wxPGEditorDialogAdapter]
         spec.includes << 'wx/propgrid/propgriddefs.h'
-        if Config.instance.wx_version >= '3.3.0'
+        if Config.instance.wx_version > '3.2.4'
           # make sure SWIG knows this as enum type
           spec.add_swig_code 'enum wxPGPropertyFlags;'
         end

data/rakelib/lib/director/pgproperties.rb

@@ -65,7 +65,7 @@ module WXRuby3
                     'wxUIntProperty::m_prefix',
                     'wxDateProperty::m_format',
                     'wxDateProperty::m_dpStyle'
-        if Config.instance.wx_version >= '3.3.0'
+        if Config.instance.wx_version > '3.2.4'
           # currently missing from interface docs
           spec.extend_interface 'wxEnumProperty',
                                 'bool ValueFromString_(wxVariant& value, int* pIndex, const wxString& text,int argFlags) const',
@@ -111,7 +111,7 @@ module WXRuby3
         end
         # make sure the derived Enum property classes provide the protected accessors too
         %w[wxCursorProperty wxEditEnumProperty wxSystemColourProperty wxColourProperty].each do |kls|
-          if Config.instance.wx_version >= '3.3.0'
+          if Config.instance.wx_version > '3.2.4'
             # currently missing from interface docs
             spec.extend_interface kls,
                                   'int GetIndex() const',
@@ -136,7 +136,7 @@ module WXRuby3
                     'wxLongStringProperty::DisplayEditorDialog',
                     'wxMultiChoiceProperty::DisplayEditorDialog',
                     'wxFontProperty::DisplayEditorDialog'
-        if Config.instance.wx_version >= '3.3.0'
+        if Config.instance.wx_version > '3.2.4'
           # for wxEnumProperty and derivatives ValueFromString_/ValueFromInt_
           spec.map_apply 'int * OUTPUT' => 'int* pIndex'
         end

data/rakelib/lib/director/pgproperty.rb

@@ -113,7 +113,11 @@ module WXRuby3
           # do not think this useful for wxRuby (Also; caused GC problems)
           spec.ignore 'wxPGProperty::GetCellRenderer'
           # obsolete
-          spec.ignore %w[wxPGProperty::AddChild wxPGProperty::GetValueString]
+          if Config.instance.wx_version < '3.3.0'
+            spec.ignore %w[wxPGProperty::AddChild wxPGProperty::GetValueString]
+          else
+            spec.ignore 'wxPGProperty::AddChild'
+          end
           # not of use in Ruby
           spec.ignore(%w[wxPGProperty::GetClientData wxPGProperty::SetClientData])
           # only keep the const version

data/rakelib/lib/director/richtext_style_listbox.rb

@@ -15,6 +15,7 @@ module WXRuby3
     class RichTextStyleListBox < Window
 
       include Typemap::RichText
+      include Typemap::ComboPopup
 
       def setup
         super
@@ -28,6 +29,10 @@ module WXRuby3
                                            wxWindow
                                            wxEvtHandler
                                            wxObject])
+        # missing from docs; required so proxy calls correct override
+        spec.extend_interface 'wxRichTextStyleComboCtrl',
+                              'virtual void DoSetPopupControl(wxComboPopup* popup)',
+                              visibility: 'protected'
       end
 
     end

data/rakelib/lib/director/sizer.rb

@@ -20,7 +20,7 @@ module WXRuby3
         when 'wxSizer'
           spec.items << 'wxSizerFlags'
           spec.gc_as_untracked('wxSizerFlags')
-          if Config.instance.wx_version < '3.3.0'
+          unless Config.instance.wx_version > '3.2.4'
             # missing from docs
             spec.extend_interface 'wxSizerFlags',
                                   'wxSizerFlags& HorzBorder()'

data/rakelib/lib/director/window.rb

@@ -126,6 +126,10 @@ module WXRuby3
           else
             spec.ignore('wxWindow::SetAccessible',
                         'wxWindow::GetAccessible')
+            if Config.instance.wx_version > '3.2.4'
+              spec.ignore('wxWindow::CreateAccessible',
+                          'wxWindow::GetOrCreateAccessible')
+            end
           end
           spec.ignore_unless('USE_HOTKEY', %w[wxWindow::RegisterHotKey wxWindow::UnregisterHotKey])
           spec.ignore('wxWindow::SetSize(int, int)') # not useful as the wxSize variant will also accept an array

data/rakelib/lib/extractor/module.rb

@@ -117,6 +117,13 @@ module WXRuby3
         when 'file', 'namespace'
           Extractor.extracting_msg(kind, element, 'compoundname')
           element.xpath('sectiondef/memberdef').each { |node| self.add_element(node) }
+          # from doxygen 1.9.7 onwards some members are not included in the same XML file
+          # but referenced from another XML file; so we need to resolve such references
+          # and than add the resolved element
+          element.xpath('sectiondef/member').each do |node|
+            node = self.resolveRefId(node)
+            self.add_element(node)
+          end
 
         else
           raise ExtractorError.new('Unknown module item kind: %s' % kind)
@@ -124,6 +131,14 @@ module WXRuby3
         item
       end
 
+      def resolveRefId(node)
+        refid = node['refid'].split('_')
+        refid.pop
+        fname = File.join(Extractor.xml_dir, refid.join('_')+'.xml')
+        root = File.open(fname) {|f| Nokogiri::XML(f) }.root
+        root.at_xpath(".//sectiondef/memberdef[@id='#{node['refid']}']")
+      end
+
       # Add a new C++ function into the module that is written by hand, not
       # wrapped.
       def add_cpp_function(type, name, argsString, body, doc = nil, **kwargs)

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

@@ -0,0 +1,135 @@
+---
+:wxComboCtrl:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /wxDECLARE_EVENT_TABLE/
+          :replace: |
+            
+            ```ruby
+            class ListViewComboPopup < Wx::ListView
+            
+              include Wx::ComboPopup
+              
+              # Allow only default ctor
+              def initialize
+                # call default control ctor; need to call Wx::ListView#create later
+                super
+              end
+              
+              # Initialize member variables
+              def init
+                @value = -1
+              end
+              
+              # Create popup control
+              def create(parent)
+                # need to finish creating the list view here
+                # as calling super here would just call Wx::ComboPopup#create and not Wx::ListView#create
+                # we need to use Ruby magic
+                wx_lv_create = (Wx::ListView.instance_method :create).bind(self)
+                wx_lv_create.call(parent, 1, [0,0], Wx::DEFAULT_SIZE)
+                evt_motion :on_mouse_move
+                evt_left_up :on_mouse_click
+                end
+              
+              # Return pointer to the created control
+              def get_control
+                self
+              end
+              
+              def lv_find_item(*args)
+                unless @wx_lv_find_item
+                @wx_lv_find_item = (Wx::ListView.instance_method :find_item).bind(self)
+                end
+                @wx_lv_find_item.call(*args)
+              end
+              protected :lv_find_item
+              
+              # Translate string into a list selection
+              def set_string_value(s)
+                n = lv_find_item(-1, s)
+                if n >= 0 && n < get_item_count
+                  select(n)
+                  @value = n
+                end
+              end
+              
+              # Get list selection as a string
+              def get_string_value
+                return get_item_text(@value) if @value >= 0
+                ''
+              end
+              
+              # Do mouse hot-tracking (which is typical in list popups)
+              def on_mouse_move(event)
+                # Move selection to cursor ...
+              end
+              
+              # On mouse left up, set the value and close the popup
+              def on_mouse_click(_event)
+                @value = get_first_selected
+                
+                # Send event as well ...
+                
+                dismiss
+              end
+            
+            end
+            ```
+        - :pattern: !ruby/regexp /wxComboCtrl/
+          :replace: |
+            
+            ```ruby
+              comboCtrl = Wx::ComboCtrl.new(self, Wx::ID_ANY, '')
+              
+              popupCtrl = ListViewComboPopup.new
+              
+              # It is important to call #set_popup_control as soon as possible
+              comboCtrl.set_popup_control(popupCtrl)
+              
+              # Populate using Wx::ListView methods
+              popupCtrl.insert_item((popupCtrl.item_count, 'First Item')
+              popupCtrl.insert_item((popupCtrl.item_count, 'Second Item')
+              popupCtrl.insert_item((popupCtrl.item_count, 'Third Item')
+            ```
+:wxComboCtrl.SetMainControl:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+            
+            ```ruby
+              # Create the combo control using its default ctor.
+              combo = Wx::ComboCtrl.new
+              
+              # Create the custom main control using its default ctor too.
+              main = SomeWindow.new
+              
+              # Set the custom main control before creating the combo.
+              combo.set_main_control(main)
+              
+              # And only create it now: Wx::TextCtrl won't be unnecessarily
+              # created because the combo already has a main window.
+              combo.create(panel, Wx::ID_ANY, '')
+              
+              # Finally create the main window itself, now that its parent was
+              # created.
+              main.create(combo, ...)
+            ```
+:wxComboCtrl.SetTextCtrlStyle:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+            
+            ```ruby
+              comboCtrl = Wx::ComboCtrl.new
+              
+              # Let's make the text right-aligned
+              comboCtrl.set_text_ctrl_style(Wx::TE_RIGHT)
+              
+              comboCtrl.create(parent, Wx::ID_ANY, '')
+            ```

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

@@ -0,0 +1,62 @@
+---
+:wxFileDialogCustomizeHook:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+            
+            ```ruby
+            class EncryptHook < Wx::FileDialogCustomizeHook
+            
+              attr_reader :encrypt
+            
+              # Override to add custom controls using the provided customizer object.
+              def add_custom_controls(customizer)
+                # Suppose we can encrypt files when saving them.
+                @checkbox = customizer.add_check_box('Encrypt')
+       
+                # While @checkbox is not a Wx::CheckBox, it looks almost like one
+                # and, in particular, we can bind to custom control events as usual.
+                @checkbox.evt_checkbox(Wx::ID_ANY) do |event| 
+                   # We can also call Wx::Window-like functions on them.
+                   @button.enable(event.checked?)
+                end
+       
+                # The encryption parameters can be edited in a dedicated dialog.
+                @button = customizer.add_button('Parameters...')
+                @button.evt_button(Wx::ID_ANY) do |event|
+                   # ... show the encryption parameters dialog here ...
+                end
+              end
+          
+              # Override to save the values of the custom controls.
+              def transfer_data_from_custom_controls 
+                # Save the checkbox value, as we won't be able to use it any more
+                # once this function returns.
+                @encrypt = @checkbox.get_value
+              end
+          
+            end
+            
+            # ...
+            
+            def some_method
+              Wx.FileDialog(nil, 'Save document', '', 'file.my',
+                                 'My files (*.my)|*.my',
+                                 Wx::FD_SAVE | Wx::FD_OVERWRITE_PROMPT) do |dialog|
+           
+                # This object may be destroyed before the dialog, but must remain
+                # alive until #show_modal returns.
+                customize_hook = EncryptHook.new
+                dialog.set_customize_hook(custom_hook)
+           
+                if dialog.show_modal == Wx::ID_OK 
+                  if customize_hook.encrypt 
+                    # ... save with encryption ...
+                  else
+                    # ... save without encryption ...
+                  end
+                end
+            end
+            ```

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

@@ -0,0 +1,28 @@
+---
+:wxFileSystemHandler.CanOpen:
+  :detail:
+    :pre:
+      :para:
+        - :pattern: !ruby/regexp /Example:/
+          :subst: ''
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: ''
+:wxFileSystemHandler.GetMimeTypeFromExt:
+  :detail:
+    :pre:
+      :para:
+        - :pattern: !ruby/regexp /Example:/
+          :subst: ''
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: ''
+:wxMemoryFSHandler:
+  :detail:
+    :pre:
+      :para:
+        - :pattern: !ruby/regexp /Example:/
+          :subst: ''
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: ''