Class: Glimmer::SWT::TableProxy

Inherits:
WidgetProxy show all
Includes:
Glimmer
Defined in:
lib/glimmer/swt/table_proxy.rb

Defined Under Namespace

Modules: TableListenerEvent

Constant Summary

Constants inherited from WidgetProxy

WidgetProxy::DEFAULT_INITIALIZERS, WidgetProxy::DEFAULT_STYLES, WidgetProxy::KEYWORD_ALIASES

Instance Attribute Summary collapse

Attributes inherited from WidgetProxy

#drag_source_proxy, #drag_source_style, #drag_source_transfer, #drop_target_proxy, #drop_target_transfer, #parent_proxy, #swt_widget

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Glimmer

included

Methods inherited from WidgetProxy

#add_observer, #async_exec, #can_add_observer?, #can_handle_drag_observation_request?, #can_handle_drop_observation_request?, #can_handle_observation_request?, #content, create, #dispose, #ensure_drag_source_proxy, #ensure_drop_target_proxy, #extract_args, #get_attribute, #handle_observation_request, #has_attribute?, #has_style?, #method_missing, #pack_same_size, #remove_observer, #respond_to?, #set_attribute, swt_widget_class_for, swt_widget_class_manual_entries, #sync_exec, underscored_widget_name, widget_exists?, #widget_property_listener_installers, widget_proxy_class

Methods included from Packages

included

Constructor Details

#initialize(underscored_widget_name, parent, args) ⇒ TableProxy

Returns a new instance of TableProxy.



252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
 
# File 'lib/glimmer/swt/table_proxy.rb', line 252

def initialize(underscored_widget_name, parent, args)
  @editable = args.delete(:editable)
  super
  @table_editor = TableEditor.new(swt_widget)
  @table_editor.horizontalAlignment = SWTProxy[:left]
  @table_editor.grabHorizontal = true
  @table_editor.minimumHeight = 20
  if editable?
    content {
      on_mouse_up { |event|
        edit_table_item(event.table_item, event.column_index)
      }
    }
  end
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Glimmer::SWT::WidgetProxy

Instance Attribute Details

#additional_sort_properties ⇒ Object

Returns the value of attribute additional_sort_properties.



248
249
250
 
# File 'lib/glimmer/swt/table_proxy.rb', line 248

def additional_sort_properties
  @additional_sort_properties
end

#column_properties ⇒ Object

Returns the value of attribute column_properties.



249
250
251
 
# File 'lib/glimmer/swt/table_proxy.rb', line 249

def column_properties
  @column_properties
end

#editable ⇒ Object (readonly) Also known as: editable?

Returns the value of attribute editable.



248
249
250
 
# File 'lib/glimmer/swt/table_proxy.rb', line 248

def editable
  @editable
end

#editor ⇒ Object

Returns the value of attribute editor.



248
249
250
 
# File 'lib/glimmer/swt/table_proxy.rb', line 248

def editor
  @editor
end

#sort_block ⇒ Object

Returns the value of attribute sort_block.



248
249
250
 
# File 'lib/glimmer/swt/table_proxy.rb', line 248

def sort_block
  @sort_block
end

#sort_by_block ⇒ Object

Returns the value of attribute sort_by_block.



248
249
250
 
# File 'lib/glimmer/swt/table_proxy.rb', line 248

def sort_by_block
  @sort_by_block
end

#sort_direction ⇒ Object (readonly)

Returns the value of attribute sort_direction.



248
249
250
 
# File 'lib/glimmer/swt/table_proxy.rb', line 248

def sort_direction
  @sort_direction
end

#sort_property ⇒ Object

Returns the value of attribute sort_property.



248
249
250
 
# File 'lib/glimmer/swt/table_proxy.rb', line 248

def sort_property
  @sort_property
end

#sort_type ⇒ Object (readonly)

Returns the value of attribute sort_type.



248
249
250
 
# File 'lib/glimmer/swt/table_proxy.rb', line 248

def sort_type
  @sort_type
end

#table_editor ⇒ Object (readonly)

Returns the value of attribute table_editor.



248
249
250
 
# File 'lib/glimmer/swt/table_proxy.rb', line 248

def table_editor
  @table_editor
