wxruby3 0.9.8 → 1.0.1

data/lib/wx/doc/app.rb

@@ -9,47 +9,103 @@ module Wx
 
   class App
 
-    # Set the menu item id for the About menu item.
-    # Default is {Wx::ID_ABOUT}
-    # @param [Integer] id
-    # @wxrb_require WXOSX
-    def set_mac_about_menu_itemid(id) end
-    alias :mac_about_menu_itemid= :set_mac_about_menu_itemid
-
-    # Get the current menu item id for the About menu item.
-    # Default is {Wx::ID_ABOUT}
-    # @return [Integer]
-    # @wxrb_require WXOSX
-    def get_mac_about_menu_itemid(id) end
-    alias :mac_about_menu_itemid :get_mac_about_menu_itemid
-
-    # Set the menu item id for the Preferences menu item.
-    # Default is {Wx::ID_PREFERENCES}
-    # @param [Integer] id
-    # @wxrb_require WXOSX
-    def set_mac_preferences_menu_itemid(id) end
-    alias :mac_preferences_menu_itemid= :set_mac_preferences_menu_itemid
-
-    # Get the current menu item id for the Preferences menu item.
-    # Default is {Wx::ID_PREFERENCES}
-    # @return [Integer]
-    # @wxrb_require WXOSX
-    def get_mac_preferences_menu_itemid(id) end
-    alias :mac_preferences_menu_itemid :get_mac_preferences_menu_itemid
-
-    # Set the menu item id for the Exit menu item.
-    # Default is {Wx::ID_EXIT}
-    # @param [Integer] id
-    # @wxrb_require WXOSX
-    def set_mac_exit_menu_itemid(id) end
-    alias :mac_exit_menu_itemid= :set_mac_exit_menu_itemid
-
-    # Get the current menu item id for the Exit menu item.
-    # Default is {Wx::ID_EXIT}
-    # @return [Integer]
-    # @wxrb_require WXOSX
-    def get_mac_exit_menu_itemid(id) end
-    alias :mac_exit_menu_itemid :get_mac_exit_menu_itemid
+    # Run the (main loop for) the application instance.
+    # Optionally runs a given block as the applications #on_init callback
+    # if no actual #on_init method has been defined.
+    # A given block will be ignored if an actual #on_init method has been defined.
+    # @yieldreturn [Boolean] return true if init block succeeded, false otherwise
+    # @return [Integer] return code from the #on_exit callback (`0` if no #on_exit defined or called)
+    def run(&block) end
+
+    # Convenience method to instantiate an application object of the class
+    # and call the {Wx::App#run} method for that application object.
+    # @yieldreturn [Boolean] return true if init block succeeded, false otherwise
+    # @return [Integer] return code from {Wx::App#run}
+    def self.run(&block) end
+
+    class << self
+
+      # Set the menu item id for the About menu item.
+      # Default is {Wx::ID_ABOUT}. Setting to {Wx::ID_NONE} will disable moving the About item to the Application menu.
+      # @param [Integer] id
+      # @wxrb_require WXOSX
+      # @see Wx::App.get_mac_about_menu_itemid
+      def set_mac_about_menu_itemid(id) end
+      alias :mac_about_menu_itemid= :set_mac_about_menu_itemid
+
+      # Get the current menu item id for the About menu item.
+      # Default is {Wx::ID_ABOUT}
+      # @return [Integer]
+      # @wxrb_require WXOSX
+      # @see Wx::App.set_mac_about_menu_itemid
+      def get_mac_about_menu_itemid; end
+      alias :mac_about_menu_itemid :get_mac_about_menu_itemid
+
+      # Set the menu item id for the Preferences menu item.
+      # Default is {Wx::ID_PREFERENCES}
+      # @param [Integer] id
+      # @wxrb_require WXOSX
+      # @see Wx::App.get_mac_preferences_menu_itemid
+      def set_mac_preferences_menu_itemid(id) end
+      alias :mac_preferences_menu_itemid= :set_mac_preferences_menu_itemid
+
+      # Get the current menu item id for the Preferences menu item.
+      # Default is {Wx::ID_PREFERENCES}
+      # @return [Integer]
+      # @wxrb_require WXOSX
+      # @see Wx::App.set_mac_preferences_menu_itemid
+      def get_mac_preferences_menu_itemid; end
+      alias :mac_preferences_menu_itemid :get_mac_preferences_menu_itemid
+
+      # Set the menu item id for the Exit menu item.
+      # Default is {Wx::ID_EXIT}.  Setting to {Wx::ID_NONE} will disable hiding the exit item. Standard item will still be added to Application menu.
+      # @param [Integer] id
+      # @wxrb_require WXOSX
+      # @see Wx::App.get_mac_exit_menu_itemid
+      def set_mac_exit_menu_itemid(id) end
+      alias :mac_exit_menu_itemid= :set_mac_exit_menu_itemid
+
+      # Get the current menu item id for the Exit menu item.
+      # Default is {Wx::ID_EXIT}
+      # @return [Integer]
+      # @wxrb_require WXOSX
+      # @see Wx::App.set_mac_exit_menu_itemid
+      def get_mac_exit_menu_itemid; end
+      alias :mac_exit_menu_itemid :get_mac_exit_menu_itemid
+
+      # Set the menu title for the Help menu.
+      # Default is '&Help'
+      # @param [String] title
+      # @wxrb_require WXOSX
+      # @see Wx::App.get_mac_help_menu_title
+      def set_mac_help_menu_title(title) end
+      alias :mac_help_menu_title= :set_mac_help_menu_title
+
+      # Get the current title for the Help menu.
+      # Default is '&Help'
+      # @return [String]
+      # @wxrb_require WXOSX
+      # @see Wx::App.set_mac_help_menu_title
+      def get_mac_help_menu_title; end
+      alias :mac_help_menu_title :get_mac_help_menu_title
+
+      # Set the menu title for the Window menu.
+      # Default is '&Window'
+      # @param [String] title
+      # @wxrb_require WXOSX
+      # @see Wx::App.get_mac_window_menu_title
+      def set_mac_window_menu_title(title) end
+      alias :mac_window_menu_title= :set_mac_window_menu_title
+
+      # Get the current title for the Window menu.
+      # Default is '&Window'
+      # @return [String]
+      # @wxrb_require WXOSX
+      # @see Wx::App.set_mac_window_menu_title
+      def get_mac_window_menu_title; end
+      alias :mac_window_menu_title :get_mac_window_menu_title
+
+    end
 
   end
 

