wxruby3 0.9.0.pre.beta.14 → 0.9.0.pre.rc.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e6a85a400700ba48119fc656cf79208b3f5f603eaafb01d30206de46876dbf1
-  data.tar.gz: ffe7e7cde7840f547efe45893162bfc54e2bd9402d7aaf975a98f298fbdbdf8e
+  metadata.gz: a325622c35b3b6321d220fe21ef12c341dc640487529e05ae5cc3775b0685c50
+  data.tar.gz: af2bfd3115f68d2ac2485dad07ede48f45cba4e64fbbfae19d3756dc3c6e9176
 SHA512:
-  metadata.gz: 86dc10b04a49bd56825267b23117720fa5b2398cb01194cdd050fa9d8f6c81ba5a80426447a82fa747a725cdb1802bc0138ebd43322c7c162104a14c5a71ebb3
-  data.tar.gz: e9aa356d29c7d571f68a99dbd33041aed71d770951cca3d32a37b5eab634da938b9da931dad7fefafb67ad33401535357c27db647798e764abdd0def4133f09a
+  metadata.gz: 8dcc66a0505ea81a55aa8f22b2692ac83c4c055252691ec1122dc8ee11b7119bad00a6bd79cdb8e4cbab7d03f33912818b3c1a6b77f6c7dcddec5b5bd99d62a1
+  data.tar.gz: 9894a71c94deaef52479339f540cbdff8a02c301bc80c927bd96590c1366d893690eebd7d526ee09d90abe568dcec289233ffc717b4cad123c47e597f44c534b

data/.yardopts

@@ -1,6 +1,7 @@
 --load rakelib/yard/yard-relative_markdown_links.rb
 --load rakelib/yard/yard-custom-templates.rb
 --charset UTF-8
+--markup markdown
 --readme README.md
 --title "wxRuby3 API Documentation"
 --output-dir rdoc

data/README.md

@@ -13,12 +13,53 @@ Reviving wxRuby
 
 ## Introduction
 
