wxruby3 1.6.1 → 1.8.0

data/rakelib/lib/director/webview.rb

@@ -0,0 +1,166 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+
+###
+# wxRuby3 wxWidgets interface director
+###
+
+require_relative './window'
+
+module WXRuby3
+
+  class Director
+
+    class WebView < Window
+
+      include Typemap::IOStreams
+      include Typemap::DateTime
+
+      def setup
+        spec.items << 'wxWebViewHistoryItem'
+        if Config.instance.wx_version_check('3.3.0') >= 0
+          spec.items << 'wxWebViewConfiguration'
+        end
+        super
+        if Config.instance.wx_version_check('3.3.0') >= 0
+          spec.gc_as_object 'wxWebViewConfiguration'
+          spec.no_proxy 'wxWebViewConfiguration'
+          spec.extend_interface 'wxWebViewConfiguration', 'wxWebViewConfiguration()', visibility: 'protected'
+          spec.make_abstract 'wxWebViewConfiguration'
+          # not useful in wxRuby
+          spec.ignore 'wxWebViewConfiguration::GetNativeConfiguration'
+        end
+        spec.gc_as_untracked 'wxWebViewHistoryItem'
+
+        spec.no_proxy 'wxWebView'
+        spec.ignore 'wxWebView::RegisterFactory'
+        spec.ignore 'wxWebView::GetNativeBackend'
+        if Config.instance.features_set?('WXMSW', 'USE_WEBVIEW_IE')
+          spec.include 'wx/msw/webview_ie.h', 'wx/msw/registry.h'
+          spec.add_extend_code 'wxWebView', <<~__CODE
+            // Have to add our own version here as wxw gets the execution module name wrong. 
+            static bool msw_set_ie_emulation_level(wxWebViewIE_EmulationLevel level = wxWEBVIEWIE_EMU_IE11)
+            {
+              // Registry key where emulation level for programs are set
+              static const wxChar* IE_EMULATION_KEY =
+                  wxT("SOFTWARE\\\\Microsoft\\\\Internet Explorer\\\\Main")
+                  wxT("\\\\FeatureControl\\\\FEATURE_BROWSER_EMULATION");
+          
+              wxRegKey key(wxRegKey::HKCU, IE_EMULATION_KEY);
+              // Check the existence of the key and create it if it does not exist
+              if ( !key.Exists() && !key.Create() )
+              {
+                  wxLogWarning(_("Failed to find web view emulation level in the registry"));
+                  return false;
+              }
+          
+              const wxString programName = wxT("ruby.exe");
+              if ( level != wxWEBVIEWIE_EMU_DEFAULT )
+              {
+                  if ( !key.SetValue(programName, level) )
+                  {
+                      wxLogWarning(_("Failed to set web view to modern emulation level"));
+                      return false;
+                  }
+              }
+              else
+              {
+                  if ( !key.DeleteValue(programName) )
+                  {
+                      wxLogWarning(_("Failed to reset web view to standard emulation level"));
+                      return false;
+                  }
+              }
+          
+              return true;
+            }
+            __CODE
+        else
+          spec.ignore 'wxWebViewIE_EmulationLevel'
+        end
+        if Config.instance.wx_version_check('3.1.1') >= 0
+          spec.map 'wxString *output' => 'String,nil' do
+            map_in ignore: true, temp: 'wxString tmp', code: '$1 = &tmp;'
+            map_out ignore: 'bool'
+            map_argout code: <<~__CODE
+              if (result)
+              {
+                $result = WXSTR_TO_RSTR(tmp$argnum);
+              }
+              else
+              {
+                $result = Qnil;
+              }
+              __CODE
+          end
+        end
+        if Config.instance.wx_version_check('3.1.6') >= 0
+          # do not support inherently unsafe 'void* clientData'
+          spec.ignore 'wxWebView::RunScriptAsync', ignore_doc: false
+          spec.add_extend_code 'wxWebView', <<~__CODE
+            void RunScriptAsync(const wxString& javascript)
+            {
+              $self->RunScriptAsync(javascript, nullptr);
+            }
+            __CODE
+          spec.map 'void* clientData', swig: false do
+            map_in ignore: true, code: ''
+          end
+        end
+
+        spec.add_swig_code <<~__CODE
+          %include <wx_ruby_shared_ptr.i>
+          %wx_ruby_shared_ptr(wxWebViewHandler, wxWebViewHandler);
+          %wx_ruby_shared_ptr(wxWebViewArchiveHandler, wxWebViewHandler);
+          %wx_ruby_shared_ptr(wxWebViewFSHandler, wxWebViewHandler);
+
+          %include <wx_shared_ptr.i>
+          %wx_shared_ptr(wxWebViewHistoryItem);
+          __CODE
+
+        spec.map 'wxSharedPtr<wxWebViewHandler>' => 'Wx::WebViewHandler>' do
+          map_in code: <<~__CODE
+            void* argp$argnum;
+            int res$argnum = SWIG_ConvertPtr($input, &argp$argnum, SWIGTYPE_p_WxRubySharedPtrT_wxWebViewHandler_wxWebViewHandler_t,  0 );
+            if (!SWIG_IsOK(res$argnum)) {
+              SWIG_exception_fail(SWIG_ArgError(res2), Ruby_Format_TypeError( "", "WxRubySharedPtr< wxWebViewHandler, wxWebViewHandler >","RegisterHandler", 2, argv[0] )); 
+            }  
+            if (!argp2) {
+              SWIG_exception_fail(SWIG_NullReferenceError, Ruby_Format_TypeError("invalid null reference ", "WxRubySharedPtr< wxWebViewHandler, wxWebViewHandler >","RegisterHandler", 2, argv[0]));
+            } else {
+              arg2 = *(reinterpret_cast< WxRubySharedPtr< wxWebViewHandler, wxWebViewHandler > * >(argp2));
+            }
+            __CODE
+        end
+
+        spec.map 'wxVector< wxSharedPtr<wxWebViewHistoryItem> >' => 'Array<Wx::WEB::WebViewHistoryItem>' do
+          map_out code: <<~__CODE
+              $result = rb_ary_new();
+              wxVector< wxSharedPtr<wxWebViewHistoryItem> > *history = (wxVector< wxSharedPtr<wxWebViewHistoryItem> > *)&$1;
+              for (wxSharedPtr<wxWebViewHistoryItem>& hist_item : *history)
+              {
+                VALUE r_hist = SWIG_NewPointerObj(new wxSharedPtr<wxWebViewHistoryItem>(SWIG_STD_MOVE(hist_item)), SWIGTYPE_p_wxSharedPtrT_wxWebViewHistoryItem_t, SWIG_POINTER_OWN);
+                rb_ary_push($result, r_hist);
+              }
+            __CODE
+        end
+
+        spec.map 'wxSharedPtr<wxWebViewHistoryItem>' => 'Wx::WEB::WebViewHistoryItem', swig: false do
+          map_in code: ''
+        end
+
+        # fix event definitions
+        if Config.instance.wx_version_check('3.3.0') >= 0
+          # completely missing up and until 3.3.2 but should be there
+          if Config.instance.wx_version_check('3.3.2') <= 0
+            spec.add_swig_code %Q{%constant wxEventType wxEVT_WEBVIEW_BROWSING_DATA_CLEARED = wxEVT_WEBVIEW_BROWSING_DATA_CLEARED;}
+          end
+        end
+      end
+
+    end # class WebView
+
+  end # class Director
+
+end # module WXRuby3