end

#table_editor_widget_proxy ⇒ Object (readonly)

Returns the value of attribute table_editor_widget_proxy.



248
249
250
 
# File 'lib/glimmer/swt/table_proxy.rb', line 248

def table_editor_widget_proxy
  @table_editor_widget_proxy
end

Class Method Details

.editors ⇒ Object 



58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
 
# File 'lib/glimmer/swt/table_proxy.rb', line 58

def editors
  @editors ||= {
    # ensure editor can work with string keys not just symbols (leave one string in for testing)
    'text' => {
      widget_value_property: :text,
      editor_gui: lambda do |args, model, property, table_proxy|
        table_proxy.table_editor.minimumHeight = 20
        table_editor_widget_proxy = text(*args) {
          text model.send(property)
          focus true
          on_focus_lost {
            table_proxy.finish_edit!
          }
          on_key_pressed { |key_event|
            if key_event.keyCode == swt(:cr)
              table_proxy.finish_edit!
            elsif key_event.keyCode == swt(:esc)
              table_proxy.cancel_edit!
            end
          }
        }
        table_editor_widget_proxy.swt_widget.selectAll
        table_editor_widget_proxy
      end,
    },
    combo: {
      widget_value_property: :text,
      editor_gui: lambda do |args, model, property, table_proxy|
        first_time = true
        table_proxy.table_editor.minimumHeight = 25
        table_editor_widget_proxy = combo(*args) {
          items model.send("#{property}_options")
          text model.send(property)
          focus true
          on_focus_lost {
            table_proxy.finish_edit!
          }
          on_key_pressed { |key_event|
            if key_event.keyCode == swt(:cr)
              table_proxy.finish_edit!
            elsif key_event.keyCode == swt(:esc)
              table_proxy.cancel_edit!
            end
          }
          on_widget_selected {
            if !OS.windows? || !first_time || first_time && model.send(property) != table_editor_widget_proxy.swt_widget.text
              table_proxy.finish_edit!
            end
          }
        }
        table_editor_widget_proxy
      end,
    },
    checkbox: {
      widget_value_property: :selection,
      editor_gui: lambda do |args, model, property, table_proxy|
        first_time = true
        table_proxy.table_editor.minimumHeight = 25
        checkbox(*args) {
          selection model.send(property)
          focus true
          on_widget_selected {
            table_proxy.finish_edit!
          }
          on_focus_lost {
            table_proxy.finish_edit!
          }
          on_key_pressed { |key_event|
            if key_event.keyCode == swt(:cr)
              table_proxy.finish_edit!
            elsif key_event.keyCode == swt(:esc)
              table_proxy.cancel_edit!
            end
          }
        }
      end,
    },
    date: {
      widget_value_property: :date_time,
      editor_gui: lambda do |args, model, property, table_proxy|
        first_time = true
        table_proxy.table_editor.minimumHeight = 25
        date(*args) {
          date_time model.send(property)
          focus true
          on_focus_lost {
            table_proxy.finish_edit!
          }
          on_key_pressed { |key_event|
            if key_event.keyCode == swt(:cr)
              table_proxy.finish_edit!
            elsif key_event.keyCode == swt(:esc)
              table_proxy.cancel_edit!
            end
          }
        }
      end,
    },
    date_drop_down: {
      widget_value_property: :date_time,
      editor_gui: lambda do |args, model, property, table_proxy|
        first_time = true
        table_proxy.table_editor.minimumHeight = 25
        date_drop_down(*args) {
          date_time model.send(property)
          focus true
          on_focus_lost {
            table_proxy.finish_edit!
          }
          on_key_pressed { |key_event|
            if key_event.keyCode == swt(:cr)
              table_proxy.finish_edit!
            elsif key_event.keyCode == swt(:esc)
              table_proxy.cancel_edit!
            end
          }
        }
      end,
    },
    time: {
      widget_value_property: :date_time,
      editor_gui: lambda do |args, model, property, table_proxy|
        first_time = true
        table_proxy.table_editor.minimumHeight = 25
        time(*args) {
          date_time model.send(property)
          focus true
          on_focus_lost {
            table_proxy.finish_edit!
          }
          on_key_pressed { |key_event|
            if key_event.keyCode == swt(:cr)
              table_proxy.finish_edit!
            elsif key_event.keyCode == swt(:esc)
              table_proxy.cancel_edit!
            end
          }
        }
      end,
    },
    radio: {
      widget_value_property: :selection,
      editor_gui: lambda do |args, model, property, table_proxy|
        first_time = true
        table_proxy.table_editor.minimumHeight = 25
        radio(*args) {
          selection model.send(property)
          focus true
          on_widget_selected {
            table_proxy.finish_edit!
          }
          on_focus_lost {
            table_proxy.finish_edit!
          }
          on_key_pressed { |key_event|
            if key_event.keyCode == swt(:cr)
              table_proxy.finish_edit!
            elsif key_event.keyCode == swt(:esc)
              table_proxy.cancel_edit!
            end
          }
        }
      end,
    },
    spinner: {
      widget_value_property: :selection,
      editor_gui: lambda do |args, model, property, table_proxy|
        first_time = true
        table_proxy.table_editor.minimumHeight = 25
        table_editor_widget_proxy = (*args) {
          selection model.send(property)
          focus true
          on_focus_lost {
            table_proxy.finish_edit!
          }
          on_key_pressed { |key_event|
            if key_event.keyCode == swt(:cr)
              table_proxy.finish_edit!
            elsif key_event.keyCode == swt(:esc)
              table_proxy.cancel_edit!
            end
          }
        }
        table_editor_widget_proxy
      end,
    },
  }
