wxruby3 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4bac7565182a0ae6badaee56d7b323459bdc2b198281a50639fafd6fcb2d2499
-  data.tar.gz: 5dc08857adaf213871ec7fce09117bac4cc19f00cac50638de552dc2219ea803
+  metadata.gz: ed10da8feaf6d3e77a775f3386dd9970314810239e7e4ce1c2c447658f6f4106
+  data.tar.gz: 125e2ddedb7148987456508b887dacae1262753a408cd39503faff80fe6435cc
 SHA512:
-  metadata.gz: cbd4920bcc8ae2085ed85b49ee218642c1eb8a58c6bae7132fd653f479e5af6a60c716f61a9ad38bfdcc5cdc1e3560eb4152365127414bf0c401f266b39228c9
-  data.tar.gz: 60bba874185fe173a83d8878e458721a3f3fe58cbf484be2826c100a6009dff062972af7ecbaa9bc7dd3095d100aafdf326ac2dd994e1e50e7939654673d2466
+  metadata.gz: dbe29edc61e3c139efec7d90d5f80b17b3671c141f3f6f3421905320de87b2900e90785bd83550e6b9d502bb184bef4a58c5061c7271629dc5f83d4c2f55ac94
+  data.tar.gz: 2b420414ee1c4b8eefa3fa797c5452e8490048876bfe2172fa14f8ffdd4937c907a4714c6af1650768e91cab08f4746881b5c19989bf66778f4ed4a1d2506020

data/ext/wxruby3/swig/custom/director.swg

@@ -147,20 +147,14 @@ namespace Swig {
 
     DirectorTypeMismatchException(VALUE self, const char *method, VALUE error, const char *msg="");
 
-    static inline void raise(VALUE error, const char *msg)
-    {
-      throw DirectorTypeMismatchException(error, msg);
-    }
+    static void raise(VALUE error, const char *msg);
 
-    static inline void raise(const char *msg)
-    {
-      throw DirectorTypeMismatchException(msg);
-    }
+    static void raise(const char *msg);
 
-    static inline void raise(VALUE self, const char* method, VALUE error, const char *msg)
-    {
-      throw DirectorTypeMismatchException(self, method, error, msg);
-    }
+    static void raise(VALUE self, const char* method, VALUE error, const char *msg);
+
+  private:
+    static void print(const DirectorTypeMismatchException& ex);
   };
 
   /* Any Ruby exception that occurs during a director method call */
@@ -195,14 +189,6 @@ namespace Swig {
     }
   };
 
-  /* wxRuby customization */
-  class WXRUBY_EXPORT DirectorRubyException : public DirectorException
-  {
-  public:
-    DirectorRubyException(VALUE error, VALUE rcvr, ID fn_id);
-
-  };
-
   /* Simple thread abstraction for pthreads on win32 */
 #ifdef __THREAD__
 # define __PTHREAD__

data/lib/wx/core/animation.rb

@@ -6,21 +6,42 @@
 # Copyright 2004-2007, wxRuby development team
 # released under the MIT-like wxRuby2 license
 
-class Wx::Animation
-  # Redefine the initialize method so it raises an exception if a
-  # non-existent file is given to the constructor; otherwise, wx Widgets
-  # just carries on with an empty bitmap, which may cause faults later
-  wx_init = self.instance_method(:initialize)
-  define_method(:initialize) do | *args |
-    if args[0].kind_of? String
-      if not File.exist?( File.expand_path(args[0]) )
-        Kernel.raise( ArgumentError, 
-                      "Animation file does not exist: #{args[0]}" )
+module Wx
+
+  class Animation
+    # Redefine the initialize method so it raises an exception if a
+    # non-existent file is given to the constructor; otherwise, wx Widgets
+    # just carries on with an empty bitmap, which may cause faults later
+    wx_init = self.instance_method(:initialize)
+    define_method(:initialize) do | *args |
+      if args[0].kind_of? String
+        if not File.exist?( File.expand_path(args[0]) )
+          Kernel.raise( ArgumentError,
+                        "Animation file does not exist: #{args[0]}" )
+        end
+        res = wx_init.bind(self).call()
+        res.load_file(args[0], args[1] || Wx::ANIMATION_TYPE_ANY)
+      else
+        wx_init.bind(self).call(*args)
+      end
+    end
+  end
+
+  if Wx::WXWIDGETS_VERSION >= '3.3.0'
+
+    class AnimationCtrl
+
+      # Redefine this method to accept either a single animation or an animation bundle
+      wx_set_animation = self.instance_method(:set_animation)
+      define_method(:set_animation) do | arg |
+        if Wx::Animation === arg
+          arg = Wx::AnimationBundle.new(arg)
+        end
+        wx_set_animation.bind(self).call(arg)
       end
