fxruby 1.6.50 → 1.6.51

data/docs/file.README.html

@@ -58,29 +58,29 @@
       </div>
 
       <div id="content"><div id='filecontents'>
-<h1 id="label-Introduction">Introduction</h1>
+<h1 id="introduction">Introduction</h1>
 
 <p><strong>This is the RDoc-generated API documentation for FXRuby version 1.6.</strong> If you have some constructive comments about the content, format or presentation, please do send those to me (at <a href="mailto:lyle@rubyforge.org">lyle@rubyforge.org</a>).</p>
 
-<h1 id="label-Page+layout">Page layout</h1>
+<h1 id="page-layout">Page layout</h1>
 
 <p>The page layout is roughly the same for every class. The page begins with a brief description of the class and is then followed by one or more of the following sections:</p>
-<dl class="rdoc-list label-list"><dt><strong>Attributes</strong>
+<dl class="rdoc-list label-list"><dt><strong>Attributes</strong></dt>
 <dd>
 <p>This section lists the names of all the attributes for this widget. As with all Ruby object “attributes”, these are actually just the names of instance methods for the class, but it is nevertheless natural to think of these as attributes (or <em>properties</em>) of the widget. Most attributes are both readable and writeable, but some are only read-only, so be sure to check the attributes listing within the main class documentation section to be sure.</p>
-</dd><dt><strong>Events</strong>
+</dd><dt><strong>Events</strong></dt>
 <dd>
 <p>This section lists the types for all of the messages that this widget might send to its message target, and the circumstances under which those messages are sent. When it’s important, the message data associated with that event is also described.</p>
-</dd><dt><strong>Options</strong>
+</dd><dt><strong>Options</strong></dt>
 <dd>
 <p>Most widgets have one or more options that affect their appearance or behavior. These options can be passed into the class’s <em>new</em> method when the object is first instantiated. They can usually also be changed after the object exists via some object-specific accessor method. For example, the options for an FXButton can be get or set via the FXButton#buttonStyle accessor methods.</p>
 </dd></dl>
 
-<h1 id="label-Where-27s+the+code-3F">Where’s the code?</h1>
+<h1 id="wheres-the-code">Where’s the code?</h1>
 
 <p>One difference you may notice from documentation generated for other Ruby extensions is that there’s no source code attached to the instance methods when you click on them (i.e. they will appear to be empty method definitions). That’s because most of these functions are in fact implemented in C++ code (since FXRuby is itself a C++ extension to Ruby).</p>
 
-<h1 id="label-TODO">TODO</h1>
+<h1 id="todo">TODO</h1>
 
 <p>A few notes and suggestions from Hugh Sasse:</p>
 <ul><li>
@@ -94,9 +94,9 @@
 </div></div>
 
       <div id="footer">
-  Generated on Tue Mar 11 16:01:29 2025 by
+  Generated on Thu Mar 26 09:48:22 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.37 (ruby-3.5.0).
+  0.9.38 (ruby-4.0.0).
 </div>
 
     </div>

data/docs/index.html

@@ -57,80 +57,121 @@
         <div class="clear"></div>
       </div>
 
-      <div id="content"><div id='filecontents'>
-<h1 id="label-FXRuby">FXRuby</h1>
-<ul><li>
-<p><a href="http://github.com/larskanis/fxruby">github.com/larskanis/fxruby</a></p>
-</li><li>
-<p>Full API-description: <a href="http://rubydoc.info/gems/fxruby/frames">rubydoc.info/gems/fxruby/frames</a> or <a href="https://larskanis.github.io/fxruby">larskanis.github.io/fxruby</a>/</p>
-</li><li>
-<p>Latest fxruby <a href="http://badge.fury.io/rb/fxruby"><img src="https://badge.fury.io/rb/fxruby.svg"></a></p>
-</li><li>
-<p>CI-Status: <a href="https://github.com/larskanis/fxruby/actions/workflows/ci.yml"><img src="https://github.com/larskanis/fxruby/actions/workflows/ci.yml/badge.svg?branch=1.6"></a> and on Windows: <a href="https://ci.appveyor.com/project/larskanis/fxruby/branch/1.6"><img src="https://ci.appveyor.com/api/projects/status/too7sj4gq643ts8w/branch/1.6?svg=true"></a></p>
-</li></ul>
+      <div id="content"><div id='filecontents'><h1 id="fxruby">FXRuby</h1>
 