end

Instance Method Details

#add_listener(underscored_listener_name, &block) ⇒ Object 



509
510
511
512
513
514
515
 
# File 'lib/glimmer/swt/table_proxy.rb', line 509

def add_listener(underscored_listener_name, &block)
  enhanced_block = lambda do |event|
    event.extend(TableListenerEvent)
    block.call(event)
  end
  super(underscored_listener_name, &enhanced_block)
end

#all_table_items ⇒ Object

Returns all table items including descendants



406
407
408
 
# File 'lib/glimmer/swt/table_proxy.rb', line 406

def all_table_items
  search
end

#cancel_edit! ⇒ Object 



429
430
431
 
# File 'lib/glimmer/swt/table_proxy.rb', line 429

def cancel_edit!
  @cancel_edit&.call if @edit_mode
end

#cells ⇒ Object 



393
394
395
396
 
# File 'lib/glimmer/swt/table_proxy.rb', line 393

def cells
  column_count = @table.column_properties.size
  swt_widget.items.map {|item| column_count.times.map {|i| item.get_text(i)} }
end

#cells_for(model) ⇒ Object 



389
390
391
 
# File 'lib/glimmer/swt/table_proxy.rb', line 389

def cells_for(model)
  column_properties.map {|property| model.send(property)}
end

#column_sort_properties ⇒ Object 



300
301
302
303
304
 
# File 'lib/glimmer/swt/table_proxy.rb', line 300

def column_sort_properties
  column_properties.zip(table_column_proxies.map(&:sort_property)).map do |pair|
    [pair.compact.last].flatten.compact
  end
end

#detect_sort_type ⇒ Object 



284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
 
# File 'lib/glimmer/swt/table_proxy.rb', line 284

def detect_sort_type
  @sort_type = sort_property.size.times.map { String }
  array = model_binding.evaluate_property
  sort_property.each_with_index do |a_sort_property, i|
    values = array.map { |object| object.send(a_sort_property) }
    value_classes = values.map(&:class).uniq
    if value_classes.size == 1
      @sort_type[i] = value_classes.first
    elsif value_classes.include?(Integer)
      @sort_type[i] = Integer
    elsif value_classes.include?(Float)
      @sort_type[i] = Float
    end
  end
end

#edit_in_progress? ⇒ Boolean

Indicates if table is editing a table item because the user hit ENTER or focused out after making a change in edit mode to a table item cell. It is set to false once change is saved to model

Returns:

  • (Boolean) 


439
440
441
 
# File 'lib/glimmer/swt/table_proxy.rb', line 439

def edit_in_progress?
  !!@edit_in_progress
end

#edit_mode? ⇒ Boolean

Indicates if table is in edit mode, thus displaying a text widget for a table item cell