-      res = wx_init.bind(self).call()
-      res.load_file(args[0], args[1] || Wx::ANIMATION_TYPE_ANY)
-    else
-      wx_init.bind(self).call(*args)
+
     end
+
   end
+
 end

data/lib/wx/core/choicedlg.rb

@@ -14,9 +14,8 @@ module Wx
                              choices,
                              parent = nil,
                              initial_selection: 0,
-                             x:  Wx::DEFAULT_COORD,
-                             y:  Wx::DEFAULT_COORD)
-    dialog = Wx::SingleChoiceDialog.new(parent, message, caption, choices, nil, Wx::CHOICEDLG_STYLE, [x, y])
+                             pos:  Wx::DEFAULT_POSITION)
+    dialog = Wx::SingleChoiceDialog.new(parent, message, caption, choices, Wx::CHOICEDLG_STYLE, pos)
 
     dialog.selection = initial_selection
     return dialog.show_modal == Wx::ID_OK ? dialog.get_string_selection : ''
@@ -28,9 +27,8 @@ module Wx
                                    choices,
                                    parent = nil,
                                    initial_selection: 0,
-                                   x:  Wx::DEFAULT_COORD,
-                                   y:  Wx::DEFAULT_COORD)
-    dialog = Wx::SingleChoiceDialog.new(parent, message, caption, choices, nil, Wx::CHOICEDLG_STYLE, [x, y])
+                                   pos:  Wx::DEFAULT_POSITION)
+    dialog = Wx::SingleChoiceDialog.new(parent, message, caption, choices, Wx::CHOICEDLG_STYLE, pos)
 
     dialog.selection = initial_selection
     return dialog.show_modal == Wx::ID_OK ? dialog.get_selection : -1
@@ -43,16 +41,15 @@ module Wx
                                 choices,
                                 parent = nil,
                                 initial_selections: [],
-                                x:  Wx::DEFAULT_COORD,
-                                y:  Wx::DEFAULT_COORD)
-    dialog = Wx::MultiChoiceDialog.new(parent, message, caption, choices, Wx::CHOICEDLG_STYLE, [x, y])
+                                pos:  Wx::DEFAULT_POSITION)
+    dialog = Wx::MultiChoiceDialog.new(parent, message, caption, choices, Wx::CHOICEDLG_STYLE, pos)
 
     # call this even if selections array is empty and this then (correctly)
     # deselects the first item which is selected by default
     dialog.selections = initial_selections
 
     if dialog.show_modal != Wx::ID_OK
-      return []
+      return nil
     end
 
     dialog.get_selections

data/lib/wx/core/colour.rb

@@ -45,6 +45,16 @@ module Wx
     def to_s
       "#<Wx::Colour: (#{red}, #{green}, #{blue} *#{alpha})>"
     end
+
+    # Copy ctor available.
+    def dup
+      self.class.new(self)
+    end
+
+    def clone
+      dup
+    end
+
   end
 
 end

data/lib/wx/core/dialog.rb

@@ -25,8 +25,8 @@ class Wx::Dialog
       scope = klass.name.split('::')
       functor_nm = scope.pop
       code = <<~__CODE
-        def #{functor_nm}(*args, &block)
-          dlg = #{klass.name}.new(*args)
+        def #{functor_nm}(*args, **kwargs, &block)
+          dlg = #{klass.name}.new(*args, **kwargs)
           begin
             if block_given?
               return block.call(dlg)

data/lib/wx/core/enum.rb

@@ -8,6 +8,23 @@
 
 class Wx::Enum
 
+  class << self
+
+    def enumerators
+      self.constants(false).inject({}) do |tbl, cn|
+        cv = self.const_get(cn)
+        tbl[cv.to_i] = cn if self === cv
+        tbl
+      end
+    end
+
+    def [](enum_name)
+      return self.const_get(enum_name) if self.const_defined?(enum_name)
+      nil
+    end
+
+  end
+
   def |(other)
     if other.instance_of?(self.class)
       self.class.new(to_i | other.to_i)
@@ -52,10 +69,10 @@ class Wx::Enum
     return '' if to_i == 0
     enums = []
     mask = to_i
-    self.class.values.each_value do |enum|
-      if enum != 0 && mask.allbits?(enum)
-        enums << enum.to_s
-        mask &= ~enum
+    self.class.enumerators.each_pair do |eval, ename|
+      if eval != 0 && mask.allbits?(eval)
+        enums << ename
+        mask &= ~eval
         break if mask == 0
       end
     end
