Module: Tk::BLT::Table

Extended by:
Tk, TkItemConfigMethod
Includes:
Tk
Defined in:
lib/tkextlib/blt/table.rb

Defined Under Namespace

Modules: TableContainer

Constant Summary collapse

TkCommandNames = 
['::blt::table'.freeze].freeze

Constants included from TkUtil

TkUtil::None, TkUtil::RELEASE_DATE

Constants included from Tk

AUTO_PATH, INTERP, JAPANIZED_TK, LIBRARY_PATH, MAINLOOP, PACKAGE_PATH, RELEASE_DATE, TCL_LIBRARY_PATH, TCL_MAJOR_VERSION, TCL_MINOR_VERSION, TCL_PACKAGE_PATH, TCL_PATCHLEVEL, TCL_PRECISION, TCL_VERSION, TK_MAJOR_VERSION, TK_MINOR_VERSION, TK_PATCHLEVEL, TK_VERSION, Tkextlib_RELEASE_DATE, TreeCtrl_Widget, X_Scrollable, Y_Scrollable

Constants included from TkCore

TkCore::EventFlag, TkCore::INTERP, TkCore::WIDGET_DESTROY_HOOK

Constants included from TkComm

TkComm::GET_CONFIGINFO_AS_ARRAY, TkComm::GET_CONFIGINFOwoRES_AS_ARRAY, TkComm::TkExtlibAutoloadModule, TkComm::Tk_CMDTBL, TkComm::Tk_IDs, TkComm::Tk_WINDOWS, TkComm::USE_TCLs_LIST_FUNCTIONS, TkComm::WidgetClassNames

Class Method Summary collapse

Methods included from TkItemConfigMethod

current_itemconfiginfo, itemcget, itemconfiginfo, itemconfigure, tagid

Methods included from TkItemConfigOptkeys

#__conv_item_keyonly_opts, #itemconfig_hash_kv

Methods included from TkUtil

_conv_args, #_conv_args, #_fromUTF8, _get_eval_enc_str, #_get_eval_enc_str, #_get_eval_string, _get_eval_string, _symbolkey2str, #_symbolkey2str, #_toUTF8, bool, #bool, callback, eval_cmd, #hash_kv, hash_kv, install_cmd, num_or_str, #num_or_str, number, #number, string, #string, uninstall_cmd

Methods included from TkTreatItemFont

#kanjifont_copy, #kanjitagfont_configure, #latintagfont_configure, #latintagfont_copy, #tagfont_configinfo, #tagfont_configure, #tagfont_copy

Methods included from Tk

BinaryString, EncodedString, UTF8_String, add_kinsoku, bell, bell_on_display, const_missing, current_grabs, cursor_display, delete_kinsoku, destroy, encoding, encoding=, errorCode, errorInfo, exit, focus, focus_lastfor, focus_next, focus_prev, focus_to, fromUTF8, grid, grid_forget, has_mainwindow?, load_tcllibrary, load_tclscript, load_tclscript_rsrc, load_tclscript_rsrcid, lower_window, pack, pack_forget, pkgconfig_get, pkgconfig_list, place, place_forget, raise_window, root, show_kinsoku, strictMotif, subst_tk_backslash, subst_utf_backslash, tcl_pkgconfig_get, tcl_pkgconfig_list, thread_update, thread_update_idletasks, tk_pkgconfig_get, tk_pkgconfig_list, toUTF8, to_backslash_sequence, ungrid, unload_tcllibrary, unpack, unplace, update, update, update_idletasks, utf_to_backslash, utf_to_backslash_sequence

Methods included from Encoding

#encoding, #encoding=, #encoding_convertfrom, #encoding_convertto, #encoding_dirs, #encoding_dirs=, #encoding_names, #encoding_system, #encoding_system=

Methods included from TkCore

#_tk_call_to_list_core, #after, #after_cancel, #after_idle, #appname, #appsend, #appsend_deny, #appsend_displayof, callback, #callback_break, #callback_continue, #callback_return, #chooseColor, #chooseDirectory, #do_one_event, #event_generate, #getMultipleOpenFile, #getMultipleSaveFile, #getOpenFile, #getSaveFile, #get_eventloop_tick, #get_eventloop_weight, #get_no_event_wait, #inactive, #inactive_displayof, #info, #ip_eval, #ip_eval_with_enc, #ip_eval_without_enc, #ip_invoke, #ip_invoke_with_enc, #ip_invoke_without_enc, #is_mainloop?, #load_cmd_on_ip, #mainloop, #mainloop_exist?, #mainloop_thread?, #mainloop_watchdog, #messageBox, #rb_appsend, #rb_appsend_displayof, #reset_inactive, #reset_inactive_displayof, #restart, #scaling, #scaling_displayof, #set_eventloop_tick, #set_eventloop_weight, #set_no_event_wait, #tk_call, #tk_call_to_list, #tk_call_to_list_with_enc, #tk_call_to_list_without_enc, #tk_call_to_simplelist, #tk_call_to_simplelist_with_enc, #tk_call_to_simplelist_without_enc, #tk_call_with_enc, #tk_call_without_enc, #windowingsystem