data/rakelib/lib/director/webview_event.rb

@@ -0,0 +1,37 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+
+###
+# wxRuby3 wxWidgets interface director
+###
+
+require_relative './event'
+
+module WXRuby3
+
+  class Director
+
+    class WebViewEvent < Event
+
+      def setup
+        super
+        spec.override_inheritance_chain('wxWebViewEvent',
+                                        {'wxNotifyEvent' => 'wxEvents'}, {'wxCommandEvent' => 'wxEvent'}, 'wxEvent', 'wxObject')
+        if Config.instance.wx_version_check('3.3.0') >= 0
+          spec.items << 'wxWebViewWindowFeatures'
+          spec.gc_as_untracked 'wxWebViewWindowFeatures'
+          spec.no_proxy 'wxWebViewWindowFeatures'
+          spec.make_abstract 'wxWebViewWindowFeatures'
+          spec.extend_interface 'wxWebViewWindowFeatures',
+                                'virtual wxWebViewWindowFeatures()',
+                                visibility: 'protected'
+
+        end
+        spec.do_not_generate(:variables, :defines, :enums, :functions)
+      end
+    end # class WebViewEvent
+
+  end # class Director
+
+end # module WXRuby3

data/rakelib/lib/director/webview_handler.rb

@@ -0,0 +1,63 @@
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+
+###
+# wxRuby3 wxWidgets interface director
+###
+
+module WXRuby3
+
+  class Director
+
+    class WebViewHandler < Director
+
+      include Typemap::IOStreams
+      include Typemap::MBConv
+
+      def setup
+        spec.items.concat %w[wxWebViewArchiveHandler wxWebViewFSHandler]
+        if Config.instance.wx_version_check('3.3.0') >= 0
+          spec.items.concat %w[wxWebViewHandlerRequest wxWebViewHandlerResponse wxWebViewHandlerResponseData]
+        end
+        super
+        spec.gc_as_untracked 'wxWebViewHandler', 'wxWebViewArchiveHandler', 'wxWebViewFSHandler'
+        spec.make_abstract 'wxWebViewHandler'
+        spec.add_swig_code <<~__CODE
+            %include <wx_ruby_shared_ptr.i>
+            %wx_ruby_shared_ptr(wxWebViewHandler, wxWebViewHandler);
+            %wx_ruby_shared_ptr(wxWebViewArchiveHandler, wxWebViewHandler);
+            %wx_ruby_shared_ptr(wxWebViewFSHandler, wxWebViewHandler);
+            __CODE
+        if Config.instance.wx_version_check('3.3.0') >= 0
+          spec.gc_as_untracked 'wxWebViewHandlerRequest', 'wxWebViewHandlerResponse', 'wxWebViewHandlerResponseData'
+          spec.no_proxy 'wxWebViewHandlerRequest', 'wxWebViewHandlerResponse'
+          spec.make_abstract 'wxWebViewHandlerRequest'
+          spec.make_abstract 'wxWebViewHandlerResponse'
+          spec.make_abstract 'wxWebViewHandlerResponseData'
+          spec.add_swig_code <<~__CODE
+            %include <wx_shared_ptr.i>
+            %wx_shared_ptr(wxWebViewHandlerResponse);
+            %wx_shared_ptr(wxWebViewHandlerResponseData);
+            __CODE
+          spec.map 'wxSharedPtr<wxWebViewHandlerResponse>' => 'Wx::WEB::WebViewHandlerResponse', swig: false do
+            map_in code: ''
+          end
+          spec.map 'wxSharedPtr<wxWebViewHandlerResponseData>' => 'Wx::WEB::WebViewHandlerResponseData', swig: false do
+            map_in code: ''
+          end
+          spec.suppress_warning(473,
+                                'wxWebViewHandlerResponseData::GetStream')
+        end
+        spec.suppress_warning(473,
+                              'wxWebViewHandler::GetFile',
+                              'wxWebViewArchiveHandler::GetFile',
+                              'wxWebViewFSHandler::GetFile')
+        spec.do_not_generate(:variables, :defines, :enums, :functions)
+      end
+
+    end # class WebViewHandler
+
+  end # class Director
+
+end # module WXRuby3