@@ -65,7 +82,7 @@ class Wx::Enum
   private :bitmask_to_s
 
   def to_s
-    self.class.values.has_key?(to_i) ? "#{self.class.name}::#{self.class.names_by_value[self]}" : bitmask_to_s
+    self.class.enumerators.has_key?(to_i) ? "#{self.class.name}::#{self.class.enumerators[to_i]}" : bitmask_to_s
   end
 
 end

data/lib/wx/core/event.rb

@@ -58,4 +58,11 @@ module Wx
     Wx::EVT_NC_PAINT,
     Wx::NcPaintEvent
   ]
+  if Wx.const_defined?(:EVT_HOTKEY)
+    EvtHandler.register_event_type EvtHandler::EventType[
+                                     'evt_hotkey', 1,
+                                     Wx::EVT_HOTKEY,
+                                     Wx::KeyEvent
+                                   ]
+  end
 end

data/lib/wx/core/file_dialog.rb

@@ -20,4 +20,29 @@ module Wx
 
   end
 
+  class FileDialogCustomizeHook
+
+    # prevent construction of abstract base
+    if RUBY_VERSION < '2.7.0'
+      def self.new(*)
+        raise NotImplementedError, 'Wx::FileDialogCustomizeHook is an abstract class.' if self == Wx::FileDialogCustomizeHook
+        super
+      end
+    else
+      def self.new(*, **)
+        raise NotImplementedError, 'Wx::FileDialogCustomizeHook is an abstract class.' if self == Wx::FileDialogCustomizeHook
+        super
+      end
+    end
+
+    # provide default no-ops
+
+    def add_custom_controls(customizer) end
+
+    def update_custom_controls; end
+
+    def transfer_data_from_custom_controls; end
+
+  end
+
 end

data/lib/wx/core/functions.rb

@@ -13,20 +13,14 @@ module Wx
     # Allow this to be called with keyword parameters, and avoid
     # segfaults on OS X with bad params
     wx_about_box = self.instance_method(:about_box)
-    define_method(:about_box) do | info |
-      # If AboutDialogInfo has no version, it segfaults on OS X 10.5
-      no_version = ArgumentError.new("Must supply a version for AboutDialog")
+    define_method(:about_box) do | info, parent=nil |
       case info
       when Wx::AboutDialogInfo
-        unless info.has_version
-          Kernel.raise no_version 
-        end
-
         ab_info = info
       when Hash
         ab_info = Wx::AboutDialogInfo.new
         ab_info.name    = info[:name] || 'wxRuby application'
-        ab_info.version = info[:version] || Kernel.raise(no_version)
+        ab_info.version = info[:version] if info[:version]
         
         ab_info.description = info[:description] || ''
         ab_info.copyright   = info[:copyright] || ''
@@ -36,7 +30,7 @@ module Wx
         ab_info.artists     = info[:artists] || []
         ab_info.translators = info[:translators] || []
         if info.key?(:website)
-          ab_info.set_website(*info[:website])
+          ab_info.set_web_site(*info[:website])
         end
         if info.key?(:icon)
           ab_info.icon = info[:icon]
@@ -46,7 +40,7 @@ module Wx
         Kernel.raise ArgumentError,
                      "Can't use #{info.inspect} for AboutDialogInfo"
       end
-      wx_about_box.bind(self).call(ab_info)
+      wx_about_box.bind(self).call(ab_info, parent)
     end
   end
 end

data/lib/wx/core/gdi_object.rb

@@ -0,0 +1,24 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+#
+# Some parts are
+# Copyright 2004-2007, wxRuby development team
+# released under the MIT-like wxRuby2 license
+
+module Wx
+
+  class GDIObject < Object
+
+    # GDIObjects have safe, working (and relatively cheap) copy ctors.
+    def dup
+      self.class.new(self)
+    end
+
+    def clone
+      dup
+    end
+
+  end
+
+end

data/lib/wx/core/object.rb

@@ -8,16 +8,31 @@
 
 # The root class for most (not all) WxRuby classes
 
-class Wx::Object
-  # Massage the output of inspect to show the public module name (Wx),
-  # instead of the internal name (Wxruby2)
-  # def to_s
-  #   super.sub('ruby2', '')
-  # end
-
-  # Returns a string containing the C++ pointer address of this
-  # object. Only useful for debugging.
-  def ptr_addr
-    Wx::ptr_addr(self)
+module Wx
+
+  class Object
+    # Massage the output of inspect to show the public module name (Wx),
+    # instead of the internal name (Wxruby2)
+    # def to_s
+    #   super.sub('ruby2', '')
+    # end
+
+    # Returns a string containing the C++ pointer address of this
+    # object. Only useful for debugging.
+    def ptr_addr
+      Wx::ptr_addr(self)
+    end
+
+    # By default Wx:::Object derived class instances cannot be #dup-licated.
+    def dup
+      nil
+    end
+
+    # By default Wx::Object derived class instances cannot be cloned but instead return self.
+    def clone
+      self
+    end
+
   end