Methods included from TkComm

#_at, #bind, #bind_all, #bind_append, #bind_append_all, #bind_remove, #bind_remove_all, #bindinfo, #bindinfo_all, #image_obj, #install_cmd, #subst, #uninstall_cmd

Methods included from TkEvent

#install_bind, #install_bind_for_event_class

Class Method Details

.add(container, *args) ⇒ Object 



304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
 
# File 'lib/tkextlib/blt/table.rb', line 304

def add(container, *args)
  if args.empty?
    tk_call('::blt::table', container)
  else
    args = args.collect{|arg|
      if arg.kind_of?(TkWindow)
        _epath(arg)
      elsif arg.kind_of?(Array)  # index
        arg.join(',')
      else
        arg
      end
    }
    tk_call('::blt::table', container, *args)
  end
  container
end

.arrange(container) ⇒ Object 



322
323
324
325
 
# File 'lib/tkextlib/blt/table.rb', line 322

def arrange(container)
  tk_call('::blt::table', 'arrange', container)
  container
end

.cget(container, option) ⇒ Object 



176
177
178
 
# File 'lib/tkextlib/blt/table.rb', line 176

def cget(container, option)
  __itemcget([container], option)
end

.configinfo(container, *args) ⇒ Object 



184
185
186
 
# File 'lib/tkextlib/blt/table.rb', line 184

def configinfo(container, *args)
  __itemconfiginfo([container], *args)
end

.configure(container, *args) ⇒ Object 



180
181
182
 
# File 'lib/tkextlib/blt/table.rb', line 180

def configure(container, *args)
  __itemconfigure([container], *args)
end

.containers(arg = {}) ⇒ Object 



363
364
365
 
# File 'lib/tkextlib/blt/table.rb', line 363

def containers(arg={})
  list(tk_call('::blt::table', 'containers', *hash_kv(arg)))
end

.containers_pattern(pat) ⇒ Object 



367
368
369
 
# File 'lib/tkextlib/blt/table.rb', line 367

def containers_pattern(pat)
  list(tk_call('::blt::table', 'containers', '-pattern', pat))
end

.containers_slave(win) ⇒ Object 



371
372
373
 
# File 'lib/tkextlib/blt/table.rb', line 371

def containers_slave(win)
  list(tk_call('::blt::table', 'containers', '-slave', win))
end

.create_container(container) ⇒ Object 



292
293
294
295
296
297
298
299
300
301
302
 
# File 'lib/tkextlib/blt/table.rb', line 292

def create_container(container)
  tk_call('::blt::table', container)
  begin
    class << container
      include Tk::BLT::Table::TableContainer
    end
  rescue
    warn('fail to include TableContainer methods (frozen object?)')
  end
  container
end

.current_configinfo(container, *args) ⇒ Object 



188
189
190
 
# File 'lib/tkextlib/blt/table.rb', line 188

def current_configinfo(container, *args)
  __current_itemconfiginfo([container], *args)
end

.current_itemconfiginfo(container, *args) ⇒ Object 



238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
 
# File 'lib/tkextlib/blt/table.rb', line 238

def current_itemconfiginfo(container, *args)
  slot = args[-1]
  if slot.kind_of?(String) || slot.kind_of?(Symbol)
    slot = slot.to_s
    if slot[0] == ?. || slot =~ /^\d+,\d+$/ || slot =~ /^(c|C|r|R)(\*|\d+)/
      #   widget     ||    row,col          ||    Ci or Ri
      slot = nil
    else
      # option
      slot = args.pop
    end
  else
    slot = nil
  end

  fail ArgumentError, 'no item is given' if args.empty?

  id = [container]
  args.each{|item| id << tagid(item)}
  __current_itemconfiginfo(id, slot)
end

.delete(container, *args) ⇒ Object 



327
328
329
 
# File 'lib/tkextlib/blt/table.rb', line 327

def delete(container, *args)
  tk_call('::blt::table', 'delete', container, *args)
end

.extents(container, item) ⇒ Object 



331
332
333
334
335
336
 
# File 'lib/tkextlib/blt/table.rb', line 331

def extents(container, item)
  ret = []
  inf = list(tk_call('::blt::table', 'extents', container, item))
  ret << inf.slice!(0..4) until inf.empty?
  ret
end

.forget(*wins) ⇒ Object 



338
339
340
341
 
# File 'lib/tkextlib/blt/table.rb', line 338

def forget(*wins)
  wins = wins.collect{|win| _epath(win)}
  tk_call('::blt::table', 'forget', *wins)
end

.info(container) ⇒ Object 



260
261
262
263
264
265
266
267
268
 
# File 'lib/tkextlib/blt/table.rb', line 260

