wxruby3 0.9.8 → 1.0.0

data/rakelib/lib/director/geometry.rb

@@ -0,0 +1,142 @@
+# 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 Geometry < Director
+
+      def setup
+        spec.items.replace %w{wxPoint2DInt wxPoint2DDouble}
+
+        spec.ignore 'wxPoint2DInt::m_x', 'wxPoint2DInt::m_y',
+                    'wxPoint2DDouble::m_x', 'wxPoint2DDouble::m_y'
+
+        spec.add_extend_code 'wxPoint2DInt', <<~__HEREDOC
+          wxInt32 get_x()
+          {
+            return $self->m_x;
+          }
+          wxInt32 set_x(wxInt32 v)
+          {
+            return ($self->m_x = v);
+          }
+          wxInt32 get_y()
+          {
+            return $self->m_y;
+          }
+          wxInt32 set_y(wxInt32 v)
+          {
+            return ($self->m_y = v);
+          }
+          void assign(const wxPoint2DInt& pt)
+          {
+            (*$self) = pt;
+          }
+          void add(const wxPoint2DInt& pt)
+          {
+            (*$self) += pt;
+          }
+          void sub(const wxPoint2DInt& pt)
+          {
+            (*$self) -= pt;
+          }
+          void mul(const wxPoint2DInt& pt)
+          {
+            (*$self) *= pt;
+          }
+          void mul(wxDouble v)
+          {
+            $self->m_x *= v; $self->m_y *= v;
+          }
+          void mul(wxInt32 v)
+          {
+            $self->m_x *= v; $self->m_y *= v;
+          }
+          void div(const wxPoint2DInt& pt)
+          {
+            (*$self) /= pt;
+          }
+          void div(wxDouble v)
+          {
+            $self->m_x /= v; $self->m_y /= v;
+          }
+          void div(wxInt32 v)
+          {
+            $self->m_x /= v; $self->m_y /= v;
+          }
+          __HEREDOC
+
+        spec.add_extend_code 'wxPoint2DDouble', <<~__HEREDOC
+          wxDouble get_x()
+          {
+            return $self->m_x;
+          }
+          wxDouble set_x(wxDouble v)
+          {
+            return ($self->m_x = v);
+          }
+          wxDouble get_y()
+          {
+            return $self->m_y;
+          }
+          wxDouble set_y(wxDouble v)
+          {
+            return ($self->m_y = v);
+          }
+          void assign(const wxPoint2DDouble& pt)
+          {
+            (*$self) = pt;
+          }
+          void add(const wxPoint2DDouble& pt)
+          {
+            (*$self) += pt;
+          }
+          void sub(const wxPoint2DDouble& pt)
+          {
+            (*$self) -= pt;
+          }
+          void mul(const wxPoint2DDouble& pt)
+          {
+            (*$self) *= pt;
+          }
+          void mul(wxDouble v)
+          {
+            $self->m_x *= v; $self->m_y *= v;
+          }
+          void mul(wxInt32 v)
+          {
+            $self->m_x *= v; $self->m_y *= v;
+          }
+          void div(const wxPoint2DDouble& pt)
+          {
+            (*$self) /= pt;
+          }
+          void div(wxDouble v)
+          {
+            $self->m_x /= v; $self->m_y /= v;
+          }
+          void div(wxInt32 v)
+          {
+            $self->m_x /= v; $self->m_y /= v;
+          }
+          __HEREDOC
+
+        spec.map_apply 'int * OUTPUT' => 'wxInt32 *'
+
+        # ignore all friend operators
+        spec.do_not_generate :functions
+
+      end
+
+    end
+
+  end
+
+end

data/rakelib/lib/director/graphics_context.rb

@@ -29,12 +29,13 @@ module WXRuby3
                     'wxGraphicsContext::CreateFromNativeHDC',
                     'wxGraphicsContext::CreateFromUnknownDC',
                     'wxGraphicsContext::GetNativeContext',