+
 end

data/lib/wx/core/variant.rb

@@ -8,62 +8,119 @@
 
 require 'date'
 
-class Wx::Variant
-  include ::Enumerable
+module Wx
 
-  # add a proper enumerator method
-  def each
-    if block_given?
-      get_count.times { |i| yield self[i] }
-    else
-      ::Enumerator.new { |y| get_count.times { |i| y << self[i] } }
+  class Variant
+    include ::Enumerable
+
+    # add a proper enumerator method
+    def each
+      if block_given?
+        get_count.times { |i| yield self[i] }
+      else
+        ::Enumerator.new { |y| get_count.times { |i| y << self[i] } }
+      end
     end
-  end
 
-  # make assign return self and add it's handy alias
-  wx_assign = instance_method :assign
-  define_method :assign do |v|
-    wx_assign.bind(self).call(v)
-    self
-  end
-  alias :<< :assign
-
-  # extend to_s to arraylist and list (easier in pure Ruby)
-
-  wx_to_s = instance_method :to_s
-  define_method :to_s do
-    unless null?
-      case type
-      when 'list'
-        return "[#{each.collect { |v| v.string? ? %Q{"#{v.to_s}"} : v.to_s }.join(', ')}]"
-      when 'arrstring'
-        return array_string.to_s
-      when 'wxFont'
-        return font.to_s
-      when 'wxColour'
-        return colour.to_s
-      when 'wxColourPropertyValue'
-        return colour_property_value.to_s
+    # make assign return self and add it's handy alias
+    wx_assign = instance_method :assign
+    define_method :assign do |v|
+      wx_assign.bind(self).call(v)
+      self
+    end
+    alias :<< :assign
+
+    # extend to_s to arraylist and list (easier in pure Ruby)
+
+    wx_to_s = instance_method :to_s
+    define_method :to_s do
+      unless null?
+        case type
+        when 'list'
+          return "[#{each.collect { |v| v.string? ? %Q{"#{v.to_s}"} : v.to_s }.join(', ')}]"
+        when 'arrstring'
+          return array_string.to_s
+        when 'wxFont'
+          return font.to_s
+        when 'wxColour'
+          return colour.to_s
+        when 'wxColourPropertyValue'
+          return colour_property_value.to_s
+        end
       end
+      wx_to_s.bind(self).call
+    end
+
+    # extend with more Ruby-like type checking
+
+    def string?
+      !null? && is_type('string');
+    end
+
+    def bool?
+      !null? && is_type('bool');
+    end
+
+    def long?
+      !null? && is_type('long');
+    end
+
+    def long_long?
+      !null? && is_type('longlong');
+    end
+
+    def u_long_long?
+      !null? && is_type('ulonglong');
+    end
+
+    def integer?
+      !null? && (long? || long_long? || u_long_long?);
+    end
+
+    def date_time?
+      !null? && is_type('datetime');
     end
-    wx_to_s.bind(self).call
+
+    def double?
+      !null? && is_type('double');
+    end
+
+    def numeric?
+      !null? && (integer? || double?);
+    end
+
+    def list?
+      !null? && is_type('list');
+    end
+
+    def array_string?
+      !null? && is_type('arrstring');
+    end
+
+    def font?
+      !null? && is_type('wxFont');
+    end
+
+    def colour?
+      !null? && is_type('wxColour');
+    end
+
+    def colour_property_value?
+      !null? && is_type('wxColourPropertyValue');
+    end
+
+    def object?(klass = Object)
+      !null? && is_type('WXRB_VALUE') && klass === object;
+    end
+
+    def dup
+      self.class.new(self)
+    end
+
+    def clone
+      dup
+    end
+
   end
 
-  # extend with more Ruby-like type checking
-
-  def string?; !null? && is_type('string'); end
-  def bool?; !null? && is_type('bool'); end
-  def long?; !null? && is_type('long'); end
-  def long_long?; !null? && is_type('longlong'); end
-  def u_long_long?; !null? && is_type('ulonglong'); end
-  def integer?; !null? && (long? || long_long? || u_long_long?); end
-  def date_time?; !null? && is_type('datetime'); end
-  def double?; !null? && is_type('double'); end
-  def numeric?; !null? && (integer? || double?); end
-  def list?; !null? && is_type('list'); end
-  def array_string?; !null? && is_type('arrstring'); end
-  def font?; !null? && is_type('wxFont'); end
-  def colour?; !null? && is_type('wxColour'); end
-  def colour_property_value?; !null? && is_type('wxColourPropertyValue'); end
-  def object?(klass=Object) !null? && is_type('WXRB_VALUE') && klass === object; end
 end