Returns:

  • (Boolean) 


425
426
427
 
# File 'lib/glimmer/swt/table_proxy.rb', line 425

def edit_mode?
  !!@edit_mode
end

#edit_selected_table_item(column_index, before_write: nil, after_write: nil, after_cancel: nil) ⇒ Object 



443
444
445
 
# File 'lib/glimmer/swt/table_proxy.rb', line 443

def edit_selected_table_item(column_index, before_write: nil, after_write: nil, after_cancel: nil)
  edit_table_item(swt_widget.getSelection.first, column_index, before_write: before_write, after_write: after_write, after_cancel: after_cancel)
end

#edit_table_item(table_item, column_index, before_write: nil, after_write: nil, after_cancel: nil) ⇒ Object 



447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
 
# File 'lib/glimmer/swt/table_proxy.rb', line 447

def edit_table_item(table_item, column_index, before_write: nil, after_write: nil, after_cancel: nil)
  require 'facets/hash/symbolize_keys'
  return if table_item.nil?
  model = table_item.data
  property = column_properties[column_index]
  cancel_edit!
  return unless table_column_proxies[column_index].editable?
  action_taken = false
  @edit_mode = true
  
  editor_config = table_column_proxies[column_index].editor || editor
  editor_config = editor_config.to_a
  editor_widget_options = editor_config.last.is_a?(Hash) ? editor_config.last : {}
  editor_widget_arg_last_index = editor_config.last.is_a?(Hash) ? -2 : -1
  editor_widget = (editor_config[0] || :text).to_sym
  editor_widget_args = editor_config[1..editor_widget_arg_last_index]
  model_editing_property = editor_widget_options[:property] || property
  widget_value_property = TableProxy::editors.symbolize_keys[editor_widget][:widget_value_property]
  
  @cancel_edit = lambda do |event=nil|
    @cancel_in_progress = true
    @table_editor_widget_proxy&.swt_widget&.dispose
    @table_editor_widget_proxy = nil
    after_cancel&.call
    @edit_in_progress = false
    @cancel_in_progress = false
    @cancel_edit = nil
    @edit_mode = false
  end
  
  @finish_edit = lambda do |event=nil|
    new_value = @table_editor_widget_proxy&.send(widget_value_property)
    if table_item.isDisposed
      @cancel_edit.call
    elsif !new_value.nil? && !action_taken && !@edit_in_progress && !@cancel_in_progress
      action_taken = true
      @edit_in_progress = true
      if new_value == model.send(model_editing_property)
        @cancel_edit.call
      else
        before_write&.call
        model.send("#{model_editing_property}=", new_value) # makes table update itself, so must search for selected table item again
        # Table refresh happens here because of model update triggering observers, so must retrieve table item again
        edited_table_item = search { |ti| ti.getData == model }.first
        swt_widget.showItem(edited_table_item)
        @table_editor_widget_proxy&.swt_widget&.dispose
        @table_editor_widget_proxy = nil
        after_write&.call(edited_table_item)
        @edit_in_progress = false
      end
    end
  end

  content {
    @table_editor_widget_proxy = TableProxy::editors.symbolize_keys[editor_widget][:editor_gui].call(editor_widget_args, model, model_editing_property, self)
  }
  @table_editor.setEditor(@table_editor_widget_proxy.swt_widget, table_item, column_index)
rescue => e
  Glimmer::Config.logger.error {e.full_message}
  raise e
end

#finish_edit! ⇒ Object 



433
434
435
 
# File 'lib/glimmer/swt/table_proxy.rb', line 433

def finish_edit!
  @finish_edit&.call if @edit_mode
end

#initial_sort! ⇒ Object 



348
349
350
 
# File 'lib/glimmer/swt/table_proxy.rb', line 348

def initial_sort!
  sort_by_column!
end

#model_binding ⇒ Object 



268
269
270
 
# File 'lib/glimmer/swt/table_proxy.rb', line 268

def model_binding
  swt_widget.data
end

#post_add_content ⇒ Object 



414
415
416
417
418
 
# File 'lib/glimmer/swt/table_proxy.rb', line 414

def post_add_content
  return if @initially_sorted
  initial_sort!
  @initially_sorted = true
end