-<h2 id="label-DESCRIPTION-3A">DESCRIPTION:</h2>
+<ul>
+<li><a href="http://github.com/larskanis/fxruby">http://github.com/larskanis/fxruby</a></li>
+<li>Full API-description: <a href="http://rubydoc.info/gems/fxruby/frames">http://rubydoc.info/gems/fxruby/frames</a> or <a href="https://larskanis.github.io/fxruby/">https://larskanis.github.io/fxruby/</a></li>
+<li>Latest fxruby <a href="http://badge.fury.io/rb/fxruby"><img src="https://badge.fury.io/rb/fxruby.svg" alt="Gem Version"></a></li>
+<li>CI-Status: <a href="https://github.com/larskanis/fxruby/actions/workflows/ci.yml"><img src="https://github.com/larskanis/fxruby/actions/workflows/ci.yml/badge.svg?branch=1.6" alt="Build Status"></a> and on Windows: <a href="https://ci.appveyor.com/project/larskanis/fxruby/branch/1.6"><img src="https://ci.appveyor.com/api/projects/status/too7sj4gq643ts8w/branch/1.6?svg=true" alt="Build Status on Windows"></a></li>
+</ul>
 
-<p>FXRuby is a library for developing powerful and sophisticated cross-platform graphical user interfaces (GUIs) for your Ruby applications. It’s based on the FOX Toolkit, a popular open source C++ library developed by Jeroen van der Zijp. What that means for you as an application developer is that you’re able to write code in the Ruby programming language that you already know and love, while at the same time taking advantage of the performance and functionality of a featureful, highly optimized C++ toolkit.</p>
+<h2 id="description">DESCRIPTION:</h2>
 
-<h2 id="label-FEATURES-3A">FEATURES:</h2>
+<p>FXRuby is a library for developing powerful and sophisticated
+cross-platform graphical user interfaces (GUIs) for your Ruby
+applications. It’s based on the FOX Toolkit, a popular open source
+C++ library developed by Jeroen van der Zijp. What that means for you
+as an application developer is that you’re able to write code in the
+Ruby programming language that you already know and love, while at the
+same time taking advantage of the performance and functionality of a
+featureful, highly optimized C++ toolkit.</p>
 
-<p>FXRuby supportes everything of FOX, that is useful in Ruby: * MDI/SDI application window layouts, floating toolbars * Rich set of controls (tables, imagelists, menus, canvas, …) * Flexible layout management * Image read/write support in many formats * Embedded OpenGL graphics through the <a href="https://github.com/vaiorabbit/ruby-opengl">opengl-bindings2</a> gem * Thread support</p>
+<h2 id="features">FEATURES:</h2>
 
-<h2 id="label-INSTALL-3A">INSTALL:</h2>
+<p>FXRuby supportes everything of FOX, that is useful in Ruby:</p>
 
-<p>FXRuby runs on Linux, Windows and OS-X with Ruby-2.5 or newer. Installation on Unix requires FOX development headers and libraries installed: * on Debian/Ubuntu: <code>sudo apt-get install g++ libxrandr-dev libfox-1.6-dev</code> * on Mac: <code>sudo port install rb-fxruby</code> OR <code>brew install fox &amp;&amp; brew install xquartz</code> * on Windows: the binary fxruby gems already contain all required libraries * see also detailed installation instructions in the <a href="https://github.com/lylejohnson/fxruby/wiki">Wiki</a></p>
+<ul>
+<li>MDI/SDI application window layouts, floating toolbars</li>
+<li>Rich set of controls (tables, imagelists, menus, canvas, ...)</li>
+<li>Flexible layout management</li>
+<li>Image read/write support in many formats</li>
+<li>Embedded OpenGL graphics through the <a href="https://github.com/vaiorabbit/ruby-opengl">opengl-bindings2</a> gem</li>
+<li>Thread support</li>
+</ul>
 
-<p>Then, install the gem: * gem install fxruby</p>
+<h2 id="install">INSTALL:</h2>
 
-<p>On Mac, before running applications, you must also run: <code>open -a /Applications/Utilities/XQuartz.app</code></p>
+<p>FXRuby runs on Linux, Windows and OS-X with Ruby-2.5 or newer. Installation on Unix requires
+FOX development headers and libraries installed:</p>
 