data/lib/wx/doc/bitmap.rb

@@ -14,6 +14,8 @@ module Wx
   # Default BitmapType for current platform. Actual value is platform dependent.
   CURSOR_DEFAULT_TYPE = Wx::BitmapType::BITMAP_TYPE_ANY
 
+  # @!group Art creation methods
+
   # Searches for an art file with basename 'name' and creates a Bitmap if found.
   # Raises an ArgumentError if not found.
   # Wx::ArtLocator::find_art is used to look up the art file using ::Kernel#caller_locations to
@@ -28,4 +30,6 @@ module Wx
   # @see Wx::ArtLocator::find_art
   def self.Bitmap(name, bmp_type = nil, art_path: nil, art_section: nil); end
 
+  # @!endgroup
+
 end

data/lib/wx/doc/client_dc.rb

@@ -13,7 +13,7 @@ module Wx
     # 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
+    # @return [::Object] result of the block
     def self.draw_on(win) end
 
   end
@@ -26,7 +26,7 @@ module Wx
     # @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
+    # @return [::Object] result of the block
     def self.draw_on(win) end
 
   end

data/lib/wx/doc/clipboard.rb

@@ -14,7 +14,7 @@ module Wx
 
     # Opens the global clipboard and passes the clipboard object to the block.
     # @yieldparam [Wx::Clipboard] clip the global clipboard object
-    # @return [Object] block result
+    # @return [::Object] block result
     def self.open; end
 
   end

data/lib/wx/doc/colour.rb

@@ -0,0 +1,12 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
+
+module Wx
+
+  TRANSPARENT_COLOUR = Wx::Colour.new(0, 0, 0, Wx::ALPHA_TRANSPARENT)
+
+end

data/lib/wx/doc/const.rb

@@ -71,8 +71,14 @@ module Wx
   TREE_LIST_CTRL_NAME_STR = 'wxTreeListCtrl'
   HTML_LIST_BOX_NAME_STR = 'htmlListBox'
   SIMPLE_HTML_LIST_BOX_NAME_STR = 'simpleHtmlListBox'
+  HTML_WINDOW_NAME_STR = 'htmlWindow'
   EDITABLE_LIST_BOX_NAME_STR = 'editableListBox'
   V_LIST_BOX_NAME_STR = 'wxVListBox'
