wxruby3 0.9.3-x64-mingw-ucrt → 0.9.5-x64-mingw-ucrt

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2a8e8e3953aef31ac0b70927370fcd6cfdbc04787dbd5e33371a3dddfe2f0dc
-  data.tar.gz: c35adef75eb90234d21087533e2d376130172689ce6d4a1aa4cd8c1d549a45b6
+  metadata.gz: a0ad2e04d5e9c1abdb9af5996fb90f9840998e61791ef6e70dfd38451dc6cc96
+  data.tar.gz: 650f43b258547d2bf337f3dad0562f92991fee005b99c64347eeab9ae2f8e125
 SHA512:
-  metadata.gz: a2a3ee55cda0961559da5af1b818b148d3f7bebb4ae0bf0096b2e07cdff552e0907ad4bfab5678e7cb2fb8eea3aa1e8c74d54d7817d32f0d6b4b03e9d9f726ac
-  data.tar.gz: 7c0f4533356c17073dfaf2a347ff48aeadd85ff223fca12bf8ed85d3d67ef1b4480a9bc4c87cd01826ce81d928121c993d76a3fefbbfec14e4749210cf7a2abc
+  metadata.gz: 944eec6b06fd0503e651e5a02760a1ff8e50f2c1f61ea3e0e706d61a7c62e8ee045cda7a6f03e5d1a99eaec2284ba5722e3f70a6fdcd068b0c7ebd6d680de7dc
+  data.tar.gz: 9f1588496325b7253cd5a110ca3309b92f59b6d7537e0f53a8c8ce002a1b0d5907896a205b44da75b02035a8c1a7ef7b688cea91b02eb53101e849c6215801ed

data/INSTALL.md

@@ -16,7 +16,7 @@ The minimal requirements for installing any source based setup (gem, source pack
 | C++ compiler<br>(incl. dev tools like `make`) | On linux a recent version of the GNU C++ compiler (with c++-14 support) needs to be installed<br>On Windows the RubyInstaller MSYS2-Devkit needs to be installed<br>On MacOS XCode with commandline tools needs to be installed via <code>sudo xcode-select --install</code> |
 | Git version control toolkit                   |                                                                                                                                                                                                                                                                              |
 | SWIG >= 3.0.12                                | On MacOS install Homebrew (https://brew.sh) and than <code>brew install swig</code>                                                                                                                                                                                          |
-| Doxygen (>= 1.9.1, <= 1.9.6)                  | Doxygen > 1.9.6 has changes that cause problems with the wxWidgets doxygen files.<br>On MacOS: <code>brew tap mcorino/wxruby3</code> and than `brew install doxygen@1.9.6` (default brew recipe installs 1.9.7)                                                              |
+| Doxygen (>= 1.9.1)                            | On MacOS install Homebrew (https://brew.sh) and than <code>brew install doxygen@</code>                                                                                                                                                                                      |
 | wxWidgets (>= 3.2)                            | See the <b>wxWidgets installation</b> section below.                                                                                                                                                                                                                         |
 
 The wxRuby3 build process requires `git` to clone a copy of the wxWidgets Github repository to extract the interface 

data/README.md

@@ -124,7 +124,7 @@ To install the source-only gem the following software is required:
 | C++ compiler<br>(incl. dev tools like `make`) | On linux a recent version of the GNU C++ compiler (with c++-14 support) needs to be installed<br>On Windows the RubyInstaller MSYS2-Devkit needs to be installed<br>On MacOS XCode with commandline tools needs to be installed |
 | Git version control toolkit                   |                                                                                                                                                                                                                                 |
 | SWIG >= 3.0.12                                | On MacOS install with Homebrew                                                                                                                                                                                                  |
-| Doxygen (>= 1.9.1, <= 1.9.6)                  | Doxygen > 1.9.6 has changes that cause problems with the wxWidgets doxygen files.                                                                                                                                               |
+| Doxygen (>= 1.9.1)                            | On MacOS install with Homebrew                                                                                                                                                                                                  |
 | wxWidgets >= 3.2 (*OPTIONAL*)                 | On Linux most distributions provide system installable (development) packages for wxWidgets providing a supported version.<br>Alternatively you can fairly easily install your own preferred version manually.                  |    
 
 See the [INSTALL](INSTALL.md) document for more details.
@@ -204,7 +204,7 @@ Several years of development have passed for wxWidgets and Ruby respectively,
 improving code quality, adding new classes and new language features.
 In 2022 I finally found the time and the inspiration to pick up this project
 with the idea of reviving it to build some applications I had in mind.
-wxRuby 3 intents to provide Ruby interfaces for all relevant (!) wxWidget
+wxRuby 3 intends to provide Ruby interfaces for all relevant (!) wxWidget
 classes of the latest version 3.2 and beyond. 
 Building on the experiences of the previous wxRuby (2) developments as well
 as the wxPython Phoenix project it is expected to provide a better and more

data/lib/wx/core/book_ctrl_base.rb

@@ -0,0 +1,16 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+
+module Wx
+
+  class BookCtrlBase
+
+    # create PersistentObject for toplevel windows (incl. Dialog and Frame)
+    def create_persistent_object
+      PersistentBookCtrl.new(self)
+    end
+
+  end
+
+end

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