data/lib/wx/doc/animation_ctrl.rb

@@ -0,0 +1,18 @@
+# :stopdoc:
+# This file is automatically generated by the WXRuby3 documentation
+# generator. Do not alter this file.
+# :startdoc:
+
+
+module Wx
+
+  class GenericAnimationCtrl < AnimationCtrl
+
+    # This override of {Wx::AnimationCtrl#play} lets you specify if the animation must loop or not.
+    # @param looped [Boolean] default true
+    # @return [Boolean]
+    def play(looped = true) end
+
+  end
+
+end

data/lib/wx/doc/colour.rb

@@ -9,4 +9,16 @@ module Wx
 
   TRANSPARENT_COLOUR = Wx::Colour.new(0, 0, 0, Wx::ALPHA_TRANSPARENT)
 
+  class Colour < Object
+
+    # Returns a copy-constructed Colour object.
+    # @return [Wx::Colour] the duplicated Colour object
+    def dup; end
+
+    # Calls #dup.
+    # @return [Wx::Colour]
+    def clone; end
+
+  end
+
 end

data/lib/wx/doc/enum.rb

@@ -100,17 +100,6 @@ module Wx
     # 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
-    # @return [Class] new enum class
-    def self.create(name, enum_values) end
-
-    # Returns enum class matching name or nil.
-    # @param [String,Symbol] name name of enum class
-    # @return [Class,nil] enum class
-    def self.[](name) end
-
   end
 
 end

data/lib/wx/doc/evthandler.rb

@@ -142,6 +142,12 @@ module Wx
     # @yield [*args] optional arguments
     def call_after(meth = nil, *args, &block) end
 
+    # Process a {Wx::EVT_HOTKEY} event.
+    # @param [Integer] id hotkey id
+    # @param [String,Symbol,Method,Proc] meth (name of) method or handler proc
+    # @yieldparam [Wx::KeyEvent] event the event to handle
+    def evt_hotkey(id, meth = nil, &block) end
+
   end
 
 end

data/lib/wx/doc/functions.rb

@@ -158,9 +158,41 @@ module Wx
   # @!group Dialog shortcuts
 
   # @return [Array<Integer>] Selected choices
-  def self.get_selected_choices(message, caption, choices,
-                                parent = nil, x = Wx::DEFAULT_COORD, y = Wx::DEFAULT_COORD,
-                                centre = true, width = Wx::CHOICE_WIDTH, height = Wx::CHOICE_HEIGHT) end
+
+  # Get the user selection as a string.
+  # @param [String] message
+  # @param [String] caption
+  # @param [Array<String>] choices choice strings
+  # @param [Wx::Window,nil] parent
+  # @param [Integer] initial_selection initial choice index
+  # @param [Wx::Point,Array(Integer,Integer)] pos
+  # @return [String] selected choice or '' if cancelled
+  def self.get_single_choice(message, caption, choices, parent = nil,
+                             initial_selection: 0,
+                             pos:  Wx::DEFAULT_POSITION) end
+
+  # Get the user selection as an index.
+  # @param [String] message
+  # @param [String] caption
+  # @param [Array<String>] choices choice strings
+  # @param [Wx::Window,nil] parent
+  # @param [Integer] initial_selection
+  # @param [Wx::Point,Array(Integer,Integer)] pos
+  # @return [Integer] selected choice index or -1 if cancelled
+  def self.get_single_choice_index(message, caption, choices, parent = nil,
+                                   initial_selection: 0,
+                                   pos:  Wx::DEFAULT_POSITION) end
+
+  # @param [String] message
+  # @param [String] caption
+  # @param [Array<String>] choices choice strings
+  # @param [Wx::Window,nil] parent
+  # @param [Array<Integer>] initial_selections array of initial choice indexes
+  # @param [Wx::Point,Array(Integer,Integer)] pos
+  # @return [Array<Integer>,nil] selected choice indexes (can be empty array if none selected) or nil if cancelled
+  def self.get_selected_choices(message, caption, choices, parent = nil,
+                                initial_selections: [],
+                                pos:  Wx::DEFAULT_POSITION) end
 
   # Pops up a file selector box.
   #