wxruby3 0.9.4-x64-mingw-ucrt → 0.9.7-x64-mingw-ucrt

data/lib/wx/core/combo_ctrl.rb

@@ -0,0 +1,171 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+
+
+module Wx
+
+  module ComboPopup
+
+    def self.included(mod)
+      unless mod == Wx::ComboPopupWx
+        mod.class_eval { include Wx::ComboPopup::Methods }
+      end
+    end
+
+    module Methods
+      # Returns pointer to the associated parent {Wx::ComboCtrl}.
+      # @return [Wx::ComboCtrl]
+      # def get_combo_ctrl; end
+
+      # The including class must implement this to initialize its internal variables.
+      #
+      # This method is called immediately after construction finishes. m_combo member variable has been initialized before the call.
+      # @return [void]
+      def init
+      end
+
+      # The including class may implement this to return true if it wants to delay call to {Wx::ComboPopup#create} until the popup is shown for the first time.
+      #
+      # It is more efficient, but on the other hand it is often more convenient to have the control created immediately.
+      #
+      # <div class="wxrb-remark">
+      # <b>Remark:</b>
+      # <p>Base implementation returns false.
+      # </p>
+      # </div>
+      # @return [Boolean]
+      def lazy_create
+        false
+      end
+
+      # The including class must implement this to create the popup control.
+      #
+      # true if the call succeeded, false otherwise.
+      # @param parent [Wx::Window]
+      # @return [Boolean]
+      def create(parent)
+        false
+      end
+
+      # You only need to implement this member function if you create your popup class in non-standard way.
+      #
+      # The default implementation can handle both multiple-inherited popup control (as seen in {Wx::ComboCtrl} samples) and one allocated separately in heap.
+      # If you do completely re-implement this function, make sure it calls Destroy() for the popup control and also deletes this object (usually as the last thing).
+      # @return [void]
+      def destroy_popup
+      end
+
+      # Implement to customize matching of value string to an item container entry.
+      #
+      # <div class="wxrb-remark">
+      # <b>Remark:</b>
+      # <p>Default implementation always return true and does not alter trueItem.
+      # </p>
+      # </div>
+      # @param item [String]  String entered, usually by user or from SetValue() call.
+      # @param trueItem [Boolean] if true the true item string should be returned in case matching but different
+      # @return [Boolean, String] Returns true if a match is found or false if not. If trueItem == true and item matches an entry, but the entry's string representation is not exactly the same (case mismatch, for example), then the true item string should be returned as the match result.
+      def find_item(item, trueItem=false)
+        true
+      end
+
+      # The including class may implement this to return adjusted size for the popup control, according to the variables given.
+      #
+      # <div class="wxrb-remark">
+      # <b>Remark:</b>
+      # <p>This function is called each time popup is about to be shown.
+      # </p>
+      # </div>
+      # @param minWidth [Integer]  Preferred minimum width.
+      # @param prefHeight [Integer]  Preferred height. May be -1 to indicate no preference.
+      # @param maxHeight [Integer]  Max height for window, as limited by screen size.
+      # @return [Wx::Size]
+      def get_adjusted_size(minWidth, prefHeight, maxHeight)
+        Wx::Size.new(minWidth, prefHeight)
+      end
+
+      # The including class must implement this to return pointer to the associated control created in {Wx::ComboPopup#create}.
+      # @return [Wx::Window]
+      def get_control
+      end
+
+      # The including class must implement this to receive string value changes from {Wx::ComboCtrl}.
+      # @param value [String]
+      # @return [void]
+      def set_string_value(value)
+      end
+
+      # The including class must implement this to return string representation of the value.
+      # @return [String]
+      def get_string_value
+        nil
+      end
+
+      # The including class may implement this to do something when the parent {Wx::ComboCtrl} gets double-clicked.
+      # @return [void]
+      def on_combo_double_click
+      end
+
+      # The including class may implement this to receive key down events from the parent {Wx::ComboCtrl}.
+      #
+      # Events not handled should be skipped, as usual.
+      # @param event [Wx::KeyEvent]
+      # @return [void]
+      def on_combo_key_event(event)
+        event.skip
+      end
+
+      # The including class may implement this to receive char events from the parent {Wx::ComboCtrl}.
+      #
+      # Events not handled should be skipped, as usual.
+      # @param event [Wx::KeyEvent]
+      # @return [void]
+      def on_combo_char_event(event)
+        event.skip
+      end
+
+      # The including class may implement this to do special processing when popup is hidden.
+      # @return [void]
+      def on_dismiss
+      end
+
+      # The including class may implement this to do special processing when popup is shown.
+      # @return [void]
+      def on_popup
+      end
+
+      # The including class may implement this to paint the parent {Wx::ComboCtrl}.
+      # This is called to custom paint in the combo control itself (ie. not the popup).
+      #
+      # Default implementation draws value as string.
+      # @param dc [Wx::DC]
+      # @param rect [Wx::Rect]
+      # @return [void]
+      def paint_combo_control(dc, rect)
+        combo = get_combo_ctrl
+        if combo.get_window_style.allbits?(Wx::CB_READONLY) # ie. no textctrl
+          combo.prepare_background(dc, rect,0)
+
+          dc.draw_text(combo.get_value,
+                       rect.x + combo.get_margin_left,
+                       (rect.height-dc.get_char_height)/2 + rect.y)
+        end
+      end
+
+    end
+
+  end
+
+  class ComboPopupWx
+
+    include ComboPopup
+
+    # this method has not been wrapped as a default popup control will always already have been
+    # initialized before returned from #get_combo_control
+    # just do nothing here (or should we raise an exception?)
+    def init; end
+
+  end
+
+end