+  ACTIVITY_INDICATOR_NAME_STR = 'activityindicator'
+  TIME_PICKER_CTRL_NAME_STR = 'timectrl'
+  DATE_PICKER_CTRL_NAME_STR = 'datectrl'
+  CALENDAR_NAME_STR = 'CalendarCtrl'
+  SPIN_BUTTON_NAME_STR = 'wxSpinButton'
 
   # wxMSW only
   MSW_HEADER_CTRL_NAME_STR = 'wxMSWHeaderCtrl'
@@ -81,4 +87,14 @@ module Wx
   PROPERTY_GRID_NAME_STR = 'wxPropertyGrid'
   STC_NAME_STR = 'stcwindow'
 
+  MEDIA_CTRL_NAME_STR = 'mediaCtrl'
+  SPIN_CTRL_NAME_STR = 'spinCtrl'
+  SPIN_CTRL_DOUBLE_NAME_STR = 'wxSpinCtrlDouble'
+  SPLITTER_WINDOW_NAME_STR = 'splitter'
+  TOOLBOOK_NAME_STR = 'toolbook'
+  TREEBOOK_NAME_STR = 'treebook'
+  SASH_WINDOW_NAME_STR = 'sashWindow'
+  SASH_LAYOUT_WINDOW_NAME_STR = 'layoutWindow'
+  SCROLLED_NAME_STR = 'SCROLLED_WINDOW'
+
 end

data/lib/wx/doc/cursor.rb

@@ -7,6 +7,8 @@
 
 class Wx
 
+  # @!group Art creation methods
+
   # Searches for an art file with basename 'name' and creates a Cursor if found.
   # Raises an ArgumentError if not found.
   # Wx::ArtLocator::find_art is used to look up the art file using ::Kernel#caller_locations to
@@ -21,4 +23,6 @@ class Wx
   # @see Wx::ArtLocator::find_art
   def self.Cursor(name, bmp_type = nil, art_path: nil, art_section: nil); end
 
+  # @!endgroup
+
 end

data/lib/wx/doc/dc_overlay.rb

@@ -0,0 +1,34 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
+
+module Wx
+
+  class DCOverlay < Wx::DC
+
+    private :initialize
+
+    # Connects this overlay to the corresponding drawing dc. If the overlay is not initialized yet, this call will do so.
+    # Creates a Wx::DCOverlay instance for to do that and passes the instance to the given block to use.
+    # Uses either the entire area of the drawing DC or the area specified.
+    # @overload draw_on(overlay, dc)
+    #   @param [Wx::Overlay] overlay Overlay to connect
+    #   @param [Wx::DC] dc Drawing DC
+    #   @yieldparam [Wx::DCOverlay] ovl_dc DCOverlay instance to use
+    #   @return [::Object] result from block
+    # @overload draw_on(overlay, dc, x, y, width, height)
+    #   @param [Wx::Overlay] overlay Overlay to connect
+    #   @param [Wx::DC] dc Drawing DC
+    #   @param [Integer] x  topleft x coordinate of area to use
+    #   @param [Integer] y  topleft y coordinate of area to use
+    #   @param [Integer] width  width of area to use
+    #   @param [Integer] height height of area to use
+    #   @yieldparam [Wx::DCOverlay] ovl_dc DCOverlay instance to use
+    #   @return [::Object] result from block
+    def self.draw_on(*arg) end
+  end
+
+end

data/lib/wx/doc/enum.rb

@@ -37,7 +37,7 @@ module Wx
     def method_missing(sym, *args) end
 
     # Checks type and value equality.
-    # @param [Object] o the object to compare
+    # @param [::Object] o the object to compare
     # @return [true,false] true if o is instance of same enum class as self **and** integer values are equal; false otherwise
     def eql?(o) end
 
@@ -94,6 +94,12 @@ module Wx
     def to_int; end
     alias :to_i :to_int
 
+    # Return string representation of enum value (mask).
+    # In case the enum value matches a single enumerator value of the enum class the (scoped) name
+    # of that enumerator is returned otherwise the enum mask value is analyzed and a string representation
+    # of a bitwise **or** expression is returned matching the mask.
+    def to_s; end
+
     # Create a new class and associated enum values.
     # @param [String,Symbol] name name of new enum class
     # @param [Hash] enum_values hash with enum value name and enum integer value pairs

data/lib/wx/doc/event_blocker.rb

@@ -22,7 +22,7 @@ module Wx
       # @param [Wx::Window] win the window to block events for
       # @param [Integer] evt_type the event type to block
       # @yieldparam [Wx::EventBlocker] blkr the blocker object
