glimmer-dsl-swt 4.24.3.2 → 4.24.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 89250fa7cc394da176eb7cd91a17c7ad388607c69927a7e22b6b1be62333a0b8
-  data.tar.gz: e7e09c62b782c682c0abdb8722001c8925268cfe4bab49b536eb58f3f32fb697
+  metadata.gz: 81eb61402ae45b2e3782b9c10dc6b0374e39fb7f74351d2ed940719fbd6e4ec3
+  data.tar.gz: dfa93b670ddc363dd2dc602920d5e24510202b179f7e7740ee8abc50fc91eee4
 SHA512:
-  metadata.gz: 136c2625e94629b690a325bdc3c8669a36c612f9f651b04faa5be3dcbcc86b57ae5345c23fcce1b10656b9dca5e8a4e96a318147907785a5bff18eac3dd4b130
-  data.tar.gz: 6d1c069b332ccd3139cf0c6377dd64b5341ccd84cc4dda3c72f5255c0eaeff0639bbfcdea35cb6b66baa84fb9ed1093143cafb4897f6ba2b2198dd494e0033c3
+  metadata.gz: 46bee26330ce88284c85f263b0db58dda6dfb76cd2d2f37938c881f6567d74cd0a514565625a6c21da53b91e119fd31185dda8b22626e357fb79612e9013f6fe
+  data.tar.gz: '049762158e8e4015ec1a157edd148212078a106b753b9ad4f6111ab49746fe2934471382b4c5c20d9ee00a9abca8d8c22866c1c3ecd7aa733ccc5aeb28eb6c7b'

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Change Log
 
+## 4.24.4.0
+
+- Save `WidgetBinding` instances on `WidgetProxy` objects via `widget_bindings` attribute
+- Support specifying `@children_owner` in any custom widget for which adding children will not add them under the `body_root` (e.g. a composite wrapping a table will designate the table as the `@children_owner` for adding `table_column`s)
+- Add explicit `shell_proxy` method to `Glimmer::UI::CustomWidget` that delegates to `body_root` to avoid annoying false negative error every time that method is called
+- Optimize `table` data-binding performance for single-model update scenarios
+- Fix issue with data-binding a table as the body root of a custom widget when customizing column_attributes
+
 ## 4.24.3.2
 
 - Have `table` data-binding infer model attribute names from column names by convention (no need to specify `column_properties`)

data/README.md