data/lib/wx/core/ext.rb

@@ -28,18 +28,37 @@ module Wx
       end
     end
 
+    class Value
+      def initialize(code, block)
+        @code = code
+        @block = block
+      end
+
+      def value
+        @block ? @block.call : Kernel.eval(@code || 'nil')
+      end
+
+      def to_s
+        @code || ''
+      end
+    end
+
     def delayed_constants
       @delayed_constants ||= ::Hash.new
     end
 
     public
 
-    def add_delayed_constant(mod, sym, &block)
-      delayed_constants[Key.new(mod,sym)] = block
+    def add_delayed_constant(mod, sym, code='', &block)
+      delayed_constants[Key.new(mod,sym)] = Value.new(code, block)
+    end
+
+    def delayed_constants_for(mod)
+      delayed_constants.select { |k,v| k.mod == mod }
     end
 
     def load_delayed_constants
-      delayed_constants.each_pair { |key, blk| key.mod.const_set(key.sym, blk.call) }
+      delayed_constants.each_pair { |key, val| key.mod.const_set(key.sym, val.value) }
       delayed_constants.clear # cleanup
     end
 

data/lib/wx/doc/comboctrl.rb

@@ -7,11 +7,136 @@
 
 module Wx
 
-  class OwnerDrawnComboBox < ComboCtrl
+  # In order to use a custom popup with {Wx::ComboCtrl}, a class must include {Wx::ComboPopup}.
+  #
+  # For more information on how to use it, see {Wx::ComboCtrl Setting Custom Popup for Wx::ComboCtrl}.
+  module ComboPopup
 
-    alias :get_item_data :get_client_object
+    # Returns pointer to the associated parent {Wx::ComboCtrl}.
+    # @return [Wx::ComboCtrl]
+    def get_combo_ctrl; end
 