data/rakelib/lib/director/window.rb

@@ -127,7 +127,7 @@ module WXRuby3
             spec.ignore 'wxWindow::EnableTouchEvents'
           end
           if Config.instance.wx_version_check('3.3.0') >= 0
-            spec.ignore_unless('WXMSW', 'wxWindow::MSWDisableComposited')
+            spec.ignore_unless('WXMSW', 'wxWindow::MSWDisableComposited') if Config.instance.wx_version_check('3.3.1') <= 0
             spec.ignore('wxWindow::GTKGetWin32Handle')
           end
           if Config.instance.features_set?('USE_ACCESSIBILITY')
@@ -236,6 +236,10 @@ module WXRuby3
           spec.override_events 'wxWindow', 'EVT_ACTIVATE' => ['EVT_ACTIVATE', 0, 'wxActivateEvent']
         when 'wxNonOwnedWindow'
           spec.no_proxy('wxNonOwnedWindow')
+          if Config.instance.features_set?('WXOSX')
+            spec.extend_interface('wxNonOwnedWindow',
+                                  'virtual bool Destroy() override')
+          end
         when 'wxControl'
           # add these to the generated interface to be parsed by SWIG
           # the wxWidgets docs are flawed in this respect that several reimplemented
@@ -288,6 +292,7 @@ module WXRuby3
                           "#{spec.class_name(citem)}::GetScrollRange",
                           "#{spec.class_name(citem)}::GetScrollThumb",
                           "#{spec.class_name(citem)}::GetTextExtent",