-      # @return [Object] the value returned by the block
+      # @return [::Object] the value returned by the block
       def blocked_for(win, evt_type=Wx::EVT_ANY) end
       alias :block_for :blocked_for
 

data/lib/wx/doc/evthandler.rb

@@ -29,9 +29,31 @@ module Wx
     # @return [Integer] unique event type id
     def self.register_class(klass, konstant = nil, meth = nil, arity = nil) end
 
-    def connect(first_id, last_id, evt_type, handler) end
-
-    def disconnect(first_id, last_id, evt_spec) end
+    # Connects the given event handler dynamically for id(s) and event type.
+    #
+    # This is the core event connecting method.
+    # In Ruby using named event connector methods like {Wx::EvtHandler#evt_menu} is highly recommended as using #connect
+    # does not provide any better options (less even) than using named event connectors as all event connecting is dynamic.
+    #
+    # @param [Integer] first_id The first ID of the identifier range to be associated with the event handler. Should be Wx::ANY_ID for events that do not require identifiers.
+    # @param [Integer] last_id The last ID of the identifier range to be associated with the event handler. Should be Wx::ANY_ID for events requiring a single identifier (like {Wx::MenuEvt}).
+    # @param [Integer] evt_id The event type identifier like {Wx::EVT_MENU}.
+    # @param [Proc,Method] handler The event handler proc or method.
+    # @return [Boolean] Always returns true.
+    def connect(first_id, last_id, evt_id, handler) end
+
+    # Disconnects any event handler connected for the specified id(s) and event type.
+    #
+    # Looks up connected event handler(s) using the specified parameters as search criteria and returning true if (a)
+    # matching handler(s) has(have) been found and removed.
+    #
+    # @note Note that in wxRuby it is not possible to remove a specific handler if multiple (chained) handler(s) have been connected.
+    #
+    # @param [Integer] first_id The first ID of the identifier range associated with the event handler. Should be Wx::ANY_ID for events that have no associated identifiers.
+    # @param [Integer] last_id The last ID of the identifier range associated with the event handler. Should be Wx::ANY_ID for events that have a single identifier associated.
+    # @param [Integer,Symbol,nil] evt_id The event type identifier like {Wx::EVT_MENU} or event connector symbol (like `:evt_menu`).
+    # @return [Boolean] Returns true if any event handler found and removed, false otherwise.
+    def disconnect(first_id, last_id, evt_id) end
 
     # Processes an event, searching event tables and calling zero or more suitable event handler function(s).
     #

data/lib/wx/doc/functions.rb

@@ -102,15 +102,14 @@ module Wx
 
   # @!endgroup
 
-  # @!group Other class methods
-
   # Returns the global app object
-  # @return [Wx::App] the global app object
+  # Returns nil if no app instance is active.
+  # @return [Wx::App,nil] the global app object
   def self.get_app; end
 
   # Returns the pointer address of the underlying C++ object as a hex
   # string - useful for debugging
-  # @param obj [Object] wrapped object
+  # @param obj [::Object] wrapped object
   # @return [String] string with address in hex format
   def self.ptr_addr(obj) end
 
@@ -124,8 +123,6 @@ module Wx
   def self.bell; end
   def self.safe_yield(win = nil, only_if_needed = false) end
 
-  # @!endgroup
-
   # @!group System information
   
   # @return [String]

data/lib/wx/doc/gc_dc.rb

@@ -13,20 +13,29 @@ module Wx
 
     # Creates a Wx::GCDC instance for target and
     # passes the instance to the given block to draw on.
+    # @overload draw_on()
+    #   @yieldparam [Wx::GCDC] dc GCDC instance to draw on
+    #   @return [::Object] result from block
     # @overload draw_on(dc)
     #   @param [Wx::WindowDC,Wx::MemoryDC] target DC to draw on
     #   @yieldparam [Wx::GCDC] dc GCDC instance to draw on
-    #   @return [Object] result from block
+    #   @return [::Object] result from block
     # @overload draw_on(dc)
     #   @param [Wx::PrinterDC] target DC to draw on
     #   @yieldparam [Wx::GCDC] dc GCDC instance to draw on
-    #   @return [Object] result from block
+    #   @return [::Object] result from block
     #   @wxrb_require USE_PRINTING_ARCHITECTURE,WXMSW|WXOSX|USE_GTKPRINT
     # @overload draw_on(gc)