-<p>(otherwise, you end up getting this message when running applications on Mac: <code>FXRbApp::openDisplay: unable to open display :0.0</code>)</p>
+<ul>
+<li>on Debian/Ubuntu: <tt>sudo apt-get install g++ libxrandr-dev libfox-1.6-dev</tt></li>
+<li>on Mac: <tt>sudo port install rb-fxruby</tt> OR <tt>brew install fox &amp;&amp; brew install xquartz</tt></li>
+<li>on Windows: the binary fxruby gems already contain all required libraries</li>
+<li>see also detailed installation instructions in the <a href="https://github.com/lylejohnson/fxruby/wiki">Wiki</a></li>
+</ul>
 
-<h2 id="label-DIRECTORIES">DIRECTORIES</h2>
+<p>Then, install the gem:</p>
+
+<ul>
+<li>gem install fxruby</li>
+</ul>
+
+<p>On Mac, before running applications, you must also run: <tt>open -a /Applications/Utilities/XQuartz.app</tt></p>
+
+<p>(otherwise, you end up getting this message when running applications on Mac: <tt>FXRbApp::openDisplay: unable to open display :0.0</tt>)</p>
+
+<h2 id="directories">DIRECTORIES</h2>
 
 <p>The directory structure is:</p>
-<ul><li>
-<p>examples/</p>
-</li></ul>
 
-<p>Contains example programs demonstrating how to use FXRuby and  its many wonderful features.</p>
-<ul><li>
-<p>ext/fox16_c</p>
-</li></ul>
+<ul>
+<li>examples/</li>
+</ul>
+
+<p>Contains example programs demonstrating how to use FXRuby and
+  its many wonderful features.</p>
+
+<ul>
+<li>ext/fox16_c</li>
+</ul>
 
-<p>Contains the C++ source code for the shared library part of FXRuby.  These files are required to build FXRuby from the source code.</p>
-<ul><li>
-<p>lib/fox16</p>
-</li></ul>
+<p>Contains the C++ source code for the shared library part of FXRuby.
+  These files are required to build FXRuby from the source code.</p>
 
-<p>Contains the Ruby source code for the rest of FXRuby. These files  are not required to “build” FXRuby, but they are a part of the  standard FXRuby runtime environment and must be installed along with  the shared library part.</p>
-<ul><li>
-<p>tests/</p>
-</li></ul>
+<ul>
+<li>lib/fox16</li>
+</ul>
+
+<p>Contains the Ruby source code for the rest of FXRuby. These files
+  are not required to &quot;build&quot; FXRuby, but they are a part of the
+  standard FXRuby runtime environment and must be installed along with
+  the shared library part.</p>
+
+<ul>
+<li>tests/</li>
+</ul>
 
 <p>Contains a test battery for FXRuby.</p>
 
-<p>If you’re looking at a checkout of the source code from its GIT repository, you might see some additional directories of interest:</p>
-<ul><li>
-<p>fox-includes/</p>
-</li></ul>
+<p>If you&#39;re looking at a checkout of the source code from its GIT repository,
+you might see some additional directories of interest:</p>
+
+<ul>
+<li>fox-includes/</li>
+</ul>
+
+<p>An archive of the FOX library header files corresponding to this
+  release of FXRuby.</p>
+
+<ul>
+<li>rdoc-sources/</li>
+</ul>
 
-<p>An archive of the FOX library header files corresponding to this  release of FXRuby.</p>
-<ul><li>
-<p>rdoc-sources/</p>
-</li></ul>
+<p>A set of &quot;fake&quot; Ruby source files for the various
+  FXRuby classes, which are used to generate RDoc-style documentation.</p>
 
-<p>A set of “fake” Ruby source files for the various  FXRuby classes, which are used to generate RDoc-style documentation.</p>
-<ul><li>
-<p>swig-interfaces/</p>
-</li></ul>
+<ul>
+<li>swig-interfaces/</li>
+</ul>
 
-<p>The SWIG interface files used to generate the C++ wrapper code (i.e.  the code found in the ext/fox directory).</p>
+<p>The SWIG interface files used to generate the C++ wrapper code (i.e.
+  the code found in the ext/fox directory).</p>
 