#post_initialize_child(table_column_proxy) ⇒ Object 



410
411
412
 
# File 'lib/glimmer/swt/table_proxy.rb', line 410

def post_initialize_child(table_column_proxy)
  table_column_proxies << table_column_proxy
end

#search(&condition) ⇒ Object

Performs a search for table items matching block condition If no condition block is passed, returns all table items Returns a Java TableItem array to easily set as selection on org.eclipse.swt.Table if needed



401
402
403
 
# File 'lib/glimmer/swt/table_proxy.rb', line 401

def search(&condition)
  swt_widget.getItems.select {|item| condition.nil? || condition.call(item)}.to_java(TableItem)
end

#sort! ⇒ Object 



356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
 
# File 'lib/glimmer/swt/table_proxy.rb', line 356

def sort!
  return unless sort_property && (sort_type || sort_block || sort_by_block)
  array = model_binding.evaluate_property
  array = array.sort_by(&:hash) # this ensures consistent subsequent sorting in case there are equivalent sorts to avoid an infinite loop
  # Converting value to_s first to handle nil cases. Should work with numeric, boolean, and date fields
  if sort_block
    sorted_array = array.sort(&sort_block)
  elsif sort_by_block
    sorted_array = array.sort_by(&sort_by_block)
  else
    sorted_array = array.sort_by do |object|
      sort_property.each_with_index.map do |a_sort_property, i|
        value = object.send(a_sort_property)
        # handle nil and difficult to compare types gracefully
        if sort_type[i] == Integer
          value = value.to_i
        elsif sort_type[i] == Float
          value = value.to_f
        elsif sort_type[i] == String
          value = value.to_s
        end
        value
      end
    end
  end
  sorted_array = sorted_array.reverse if sort_direction == :descending
  model_binding.call(sorted_array)
end

#sort_by_column!(table_column_proxy = nil) ⇒ Object

Sorts by specified TableColumnProxy object. If nil, it uses the table default sort instead.



307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
 
# File 'lib/glimmer/swt/table_proxy.rb', line 307

def sort_by_column!(table_column_proxy=nil)
  index = swt_widget.columns.to_a.index(table_column_proxy.swt_widget) unless table_column_proxy.nil?
  new_sort_property = table_column_proxy.nil? ? @sort_property : table_column_proxy.sort_property || [column_properties[index]]
  return if table_column_proxy.nil? && new_sort_property.nil? && @sort_block.nil? && @sort_by_block.nil?
  if new_sort_property && table_column_proxy.nil? && new_sort_property.size == 1 && (index = column_sort_properties.index(new_sort_property))
    table_column_proxy = table_column_proxies[index]
  end
  if new_sort_property && new_sort_property.size == 1 && !additional_sort_properties.to_a.empty?
    selected_additional_sort_properties = additional_sort_properties.clone
    if selected_additional_sort_properties.include?(new_sort_property.first)
      selected_additional_sort_properties.delete(new_sort_property.first)
      new_sort_property += selected_additional_sort_properties
    else
      new_sort_property += additional_sort_properties
    end
  end
  
  @sort_direction = @sort_direction.nil? || @sort_property.first != new_sort_property.first || @sort_direction == :descending ? :ascending : :descending
  swt_widget.sort_direction = @sort_direction == :ascending ? SWTProxy[:up] : SWTProxy[:down]
  
  @sort_property = [new_sort_property].flatten.compact
  table_column_index = column_properties.index(new_sort_property.to_s.to_sym)
  table_column_proxy ||= table_column_proxies[table_column_index] if table_column_index
  swt_widget.sort_column = table_column_proxy.swt_widget if table_column_proxy
          
  if table_column_proxy
    @sort_by_block = nil
    @sort_block = nil
  end
  @sort_type = nil
  if table_column_proxy&.sort_by_block
    @sort_by_block = table_column_proxy.sort_by_block
  elsif table_column_proxy&.sort_block
    @sort_block = table_column_proxy.sort_block
  else
    detect_sort_type
  end
          
  sort!
end

#table_column_proxies ⇒ Object 



420
421
422
 
# File 'lib/glimmer/swt/table_proxy.rb', line 420

def table_column_proxies
  @table_column_proxies ||= []
end