+                          "#{spec.class_name(citem)}::GetDPI",
                           "#{spec.class_name(citem)}::HasCapture",
                           "#{spec.class_name(citem)}::HasMultiplePages",
                           "#{spec.class_name(citem)}::IsDoubleBuffered",
@@ -305,6 +310,9 @@ module WXRuby3
                           "#{spec.class_name(citem)}::SetBackgroundColour",
                           "#{spec.class_name(citem)}::SetBackgroundStyle",
                           "#{spec.class_name(citem)}::HasTransparentBackground",
+                          "#{spec.class_name(citem)}::CanSetTransparent",
+                          "#{spec.class_name(citem)}::SetTransparent",
+                          "#{spec.class_name(citem)}::GetThemeEnabled",
                           "#{spec.class_name(citem)}::SetCursor",
                           "#{spec.class_name(citem)}::SetFocus",
                           "#{spec.class_name(citem)}::SetFocusFromKbd",
@@ -329,6 +337,7 @@ module WXRuby3
                           "#{spec.class_name(citem)}::GetDefaultAttributes",
                           "#{spec.class_name(citem)}::GetWindowStyleFlag",
                           "#{spec.class_name(citem)}::GetDropTarget",
+                          "#{spec.class_name(citem)}::SetDropTarget",
                           "#{spec.class_name(citem)}::GetValidator",
                           "#{spec.class_name(citem)}::IsTopLevel",
                           "#{spec.class_name(citem)}::EnableTouchEvents",

data/rakelib/lib/director/xml_resource.rb

@@ -18,6 +18,12 @@ module WXRuby3
         spec.ignore %w[wxXmlResource::AddHandler wxXmlResource::ClearHandlers wxXmlResource::InsertHandler]
         # not really added value; will add alternative allowing more flexibility (see below)
         spec.ignore 'wxXmlResource::LoadDocument(wxXmlDocument *, const wxString &)'
+        # unwanted in Ruby
+        spec.ignore 'wxXmlResource::LoadObject',
+                    'wxXmlResource::LoadObjectRecursively'
+        # unattached loaders return owned objects
+        spec.new_object 'wxXmlResource::LoadMenu(const wxString &)',
+                        'wxXmlResource::LoadMenuBar(const wxString &)'
         # For these three methods, there are two variants in wxWidgets. One loads an
         # XRC from scratch and returns an instance of a core Wx class
         # (Wx::Dialog, Wx::Frame, or Wx::Panel). The other loads a layout into

data/rakelib/lib/generate/doc/aui_manager.yaml

@@ -25,4 +25,4 @@
       :para:
         - :pattern: !ruby/regexp /The overridden version may return true but modify.*appending them./
           :replace: |
-            The overridden version may return a 2-element array with an AuiTabCtrl and tab index instead to change where the page should be inserted, e.g. by returning a tab index of 0 to insert the new pages at the beginning instead of appending them.
+            The overridden version may return a 2-element array with an {Wx::AUI::AuiTabCtrl} and tab index instead to change where the page should be inserted, e.g. by returning a tab index of 0 to insert the new pages at the beginning instead of appending them.

data/rakelib/lib/generate/doc/rich_tool_tip.yaml