-                    'wxGraphicsContext::Create',
+                    'wxGraphicsContext::Create(const wxEnhMetaFileDC &)',
                     'wxGraphicsContext::CreateMatrix(const wxAffineMatrix2DBase &) const',
                     'wxGraphicsContext::DrawLines(size_t, const wxPoint2DDouble *, wxPolygonFillMode)',
                     'wxGraphicsContext::StrokeLines(size_t, const wxPoint2DDouble *)',
                     'wxGraphicsContext::StrokeLines (size_t, const wxPoint2DDouble *, const wxPoint2DDouble *)'
         spec.ignore_unless(Config::AnyOf.new('WXMSW', 'WXOSX', 'USE_GTKPRINT'), 'wxGraphicsContext::Create(const wxPrinterDC &)')
+        spec.new_object 'wxGraphicsContext::Create'
         spec.add_header_code <<~__HEREDOC
           // special free funcs are needed to clean up Dashes array if it has been
           // set; wxWidgets does not do this automatically so will leak if not
@@ -55,7 +56,7 @@ module WXRuby3
         # dealt with below - these require special handling because of the use
         # of wxDash array, which cannot be freed until the peninfo is disposed of
         # or until a new dash pattern is specified.
-        spec.ignore(%w[wxGraphicsPenInfo::GetDashes wxGraphicsPenInfo::Dashes], ignore_doc: false)
+        spec.ignore(%w[wxGraphicsPenInfo::GetDashes wxGraphicsPenInfo::Dashes])
         spec.ignore 'wxGraphicsPenInfo::GetDash'
         spec.add_extend_code 'wxGraphicsPenInfo', <<~__HEREDOC
           // Returns a ruby array with the dash lengths

data/rakelib/lib/director/graphics_object.rb

@@ -14,43 +14,36 @@ module WXRuby3
 
       def setup
         super
-        spec.items.concat %w[wxGraphicsPen wxGraphicsBrush wxGraphicsPath wxGraphicsFont wxGraphicsMatrix wxGraphicsBitmap]
+        spec.items.concat %w[wxGraphicsPen wxGraphicsBrush wxGraphicsPath wxGraphicsFont wxGraphicsMatrix wxGraphicsBitmap wxGraphicsRenderer]
         spec.disable_proxies
-        spec.ignore 'wxGraphicsObject::GetRenderer'
         spec.ignore 'wxGraphicsMatrix::Concat(const wxGraphicsMatrix &)'
         spec.ignore 'wxGraphicsMatrix::IsEqual(const wxGraphicsMatrix &)'
         spec.ignore 'wxGraphicsMatrix::GetNativeMatrix'
         spec.ignore 'wxGraphicsBitmap::GetNativeBitmap'
         spec.ignore 'wxGraphicsPath::GetNativePath',
-                    'wxGraphicsPath::UnGetNativePath',
-                    'wxGraphicsPath::AddCurveToPoint(const wxPoint2DDouble &, const wxPoint2DDouble &, const wxPoint2DDouble &)',
-                    'wxGraphicsPath::AddLineToPoint(const wxPoint2DDouble &)',
-                    'wxGraphicsPath::Contains(const wxPoint2DDouble &, wxPolygonFillMode) const',
-                    'wxGraphicsPath::GetCurrentPoint',
-                    'wxGraphicsPath::MoveToPoint(const wxPoint2DDouble &)',
-                    'wxGraphicsPath::AddArc(const wxPoint2DDouble &, wxDouble, wxDouble, wxDouble, bool)'
+                    'wxGraphicsPath::UnGetNativePath'
+        spec.ignore 'wxGraphicsRenderer::CreateContextFromNativeHDC',
+                    'wxGraphicsRenderer::CreateBitmapFromNativeBitmap',
+                    'wxGraphicsRenderer::CreateContextFromNativeContext',
+                    'wxGraphicsRenderer::CreateContextFromNativeWindow',
+                    'wxGraphicsRenderer::CreateContext(const wxEnhMetaFileDC&)'
+        unless Config.instance.features_set?('USE_CAIRO')
+          spec.ignore 'wxGraphicsRenderer::GetCairoRenderer'
+        end
+        unless Config.instance.features_set?('WXMSW')
+          spec.ignore 'wxGraphicsRenderer::GetGDIPlusRenderer',
+                      'wxGraphicsRenderer::GetDirect2DRenderer'
+        end
+        spec.new_object 'wxGraphicsRenderer::CreateContext'
         # Deal with GraphicsMatrix#get method
         spec.map_apply 'double *OUTPUT' => [ 'wxDouble *a', 'wxDouble *b',
                                              'wxDouble *c', 'wxDouble *d',
                                              'wxDouble *tx' , 'wxDouble *ty' ]