@@ -1,4 +1,4 @@
-# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for SWT 4.24.3.2
+# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for SWT 4.24.4.0
 ## JRuby Desktop Development GUI Framework
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-swt.svg)](http://badge.fury.io/rb/glimmer-dsl-swt)
 [![Travis CI](https://travis-ci.com/AndyObtiva/glimmer-dsl-swt.svg?branch=master)](https://travis-ci.com/github/AndyObtiva/glimmer-dsl-swt)
@@ -21,7 +21,7 @@ Featured in JRuby Cookbook](http://shop.oreilly.com/product/9780596519650.do) an
 
 ![Eclipse SWT RCP NASA Mars Rover](/images/glimmer-eclipse-swt-rcp-nasa-mars-rover.png)
 
-[Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) 4.24.3.2 includes [SWT 4.24](https://download.eclipse.org/eclipse/downloads/drops4/R-4.24-202206070700/), which was released on June 7, 2022. Gem version numbers are in sync with the SWT library versions. The first two digits represent the SWT version number. The last two digits represent the minor and patch versions of Glimmer DSL for SWT.
+[Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) 4.24.4.0 includes [SWT 4.24](https://download.eclipse.org/eclipse/downloads/drops4/R-4.24-202206070700/), which was released on June 7, 2022. Gem version numbers are in sync with the SWT library versions. The first two digits represent the SWT version number. The last two digits represent the minor and patch versions of Glimmer DSL for SWT.
 
 **Starting in version 4.20.0.0, [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) comes with the new [***Shine***](/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#shine) syntax** for highly intuitive and visually expressive View/Model Attribute Mapping, relying on `<=>` for bidirectional (two-way) data-binding and `<=` for unidirectional (one-way) data-binding, providing an alternative to the `bind` keyword. That was [originally conceived back in 2007](https://andymaleh.blogspot.com/2007/12/data-shining-in-glimmer.html).
 
@@ -338,7 +338,7 @@ jgem install glimmer-dsl-swt
 
 Or this command if you want a specific version:
 ```
-jgem install glimmer-dsl-swt -v 4.24.3.2
+jgem install glimmer-dsl-swt -v 4.24.4.0
 ```
 
 `jgem` is JRuby's version of `gem` command.
@@ -366,7 +366,7 @@ Note: if you're using activerecord or activesupport, keep in mind that Glimmer u
 
 Add the following to `Gemfile`:
 ```
-gem 'glimmer-dsl-swt', '~> 4.24.3.2'
+gem 'glimmer-dsl-swt', '~> 4.24.4.0'
 ```
 
 And, then run:
@@ -389,7 +389,7 @@ glimmer
 ```
 
 ```
-Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.24.3.2
+Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.24.4.0
       
 Usage: glimmer [--bundler] [--pd] [--quiet] [--debug] [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] (application.rb or task[task_args]) [[application2.rb]...]
 

data/VERSION

@@ -1 +1 @@
-4.24.3.2
+4.24.4.0

data/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md

@@ -54,9 +54,11 @@ This guide should help you get started with Glimmer DSL for SWT. For more advanc
     - [Combo](#combo)
     - [List](#list)
     - [Table](#table)
+      - [Table Item Properties](#table-item-properties)
       - [Table Selection](#table-selection)
       - [Table Editing](#table-editing)
       - [Table Sorting](#table-sorting)
+      - [Refined Table with Pagination](#refined-table-with-pagination)
     - [Tree](#tree)
     - [DateTime](#datetime)
   - [Observer](#observer)
@@ -4109,6 +4111,9 @@ This automatically leverages the SWT TableEditor custom class behind the scenes,
 passed table item text into something else.
 It automatically persists the change to `items` data-bound model on ENTER/FOCUS-OUT or cancels on ESC/NO-CHANGE.
 
+Note that `table` is designed to expect about 100 rows only, not more than that, or otherwise it will not offer a user-friendly experience due to requiring users to scroll through a lot of data.
+If you need to display a table with more than 100 rows, then you need to employ pagination. That is already supported in the [Refined Table (`refined_table`)](#refined-table-with-pagination) custom widget documented below.
+
 ##### Table Item Properties
 
 When data-binding a `table`'s `items`, extra [`TableItem` properties](https://help.eclipse.org/latest/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/widgets/TableItem.html) are data-bound automatically by convention for `background` color, `foreground` color, `font`, and `image` if corresponding properties (attributes) are available on the model.
@@ -4302,6 +4307,51 @@ Here is an explanation of the example above:
 
 `<= [model, :property, read_only_sort: true]` could be used with items to make sorting not propagate sorting changes to model.
 
+##### Refined Table with Pagination
+
+**(ALPHA FEATURE)**
+
+`refined_table` is a custom widget that can handle very large amounts of data by applying pagination.
+
+Just use like a standard `table`, but data-bind models to a `model_array` property instead of `items`. `refined_table` will take care of the rest.
+
+Options:
+- `per_page` (default: `10`): specifies how many rows to display per page
+- `page` (default: `1` if table is filled and `0` otherwise): specifies initial page
+
+Note that currently `refined_table` only supports displaying a **read-only** table (meaning it can read updates from the model, but it cannot write back to the model through table editing cells).
+
+Example taken from [Hello, Refined Table!](/docs/reference/GLIMMER_SAMPLES.md#hello-refined-table):
+
+![hello refined table](/images/glimmer-hello-refined-table.png)
+
+```ruby
+      #... more code precedes
+      
+      refined_table(per_page: 20) {
+        table_column {
+          width 100
+          text 'Date'
+        }
+        table_column {
+          width 200
+          text 'Ballpark'
+        }
+        table_column {
+          width 150
+          text 'Home Team'
+        }
+        table_column {
+          width 150
+          text 'Away Team'
+        }
+        
+        model_array <= [@baseball_season, :games, column_attributes: {'Home Team' => :home_team_name, 'Away Team' => :away_team_name}]
+      }
+      
+      #...more code follows
+```
+
 #### Tree
 
 The SWT Tree widget visualizes a tree data-structure, such as an employment or composition hierarchy.

data/docs/reference/GLIMMER_SAMPLES.md

@@ -41,6 +41,7 @@
     - [Hello, Slider!](#hello-slider)
     - [Hello, Spinner!](#hello-spinner)
     - [Hello, Table!](#hello-table)
+    - [Hello, Refined Table!](#hello-refined-table)
     - [Hello, Link!](#hello-link)
     - [Hello, Dialog!](#hello-dialog)
     - [Hello, Code Text!](#hello-code-text)
@@ -780,6 +781,18 @@ Hello, Table! Game Booked Rows
 
 ![Hello Table game booked rows](/images/glimmer-hello-table-game-booked-rows.png)
 
+#### Hello, Refined Table!
+
+This sample demonstrates the use of the [`refined_table` widget](/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#refined-table-with-pagination), which provides a paginated `table` that can handle very large amounts of data.
+
+Code:
+
+[samples/hello/hello_refined_table.rb](/samples/hello/hello_refined_table.rb)
+
+Hello, Refined Table!
+
+![Hello Refined Table](/images/glimmer-hello-refined-table.png)
+
 #### Hello, Link!
 
 This sample demonstrates the use of the `link` widget in Glimmer, including identifying which link was clicked and performing an action (displaying help) based on its location.

data/lib/glimmer/data_binding/table_items_binding.rb

@@ -39,18 +39,12 @@ module Glimmer
       TABLE_ITEM_PROPERTIES = %w[background foreground font image]
 
       def initialize(parent, model_binding, column_properties = nil)
-        @table = parent
+        @table = parent.is_a?(Glimmer::SWT::TableProxy) ? parent : parent.body_root # assume custom widget in latter case
         @model_binding = model_binding
         @read_only_sort = @model_binding.binding_options[:read_only_sort]
         @table.editable = false if @model_binding.binding_options[:read_only]
-        column_properties = @model_binding.binding_options[:column_properties] || @model_binding.binding_options[:column_attributes] || column_properties
-        if @table.is_a?(Glimmer::SWT::TableProxy)
-          @table.column_properties = column_properties
-          @column_properties = @table.column_properties # normalized column properties
-        else # assume custom widget
-          @table.body_root.column_properties = @column_properties
-          @column_properties = @table.body_root.column_properties # normalized column properties
-        end
+        @table.column_properties = @model_binding.binding_options[:column_properties] || @model_binding.binding_options[:column_attributes] || column_properties
+        @column_properties = @table.column_properties # normalized column properties
         Glimmer::SWT::DisplayProxy.instance.auto_exec(override_sync_exec: @model_binding.binding_options[:sync_exec], override_async_exec: @model_binding.binding_options[:async_exec]) do
           @table.swt_widget.data = @model_binding
           @table.swt_widget.set_data('table_items_binding', self)
@@ -69,6 +63,7 @@ module Glimmer
         Glimmer::SWT::DisplayProxy.instance.auto_exec(override_sync_exec: @model_binding.binding_options[:sync_exec], override_async_exec: @model_binding.binding_options[:async_exec]) do
           new_model_collection = model_binding_evaluated_property = @model_binding.evaluate_property unless internal_sort # this ensures applying converters (e.g. :on_read)
           return if same_table_data?(new_model_collection)
+          
           if same_model_collection?(new_model_collection)
             new_model_collection_attribute_values = model_collection_attribute_values(new_model_collection)
             @table.swt_widget.items.each_with_index do |table_item, row_index|
@@ -85,24 +80,38 @@ module Glimmer
             @last_model_collection_attribute_values = new_model_collection_attribute_values
           else
             if new_model_collection and new_model_collection.is_a?(Array)
-              remove_dependent(@table_observer_registration => @table_items_observer_registration) if @table_items_observer_registration
-              @table_items_observer_registration&.unobserve
-              # TODO observe and update table items piecemeal per model instead of passing @column_properties
-              # TODO ensure unobserving models when they are no longer part of the table
-              @table_items_observer_registration = observe(new_model_collection, @column_properties)
-              add_dependent(@table_observer_registration => @table_items_observer_registration)
-              @table_items_property_observer_registration ||= {}
+              @model_observer_registrations ||= {}
+              new_model_collection.each do |model|
+                @model_observer_registrations[model] ||= {}
+                @column_properties.each do |column_property|
+                  old_model_observer_registration = @model_observer_registrations[model][column_property]
+                  remove_dependent(@table_observer_registration => old_model_observer_registration) if old_model_observer_registration
+                  old_model_observer_registration&.unobserve
+                  model_observer_registration = observe(model, column_property)
+                  @model_observer_registrations[model][column_property] = model_observer_registration
+                  add_dependent(@table_observer_registration => model_observer_registration)
+                end
+              end
+
               if !same_model_collection_with_different_sort?(new_model_collection)
-                TABLE_ITEM_PROPERTIES.each do |table_item_property|
-                  remove_dependent(@table_observer_registration => @table_items_property_observer_registration[table_item_property]) if @table_items_property_observer_registration[table_item_property]
-                  @table_items_property_observer_registration[table_item_property]&.unobserve
-                  property_properties = @column_properties.map {|property| "#{property}_#{table_item_property}" }
-                  @table_items_property_observer_registration[table_item_property] = observe(new_model_collection, property_properties)
-                  add_dependent(@table_observer_registration => @table_items_property_observer_registration[table_item_property])
+                new_model_collection.each do |model|
+                  TABLE_ITEM_PROPERTIES.each do |table_item_property|
+                    @column_properties.each do |column_property|
+                      column_property = "#{column_property}_#{table_item_property}"
+                      old_model_observer_registration = @model_observer_registrations[model][column_property]
+                      remove_dependent(@table_observer_registration => old_model_observer_registration) if old_model_observer_registration
+                      old_model_observer_registration&.unobserve
+                      model_observer_registration = observe(model, column_property)
+                      @model_observer_registrations[model][column_property] = model_observer_registration
+                      add_dependent(@table_observer_registration => model_observer_registration)
+                    end
+                  end
                 end
               end
+              
               @model_collection = new_model_collection
             end
+            
             populate_table(@model_collection, @table, @column_properties, internal_sort: internal_sort)
           end
         end

data/lib/glimmer/data_binding/widget_binding.rb

@@ -31,7 +31,8 @@ module Glimmer
       include Observable
       include Observer
 
-      attr_reader :widget, :property
+      attr_reader :widget, :property, :model_binding
+      
       def initialize(widget, property, sync_exec: nil, async_exec: nil)
         @widget = widget
         @property = property
@@ -40,17 +41,35 @@ module Glimmer
         SWT::DisplayProxy.instance.auto_exec(override_sync_exec: @sync_exec, override_async_exec: @async_exec) do
           if @widget.is_a?(Glimmer::SWT::WidgetProxy) && @widget.respond_to?(:on_widget_disposed)
             @widget.on_widget_disposed do |dispose_event|
-              deregister_all_observables unless @widget.shell_proxy.last_shell_closing?
+              unless @widget.shell_proxy.last_shell_closing?
+                @widget_proxy.widget_bindings.delete(self)
+                deregister_all_observables
+              end
             end
           end
           # TODO look into hooking on_shape_disposed without slowing down shapes in samples like Tetris
         end
+        # TODO try to come up with a more comprehensive and cleaner solution to miscallenous objects like MessageBoxProxy with regards to @widget_proxy
+        @widget_proxy = widget.is_a?(Glimmer::SWT::WidgetProxy) ? widget : (widget.respond_to?(:body_root) ? widget.body_root : widget)
+      end
+      
+      def observe(*args)
+        if @widget_proxy.respond_to?(:widget_bindings)
+          # TODO try to come up with a more comprehensive and cleaner solution to miscallenous objects like MessageBoxProxy with regards to the following code
+          # assumes only one observation
+          @model_binding = args.first if args.size == 1
+          @widget_proxy.widget_bindings << self
+        end
+        super
       end
       
       def call(value)
         SWT::DisplayProxy.instance.auto_exec(override_sync_exec: @sync_exec, override_async_exec: @async_exec) do
           if @widget.respond_to?(:disposed?) && @widget.disposed?
-            deregister_all_observables unless @widget.shell_proxy.last_shell_closing?
+            unless @widget.shell_proxy.last_shell_closing?
+              @widget_proxy.widget_bindings.delete(self)
+              deregister_all_observables
+            end
             return
           end
           # need the rescue false for a scenario with tree items not being equal to model objects raising an exception
@@ -62,7 +81,10 @@ module Glimmer
       
       def evaluate_property
         if @widget.respond_to?(:disposed?) && @widget.disposed?
-          deregister_all_observables unless @widget.shell_proxy.last_shell_closing?
+          unless @widget.shell_proxy.last_shell_closing?
+            @widget_proxy.widget_bindings.delete(self)
+            deregister_all_observables
+          end
           return
         end
         @widget.get_attribute(@property)

data/lib/glimmer/dsl/swt/custom_widget_expression.rb

@@ -26,6 +26,7 @@ require 'glimmer/dsl/top_level_expression'
 require 'glimmer/ui/custom_widget'
 require 'glimmer/ui/custom_shell'
 require 'glimmer/swt/custom/code_text'
+require 'glimmer/swt/custom/refined_table'
 require 'glimmer/swt/custom/radio_group'
 require 'glimmer/swt/custom/checkbox_group'
 

data/lib/glimmer/swt/custom/refined_table.rb

@@ -0,0 +1,182 @@
+# Copyright (c) 2007-2022 Andy Maleh
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'glimmer/ui/custom_widget'
+
+module Glimmer
+  module SWT
+    module Custom
+      # RefinedTable is a customization of Table with support for Filtering/Pagination
+      class RefinedTable
+        include Glimmer::UI::CustomWidget
+        
+        option :per_page, default: 10
+        option :page, default: 0
+        option :model_array
+        
+        attr_accessor :refined_model_array
+        attr_reader :table_proxy, :page_text_proxy
+        
+        before_body do
+          self.model_array ||= []
+          self.refined_model_array = []
+        end
+        
+        after_body do
+          Glimmer::DataBinding::Observer.proc do |new_widget_bindings|
+            new_widget_bindings.each do |new_widget_binding|
+              if new_widget_binding.property.to_s == 'model_array' && !@data_bound
+                @data_bound = true
+                model_binding = new_widget_binding.model_binding
+                observe(self, :model_array) do
+                  paginate
+                end
+                @table_proxy.content {
+                  items(dsl: true) <=> [self, :refined_model_array, model_binding.binding_options.merge(read_only: true)]
+                }
+                paginate
+              end
+            end
+          end.observe(body_root.widget_bindings)
+        end
+        
+        body {
+          composite {
+            composite {
+              layout_data(:fill, :center, true, false)
+              
+              fill_layout(:horizontal)
+              
+              button {
+                text '<<'
+                
+                on_widget_selected do
+                  self.page = first_page
+                  paginate
+                end
+              }
+              
+              button {
+                text '<'
+                
+                on_widget_selected do
+                  self.page -= 1
+                  paginate
+                end
+              }
+              
+              @page_text_proxy = text(:border, :center) {
+                text <= [self, :page, on_read: ->(value) { "#{value} of #{page_count}" }]
+                
+                on_focus_gained do
+                  @page_text_proxy.select_all
+                end
+                
+                on_focus_lost do
+                  self.page = @page_text_proxy.text.to_i
+                  paginate
+                end
+                
+                on_key_pressed do |key_event|
+                  if key_event.keyCode == swt(:cr)
+                    self.page = @page_text_proxy.text.to_i
+                    paginate
+                  end
+                end
+              }
+              
+              button {
+                text '>'
+                
+                on_widget_selected do
+                  self.page += 1
+                  paginate
+                end
+              }
+              
+              button {
+                text '>>'
+                
+                on_widget_selected do
+                  self.page = last_page
+                  paginate
+                end
+              }
+            }
+            
+            @children_owner = @table_proxy = table(swt_style)
+          }
+        }
+        
+        def table_block=(block)
+          @table_proxy.content(&block)
+        end
+        
+        def method_missing(method_name, *args, &block)
+          dsl_mode = @dsl_mode || args.last.is_a?(Hash) && args.last[:dsl]
+          if dsl_mode
+            args.pop if args.last.is_a?(Hash) && args.last[:dsl]
+            super(method_name, *args, &block)
+          elsif @table_proxy&.respond_to?(method_name, *args, &block)
+            @table_proxy&.send(method_name, *args, &block)
+          else
+            super
+          end
+        end
+        
+        def respond_to?(method_name, *args, &block)
+          dsl_mode = @dsl_mode || args.last.is_a?(Hash) && args.last[:dsl]
+          if dsl_mode
+            args = args[0...-1] if args.last.is_a?(Hash) && args.last[:dsl]
+            super(method_name, *args, &block)
+          else
+            super || @table_proxy&.respond_to?(method_name, *args, &block)
+          end
+        end
+        
+        def page_count
+          (model_array && (model_array.count / per_page.to_f).ceil) || 0
+        end
+        
+        def corrected_page(initial_page_value = nil)
+          correct_page = initial_page_value || page
+          correct_page = [correct_page, page_count].min
+          correct_page = [correct_page, 1].max
+          correct_page = (model_array&.count.to_i > 0) ? (correct_page > 0 ? correct_page : 1) : 0
+          correct_page
+        end
+        
+        def first_page
+          (model_array&.count.to_i > 0) ? 1 : 0
+        end
+        
+        def last_page
+          page_count
+        end
+        
+        def paginate
+          self.page = corrected_page(page)
+          self.refined_model_array = model_array[(page - 1) * per_page, per_page]
+        end
+      end
+    end
+  end
+end

data/lib/glimmer/swt/widget_proxy.rb

@@ -159,7 +159,8 @@ module Glimmer
             @parent_proxy = parent
             styles, extra_options = extract_args(underscored_widget_name, args)
             swt_widget_class = self.class.swt_widget_class_for(underscored_widget_name)
-            @swt_widget = swt_widget_class.new(@parent_proxy.swt_widget, style(underscored_widget_name, styles), *extra_options)
+            swt_widget_producer = @parent_proxy.respond_to?(:children_owner) ? @parent_proxy.children_owner : @parent_proxy
+            @swt_widget = swt_widget_class.new(swt_widget_producer.swt_widget, style(underscored_widget_name, styles), *extra_options)
           else
             @swt_widget = swt_widget
             underscored_widget_name = self.class.underscored_widget_name(@swt_widget)
@@ -769,6 +770,10 @@ module Glimmer
           end
         end
       end
+      
+      def widget_bindings
+        @widget_bindings ||= []
+      end
 
       def content(&block)
         auto_exec do

data/lib/glimmer/ui/custom_widget.rb

@@ -271,6 +271,14 @@ module Glimmer
         "#{attribute_name}="
       end
       
+      def shell_proxy
+        @body_root.shell_proxy
+      end
+      
+      def children_owner
+        @children_owner || @body_root
+      end
+      
       def disposed?
         swt_widget.isDisposed
       end

data/samples/hello/hello_refined_table.rb

@@ -0,0 +1,159 @@
+# Copyright (c) 2007-2022 Andy Maleh
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'glimmer-dsl-swt'
+require 'date'
+
+class HelloRefinedTable
+  BaseballTeam = Struct.new(:name, :town, :ballpark, keyword_init: true) do
+    class << self
+      def all
+        @all ||= [
+          {town: 'Chicago', name: 'White Sox', ballpark: 'Guaranteed Rate Field'},
+          {town: 'Cleveland', name: 'Indians', ballpark: 'Progressive Field'},
+          {town: 'Detroit', name: 'Tigers', ballpark: 'Comerica Park'},
+          {town: 'Kansas City', name: 'Royals', ballpark: 'Kauffman Stadium'},
+          {town: 'Minnesota', name: 'Twins', ballpark: 'Target Field'},
+          {town: 'Baltimore', name: 'Orioles', ballpark: 'Oriole Park at Camden Yards'},
+          {town: 'Boston', name: 'Red Sox', ballpark: 'Fenway Park'},
+          {town: 'New York', name: 'Yankees', ballpark: 'Comerica Park'},
+          {town: 'Tampa Bay', name: 'Rays', ballpark: 'Tropicana Field'},
+          {town: 'Toronto', name: 'Blue Jays', ballpark: 'Rogers Centre'},
+          {town: 'Houston', name: 'Astros', ballpark: 'Minute Maid Park'},
+          {town: 'Los Angeles', name: 'Angels', ballpark: 'Angel Stadium'},
+          {town: 'Oakland', name: 'Athletics', ballpark: 'RingCentral Coliseum'},
+          {town: 'Seattle', name: 'Mariners', ballpark: 'T-Mobile Park'},
+          {town: 'Texas', name: 'Rangers', ballpark: 'Globe Life Field'},
+          {town: 'Chicago', name: 'Cubs', ballpark: 'Wrigley Field'},
+          {town: 'Cincinnati', name: 'Reds', ballpark: 'Great American Ball Park'},
+          {town: 'Milwaukee', name: 'Brewers', ballpark: 'American Family Field'},
+          {town: 'Pittsburgh', name: 'Pirates', ballpark: 'PNC Park'},
+          {town: 'St. Louis', name: 'Cardinals', ballpark: 'Busch Stadium'},
+          {town: 'Atlanta', name: 'Braves', ballpark: 'Truist Park'},
+          {town: 'Miami', name: 'Marlins', ballpark: 'LoanDepot Park'},
+          {town: 'New York', name: 'Mets', ballpark: 'Citi Field'},
+          {town: 'Philadelphia', name: 'Phillies', ballpark: 'Citizens Bank Park'},
+          {town: 'Washington', name: 'Nationals', ballpark: 'Nationals Park'},
+          {town: 'Arizona', name: 'Diamondbacks', ballpark: 'Chase Field'},
+          {town: 'Colorado', name: 'Rockies', ballpark: 'Coors Field'},
+          {town: 'Los Angeles', name: 'Dodgers', ballpark: 'Dodger Stadium'},
+          {town: 'San Diego', name: 'Padres', ballpark: 'Petco Park'},
+          {town: 'San Francisco', name: 'Giants', ballpark: 'Oracle Park'},
+        ].map {|team_kwargs| new(team_kwargs)}
+      end
+    end
+    
+    def complete_name
+      "#{town} #{name}"
+    end
+  end
+    
+  BaseballGame = Struct.new(:date, :home_team, :away_team, keyword_init: true) do
+    def home_team_name
+      home_team.complete_name
+    end
+    
+    def away_team_name
+      away_team.complete_name
+    end
+    
+    def ballpark
+      home_team.ballpark
+    end
+  end
+  
+  BaseballSeason = Struct.new(:year) do
+    def games
+      if @games.nil?
+        @games = []
+        baseball_team_combinations = BaseballTeam.all.combination(2).to_a
+        current_day = first_day
+        day_offset = 0
+        begin
+          if (day_offset % 7 != 6)
+            day_games = []
+            half_teams_count = BaseballTeam.all.count / 2
+            while day_games.uniq.count < half_teams_count
+              baseball_team_pair = baseball_team_combinations.sample
+              teams_played_so_far = day_games.map {|game| [game.home_team, game.away_team]}.flatten
+              unless teams_played_so_far.include?(baseball_team_pair.first) || teams_played_so_far.include?(baseball_team_pair.last)
+                baseball_game = BaseballGame.new(
+                  date: current_day,
+                  home_team: baseball_team_pair.first,
+                  away_team: baseball_team_pair.last,
+                )
+                day_games << baseball_game
+                @games << baseball_game
+              end
+            end
+          end
+          day_offset += 1
+          current_day += 1
+        end while current_day != first_day_of_playoffs
+      end
+      @games
+    end
+    
+    def first_day
+      @first_day ||= Date.new(year, 04, 01)
+    end
+    
+    def first_day_of_playoffs
+      @last_day ||= Date.new(year, 10, 01)
+    end
+  end
+  
+  include Glimmer::UI::Application
+  
+  before_body do
+    @baseball_season = BaseballSeason.new(Time.now.year)
+  end
+
+  body {
+    shell {
+      text 'Hello, Refined Table!'
+    
+      refined_table(per_page: 20) { # also `page: 1` by default
+        table_column {
+          width 100
+          text 'Date'
+        }
+        table_column {
+          width 200
+          text 'Ballpark'
+        }
+        table_column {
+          width 150
+          text 'Home Team'
+        }
+        table_column {
+          width 150
+          text 'Away Team'
+        }
+        
+        model_array <= [@baseball_season, :games, column_attributes: {'Home Team' => :home_team_name, 'Away Team' => :away_team_name}]
+      }
+    }
+  }
+
+end
+
+HelloRefinedTable.launch

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-swt
 version: !ruby/object:Gem::Version
-  version: 4.24.3.2
+  version: 4.24.4.0
 platform: ruby
 authors:
 - Andy Maleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-09-02 00:00:00.000000000 Z
+date: 2022-09-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
@@ -472,6 +472,7 @@ files:
 - lib/glimmer/swt/custom/code_text.rb
 - lib/glimmer/swt/custom/drawable.rb
 - lib/glimmer/swt/custom/radio_group.rb
+- lib/glimmer/swt/custom/refined_table.rb
 - lib/glimmer/swt/custom/shape.rb
 - lib/glimmer/swt/custom/shape/arc.rb
 - lib/glimmer/swt/custom/shape/cubic.rb
@@ -670,6 +671,7 @@ files:
 - samples/hello/hello_progress_bar.rb
 - samples/hello/hello_radio.rb
 - samples/hello/hello_radio_group.rb
+- samples/hello/hello_refined_table.rb
 - samples/hello/hello_sash_form.rb
 - samples/hello/hello_scale.rb
 - samples/hello/hello_scrolled_composite.rb