@@ -0,0 +1,26 @@
+---
+:wxRichToolTip:
+  :detail:
+    :pre:
+      :para:
+        - :pattern: !ruby/regexp /The images below show some examples.*/
+          :replace: |
+
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+            
+            ```ruby
+              password = Wx::TextCtrl.new(..., style: Wx::TE_PASSWORD)
+              # ...
+              tip = Wx::RichToolTip.new("Caps Lock is on",
+                                        "You might have made an error in your password\n" +
+                                        "entry because Caps Lock is turned on.\n" +
+                                        "\n" +
+                                        "Press Caps Lock key to turn it off.")
+               tip.set_icon(Wx::ICON_WARNING)
+               tip.show_for(password)
+            ```
+    :post:
+      - :pattern: !ruby/regexp /<div class='appearance'>.*</table></div>/m
+        :subst: ''

data/rakelib/lib/generate/doc/thread_event.yaml

@@ -0,0 +1,20 @@
+---
+:wxThreadEvent:
+  :detail:
+    :pre:
+      :detaileddescription:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+            
+            This event is not natively emitted by any control/class: it is just a helper class for the user. 
+            Its most important feature is the {Wx::RT::ThreadEvent#get_event_category} implementation which allows 
+            thread events <b>NOT</b> to be processed by {Wx::GUIEventLoop#yield_for} calls (unless the 
+            {Wx::EventCategory::EVT_CATEGORY_THREAD} is specified - which is never in wx code).
+            
+            In wxRuby user defined classes can be derived from this class but it is important to note that when used
+            with {Wx::RT::SharedEvtHandler#queue_message} (the only imaginable use for thread events) no Ruby state
+            will <b>ever</b> persist and adding instance variables is therefor not useful.
+            The real benefit of being able to derive from this class is that it provides for the registration and use of 
+            user defined event types for the derived classes allowing to differentiate in event handling.
+            @see Wx::GUIEventLoop#yield_for
+            @see Wx::RT::SharedEvtHandler

data/rakelib/lib/generate/doc/web_view.yaml

@@ -0,0 +1,135 @@
+---
+:wxWebView:
+  :detail:
+    :pre:
+      :detaileddescription:
+        - :pattern: !ruby/regexp /wxWEBVIEW_BACKEND_IE\s+\(MSW\)/
+          :subst: 'Wx::WEB::WEBVIEW_BACKEND_IE (MSW)'
+        - :pattern: !ruby/regexp /Internet\s+Explorer\s+7/
+          :subst: 'Internet Explorer 11'
+        - :pattern: !ruby/regexp /wxWebViewIE::MSWSetEmulationLevel/
+          :subst: 'wxWebView::msw_set_ie_emulation_level'
+        - :pattern: !ruby/regexp /wxWebViewBackendIE/m
+          :global: true
+          :subst: 'wxWEBVIEW_BACKEND_IE'
+        - :pattern: !ruby/regexp /wxWEBVIEW_BACKEND_EDGE/m
+          :global: true
+          :subst: 'Wx::WEB::WEBVIEW_BACKEND_EDGE'
+        - :pattern: !ruby/regexp /wxWebViewBackendEdge/m
+          :global: true
+          :subst: 'wxWEBVIEW_BACKEND_EDGE'
+        - :pattern: !ruby/regexp /This\s+backend.*using\s+CMake.\s+To\s+build.*steps:/
+          :subst: 'This backend is enabled by default for WXMSW.'
+        - :pattern: !ruby/regexp /wxWebViewBackendWebKit/m
+          :global: true
+          :subst: 'wxWEBVIEW_BACKEND_WEBKIT'
+        - :pattern: !ruby/regexp /wxWEBVIEW_WEBKIT/m
+          :global: true
+          :subst: 'Wx::WEB::WEBVIEW_BACKEND_WEBKIT'
+        - :pattern: !ruby/regexp /wxWEBVIEW_CHROMIUM/m
+          :global: true
+          :subst: 'Wx::WEB::WEBVIEW_BACKEND_CHROMIUM'
+        - :pattern: !ruby/regexp /wxWebViewBackendChromium/m
+          :global: true
+          :subst: 'wxWEBVIEW_BACKEND_CHROMIUM'
+      :programlisting:
+        - :pattern: !ruby/regexp /wxSetEnv/
+          :replace: |
+            
+            
+            ```ruby
+             ENV['WEBKIT_DISABLE_DMABUF_RENDERER'] = '1'
+            ```
+
+    :post:
+      - :pattern: !ruby/regexp /-\s+When\s+not\s+using\s+CMake:.*remove\s+the dependency\s+on\s+WebView2Loader\.dll\s+at runtime./m
+        :subst: ''
+      - :pattern: !ruby/regexp /If.*fixed\s+version.*WebView2.*Edge\s+backend\./
+        :subst: ''
+      - :pattern: !ruby/regexp /see\s+\{Wx::WebViewChromium\}.*build\s+instructions./
+        :subst: |
+          see the wxWidgets documentation for wxWebViewChromium for additional usage and build instructions.
+          This backend can not be automatically build by the wxRuby3 build scripts but requires a custom wxWidgets installation.
+          See the wxRuby3 INSTALL documentation for details on how to build with a custom wxWidgets setup.
+:wxWebView.RunScript:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /document\.write/
+          :replace: |
+            
+            
+            ```ruby
+             webview.run_script('document.write('Hello from wxWidgets!')')
+            ```
+
+        - :pattern: !ruby/regexp /document\.getElementById/
+          :replace: |
+            
+            
+            ```ruby
+               if (result = webview.run_script('document.getElementById('some_id').innerHTML'))
+                   #... result contains the contents of the given element ...
+               # else: the element with this ID probably doesn't exist.
+               end
+            ```
+
+    :post:
+      - :pattern: !ruby/regexp /return\s+false/m
+        :global: true
+        :subst: 'return nil'
+      - :pattern: !ruby/regexp /MSWSetEmulationLevel\(\)/
+        :subst: 'Wx::WEB::WebView::msw_set_ie_emulation_level'
+      - :pattern: !ruby/regexp /If.*output.*success/m
+        :subst: 'This method returns the result of executing this code on success (or nil if no result or on failure)'
+      - :pattern: !ruby/regexp /true\s+if\s+there\s+is.*error./m
+        :subst: ''
+:wxWebView.AddScriptMessageHandler:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /AddScriptMessageHandler/
+          :replace: |
+            
+            
+            ```ruby
+               # Install message handler with the name wx_msg
+               @webView.add_script_message_handler("wx_msg")
+               # Bind handler
+               @webView.evt_webview_script_message_received(Wx::ID_ANY) { |evt|
+                   Wx.log_message("Script message received; value = %s, handler = %s", evt.get_string, evt.get_message_handler)
+               }
+            ```
+
+    :post:
+      - :pattern: !ruby/regexp /Sample\s+C\+\+\s+code\s+/
+        :subst: 'Sample code '
+:wxWebView.SetProxy:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+            
+            
+            ```ruby
+              webview = Wx::WEB::WebView.new
+              unless webview.set_proxy("http://127.0.0.1:8080")
+                  Wx.log_warning("Setting proxy failed!")
+              end
+              webview.create(parent, Wx::ID_ANY)
+            ```
+
+:wxWebView.IsBackendAvailable:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+            
+            
+            ```ruby
+              if Wx::WEB::WebView::is_backend_available(Wx::WEB::WEBVIEW_BACKEND_EDGE)
+                  #... enable some extra functionality not available with the IE backend ...
+              end
+            ```

data/rakelib/lib/generate/doc/web_view_event.yaml

@@ -0,0 +1,38 @@
+---
+:wxWebViewWindowFeatures:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /wxEVT_WEBVIEW_NEWWINDOW/
+          :replace: |
+            
+            
+            ```ruby
+              # Bind new window handler
+              @webView.evt_webview_newwindow(Wx::ID_ANY) { |evt|
+                if evt.get_url == "http://badwebsite.com"
+                  evt.veto # Disallow new window for badwebsite.com
+                else
+                  evt.skip # Allow new window for all other websites
+                end    
+              }
+              
+              # Bind new window features handler
+              @webView.evt_webview_newwindow_features(Wx::ID_ANY) { |evt|
+                 # Get target window features
+                 features = evt.get_target_window_features
+                 # Create a top level window for the child web view
+                 win = Wx::Frame.new(nil, Wx::ID_ANY, features.get_position, features.get_size)
+                 sizer = Wx::VBoxSizer.new
+                 win.set_sizer(sizer)
+                 # Get the child web view
+                 childWebView = features.get_child_web_view
+                 # Place the child web view into the window
+                 childWebView.create(win, Wx::ID_ANY)
+                 sizer.add(childWebView, Wx::SizerFlags.new.proportion(1).expand)
+              }
+            ```
+
+    :post:
+      - :pattern: !ruby/regexp /Sample\s+C\+\+\s+code\s+/
+        :subst: 'Sample code '

data/rakelib/lib/generate/doc/web_view_handler.yaml

@@ -0,0 +1,58 @@
+---
+:wxWebViewHandler.SetVirtualHost:
+  :detail:
+    :post:
+      - :pattern: !ruby/regexp /name\.\{Wx::site\}/
+        :subst: '<code>name.wxsite</code>'
+:wxWebViewHandler.StartRequest:
+  :detail:
+    :pre:
+      :programlisting:
+        - :pattern: !ruby/regexp /.*/
+          :replace: |
+            
+            ```ruby
+            def start_request(request, response)
+               # Set common headers allowing access from XMLHTTPRequests()
+               response.set_header("Access-Control-Allow-Origin", "*")
+               response.set_header("Access-Control-Allow-Headers", "*")
+            
+               # Handle options request
+               if request.get_method.casecmp("options") == 0
+                 response.finish("")
+                 return
+               end
+            
+               # Check the post data type
+               unless request.get_header("Content-Type").start_with?("application/json")
+                 response.finish_with_error
+                 return;
+               end
+            
+               # Process input data
+               postData = request.get_data_string
+            
+               #...
+            
+               # Send result
+               response.set_content_type("application/json")
+               response.finish("{ result: true }")
+            end
+            ```
+:wxWebViewHandlerResponse.Finish:
+  :detail:
+    :pre:
+      :detaileddescription:
+        - :pattern: !ruby/regexp /simplesect.*kind.*see.*Finish.*wxMBConv/
+          :replace: |
+            @see finish(text, conv)
+        - :pattern: !ruby/regexp /simplesect.*kind.*see.*Finish.*wxWebViewHandlerResponseData/
+          :replace: |
+            @see find(data)
+:wxWebViewHandlerResponseData:
+  :detail:
+    :pre:
+      :detaileddescription:
+        - :pattern: !ruby/regexp /simplesect.*kind.*see.*Finish.*wxWebViewHandlerResponseData/
+          :replace: |
+            @see Wx::WEB::WebViewHandlerResponse#finish(data)

data/rakelib/lib/generate/doc.rb

@@ -49,7 +49,7 @@ module WXRuby3
           end
           table = { 'Wx' => {}}
           handle_module(Wx, table['Wx'])
-          STDOUT.puts JSON.dump(table)
+          File.open(ARGV[0], 'w+') { |f| f << JSON.dump(table) }
         __SCRIPT
         STDERR.puts "* executing constants collection script:\n#{script}" if Director.trace?
         begin
@@ -57,22 +57,27 @@ module WXRuby3
           ftmp_name = tmpfile.path.dup
           tmpfile << script
           tmpfile.close(false)
-          result = if Director.trace?
-                     Config.instance.run(ftmp_name, capture: :out, verbose: false)
-                   else
-                     Config.instance.run(ftmp_name, capture: :no_err, verbose: false)
-                   end
+          tmpconsts = Tempfile.new('constants')
+          fconsts_name = tmpconsts.path.dup
+          tmpconsts.close(false)
+          if Director.trace?
+            Config.instance.run(ftmp_name, fconsts_name, capture: :out, verbose: false)
+          else
+            Config.instance.run(ftmp_name, fconsts_name, capture: :no_err, verbose: false)
+          end
+          result = File.read(fconsts_name)
           STDERR.puts "* got constants collection output:\n#{result}" if Director.trace?
           begin
             db = JSON.load(result)
           rescue Exception
-            File.open('constants_raw.json', "w") { |f| f << result } if Director.verbose?
+            # File.open('constants_raw.json', "w") { |f| f << result } if Director.verbose?
             ::Kernel.raise RuntimeError, "Exception loading constants collection result: #{$!.message.slice(0, 512)}", cause: nil
           end
           File.open('constants.json', "w") { |f| f << JSON.pretty_generate(db) } if Director.verbose?
           return db
         ensure
           File.unlink(ftmp_name)
+          File.unlink(fconsts_name)
         end
       end