+    #   Note that the context will continue using the same font, pen and brush as before until #set_font, #set_pen
+    #   or #set_brush is explicitly called to change them. This means that the code can use this wxDC-derived object
+    #   to work using pens and brushes with alpha component, for example (which normally isn't supported by Wx::DC API),
+    #   but it also means that the return values of #get_font, #get_pen and #get_brush won't really correspond to the
+    #   actually used objects because they simply can't represent them anyhow. If you wish to avoid such discrepancy,
+    #   you need to call the setter methods to bring Wx::DC and Wx::GraphicsContext font, pen and brush in sync with each other.
     #   @param [Wx::GraphicsContext] gc GraphicsContext to draw on
     #   @yieldparam [Wx::GCDC] dc GCDC instance to draw on
-    #   @return [Object] result from block
-    def self.draw_on(arg) end
+    #   @return [::Object] result from block
+    def self.draw_on(*arg) end
   end
 
 end

data/lib/wx/doc/geometry.rb

@@ -0,0 +1,136 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+
+
+###
+# wxRuby3 2D geometry classes
+###
+# :startdoc:
+
+
+module Wx
+
+  # Convert degrees to radians.
+  # @param [Float] deg degrees
+  # @return [Float] radians
+  def self.deg_to_rad(deg) end
+
+  # Convert radians to degrees.
+  # @param [Float] rad radians
+  # @return [Float] degrees
+  def self.rad_to_deg(rad) end
+
+  class Point2DInt
+
+    # @return [Integer]
+    def get_x; end
+    alias :x :get_x
+    # @param [Integer] v
+    # @return [Integer]
+    def set_x(v) end
+    alias :x= :set_x
+
+    # @return [Integer]
+    def get_y; end
+    alias :y :get_y
+    # @param [Integer] v
+    # @return [Integer]
+    def set_y(v) end
+    alias :y= :set_y
+
+    # @param [Wx::Point2DInt] pt
+    # @return [self]
+    def assign(pt) end
+
+    # @param [Wx::Point2DInt] pt
+    # @return [self]
+    def add!(pt) end
+
+    # @param [Wx::Point2DInt] pt
+    # @return [self]
+    def sub!(pt) end
+
+    # @param [Wx::Point2DInt,Integer,Float] v
+    # @return [self]
+    def mul!(v) end
+
+    # @param [Wx::Point2DInt,Integer,Float] v
+    # @return [self]
+    def div!(v) end
+
+    # @param [Wx::Point2DInt] pt
+    # @return [Wx::Point2DInt]
+    def +(pt) end
+
+    # @param [Wx::Point2DInt] pt
+    # @return [Wx::Point2DInt]
+    def -(pt) end
+
+    # @param [Wx::Point2DInt,Integer,Float] v
+    # @return [Wx::Point2DInt]
+    def *(v) end
+
+    # @param [Wx::Point2DInt,Integer,Float] v
+    # @return [Wx::Point2DInt]
+    def /(v) end
+
+  end
+
+  class Point2DDouble
+
+    # @return [Integer]
+    def get_x; end
+    alias :x :get_x
+    # @param [Integer] v
+    # @return [Integer]
+    def set_x(v) end
+    alias :x= :set_x
+
+    # @return [Integer]
+    def get_y; end
+    alias :y :get_y
+    # @param [Integer] v
+    # @return [Integer]
+    def set_y(v) end
+    alias :y= :set_y
+
+    # @param [Wx::Point2DInt] pt
+    # @return [self]
+    def assign(pt) end
+
+    # @param [Wx::Point2DDouble] pt
+    # @return [self]
+    def add!(pt) end
+
+    # @param [Wx::Point2DDouble] pt
+    # @return [self]
+    def sub!(pt) end
+
+    # @param [Wx::Point2DDouble,Integer,Float] v
+    # @return [self]
+    def mul!(v) end
+
+    # @param [Wx::Point2DDouble,Integer,Float] v
+    # @return [self]
+    def div!(v) end
+
+    # @param [Wx::Point2DDouble] pt
+    # @return [Wx::Point2DDouble]
+    def +(pt) end
+
+    # @param [Wx::Point2DDouble] pt
+    # @return [Wx::Point2DDouble]
+    def -(pt) end
+
+    # @param [Wx::Point2DDouble,Integer,Float] v
+    # @return [Wx::Point2DDouble]
+    def *(v) end
+
+    # @param [Wx::Point2DDouble,Integer,Float] v
+    # @return [Wx::Point2DDouble]
+    def /(v) end
+
+  end
+end

data/lib/wx/doc/graphics_context.rb