-<h2 id="label-LICENSE">LICENSE</h2>
+<h2 id="license">LICENSE</h2>
 
-<pre class="code ruby"><code class="ruby">GNU LESSER GENERAL PUBLIC LICENSE
+<pre class="code ruby"><code class="ruby">        GNU LESSER GENERAL PUBLIC LICENSE
             Version 2.1, February 1999
 
   Copyright (C) 1991, 1999 Free Software Foundation, Inc.
@@ -590,9 +631,9 @@
 </div></div>
 
       <div id="footer">
-  Generated on Tue Mar 11 16:01:28 2025 by
+  Generated on Thu Mar 26 09:48:22 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.37 (ruby-3.5.0).
+  0.9.38 (ruby-4.0.0).
 </div>
 
     </div>

data/docs/js/app.js

@@ -1,4 +1,4 @@
-(function () {
+window.__app = function () {
   var localStorage = {},
     sessionStorage = {};
   try {
@@ -153,7 +153,6 @@
           });
           // Add the value of the constant as "Tooltip" to the summary object
           list.find("pre.code").each(function () {
-            console.log($(this).parent());
             var dt_element = $(this).parent().prev();
             var tooltip = $(this).text();
             if (dt_element.hasClass("deprecated")) {
@@ -250,37 +249,46 @@
     );
   }
 
-  function navResizeFn(e) {
-    if (e.which !== 1) {
-      navResizeFnStop();
-      return;
-    }
-
-    sessionStorage.navWidth = e.pageX.toString();
-    $(".nav_wrap").css("width", e.pageX);
-    $(".nav_wrap").css("-ms-flex", "inherit");
-  }
-
-  function navResizeFnStop() {
-    $(window).unbind("mousemove", navResizeFn);
-    window.removeEventListener("message", navMessageFn, false);
-  }
-
-  function navMessageFn(e) {
-    if (e.data.action === "mousemove") navResizeFn(e.data.event);
-    if (e.data.action === "mouseup") navResizeFnStop();
-  }
-
   function navResizer() {
-    $("#resizer").mousedown(function (e) {
-      e.preventDefault();
-      $(window).mousemove(navResizeFn);
-      window.addEventListener("message", navMessageFn, false);
-    });
-    $(window).mouseup(navResizeFnStop);
+    const resizer = document.getElementById("resizer");
+    resizer.addEventListener(
+      "pointerdown",
+      function (e) {
+        resizer.setPointerCapture(e.pointerId);
+        e.preventDefault();
+        e.stopPropagation();
+      },
+      false
+    );
+    resizer.addEventListener(
+      "pointerup",
+      function (e) {
+        resizer.releasePointerCapture(e.pointerId);
+        e.preventDefault();
+        e.stopPropagation();
+      },
+      false
+    );
+    resizer.addEventListener(
+      "pointermove",
+      function (e) {
+        if ((e.buttons & 1) === 0) {
+          return;
+        }
+
+        sessionStorage.navWidth = e.pageX.toString();
+        $(".nav_wrap").css("width", Math.max(200, e.pageX));
+        e.preventDefault();
+        e.stopPropagation();
+      },
+      false
+    );
 
     if (sessionStorage.navWidth) {
-      navResizeFn({ which: 1, pageX: parseInt(sessionStorage.navWidth, 10) });
+      $(".nav_wrap").css(
+        "width",
+        Math.max(200, parseInt(sessionStorage.navWidth, 10))
+      );
     }
   }
 
@@ -295,15 +303,6 @@
       document.getElementById("nav").contentWindow.postMessage(opts, "*");
       done = true;
     }
-
-    window.addEventListener(
-      "message",
-      function (event) {
-        if (event.data === "navReady") postMessage();
-        return false;
-      },
-      false
-    );
   }
 
   function mainFocus() {
@@ -341,4 +340,56 @@
     mainFocus();
     navigationChange();
   });