-        # type mapping for GraphicsPath wxPoint2DDouble args
-        spec.map 'const wxPoint2DDouble&' => 'Array<Float,Float>' do
-          map_in temp: 'wxPoint2DDouble tmp_pt', code: <<~__CODE
-            if (TYPE($input) == T_ARRAY && RARRAY_LEN($input) == 2)
-            {
-              tmp_pt = wxPoint2DDouble(NUM2DBL(rb_ary_entry($input, 0)),
-                                       NUM2DBL(rb_ary_entry($input, 1)));
-              $1 = &tmp_pt;
-            }
-            else
-            {
-              rb_raise(rb_eTypeError, "Wrong type for %i", $argnum-1);
-            }
-            __CODE
-        end
         spec.ignore 'wxGraphicsPath::GetBox() const',
-                    'wxGraphicsPath::GetCurrentPoint() const'
+                    'wxGraphicsPath::GetCurrentPoint(wxDouble*,wxDouble*) const'
         spec.map_apply 'double * OUTPUT' => 'wxDouble *'
+        # wxGraphicsRenderer::GetVersion
+        spec.map_apply 'int * OUTPUT' => ['int *major', 'int *minor', 'int *micro']
         if Config.platform == :mingw
           # it seems for WXMSW there is a problem cleaning up GraphicsObjects in GC after
           # the wxApp has ended (probably because some other wxWidgets cleanup already

data/rakelib/lib/director/image.rb

@@ -212,6 +212,65 @@ module WXRuby3
             return rb_img_hist;
           }
           __HEREDOC
+        # make sure to wrap the public attributes
+        spec.regard 'wxImage::HSVValue::hue',
+                    'wxImage::HSVValue::saturation',
+                    'wxImage::HSVValue::value',
+                    'wxImage::RGBValue::red',
+                    'wxImage::RGBValue::green',
+                    'wxImage::RGBValue::blue'
+        # ignore these and add customs
+        spec.ignore 'wxImage::HSVtoRGB',
+                    'wxImage::RGBtoHSV'
+        spec.add_extend_code 'wxImage', <<~__HEREDOC
+          static wxImage::RGBValue hsv_to_rgb(VALUE arg)
+          {
+            std::unique_ptr<wxImage::HSVValue> tmp;
+            wxImage::HSVValue* p_hsv;
+            if ( TYPE(arg) == T_DATA )
+            {
+              void* argp;
+              SWIG_ConvertPtr(arg, &argp, SWIGTYPE_p_wxImage__HSVValue, 0);
+              p_hsv = reinterpret_cast< wxImage::HSVValue * >(argp);
+            }
+            else if ( TYPE(arg) == T_ARRAY && RARRAY_LEN(arg) == 3 )
+            {
+              p_hsv = new wxImage::HSVValue( NUM2DBL( rb_ary_entry(arg, 0) ),
+                                             NUM2DBL( rb_ary_entry(arg, 1) ),
+                                             NUM2DBL( rb_ary_entry(arg, 2) ) );
+              tmp.reset(p_hsv); // auto destruct when method scope ends 
+            }
+            else
+            {
+              rb_raise(rb_eArgError, "Expected either Array(Float,Float,Float) or Wx::Image::HSVValue for #0");
+            }
+            return wxImage::HSVtoRGB(*p_hsv);
+          }
+
+          static wxImage::HSVValue rgb_to_hsv(VALUE arg)
+          {
+            std::unique_ptr<wxImage::RGBValue> tmp;
+            wxImage::RGBValue* p_rgb;
+            if ( TYPE(arg) == T_DATA )
+            {
+              void* argp;
+              SWIG_ConvertPtr(arg, &argp, SWIGTYPE_p_wxImage__RGBValue, 0);
+              p_rgb = reinterpret_cast< wxImage::RGBValue * >(argp);
+            }
+            else if ( TYPE(arg) == T_ARRAY && RARRAY_LEN(arg) == 3 )
+            {
+              p_rgb = new wxImage::RGBValue( NUM2DBL( rb_ary_entry(arg, 0) ),
+                                             NUM2DBL( rb_ary_entry(arg, 1) ),
+                                             NUM2DBL( rb_ary_entry(arg, 2) ) );
+              tmp.reset(p_rgb); // auto destruct when method scope ends 
+            }
+            else
+            {
+              rb_raise(rb_eArgError, "Expected either Array(Float,Float,Float) or Wx::Image::RGBValue for #0");
+            }
+            return wxImage::RGBtoHSV(*p_rgb);
+          }
+          __HEREDOC
         spec.do_not_generate(:functions)
       end
     end # class Image