def info(container)
  ret = {}
  inf = list(tk_call('::blt::table', 'info', container))
  until inf.empty?
    opt = inf.slice!(0..1)
    ret[opt[1..-1]] = opt[1]
  end
  ret
end

.insert(container, *args) ⇒ Object 



343
344
345
 
# File 'lib/tkextlib/blt/table.rb', line 343

def insert(container, *args)
  tk_call('::blt::table', 'insert', container, *args)
end

.insert_after(container, *args) ⇒ Object 



351
352
353
 
# File 'lib/tkextlib/blt/table.rb', line 351

def insert_after(container, *args)
  tk_call('::blt::table', 'insert', container, '-after', *args)
end

.insert_before(container, *args) ⇒ Object 



347
348
349
 
# File 'lib/tkextlib/blt/table.rb', line 347

def insert_before(container, *args)
  tk_call('::blt::table', 'insert', container, '-before', *args)
end

.itemcget(container, item, option) ⇒ Object 



192
193
194
 
# File 'lib/tkextlib/blt/table.rb', line 192

def itemcget(container, item, option)
  __itemcget([container, tagid(item)], option)
end

.itemconfiginfo(container, *args) ⇒ Object 



216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
 
# File 'lib/tkextlib/blt/table.rb', line 216

def itemconfiginfo(container, *args)
  slot = args[-1]
  if slot.kind_of?(String) || slot.kind_of?(Symbol)
    slot = slot.to_s
    if slot[0] == ?. || slot =~ /^\d+,\d+$/ || slot =~ /^(c|C|r|R)(\*|\d+)/
      #   widget     ||    row,col          ||    Ci or Ri
      slot = nil
    else
      # option
      slot = args.pop
    end
  else
    slot = nil
  end

  fail ArgumentError, 'no item is given' if args.empty?

  id = [container]
  args.each{|item| id << tagid(item)}
  __itemconfiginfo(id, slot)
end

.itemconfigure(container, *args) ⇒ Object 



196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
 
# File 'lib/tkextlib/blt/table.rb', line 196

def itemconfigure(container, *args)
  if args[-1].kind_of?(Hash)
    # container, item, item, ... , hash_optkeys
    keys = args.pop
    fail ArgumentError, 'no item is given' if args.empty?
    id = [container]
    args.each{|item| id << tagid(item)}
    __itemconfigure(id, keys)
  else
    # container, item, item, ... , option, value
    val = args.pop
    opt = args.pop
    fail ArgumentError, 'no item is given' if args.empty?
    id = [container]
    args.each{|item| id << tagid(item)}
    __itemconfigure(id, opt, val)
  end
  container
end

.iteminfo(container, item) ⇒ Object 



270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
 
# File 'lib/tkextlib/blt/table.rb', line 270

def iteminfo(container, item)
  inf = list(tk_call('::blt::table', 'info', container, tagid(item)).chomp)

  ret = []
  until inf.empty? || (inf[0].kind_of?(String) && inf[0] =~ /^-/)
    ret << inf.shift
  end

  if inf.length > 1
    keys = {}
    while inf.length > 1
      opt = inf.slice!(0..1)
      keys[opt[0][1..-1]] = opt[1]
    end
    ret << keys
  end

  ret
end

.join(container, first, last) ⇒ Object 



355
356
357
 
# File 'lib/tkextlib/blt/table.rb', line 355

def join(container, first, last)
  tk_call('::blt::table', 'join', container, first, last)
end

.locate(container, x, y) ⇒ Object 



359
360
361
 
# File 'lib/tkextlib/blt/table.rb', line 359

def locate(container, x, y)
  tk_call('::blt::table', 'locate', container, x, y)
end

.save(container) ⇒ Object 



375
376
377
 
# File 'lib/tkextlib/blt/table.rb', line 375

def save(container)
  tk_call('::blt::table', 'save', container)
end

.search(container, keys = {}) ⇒ Object 



379
380
381
 
# File 'lib/tkextlib/blt/table.rb', line 379

def search(container, keys={})
  list(tk_call('::blt::table', 'containers', *hash_kv(keys)))
end

.split(container, *args) ⇒ Object 



383
384
385
 
# File 'lib/tkextlib/blt/table.rb', line 383

def split(container, *args)
  tk_call('::blt::table', 'split', container, *args)
end

.tagid(tag) ⇒ Object 



151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
 
# File 'lib/tkextlib/blt/table.rb', line 151

def tagid(tag)
  if tag.kind_of?(Array)
    case tag[0]
    when Integer
      # [row, col]
      tag.join(',')
    when :c, :C, 'c', 'C', :r, :R, 'r', 'R'
      # c0 or r1 or C*, and so on
      tag.collect{|elem| elem.to_s}.join('')
    else
      tag
    end
  elsif tag.kind_of?(TkWindow)
    _epath(tag)
  else
    tag
  end
end

.tagid2obj(tagid) ⇒ Object 



170
171
172
 
# File 'lib/tkextlib/blt/table.rb', line 170

def tagid2obj(tagid)
  tagid
end