-    alias :set_item_data :set_client_object
+    # The including class must implement this to initialize its internal variables.
+    #
+    # This method is called immediately after construction finishes. m_combo member variable has been initialized before the call.
+    # @return [void]
+    def init; end
+
+    # The including class may implement this to return true if it wants to delay call to {Wx::ComboPopup#create} until the popup is shown for the first time.
+    #
+    # It is more efficient, but on the other hand it is often more convenient to have the control created immediately.
+    #
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Base implementation returns false.
+    # </p>
+    # </div>
+    # @return [Boolean]
+    def lazy_create; end
+
+    # The including class must implement this to create the popup control.
+    #
+    # true if the call succeeded, false otherwise.
+    # @param parent [Wx::Window]
+    # @return [Boolean]
+    def create(parent) end
+
+    # You only need to implement this member function if you create your popup class in non-standard way.
+    #
+    # The default implementation can handle both multiple-inherited popup control (as seen in {Wx::ComboCtrl} samples) and one allocated separately in heap.
+    # If you do completely re-implement this function, make sure it calls Destroy() for the popup control and also deletes this object (usually as the last thing).
+    # @return [void]
+    def destroy_popup; end
+
+    # Implement to customize matching of value string to an item container entry.
+    #
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Default implementation always return true and does not alter trueItem.
+    # </p>
+    # </div>
+    # @param item [String]  String entered, usually by user or from SetValue() call.
+    # @param trueItem [Boolean] if true the true item string should be returned in case matching but different
+    # @return [Boolean, String] Returns true if a match is found or false if not. If trueItem == true and item matches an entry, but the entry's string representation is not exactly the same (case mismatch, for example), then the true item string should be returned as the match result.
+    def find_item(item, trueItem=false) end
+
+    # The including class may implement this to return adjusted size for the popup control, according to the variables given.
+    #
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>This function is called each time popup is about to be shown.
+    # </p>
+    # </div>
+    # @param minWidth [Integer]  Preferred minimum width.
+    # @param prefHeight [Integer]  Preferred height. May be -1 to indicate no preference.
+    # @param maxHeight [Integer]  Max height for window, as limited by screen size.
+    # @return [Wx::Size]
+    def get_adjusted_size(minWidth, prefHeight, maxHeight) end
+
+    # The including class must implement this to return pointer to the associated control created in {Wx::ComboPopup#create}.
+    # @return [Wx::Window]
+    def get_control; end
+
+    # The including class must implement this to receive string value changes from {Wx::ComboCtrl}.
+    # @param value [String]
+    # @return [void]
+    def set_string_value(value) end
+
+    # The including class must implement this to return string representation of the value.
+    # @return [String]
+    def get_string_value; end
+
+    # The including class may implement this to do something when the parent {Wx::ComboCtrl} gets double-clicked.
+    # @return [void]
+    def on_combo_double_click; end
+
+    # The including class may implement this to receive key down events from the parent {Wx::ComboCtrl}.
+    #
+    # Events not handled should be skipped, as usual.
+    # @param event [Wx::KeyEvent]
+    # @return [void]
+    def on_combo_key_event(event) end
+
+    # The including class may implement this to receive char events from the parent {Wx::ComboCtrl}.
+    #
+    # Events not handled should be skipped, as usual.
+    # @param event [Wx::KeyEvent]
+    # @return [void]
+    def on_combo_char_event(event) end
+
+    # The including class may implement this to do special processing when popup is hidden.
+    # @return [void]
+    def on_dismiss; end
+
+    # The including class may implement this to do special processing when popup is shown.
+    # @return [void]
+    def on_popup; end
+
+    # The including class may implement this to paint the parent {Wx::ComboCtrl}.
+    # This is called to custom paint in the combo control itself (ie. not the popup).
+    #
+    # Default implementation draws value as string.
+    # @param dc [Wx::DC]
+    # @param rect [Wx::Rect]
+    # @return [void]
+    def paint_combo_control(dc, rect) end
+
+  end
+
+  # A Ruby interface class for default comboctrl popup classes used by {Wx::OwnerDrawnComboBox} and
+  # {Wx::RichTextStyleListBox}.
+  #
+  # If no custom popup control has been installed with {Wx::ComboCtrl#SetPopupControl} an instance of this
+  # class will be returned when {Wx::ComboCtrl#GetPopupControl} is called for either of the widgets mentioned
+  # above.
+  # <div class="wxrb-remark">
+  # <b>Remark:</b>
+  # <p>This is an abstract class that cannot be derived from.
+  # </p>
+  # </div>
+  class ComboPopupWx
+
+    include ComboPopup
 
   end
 

data/lib/wx/doc/gen/about_dialog_info.rb

@@ -336,4 +336,4 @@ module Wx
   end # AboutDialogInfo
   
 
-end
+  end

data/lib/wx/doc/gen/accelerator.rb

@@ -178,4 +178,4 @@ module Wx
   end # AcceleratorTable
   
 
-end
+  end

data/lib/wx/doc/gen/accessible.rb

@@ -819,4 +819,4 @@ module Wx
   end # Accessible
   
 
-end
+  end

data/lib/wx/doc/gen/activity_indicator.rb

@@ -68,4 +68,4 @@ module Wx
   end # ActivityIndicator
   
 
-end
+  end

data/lib/wx/doc/gen/animation.rb

@@ -266,4 +266,4 @@ module Wx
   end # AnimationDecoder
   
 
-end
+  end

data/lib/wx/doc/gen/animation_ctrl.rb

@@ -136,4 +136,4 @@ module Wx
   end # AnimationCtrl
   
 
-end
+  end

data/lib/wx/doc/gen/any_button.rb

@@ -188,4 +188,4 @@ module Wx
   end # AnyButton
   
 
-end
+  end

data/lib/wx/doc/gen/app.rb

@@ -336,4 +336,4 @@ module Wx
   end # App
   
 
-end
+  end

data/lib/wx/doc/gen/app_traits.rb

@@ -107,14 +107,6 @@ module Wx
     # 
     class ResourceCat < Wx::Enum
     
-      # No special category, this is the default.
-      # 
-      ResourceCat_None = Wx::StandardPaths::ResourceCat.new(0)
-      
-      # Message catalog resources category.
-      # 
-      ResourceCat_Messages = Wx::StandardPaths::ResourceCat.new(1)
-      
     end # ResourceCat
     
     # Possible values for userDir parameter of {Wx::StandardPaths#get_user_dir}.