-wxRuby3 is a cross-platform GUI library for Ruby, based on the [wxWidgets](https://wxwidgets.org)
+wxRuby3 is a cross-platform GUI library for Ruby, based on the mature [wxWidgets](https://wxwidgets.org)
 GUI toolkit for C++. It uses native widgets wherever possible, providing
 the correct look, feel and behaviour to GUI applications on Windows, OS
 X and Linux/GTK. wxRuby aims to provide a comprehensive solution to
 developing professional-standard desktop applications in Ruby. 
 
+## Usage examples
+
+### Hello world
+
+wxRuby3 is very easy to use.
+
+```ruby
+require 'wx'
+
+Wx::App.run do
+  Wx::Frame.new(nil, title: 'Hello world!').show
+end
+```
+
+![Hello_World](assets/hello_world.png "Hello World sample")
+
+### Hello Button
+
+Anyone who is familiar with wxWidgets should feel right at home since the API may be Ruby-fied, it is still easily 
+recognizable (but being Ruby-fied allowing for elegant and compact coding). And for those that do not have previous 
+experience do not fear, wxRuby3 comes with detailed [documentation](https://mcorino.github.io/wxRuby3/file.00_starting.html) and lots of examples and test.    
+
+```ruby
+require 'wx'
+
+class TheFrame < Wx::Frame
+  def initialize(title)
+    super(nil, title: title)
+    panel = Wx::Panel.new(self)
+    button = Wx::Button.new(panel, label: 'Click me')
+    button.evt_button(Wx::ID_ANY) { Wx.message_box('Hello. Thanks for clicking me!', 'Hello Button sample') }
+  end
+end
+
+Wx::App.run { TheFrame.new('Hello world!').show }
+```
+
+![Hello_Button](assets/hello_button.png "Hello Button sample")
+![Hello_Button_Clicked](assets/hello_button_clicked.png "Hello Button sample clicked")
+
+
 ## wxRuby3 licence
 
 wxRuby3 is free and open-source. It is distributed under the liberal
@@ -54,8 +95,10 @@ of these products.
 
 Currently the following are fully supported:
 
-* Windows 10 (RubyInstaller MSYS2-DevKit) / Ruby >= 2.5 / wxWidgets >= 3.2
-* Linux (i686 + AMD-64) / Ruby >= 2.5 / wxWidgets >= 3.2
+| Platform                                                                   | Ruby version(s) | wxWidgets version(s) |
+|----------------------------------------------------------------------------|-----------------| --- |
+| Windows 10 (tested)<br>(most likely also Windows 11)                       | Ruby >= 2.5<br>(RubyInstaller MSYS2-DevKit) | wxWidgets >= 3.2 |
+| Linux (tested; any AMD-64 distribution)<br>(most likely also i686 and ARM) | Ruby >= 2.5 | wxWidgets >= 3.2 |
 
 Support for other platforms is not being actively developed at present,
 but patches are welcome. It is likely to be much simpler to get wxRuby
@@ -109,7 +152,7 @@ which may be relevant.
 
 ### What wxWidgets features are supported by wxRuby3?
 
-wxRuby supports almost all of the wxWidgets 3.x GUI API, providing over
+wxRuby supports almost all of the wxWidgets 3.2+ GUI API, providing over
 600 classes in total. wxWidgets classes that provide general and/or non-GUI 
 programming support features, such as strings, networking, threading, database
 access and such are not and will never be ported, as it's assumed that 

data/ext/wxruby3/include/wxruby-runtime.h

@@ -57,6 +57,7 @@ WXRUBY_EXPORT bool GC_IsWindowDeleted(void *ptr);
 // Defined in wx.i; getting, setting and using swig_type <-> ruby class
 // mappings
 WXRUBY_EXPORT swig_type_info* wxRuby_GetSwigTypeForClass(VALUE cls);
+WXRUBY_EXPORT swig_type_info* wxRuby_GetSwigTypeForClassName(const char* clsname);
 WXRUBY_EXPORT void wxRuby_SetSwigTypeForClass(VALUE cls, swig_type_info* ty);
 
 // Common wrapping functions

data/ext/wxruby3/swig/memory_management.i

@@ -97,14 +97,11 @@ GC_NEVER(kls);
 %enddef
 
 // Strategy for objects whose pointer / id identity does not matter,
-// only their attributes: Size, Point and Rect. They are commonly
-// created as temporary objects on the stack in C++ and then passed into
+// only their attributes and/or methods like DC (and derivatives) Size, Point and Rect. They are commonly
+// created as temporary objects (mostly on the stack) in C++ and then passed into
 // director methods. Once the director method has run they should no
 // longer be referenced in ruby.
-%define GC_MANAGE_AS_FUNGIBLE_OBJECT(kls)
-%enddef
-
-%define GC_MANAGE_AS_TEMP(kls)
+%define GC_MANAGE_AS_UNTRACKED(kls)
 %enddef
 
 // Sizers attached to windows are automatically destroyed by wxWidgets,
@@ -133,10 +130,9 @@ GC_NEVER(kls);
 %enddef
 
 
-// All other classes - mainly helper classes (eg Sizer, GridCellxxx) and
-// informational classes eg Point, Size, Rect. These are tracked but
-// sometimes later disowned once passed into a widget, and thenceforth
-// managed by WxWidgets
+// All other classes - mainly helper classes (eg Sizer, GridCellxxx).
+// These are tracked but sometimes later disowned once passed into a
+// widget, and thenceforth managed by WxWidgets
 %define GC_MANAGE(kls)
 GC_MANAGE_AS_OBJECT(kls)
 %enddef

data/ext/wxruby3/swig/wx.i

@@ -32,17 +32,24 @@ RbClassToSwigTypeHash Global_Type_Map;
 
 // Record swig_type_info for a wxRuby class; called in class
 // initialisation
-WXRUBY_EXPORT void wxRuby_SetSwigTypeForClass(VALUE cls, swig_type_info* ty) {
+WXRUBY_EXPORT void wxRuby_SetSwigTypeForClass(VALUE cls, swig_type_info* ty)
+{
   Global_Type_Map[cls] = ty;
 }
 
 // Retrieve swig_type_info for a ruby class - needed by functions which
 // wrap objects whose type is not known in advance - eg
 // Window#find_window_by_index (see Window.i)
-WXRUBY_EXPORT swig_type_info* wxRuby_GetSwigTypeForClass(VALUE cls) {
+WXRUBY_EXPORT swig_type_info* wxRuby_GetSwigTypeForClass(VALUE cls)
+{
   return Global_Type_Map[cls];
 }
 
+WXRUBY_EXPORT swig_type_info* wxRuby_GetSwigTypeForClassName(const char* clsname)
+{
+  return wxRuby_GetSwigTypeForClass(rb_const_get(wxRuby_Core(), rb_intern(clsname)));
+}
+
 // Overriding standard SWIG tracking - SWIG's implementation is not
 // compatible with ruby 1.8.7 / 1.9.x as it can allocate BigNum objects
 // during GC , which is an error. So instead we provide a C++ ptr->Ruby
@@ -52,7 +59,8 @@ WX_DECLARE_VOIDPTR_HASH_MAP(VALUE,
 PtrToRbObjHash Global_Ptr_Map;
 
 // Add a tracking from ptr -> object
-WXRUBY_EXPORT void wxRuby_AddTracking(void* ptr, VALUE object) {
+WXRUBY_EXPORT void wxRuby_AddTracking(void* ptr, VALUE object)
+{
 #ifdef __WXRB_DEBUG__
   if (wxRuby_TraceLevel()>1)
   {
@@ -68,7 +76,8 @@ WXRUBY_EXPORT void wxRuby_AddTracking(void* ptr, VALUE object) {
 }
 
 // Return the ruby object for ptr
-WXRUBY_EXPORT VALUE wxRuby_FindTracking(void* ptr) {
+WXRUBY_EXPORT VALUE wxRuby_FindTracking(void* ptr)
+{
   if ( Global_Ptr_Map.count(ptr) == 0 )
     return Qnil;
   else
@@ -76,7 +85,8 @@ WXRUBY_EXPORT VALUE wxRuby_FindTracking(void* ptr) {
 }
 
 // Remove the tracking for ptr
-WXRUBY_EXPORT void wxRuby_RemoveTracking(void* ptr) {
+WXRUBY_EXPORT void wxRuby_RemoveTracking(void* ptr)
+{
 #ifdef __WXRB_DEBUG__
   if (wxRuby_TraceLevel()>1)
     std::wcout << "< wxRuby_RemoveTracking(" << ptr << ")" << std::endl;
@@ -85,7 +95,8 @@ WXRUBY_EXPORT void wxRuby_RemoveTracking(void* ptr) {
 }
 
 // Iterate over all the trackings, calling the passed-in method on each
-WXRUBY_EXPORT void wxRuby_IterateTracking( void(*meth)(void* ptr, VALUE obj) ) {
+WXRUBY_EXPORT void wxRuby_IterateTracking( void(*meth)(void* ptr, VALUE obj) )
+{
   PtrToRbObjHash::iterator it;
   for( it = Global_Ptr_Map.begin(); it != Global_Ptr_Map.end(); ++it )
     {

data/lib/wx/core/art_locator.rb

@@ -54,7 +54,7 @@ module Wx
       private :search_paths
 
       def add_search_path(*paths)
-        paths.flatten.each { |p| paths << s.to_s unless paths.include?(s.to_s) }
+        paths.flatten.each { |p| search_paths << p.to_s unless search_paths.include?(p.to_s) }
       end
       alias :add_search_paths :add_search_path
 
@@ -74,7 +74,7 @@ module Wx
 
       def find_art(art_name, art_type: nil, art_path: nil, art_section: nil, bmp_type: nil)
         unless art_path
-          caller_path = caller_locations(1).first.absolute_path
+          caller_path = caller_locations(1).first.absolute_path || caller_locations(1).first.path
           art_path = File.dirname(caller_path)
           art_section ||= File.basename(caller_path, '.*')
         end

data/lib/wx/core/artprovider.rb

@@ -7,7 +7,7 @@ class Wx::ArtProvider
     wx_push_back = instance_method(:push_back)
     define_method(:push_back) do | art_prov |
       wx_push_back.bind(self).call(art_prov)
-      @__art_provs.unshift(art_prov)
+      @__art_provs.push(art_prov)
     end
 
     wx_pop = instance_method(:pop)
@@ -19,7 +19,7 @@ class Wx::ArtProvider
     wx_push = instance_method(:push)
     define_method(:push) do | art_prov |
       wx_push.bind(self).call(art_prov)
-      @__art_provs.push(art_prov)
+      @__art_provs.unshift(art_prov)
     end
 
     wx_delete = instance_method(:delete)

data/lib/wx/core/bitmap.rb

@@ -86,15 +86,16 @@ module Wx
     # Accepts a block, which will be passed a device context which can be
     # used to draw upon the Bitmap
     def draw
-      dc = Wx::MemoryDC.new
-      dc.select_object(self)
-      yield dc
-      dc.select_object( Wx::NULL_BITMAP )
+      return unless block_given?
+      Wx::MemoryDC.draw_on(self) do |dc|
+        dc.select_object(self)
+        yield dc
+      end
     end
   end
 
   def self.Bitmap(name, bmp_type = nil)
-    art_path = File.dirname(caller_path = caller_locations(1).first.absolute_path)
+    art_path = File.dirname(caller_path = caller_locations(1).first.absolute_path || caller_locations(1).first.path)
     art_owner = File.basename(caller_path, '.*')
     art_file = ArtLocator.find_art(name, art_type: :bitmap, art_path: art_path, art_section: art_owner, bmp_type: bmp_type)
     ::Kernel.raise ArgumentError, "Cannot locate art file for #{name}:Bitmap" unless art_file

data/lib/wx/core/bitmap_combobox.rb

@@ -0,0 +1,34 @@
+
+module Wx
+
+  class BitmapCombobox < Wx::ComboBox
+
+    # We need to cache client data in Ruby variables as we cannot access items
+    # during the GC mark phase as for some platforms (WXMSW at least) that would
+    # involve calling methods that would break in that phase.
+
+    wx_append = instance_method :append
+    define_method :append do |item, bitmap=Wx::NULL_BITMAP, data=nil|
+      itm_pos = if data
+                  wx_append.bind(self).call(item, bitmap, data)
+                else
+                  wx_append.bind(self).call(item, bitmap)
+                end
+      client_data_store.insert(itm_pos, data)
+      itm_pos
+    end
+
+    wx_insert = instance_method :insert
+    define_method :insert do |item, bitmap, pos, data=nil|
+      itm_pos = if data
+                  wx_insert.bind(self).call(item, bitmap, pos, data)
+                else
+                  wx_insert.bind(self).call(item, bitmap, pos)
+                end
+      client_data_store.insert(itm_pos, data)
+      itm_pos
+    end
+
+  end
+
+end

data/lib/wx/core/controlwithitems.rb

@@ -32,6 +32,7 @@ class Wx::ControlWithItems
 
   wx_append = instance_method :append
   define_method :append do |item, data=nil|
+    itm_pos = -1
     if data
       if ::Array === item
         if !(::Array === data)
@@ -39,21 +40,42 @@ class Wx::ControlWithItems
         elsif data.size != item.size
           ::Kernel.raise ::ArgumentError.new("item and data array must be equal size")
         end
-        offs = get_count
-        wx_append.bind(self).call(item)
-        item.size.times { |ix| set_client_data(offs+ix, data[ix]) }
+        if sorted?
+          item.each_with_index do |itm, ix|
+            itm_pos = wx_append.bind(self).call(itm, data[ix])
+            client_data_store.insert(itm_pos, data[ix])
+          end
+        else
+          offs = get_count
+          itm_pos = wx_append.bind(self).call(item)
+          item.size.times { |ix| set_client_data(offs+ix, data[ix]) }
+        end
       else
-        wx_append.bind(self).call(item, data)
-        client_data_store[get_count-1] = data
+        itm_pos = wx_append.bind(self).call(item, data)
+        client_data_store.insert(itm_pos, data)
       end
     else
-      wx_append.bind(self).call(item)
-      # no changes to data store
+      if ::Array === item
+        if sorted?
+          item.each_with_index do |itm, ix|
+            itm_pos = wx_append.bind(self).call(itm, data[ix])
+            client_data_store.insert(itm_pos, nil)
+          end
+        else
+          itm_pos = wx_append.bind(self).call(item)
+          client_data_store.concat(::Array.new(item.size))
+        end
+      else
+        itm_pos = wx_append.bind(self).call(item)
+        client_data_store.insert(itm_pos, nil)
+      end
     end
+    itm_pos
   end
 
   wx_insert = instance_method :insert
   define_method :insert do |item, pos, data=nil|
+    itm_pos = -1
     if data
       if ::Array === item
         if !(::Array === data)
@@ -61,21 +83,37 @@ class Wx::ControlWithItems
         elsif data.size != item.size
           ::Kernel.raise ::ArgumentError.new("item and data array must be equal size")
         end
-        wx_insert.bind(self).call(item, pos)
-        client_data_store.insert(pos, *::Array.new(item.size))
-        item.size.times { |ix| set_client_data(pos+ix, data[ix]) }
+        if sorted?
+          item.each_with_index do |itm, ix|
+            itm_pos = wx_insert.bind(self).call(itm, data[ix])
+            client_data_store.insert(itm_pos, data[ix])
+          end
+        else
+          itm_pos = wx_insert.bind(self).call(item, pos)
+          client_data_store.insert(pos, *::Array.new(item.size))
+          item.size.times { |ix| set_client_data(pos+ix, data[ix]) }
+        end
       else
-        wx_insert.bind(self).call(item, pos, data)
-        client_data_store.insert(pos, data)
+        itm_pos = wx_insert.bind(self).call(item, pos, data)
+        client_data_store.insert(itm_pos, data)
       end
     else
-      wx_insert.bind(self).call(item, pos)
       if ::Array === item
-        client_data_store.insert(pos, *::Array.new(item.size))
+        if sorted?
+          item.each_with_index do |itm, ix|
+            itm_pos = wx_insert.bind(self).call(itm)
+            client_data_store.insert(itm_pos, nil)
+          end
+        else
+          itm_pos = wx_insert.bind(self).call(item, pos)
+          client_data_store.insert(pos, *::Array.new(item.size))
+        end
       else
+        itm_pos = wx_insert.bind(self).call(item, pos)
         client_data_store.insert(pos, nil)
       end
     end
+    itm_pos
   end
 
   wx_set = instance_method :set

data/lib/wx/core/cursor.rb

@@ -2,7 +2,7 @@
 module Wx
 
   def self.Cursor(name, bmp_type = nil, *rest)
-    art_path = File.dirname(caller_path = caller_locations(1).first.absolute_path)
+    art_path = File.dirname(caller_path = caller_locations(1).first.absolute_path || caller_locations(1).first.path)
     art_owner = File.basename(caller_path, '.*')
     art_file = ArtLocator.find_art(name, art_type: :icon, art_path: art_path, art_section: art_owner, bmp_type: bmp_type)
     ::Kernel.raise ArgumentError, "Cannot locate art file for #{name}:Cursor" unless art_file

data/lib/wx/core/dc.rb

@@ -69,24 +69,4 @@ module Wx
 
   end
 
-  class MemoryDC
-
-    # convenience method for drawing on a temporary memory DC
-    def self.draw_on(arg)
-      dc = case arg
-           when Wx::Bitmap, Wx::DC
-             self.new(arg)
-           else
-             ::Kernel.raise ArgumentError, 'Expected Wx::Bitmap or Wx::DC'
-           end
-      begin
-        yield(dc) if block_given?
-      ensure
-        dc.select_object(Wx::NULL_BITMAP)
-      end
-      nil
-    end
-
-  end
-
 end

data/lib/wx/core/event_blocker.rb

@@ -0,0 +1,14 @@
+
+module Wx
+
+  class EventBlocker
+
+    class << self
+
+      alias :block_for :blocked_for
+
+    end
+
+  end
+
+end

data/lib/wx/core/evthandler.rb

@@ -17,9 +17,45 @@ class Wx::EvtHandler
 
   # Fast look-up hash to map event type ids to ruby event classes
   EVENT_TYPE_CLASS_MAP = {}
+  private_constant :EVENT_TYPE_CLASS_MAP
   # Hash to look up EVT constants from symbol names of evt handler
   # methods; used internally by disconnect (see EvtHandler.i)
   EVENT_NAME_TYPE_MAP = {}
+  private_constant :EVENT_NAME_TYPE_MAP
+
+  class << self
+
+    def get_event_type_class_map
+      EVENT_TYPE_CLASS_MAP
+    end
+    private :get_event_type_class_map
+
+    # Add caching for added event filters as we need to keep these alive
+    # for as long as they are registered
+
+    def event_filters
+      @event_filters ||= []
+    end
+    private :event_filters
+
+    wx_add_filter = instance_method :add_filter
+    define_method :add_filter do |filter|
+      wx_add_filter.bind(self).call(filter)
+      event_filters << filter
+    end
+
+    wx_remove_filter = instance_method :remove_filter
+    define_method :remove_filter do |filter|
+      wx_remove_filter.bind(self).call(filter)
+      event_filters.delete(filter)
+    end
+
+    def clear_filters
+      event_filters.each { |f| remove_filter(f) }
+      event_filters.clear
+    end
+
+  end
 
   # Given a Wx EventType id (eg Wx::EVT_MENU), returns a WxRuby Event
   # class which should be passed to event handler blocks. The actual

data/lib/wx/core/find_replace_dialog.rb

@@ -0,0 +1,24 @@
+
+module Wx
+
+  class FindReplaceDialog < Wx::Dialog
+
+    # add caching for FindReplaceData object
+    # dialog does not take over ownership but does allow referencing
+    # the data object so we need to keep it alive here
+
+    wx_initialize = instance_method :initialize
+    define_method :initialize do |parent, data, *args|
+      wx_initialize.bind(self).call(parent, data, *args)
+      @fr_data = data
+    end
+
+    wx_set_data = instance_method :set_data
+    define_method :set_data do |data|
+      wx_set_data.bind(self).call(data)
+      @fr_data = data
+    end
+
+  end
+
+end

data/lib/wx/core/icon.rb

@@ -51,7 +51,7 @@ module Wx
   end
 
   def self.Icon(name, bmp_type = nil, *rest)
-    art_path = File.dirname(caller_path = caller_locations(1).first.absolute_path)
+    art_path = File.dirname(caller_path = caller_locations(1).first.absolute_path || caller_locations(1).first.path)
     art_owner = File.basename(caller_path, '.*')
     art_file = ArtLocator.find_art(name, art_type: :icon, art_path: art_path, art_section: art_owner, bmp_type: bmp_type)
     ::Kernel.raise ArgumentError, "Cannot locate art file for #{name}:Icon" unless art_file

data/lib/wx/core/image.rb

@@ -69,7 +69,7 @@ module Wx
   end
 
   def self.Image(name, bmp_type = nil, *rest)
-    art_path = File.dirname(caller_path = caller_locations(1).first.absolute_path)
+    art_path = File.dirname(caller_path = caller_locations(1).first.absolute_path || caller_locations(1).first.path)
     art_owner = File.basename(caller_path, '.*')
     art_file = ArtLocator.find_art(name, art_type: :image, art_path: art_path, art_section: art_owner, bmp_type: bmp_type)
     ::Kernel.raise ArgumentError, "Cannot locate art file for #{name}:Image" unless art_file

data/lib/wx/core/paintdc.rb

@@ -0,0 +1,8 @@
+
+class Wx::PaintDC
+
+  def self.draw_on(win, &block)
+    win.paint(&block) if block
+  end
+
+end

data/lib/wx/core/text_entry.rb

@@ -0,0 +1,15 @@
+
+module Wx
+
+  module TextEntry
+
+    wx_auto_complete = instance_method :auto_complete
+    define_method :auto_complete do |completer|
+      if wx_auto_complete.bind(self).call(completer)
+        @completer = completer # keep the Ruby object alive
+      end
+    end
+
+  end
+
+end

data/lib/wx/core/v_list_box.rb

@@ -0,0 +1,13 @@
+
+class Wx::VListBox
+
+  wx_each_selected = instance_method :each_selected
+  define_method :each_selected do |&block|
+    if block
+      wx_each_selected.bind(self).call(&block)
+    else
+      ::Enumerator.new { |y| wx_each_selected.bind(self).call { |sel| y << sel } }
+    end
+  end
+
+end

data/lib/wx/core/window.rb

@@ -49,7 +49,7 @@ class Wx::Window
   # This modified version of evt_paint sets a variable indicating that a
   # paint event is being handled just before running the event
   # handler. This ensures that any call to Window#paint within the
-  # handler will supply a Wx::PaintDC (see swig/Window.i).
+  # handler will supply a Wx::PaintDC (see Window SWIG director).
   def evt_paint(meth = nil, &block)
     paint_proc = acquire_handler(meth, block)
     wrapped_block = proc do | event |

data/lib/wx/doc/busy_info.rb

@@ -0,0 +1,21 @@
+
+module Wx
+
+  class BusyInfo
+
+    # @overload busy(message, parent=nil)
+    #   Shows busy info window with message, blocks event handling and calls the given block
+    #   passing the BusyInfo instance as argument.
+    #   @param [String] message
+    #   @param [Wx::Window,nil] parent
+    #   @yieldparam [Wx::BusyInfo] bi BusyInfo instance
+    # @overload busy(busy_info)
+    #   Shows busy info window according to busy_info settings, blocks event handling and calls the given block
+    #   passing the BusyInfo instance as argument.
+    #   @param [Wx::BusyInfoFlags] busy_info
+    #   @yieldparam [Wx::BusyInfo] bi BusyInfo instance
+    def self.busy(*args) end
+
+  end
+
+end

data/lib/wx/doc/client_dc.rb

@@ -0,0 +1,28 @@
+
+module Wx
+
+  class ClientDC < Wx::DC
+
+    # Executes the given block providing a temporary (client) dc as
+    # it's single argument.
+    # @param [Wx::Window] win window to draw on
+    # @yieldparam [Wx::ClientDC] dc the ClientDC instance to paint on
+    # @return [Object] result of the block
+    def self.draw_on(win) end
+
+  end
+
+  class PaintDC < Wx::ClientDC
+
+    # Executes the given block providing a temporary dc as
+    # it's single argument.
+    # Pass a pointer to the window on which you wish to paint.
+    # @note In wxRuby this method mostly exists to be consistent with the other DC classes. It is however recommended to use Wx::Window#paint instead.
+    # @param [Wx::Window] win window to draw on
+    # @yieldparam [Wx::PaintDC] dc the PaintDC instance to paint on
+    # @return [Object] result of the block
+    def self.draw_on(win) end
+
+  end
+
+end