data/rakelib/lib/director/menu.rb

@@ -90,9 +90,8 @@ module WXRuby3
         # fix SWIG's problems with const& return value
         spec.ignore('wxMenu::GetTitle', ignore_doc: false) # keep doc
         spec.add_extend_code 'wxMenu', <<~__HEREDOC
-          wxString* GetTitle() const {
-            wxString const& title = $self->GetTitle();
-            return &const_cast<wxString&> (title);
+          wxString GetTitle() const {
+            return $self->GetTitle();
           }
 
           VALUE each_item()

data/rakelib/lib/director/menu_bar.rb

@@ -23,9 +23,6 @@ module WXRuby3
                 'wxMenuBar::GetLabelTop',
                 'wxMenuBar::SetLabelTop',
                 'wxMenuBar::Refresh')
-        unless Config.instance.wx_version >= '3.3' || Config.instance.wx_abi_version > '3.0.0'
-          spec.ignore 'wxMenuBar::OSXGetAppleMenu'
-        end
         # for FindItem
         spec.map 'wxMenu **' => 'Wx::Menu' do
           map_in ignore: true, temp: 'wxMenu *tmp', code: '$1 = &tmp;'

data/rakelib/lib/director/pen.rb

@@ -79,7 +79,7 @@ module WXRuby3
         # dealt with below - these require special handling because of the use
         # of wxDash array, which cannot be freed until the pen(info) is disposed of
         # or until a new dash pattern is specified.
-        spec.ignore(%w[wxPen::GetDashes wxPen::SetDashes wxPenInfo::GetDashes wxPenInfo::Dashes], ignore_doc: false)
+        spec.ignore(%w[wxPen::GetDashes wxPen::SetDashes wxPenInfo::GetDashes wxPenInfo::Dashes])
         spec.ignore 'wxPenInfo::GetDash'
         spec.add_extend_code 'wxPen', <<~__HEREDOC
           // Returns a ruby array with the dash lengths

data/rakelib/lib/director/richtext_ctrl.rb