@@ -14,19 +14,22 @@ module Wx
     #   Deletes the gc object after the block returns.
     #   @see Wx::GraphicsRenderer#create_context
     #   @param window [Wx::Window]
-    #   @return [Wx::GraphicsContext]
+    #   @yieldparam [Wx::GraphicsContext]
+    #   @return [::Object] last result of the given block
     # @overload self.draw_on(windowDC)
     #   Creates a {Wx::GraphicsContext} from a {Wx::WindowDC} and passes that object to the given block.
     #   Deletes the gc object after the block returns.
     #   @see Wx::GraphicsRenderer#create_context
     #   @param windowDC [Wx::WindowDC]
-    #   @return [Wx::GraphicsContext]
+    #   @yieldparam [Wx::GraphicsContext]
+    #   @return [::Object] last result of the given block
     # @overload self.draw_on(memoryDC)
     #   Creates a {Wx::GraphicsContext} from a {Wx::MemoryDC} and passes that object to the given block.
     #   Deletes the gc object after the block returns.
     #   @see Wx::GraphicsRenderer#create_context
     #   @param memoryDC [Wx::MemoryDC]
-    #   @return [Wx::GraphicsContext]
+    #   @yieldparam [Wx::GraphicsContext]
+    #   @return [::Object] last result of the given block
     # @overload self.draw_on(printerDC)
     #   Creates a {Wx::GraphicsContext} from a {Wx::PrinterDC} and passes that object to the given block.
     #   Deletes the gc object after the block returns.
@@ -34,18 +37,21 @@ module Wx
     #   @see Wx::GraphicsRenderer#create_context
     #   @see  Printing Under Unix (GTK+)
     #   @param printerDC [Wx::PrinterDC]
-    #   @return [Wx::GraphicsContext]
+    #   @yieldparam [Wx::GraphicsContext]
+    #   @return [::Object] last result of the given block
     #   @wxrb_require USE_PRINTING_ARCHITECTURE,WXMSW|WXOSX|USE_GTKPRINT
     # @overload self.draw_on(image)
     #   Creates a {Wx::GraphicsContext} associated with a {Wx::Image} and passes that object to the given block.
     #   Deletes the gc object after the block returns.
     #   The image specifies the size of the context as well as whether alpha is supported (if {Wx::Image#has_alpha}) or not and the initial contents of the context. The image object must have a life time greater than that of the new context as the context copies its contents back to the image when it is destroyed.
     #   @param image [Wx::Image]
-    #   @return [Wx::GraphicsContext]
+    #   @yieldparam [Wx::GraphicsContext]
+    #   @return [::Object] last result of the given block
     # @overload self.draw_on()
     #   Create a lightweight context that can be used only for measuring text and passes that object to the given block.
     #   Deletes the gc object after the block returns.
-    #   @return [Wx::GraphicsContext]
+    #   @yieldparam [Wx::GraphicsContext]
+    #   @return [::Object] last result of the given block
     def self.draw_on(*args) end
 
   end
@@ -56,7 +62,19 @@ module Wx
     # @param col [Wx::Colour]  The colour of this stop. Note that the alpha component of the colour is honoured thus allowing the background colours to partially show through the gradient.
     # @param pos [Float]  The stop position, must be in [0, 1] range with 0 being the beginning and 1 the end of the gradient.
     # @return [Wx::GraphicsGradientStop]
-    def initialize(col=Wx::TransparentColour, pos=0.0) end
+    def initialize(col=Wx::TRANSPARENT_COLOUR, pos=0.0) end
+
+  end
+
+  class GraphicsPenInfo
+
+    # @param dashes [Array<Integer>]
+    # @return [Wx::GraphicsPenInfo]
+    def dashes(dashes) end
+
+    # @return [Array<Integer>]
+    def get_dashes; end
+    alias_method :dashes, :get_dashes
 
   end
 

data/lib/wx/doc/icon.rb

@@ -7,6 +7,8 @@
 
 class Wx
 
+  # @!group Art creation methods
+
   # Searches for an art file with basename 'name' and creates an Icon if found.
   # Raises an ArgumentError if not found.
   # Wx::ArtLocator::find_art is used to look up the art file using ::Kernel#caller_locations to
@@ -23,4 +25,6 @@ class Wx
   # @see Wx::ArtLocator::find_art
   def self.Icon(name, bmp_type = nil, desired_width=-1, desired_height=-1, art_path: nil, art_section: nil); end
 
+  # @!endgroup
+
 end