Module: Glimmer::UI::CustomWidget
Instance Attribute Summary collapse
Class Method Summary
collapse
Instance Method Summary
collapse
-
#add_observer(observer, attribute_name) ⇒ Object
-
#async_exec(&block) ⇒ Object
TODO see if it is worth it to eliminate duplication of async_exec/sync_exec delegation to DisplayProxy, via a module.
-
#attribute_setter(attribute_name) ⇒ Object
-
#can_add_observer?(attribute_name) ⇒ Boolean
-
#can_handle_observation_request?(observation_request) ⇒ Boolean
-
#content(&block) ⇒ Object
Returns content block if used as an attribute reader (no args) Otherwise, if a block is passed, it adds it as content to this custom widget.
-
#disposed? ⇒ Boolean
-
#get_attribute(attribute_name) ⇒ Object
-
#handle_observation_request(observation_request, &block) ⇒ Object
-
#has_attribute?(attribute_name, *args) ⇒ Boolean
-
#has_instance_method?(method_name) ⇒ Boolean
This method ensures it has an instance method not coming from Glimmer DSL.
-
#has_style?(style) ⇒ Boolean
-
#initialize(parent, *swt_constants, options, &content) ⇒ Object
-
#local_respond_to? ⇒ Object
-
#method_missing(method, *args, &block) ⇒ Object
-
#observer_registrations ⇒ Object
-
#post_initialize_child(child) ⇒ Object
Subclasses may override to perform post initialization work on an added child.
-
#respond_to?(method, *args, &block) ⇒ Boolean
-
#set_attribute(attribute_name, *args) ⇒ Object
-
#sync_exec(&block) ⇒ Object
-
#timer_exec(delay_in_millis, &block) ⇒ Object
Dynamic Method Handling
This class handles dynamic methods through the method_missing method
#method_missing(method, *args, &block) ⇒ Object
305
306
307
308
309
310
311
312
313
|
# File 'lib/glimmer/ui/custom_widget.rb', line 305
def method_missing(method, *args, &block)
if can_handle_observation_request?(method)
handle_observation_request(method, &block)
else
body_root.send(method, *args, &block)
end
end
|
Instance Attribute Details
#body_root ⇒ Object
Returns the value of attribute body_root.
169
170
171
|
# File 'lib/glimmer/ui/custom_widget.rb', line 169
def body_root
@body_root
end
|
#options ⇒ Object
Returns the value of attribute options.
169
170
171
|
# File 'lib/glimmer/ui/custom_widget.rb', line 169
def options
@options
end
|
#parent ⇒ Object
Returns the value of attribute parent.
169
170
171
|
# File 'lib/glimmer/ui/custom_widget.rb', line 169
def parent
@parent
end
|
#parent_proxy ⇒ Object
Returns the value of attribute parent_proxy.
169
170
171
|
# File 'lib/glimmer/ui/custom_widget.rb', line 169
def parent_proxy
@parent_proxy
end
|
#swt_style ⇒ Object
Returns the value of attribute swt_style.
169
170
171
|
# File 'lib/glimmer/ui/custom_widget.rb', line 169
def swt_style
@swt_style
end
|
Returns the value of attribute swt_widget.
169
170
171
|
# File 'lib/glimmer/ui/custom_widget.rb', line 169
def swt_widget
@swt_widget
end
|
Class Method Details
.after_body(&block) ⇒ Object
159
160
161
|
# File 'lib/glimmer/ui/custom_widget.rb', line 159
def after_body(&block)
@after_body_block = block
end
|
.before_body(&block) ⇒ Object
151
152
153
|
# File 'lib/glimmer/ui/custom_widget.rb', line 151
def before_body(&block)
@before_body_block = block
end
|
.body(&block) ⇒ Object
155
156
157
|
# File 'lib/glimmer/ui/custom_widget.rb', line 155
def body(&block)
@body_block = block
end
|
Current custom widgets being rendered. Useful to yoke all observers evaluated during rendering of their custom widgets for automatical disposal on_widget_disposed
164
165
166
|
# File 'lib/glimmer/ui/custom_widget.rb', line 164
def current_custom_widgets
@current_custom_widgets ||= []
end
|
106
107
108
|
# File 'lib/glimmer/ui/custom_widget.rb', line 106
def custom_widget_namespaces
@custom_widget_namespaces ||= reset_custom_widget_namespaces
end
|
.def_option_attr_accessors(new_options) ⇒ Object
138
139
140
141
142
143
144
145
146
147
148
149
|
# File 'lib/glimmer/ui/custom_widget.rb', line 138
def def_option_attr_accessors(new_options)
new_options.each do |option, default|
class_eval <<-end_eval, __FILE__, __LINE__
def #{option}
options[:#{option}]
end
def #{option}=(option_value)
self.options[:#{option}] = option_value
end
end_eval
end
end
|
Flyweight Design Pattern memoization cache. Can be cleared if memory is needed.
78
79
80
|
# File 'lib/glimmer/ui/custom_widget.rb', line 78
def flyweight_custom_widget_classes
@flyweight_custom_widget_classes ||= {}
end
|
.for(underscored_custom_widget_name) ⇒ Object
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
# File 'lib/glimmer/ui/custom_widget.rb', line 44
def for(underscored_custom_widget_name)
unless flyweight_custom_widget_classes.keys.include?(underscored_custom_widget_name)
begin
= underscored_custom_widget_name.
to_s.
split(/__/).map do |namespace|
namespace.camelcase(:upper)
end
custom_widget_namespaces.each do |base|
.reduce(base) do |result, namespace|
if !result.constants.include?(namespace)
namespace = result.constants.detect {|c| c.to_s.upcase == namespace.to_s.upcase } || namespace
end
begin
flyweight_custom_widget_classes[underscored_custom_widget_name] = constant = result.const_get(namespace)
return constant if constant.ancestors.include?(Glimmer::UI::CustomWidget)
flyweight_custom_widget_classes[underscored_custom_widget_name] = constant
rescue => e
flyweight_custom_widget_classes[underscored_custom_widget_name] = result
end
end
end
raise "#{underscored_custom_widget_name} has no custom widget class!"
rescue => e
Glimmer::Config.logger.debug {e.message}
Glimmer::Config.logger.debug {"#{e.message}\n#{e.backtrace.join("\n")}"}
flyweight_custom_widget_classes[underscored_custom_widget_name] = nil
end
end
flyweight_custom_widget_classes[underscored_custom_widget_name]
end
|
.keyword ⇒ Object
Returns keyword to use for this custom widget
83
84
85
|
# File 'lib/glimmer/ui/custom_widget.rb', line 83
def keyword
self.name.underscore.gsub('::', '__')
end
|
.namespaces_for_class(m) ⇒ Object
98
99
100
101
102
103
104
|
# File 'lib/glimmer/ui/custom_widget.rb', line 98
def namespaces_for_class(m)
return [m] if m.name.nil?
namespace_constants = m.name.split(/::/).map(&:to_sym)
namespace_constants.reduce([Object]) do |output, namespace_constant|
output += [output.last.const_get(namespace_constant)]
end[1..-1].uniq.reverse
end
|
.option(new_option, default: nil) ⇒ Object
131
132
133
134
135
136
|
# File 'lib/glimmer/ui/custom_widget.rb', line 131
def option(new_option, default: nil)
new_option = new_option.to_s.to_sym
new_options = {new_option => default}
@options = options.merge(new_options)
def_option_attr_accessors(new_options)
end
|
.options(*new_options) ⇒ Object
Allows defining convenience option accessors for an array of option names Example: ‘options :color1, :color2` defines `#color1` and `#color2` where they return the instance values `options` and `options` respectively. Can be called multiple times to set more options additively. When passed no arguments, it returns list of all option names captured so far
120
121
122
123
124
125
126
127
128
129
|
# File 'lib/glimmer/ui/custom_widget.rb', line 120
def options(*new_options)
new_options = new_options.compact.map(&:to_s).map(&:to_sym)
if new_options.empty?
@options ||= {} else
new_options = new_options.reduce({}) {|new_options_hash, new_option| new_options_hash.merge(new_option => nil)}
@options = options.merge(new_options)
def_option_attr_accessors(new_options)
end
end
|
110
111
112
|
# File 'lib/glimmer/ui/custom_widget.rb', line 110
def reset_custom_widget_namespaces
@custom_widget_namespaces = Set[Object, Glimmer::UI]
end
|
.shortcut_keyword ⇒ Object
Returns shortcut keyword to use for this custom widget (keyword minus namespace)
88
89
90
|
# File 'lib/glimmer/ui/custom_widget.rb', line 88
def shortcut_keyword
self.name.underscore.gsub('::', '__').split('__').last
end
|
Instance Method Details
#add_observer(observer, attribute_name) ⇒ Object
230
231
232
233
234
235
236
|
# File 'lib/glimmer/ui/custom_widget.rb', line 230
def add_observer(observer, attribute_name)
if has_instance_method?(attribute_name)
super
else
@body_root.add_observer(observer, attribute_name)
end
end
|
#async_exec(&block) ⇒ Object
TODO see if it is worth it to eliminate duplication of async_exec/sync_exec delegation to DisplayProxy, via a module
283
284
285
|
# File 'lib/glimmer/ui/custom_widget.rb', line 283
def async_exec(&block)
SWT::DisplayProxy.instance.async_exec(&block)
end
|
#attribute_setter(attribute_name) ⇒ Object
268
269
270
|
# File 'lib/glimmer/ui/custom_widget.rb', line 268
def attribute_setter(attribute_name)
"#{attribute_name}="
end
|
#can_add_observer?(attribute_name) ⇒ Boolean
226
227
228
|
# File 'lib/glimmer/ui/custom_widget.rb', line 226
def can_add_observer?(attribute_name)
has_instance_method?(attribute_name) || has_instance_method?("#{attribute_name}?") || @body_root.can_add_observer?(attribute_name)
end
|
#can_handle_observation_request?(observation_request) ⇒ Boolean
206
207
208
209
210
211
212
213
214
|
# File 'lib/glimmer/ui/custom_widget.rb', line 206
def can_handle_observation_request?(observation_request)
observation_request = observation_request.to_s
result = false
if observation_request.start_with?('on_updated_')
property = observation_request.sub(/^on_updated_/, '')
result = can_add_observer?(property)
end
result || body_root&.can_handle_observation_request?(observation_request)
end
|
#content(&block) ⇒ Object
Returns content block if used as an attribute reader (no args) Otherwise, if a block is passed, it adds it as content to this custom widget
297
298
299
300
301
302
303
|
# File 'lib/glimmer/ui/custom_widget.rb', line 297
def content(&block)
if block_given?
Glimmer::DSL::Engine.add_content(self, Glimmer::DSL::SWT::CustomWidgetExpression.new, self.class.keyword, &block)
else
@content
end
end
|
#disposed? ⇒ Boolean
272
273
274
|
# File 'lib/glimmer/ui/custom_widget.rb', line 272
def disposed?
swt_widget.isDisposed
end
|
#get_attribute(attribute_name) ⇒ Object
260
261
262
263
264
265
266
|
# File 'lib/glimmer/ui/custom_widget.rb', line 260
def get_attribute(attribute_name)
if has_instance_method?(attribute_name)
send(attribute_name)
else
@body_root.get_attribute(attribute_name)
end
end
|
#handle_observation_request(observation_request, &block) ⇒ Object
216
217
218
219
220
221
222
223
224
|
# File 'lib/glimmer/ui/custom_widget.rb', line 216
def handle_observation_request(observation_request, &block)
observation_request = observation_request.to_s
if observation_request.start_with?('on_updated_')
property = observation_request.sub(/^on_updated_/, '') add_observer(DataBinding::Observer.proc(&block), property) if can_add_observer?(property)
else
body_root.handle_observation_request(observation_request, &block)
end
end
|
#has_attribute?(attribute_name, *args) ⇒ Boolean
238
239
240
241
|
# File 'lib/glimmer/ui/custom_widget.rb', line 238
def has_attribute?(attribute_name, *args)
has_instance_method?(attribute_setter(attribute_name)) ||
@body_root.has_attribute?(attribute_name, *args)
end
|
#has_instance_method?(method_name) ⇒ Boolean
This method ensures it has an instance method not coming from Glimmer DSL
252
253
254
255
256
257
258
|
# File 'lib/glimmer/ui/custom_widget.rb', line 252
def has_instance_method?(method_name)
respond_to?(method_name) and
!swt_widget&.respond_to?(method_name) and
(method(method_name) rescue nil) and
!method(method_name)&.source_location&.first&.include?('glimmer/dsl/engine.rb') and
!method(method_name)&.source_location&.first&.include?('glimmer/swt/widget_proxy.rb')
end
|
#has_style?(style) ⇒ Boolean
276
277
278
|
# File 'lib/glimmer/ui/custom_widget.rb', line 276
def has_style?(style)
(swt_style & SWT::SWTProxy[style]) == SWT::SWTProxy[style]
end
|
#initialize(parent, *swt_constants, options, &content) ⇒ Object
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
|
# File 'lib/glimmer/ui/custom_widget.rb', line 171
def initialize(parent, *swt_constants, options, &content)
Glimmer::UI::CustomWidget.current_custom_widgets << self
@parent_proxy = @parent = parent
@parent_proxy = @parent&.get_data('proxy') if @parent.respond_to?(:get_data) && @parent.get_data('proxy')
@swt_style = SWT::SWTProxy[*swt_constants]
options ||= {}
@options = self.class.options.merge(options)
@content = Util::ProcTracker.new(content) if content
execute_hook('before_body')
body_block = self.class.instance_variable_get("@body_block")
raise Glimmer::Error, 'Invalid custom widget for having no body! Please define body block!' if body_block.nil?
@body_root = instance_exec(&body_block)
raise Glimmer::Error, 'Invalid custom widget for having an empty body! Please fill body block!' if @body_root.nil?
@swt_widget = @body_root.swt_widget
auto_exec do
@swt_widget.set_data('custom_widget', self)
end
execute_hook('after_body')
auto_exec do
@dispose_listener_registration = @body_root.on_widget_disposed do
observer_registrations.compact.each(&:deregister)
observer_registrations.clear
end
end
end
|
#local_respond_to? ⇒ Object
315
|
# File 'lib/glimmer/ui/custom_widget.rb', line 315
alias local_respond_to? respond_to?
|
#observer_registrations ⇒ Object
202
203
204
|
# File 'lib/glimmer/ui/custom_widget.rb', line 202
def observer_registrations
@observer_registrations ||= []
end
|
#post_initialize_child(child) ⇒ Object
Subclasses may override to perform post initialization work on an added child
198
199
200
|
# File 'lib/glimmer/ui/custom_widget.rb', line 198
def post_initialize_child(child)
end
|
#respond_to?(method, *args, &block) ⇒ Boolean
316
317
318
319
320
|
# File 'lib/glimmer/ui/custom_widget.rb', line 316
def respond_to?(method, *args, &block)
super or
can_handle_observation_request?(method) or
body_root.respond_to?(method, *args, &block)
end
|
#set_attribute(attribute_name, *args) ⇒ Object
243
244
245
246
247
248
249
|
# File 'lib/glimmer/ui/custom_widget.rb', line 243
def set_attribute(attribute_name, *args)
if has_instance_method?(attribute_setter(attribute_name))
send(attribute_setter(attribute_name), *args)
else
@body_root.set_attribute(attribute_name, *args)
end
end
|
#sync_exec(&block) ⇒ Object
287
288
289
|
# File 'lib/glimmer/ui/custom_widget.rb', line 287
def sync_exec(&block)
SWT::DisplayProxy.instance.sync_exec(&block)
end
|
#timer_exec(delay_in_millis, &block) ⇒ Object
291
292
293
|
# File 'lib/glimmer/ui/custom_widget.rb', line 291
def timer_exec(delay_in_millis, &block)
SWT::DisplayProxy.instance.timer_exec(delay_in_millis, &block)
end
|