@@ -146,7 +146,7 @@ module WXRuby3
             {
               if (TYPE(result) == T_FIXNUM)
               {
-                *newPos = NUM2LONG(result);
+                if (newPos) *newPos = NUM2LONG(result);
                 c_result = true;
               }
               else

data/rakelib/lib/director/system_settings.rb

@@ -22,7 +22,7 @@ module WXRuby3
                          'wxSystemSettings::HasFeature',
                          'wxSystemSettings::GetScreenType'
         spec.ignore 'wxSystemSettings::GetAppearance'
-        spec.add_extend_code <<~__HEREDOC
+        spec.add_extend_code 'wxSystemSettings', <<~__HEREDOC
           static wxString GetAppearanceName()
           {
             return wxSystemSettings::GetAppearance().GetName();

data/rakelib/lib/director/window.rb

@@ -150,13 +150,14 @@ module WXRuby3
             static VALUE do_paint_buffered(wxWindow* ptr)
             {
               VALUE rc = Qnil;
-              wxAutoBufferedPaintDC dc(ptr);
             #if wxALWAYS_NATIVE_DOUBLE_BUFFER
+              wxPaintDC dc(ptr);
               wxPaintDC* ptr_dc = &dc;
               VALUE r_class = rb_const_get(mWxCore, rb_intern("PaintDC"));
             #else
-              wxMemoryDC* ptr_dc = &dc;
-              VALUE r_class = rb_const_get(mWxCore, rb_intern("MemoryDC"));
+              wxBufferedPaintDC dc(ptr);
+              wxBufferedPaintDC* ptr_dc = &dc;
+              VALUE r_class = rb_const_get(mWxCore, rb_intern("BufferedPaintDC"));
             #endif
               swig_type_info* swig_type = wxRuby_GetSwigTypeForClass(r_class);
               VALUE rb_dc = SWIG_NewPointerObj(SWIG_as_voidptr(ptr_dc), swig_type, 0);

data/rakelib/lib/extractor/function.rb

@@ -293,7 +293,7 @@ module WXRuby3
         @is_static = element['static'] == 'yes'
         @is_virtual = %w[virtual pure-virtual].include?(element['virt'])
         @is_pure_virtual = (element['virt'] == 'pure-virtual')
-        @args_string.sub!(/\s*=0/, '') if @is_pure_virtual
+        @args_string.sub!(/\)(\s*const)?\s*=0/, ')\1') if @is_pure_virtual
         @is_override = !!element.at_xpath('reimplements')
         @is_const = (element['const'] == 'yes')
         @is_ctor = (@name == @class_name)

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

@@ -13,3 +13,13 @@
               animations.add("throbber_2x.gif")
               animationCtrl.play if animationCtrl.set_animation(animations)
             ```
+:wxAnimationCtrl.SetAnimation:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+            
+            ```ruby
+              animationCtrl.set_animation(Wx::AnimationBundle.new('progress.gif'))
+            ```

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

@@ -0,0 +1,35 @@
+---
+:wxBannerWindow:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+            
+            ```ruby
+              class MyFrame < Wx::Frame
+            
+                def initialize(...)
+            
+                  # ... create the frame itself ...
+            
+                  # Create and initialize the banner.
+                  banner = Wx::BannerWindow.new(self, Wx::TOP)
+                  banner.set_text("Welcome to my wonderful program",
+                                  "  Before doing anything else, you need to connect to the online server.\n" +
+                                  "  Please enter your credentials in the controls below.")
+             
+                  # And position it along the top edge of the window.
+                  sizer = Wx::VBoxSizer.new
+                  sizer.add(banner, Wx::SizerFlags.new.expand)
+             
+                  # ... add the rest of the window contents to the same sizer ...
+             
+                  set_sizer_and_fit(sizer)
+            
+                end
+            
+                # ...
+            
+              end
+            ```

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

@@ -32,3 +32,15 @@
                 end
               end
             ```
+:wxGraphicsPenInfo:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+
+            ```ruby
+              ctx = Wx::GraphicsContext.create(dc)
+            
+              ctx.set_pen(Wx::GraphicsPenInfo.new(Wx::BLUE).width(1.25).style(Wx::PENSTYLE_DOT))
+            ```

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

@@ -0,0 +1,12 @@
+---
+:wxGraphicsRenderer:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+
+            ```ruby
+              # path = Wx::GraphicsPath from somewhere
+              brush = path.get_renderer.create_brush(Wx::BLACK_BRUSH)
+            ```

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

@@ -23,3 +23,28 @@
             
               end
             ```
+:wxGrid.GetSelectedBlocks:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+            
+            ```ruby
+              grid.get_selected_blocks.each do |gbc|
+                break if gbc.intersects(my_block)
+              end
+            ```
+    :post:
+      - :pattern: !ruby/regexp /,\s+e\.g\.\s+with\s+range-for\s+loop:/
+        :subst: ':'
+:wxGridFitMode:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+            
+            ```ruby
+              grid.set_default_cell_fit_mode(Wx::GRID::GridFitMode.clip)
+            ```

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

@@ -0,0 +1,91 @@
+---
+:wxHeaderCtrl.Create:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+
+            ```ruby
+              Wx::HD_DEFAULT_STYLE & ~Wx::HD_ALLOW_REORDER
+            ```
+:wxHeaderCtrl.AddColumnsItems:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+
+            ```ruby
+              menu = Wx::Menu.new
+              menu.append(100, 'Some custom command')
+              menu.append_separator
+              add_columns_items(menu, 200)
+              rc = get_popup_menu_selection_from_user(menu, pt)
+              if rc >= 200
+                # ... toggle visibility of the column rc-200 ...
+              end
+            ```
+:wxHeaderCtrl.UpdateColumnWidthToFit:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+
+            ```ruby
+              class MyHeaderColumn < Wx::HeaderColumn
+                # ...
+            
+                def set_width(width) 
+                  @width = width
+                end
+          
+                def get_width 
+                  @width
+                end
+            
+              end
+              
+              class MyHeaderCtrl < Wx::HeaderCtrl
+                # ...
+            
+                protected
+            
+                def get_column(idx)
+                  # @cols = Array<MyHeaderColumn>
+                  @cols[idx]
+                end
+              
+                def update_column_width_to_fit(idx, widthTitle)
+                  widthContents = # ... compute minimal width for column idx ...
+                  @cols[idx].set_width([widthContents, widthTitle].max)
+                  true
+                end
+            
+              end
+            ```
+:wxHeaderCtrlSimple.HideColumn:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+
+            ```ruby
+              show_column(idx, false)
+            ```
+:wxHeaderColumnSimple:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+
+            ```ruby
+              header = Wx::HeaderCtrlSimple.new(...)
+              col = Wx::HeaderColumnSimple.new('Title')
+              col.set_width(100)
+              col.set_sortable(100)
+              header.append_column(col)
+            ```

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

@@ -9,3 +9,13 @@
             ```ruby
               get_icon(Wx::Size.new(size,size))
             ```
+:wxIconBundle.GetIcon:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+
+            ```ruby
+              get_icon(Wx::Size.new(size,size))
+            ```

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

@@ -0,0 +1,27 @@
+---
+:wxInfoBar:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+
+            ```ruby
+              class MyFrame < Wx::Frame
+              
+                def initialize()
+                  # ...
+                  @infoBar = Wx::InfoBar.new(self)
+              
+                  sizer = Wx::VBoxSizer.new
+                  sizer.add(@infoBar, Wx::SizerFlags.new.expand)
+                  # ... add other frame controls to the sizer ...
+                  set_sizer(sizer)
+                end
+                
+                def some_method
+                    @infoBar.show_message('Something happened', Wx::ICON_INFORMATION)
+                end
+            
+              end
+            ```

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

@@ -7,7 +7,7 @@
           :replace: |
             
             ```ruby
-              wxLog.set_component_level("wx/net", Wx::LOG_Error)
+              Wx::Log.set_component_level('wx/net', Wx::LOG_Error)
             ```
 :wxLog.LogRecord:
   :detail:

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

@@ -0,0 +1,27 @@
+---
+:wxMediaCtrl:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+
+            ```ruby
+              class MyFrame < Wx::Frame
+            
+                def initialize()
+                  # ... setup frame controls ...
+                  # bind events
+                  # ...
+                  evt_media_stop MY_ID, :on_media_stop
+                end
+            
+                def on_media_stop(evt)
+                  if @userWantsToSeek
+                    @mediactrl.seek(@mediactrl.length - 1)
+                    evt.veto
+                  end
+                end
+            
+              end
+            ```