@@ -123,34 +115,6 @@ module Wx
     # 
     class Dir < Wx::Enum
     
-      # Directory for caching files.
-      # 
-      Dir_Cache = Wx::StandardPaths::Dir.new(0)
-      
-      # Directory containing user documents.
-      # 
-      Dir_Documents = Wx::StandardPaths::Dir.new(1)
-      
-      # Directory containing files on the users desktop.
-      # 
-      Dir_Desktop = Wx::StandardPaths::Dir.new(2)
-      
-      # Directory for downloaded files.
-      # 
-      Dir_Downloads = Wx::StandardPaths::Dir.new(3)
-      
-      # Directory containing music files.
-      # 
-      Dir_Music = Wx::StandardPaths::Dir.new(4)
-      
-      # Directory containing picture files.
-      # 
-      Dir_Pictures = Wx::StandardPaths::Dir.new(5)
-      
-      # Directory containing video files.
-      # 
-      Dir_Videos = Wx::StandardPaths::Dir.new(6)
-      
     end # Dir
     
     # Possible values for {Wx::StandardPaths#set_file_layout} argument.
@@ -159,14 +123,6 @@ module Wx
     # 
     class FileLayout < Wx::Enum
     
-      # Use the classic file layout.
-      # 
-      FileLayout_Classic = Wx::StandardPaths::FileLayout.new(0)
-      
-      # Use a XDG styled file layout.
-      # 
-      FileLayout_XDG = Wx::StandardPaths::FileLayout.new(1)
-      
     end # FileLayout
     
     # Possible values for {Wx::StandardPaths#make_config_file_name} naming convention argument.
@@ -175,14 +131,6 @@ module Wx
     # 
     class ConfigFileConv < Wx::Enum
     
-      # Use the class Unix dot-file convention.
-      # 
-      ConfigFileConv_Dot = Wx::StandardPaths::ConfigFileConv.new(0)
-      
-      # Use <code></code>.conf extension for the file names.
-      # 
-      ConfigFileConv_Ext = Wx::StandardPaths::ConfigFileConv.new(1)
-      
     end # ConfigFileConv
     
     # MSW-specific function undoing the effect of {Wx::StandardPaths#ignore_app_sub_dir} calls.
@@ -269,7 +217,7 @@ module Wx
     # @param lang [String] 
     # @param category [Wx::StandardPaths::ResourceCat] 
     # @return [String]
-    def get_localized_resources_dir(lang, category=Wx::StandardPaths::ResourceCat::ResourceCat_None) end
+    def get_localized_resources_dir(lang, category=RESOURCE_CAT_NONE) end
     alias_method :localized_resources_dir, :get_localized_resources_dir
     
     # Return the directory where the loadable modules (plugins) live.
@@ -404,7 +352,7 @@ module Wx
     # @param basename [String] 
     # @param conv [Wx::StandardPaths::ConfigFileConv] 
     # @return [String]
-    def make_config_file_name(basename, conv=Wx::StandardPaths::ConfigFileConv::ConfigFileConv_Ext) end
+    def make_config_file_name(basename, conv=CONFIG_FILE_CONV_EXT) end
     
     # Returns reference to the unique global standard paths object.
     # @return [Wx::StandardPaths]
@@ -428,4 +376,4 @@ module Wx
   end # StandardPaths
   
 
-end
+  end

data/lib/wx/doc/gen/art_provider.rb

@@ -289,7 +289,6 @@ module Wx
   # There's another way of taking advantage of this class: you can use it in your code and use platform native icons as provided by {Wx::ArtProvider.get_bitmap_bundle} or {Wx::ArtProvider.get_icon}.
   # 
   # ## Identifying art resources
-  # 
   # Every bitmap and icon bundle are known to {Wx::ArtProvider} under a unique ID that is used when requesting a resource from it. The ID is represented by the {Wx::ArtID} type and can have one of these predefined values (you can see bitmaps represented by these constants in the Art Provider Sample):
   # 
   # - {Wx::ART_ERROR} 
@@ -417,7 +416,6 @@ module Wx
   # </div>
   # 
   # ## Clients
-  # 
   # The client is the entity that calls {Wx::ArtProvider}'s {Wx::ArtProvider.get_bitmap} or {Wx::ArtProvider.get_icon} function. It is represented by {Wx::ClientID} type and can have one of these values:
   # 
   # - {Wx::ART_TOOLBAR} 
@@ -604,4 +602,4 @@ module Wx
   end # ArtProvider
   
 
-end
+  end