-})();
+};
+window.__app();
+
+window.addEventListener(
+  "message",
+  async (e) => {
+    if (e.data.action === "navigate") {
+      const response = await fetch(e.data.url);
+      const text = await response.text();
+      const parser = new DOMParser();
+      const doc = parser.parseFromString(text, "text/html");
+
+      const classListLink =
+        document.getElementById("class_list_link").classList;
+
+      const content = doc.querySelector("#main").innerHTML;
+      document.querySelector("#main").innerHTML = content;
+      document.title = doc.head.querySelector("title").innerText;
+      document.head.querySelectorAll("script").forEach((script) => {
+        if (
+          !script.type ||
+          (script.type.includes("text/javascript") && !script.src)
+        ) {
+          script.remove();
+        }
+      });
+
+      doc.head.querySelectorAll("script").forEach((script) => {
+        if (
+          !script.type ||
+          (script.type.includes("text/javascript") && !script.src)
+        ) {
+          const newScript = document.createElement("script");
+          newScript.type = "text/javascript";
+          newScript.textContent = script.textContent;
+          document.head.appendChild(newScript);
+        }
+      });
+
+      window.__app();
+
+      document.getElementById("class_list_link").classList = classListLink;
+
+      const url = new URL(e.data.url, "https://localhost");
+      const hash = decodeURIComponent(url.hash ?? "");
+      if (hash) {
+        document.getElementById(hash.substring(1)).scrollIntoView();
+      }
+      history.pushState({}, document.title, e.data.url);
+    }
+  },
+  false
+);

data/docs/js/full_list.js

@@ -20,17 +20,6 @@ function escapeShortcut() {
   });
 }
 
-function navResizer() {
-  $(window).mousemove(function(e) {
-    window.parent.postMessage({
-      action: 'mousemove', event: {pageX: e.pageX, which: e.which}
-    }, '*');
-  }).mouseup(function(e) {
-    window.parent.postMessage({action: 'mouseup'}, '*');
-  });
-  window.parent.postMessage("navReady", "*");
-}
-
 function clearSearchTimeout() {
   clearTimeout(searchTimeout);
   searchTimeout = null;
@@ -44,14 +33,21 @@ function enableLinks() {
     $clicked.addClass('clicked');
     evt.stopPropagation();
 
-    if (evt.target.tagName === 'A') return true;
+    if (window.origin === "null") {
+      if (evt.target.tagName === 'A') return true;
 
-    var elem = $clicked.find('> .item .object_link a')[0];
-    var e = evt.originalEvent;
-    var newEvent = new MouseEvent(evt.originalEvent.type);
-    newEvent.initMouseEvent(e.type, e.canBubble, e.cancelable, e.view, e.detail, e.screenX, e.screenY, e.clientX, e.clientY, e.ctrlKey, e.altKey, e.shiftKey, e.metaKey, e.button, e.relatedTarget);
-    elem.dispatchEvent(newEvent);
-    evt.preventDefault();
+      var elem = $clicked.find('> .item .object_link a')[0];
+      var e = evt.originalEvent;
+      var newEvent = new MouseEvent(evt.originalEvent.type);
+      newEvent.initMouseEvent(e.type, e.canBubble, e.cancelable, e.view, e.detail, e.screenX, e.screenY, e.clientX, e.clientY, e.ctrlKey, e.altKey, e.shiftKey, e.metaKey, e.button, e.relatedTarget);
+      elem.dispatchEvent(newEvent);
+      evt.preventDefault();
+    } else {
+      window.top.postMessage({
+        action: "navigate",
+        url: $clicked.find('.object_link a').attr('href'),
+      }, "*");
+    }
     return false;
   });
 }
@@ -199,6 +195,13 @@ function highlight() {
   });
 }
 
+function isInView(element) {
+  const rect = element.getBoundingClientRect();
+  const windowHeight =
+    window.innerHeight || document.documentElement.clientHeight;
+  return rect.left >= 0 && rect.bottom <= windowHeight;
+}
+  
 /**
  * Expands the tree to the target element and its immediate
  * children.
@@ -214,7 +217,7 @@ function expandTo(path) {
     $(el).find('> div > a.toggle').attr('aria-expanded', 'true');
   });
 
-  if($target[0]) {
+  if($target[0] && !isInView($target[0])) {
     window.scrollTo(window.scrollX, $target.offset().top - 250);
     highlight();
   }
@@ -232,7 +235,6 @@ window.addEventListener("message", windowEvents, false);
 
 $(document).ready(function() {
   escapeShortcut();
-  navResizer();
   enableLinks();
   enableToggles();
   populateSearchCache();