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, Fontchooser, 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 Encoding

Encoding::BINARY, Encoding::BINARY_NAME, Encoding::DEFAULT_EXTERNAL_NAME, Encoding::DEFAULT_INTERNAL_NAME, Encoding::ENCODING_TABLE, Encoding::RubyEncoding, Encoding::UNKNOWN, Encoding::UTF8_NAME

Constants included from TkCore

TkCore::EventFlag, TkCore::INTERP, TkCore::INTERP_MUTEX, TkCore::INTERP_ROOT_CHECK, TkCore::INTERP_THREAD, TkCore::INTERP_THREAD_STATUS, TkCore::RUN_EVENTLOOP_ON_MAIN_THREAD, TkCore::WIDGET_DESTROY_HOOK, TkCore::WITH_ENCODING, TkCore::WITH_RUBY_VM

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

__IGNORE_UNKNOWN_CONFIGURE_OPTION__, __check_available_itemconfigure_options, __current_itemconfiginfo, __set_IGNORE_UNKNOWN_CONFIGURE_OPTION__!, current_itemconfiginfo, itemcget, itemcget_strict, itemcget_tkstring, 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_nil, num_or_nil, num_or_str, #num_or_str, number, #number, string, #string, uninstall_cmd, untrust

Methods included from TkTreatItemFont

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

Methods included from Tk

BinaryString, EncodedString, Grid, Pack, Place, UTF8_String, __create_widget_set__, __disable_toplevel_control__, __import_toplevel_aliases__, __regist_toplevel_aliases__, __remove_toplevel_aliases__, __reset_toplevel_owner__, __set_loaded_toplevel_aliases__, __set_toplevel_aliases__, __toplevel_alias_setup_proc__, _replace_toplevel_aliases, add_kinsoku, backup_current_topdef, bell, bell_on_display, const_missing, current_grabs, cursor_display, default_widget_set, default_widget_set=, define_topalias, define_topobj, 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, regist_sym_for_loaded_file, replace_topalias, replace_topobj, root, set_topalias, show_kinsoku, sleep, 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, topalias_defined?, toplevel_aliases_on_widget_set, topobj_defined?, ungrid, unload_tcllibrary, unpack, unplace, update, update, update_idletasks, utf_to_backslash, utf_to_backslash_sequence, wakeup, widget_set_symbols

Methods included from Encoding

#default_encoding=, #encoding=, #encoding_convertfrom, #encoding_convertto, #encoding_dirs, #encoding_dirs=, #encoding_name, #encoding_names, #encoding_obj, #encoding_objs, #encoding_system=, #encoding_system_name, #encoding_system_obj, #force_default_encoding, #force_default_encoding=, #force_default_encoding?, #tk_encoding_names

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, _callback_entry?, _callback_entry_class?, _curr_cmd_id, _fromUTF8, _genobj_for_tkwidget, _next_cmd_id, _toUTF8, array2tk_list, #bind, #bind_all, #bind_append, #bind_append_all, #bind_remove, #bind_remove_all, #bindinfo, #bindinfo_all, bool, image_obj, #install_cmd, install_cmd, list, num_or_nil, num_or_str, number, procedure, simplelist, slice_ary, string, #subst, tk_tcl2ruby, uninstall_cmd, #uninstall_cmd, window

Methods included from TkEvent

#install_bind, #install_bind_for_event_class

Class Method Details

.__boolval_optkeys ⇒ Object 



161
162
163
 
# File 'lib/tkextlib/blt/table.rb', line 161

def __boolval_optkeys
  super() << 'propagate'
end

.__current_itemconfiginfo ⇒ Object 



156
 
# File 'lib/tkextlib/blt/table.rb', line 156

alias __current_itemconfiginfo current_itemconfiginfo

.__item_cget_cmd(id) ⇒ Object

id := [ container, item ]



132
133
134
135
 
# File 'lib/tkextlib/blt/table.rb', line 132

def __item_cget_cmd(id) # id := [ container, item ]
  win = (id[0].kind_of?(TkWindow))? id[0].path: id[0].to_s
  ['::blt::table', 'cget', win, id[1]]
end

.__item_config_cmd(id) ⇒ Object

id := [ container, item, … ]



138
139
140
141
142
 
# File 'lib/tkextlib/blt/table.rb', line 138

def __item_config_cmd(id) # id := [ container, item, ... ]
  container, *items = id
  win = (container.kind_of?(TkWindow))? container.path: container.to_s
  ['::blt::table', 'configure', win, *items]
end

.__item_pathname(id) ⇒ Object 



145
146
147
148
 
# File 'lib/tkextlib/blt/table.rb', line 145

def __item_pathname(id)
  win = (id[0].kind_of?(TkWindow))? id[0].path: id[0].to_s
  win + ';'
end

.__itemcget ⇒ Object 



152
 
# File 'lib/tkextlib/blt/table.rb', line 152

alias __itemcget itemcget

.__itemcget_strict ⇒ Object 



153
 
# File 'lib/tkextlib/blt/table.rb', line 153

alias __itemcget_strict itemcget_strict

.__itemcget_tkstring ⇒ Object 



151
 
# File 'lib/tkextlib/blt/table.rb', line 151

alias __itemcget_tkstring itemcget_tkstring

.__itemconfiginfo ⇒ Object 



155
 
# File 'lib/tkextlib/blt/table.rb', line 155

alias __itemconfiginfo itemconfiginfo

.__itemconfigure ⇒ Object 



154
 
# File 'lib/tkextlib/blt/table.rb', line 154

alias __itemconfigure itemconfigure

.add(container, *args) ⇒ Object 



331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
 
# File 'lib/tkextlib/blt/table.rb', line 331

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 



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

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

.cget(container, option) ⇒ Object 



194
195
196
 
# File 'lib/tkextlib/blt/table.rb', line 194

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

.cget_strict(container, option) ⇒ Object 



197
198
199
 
# File 'lib/tkextlib/blt/table.rb', line 197

def cget_strict(container, option)
  __itemcget_strict([container], option)
end

.cget_tkstring(container, option) ⇒ Object 



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

def cget_tkstring(container, option)
  __itemcget_tkstring([container], option)
end

.configinfo(container, *args) ⇒ Object 



205
206
207
 
# File 'lib/tkextlib/blt/table.rb', line 205

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

.configure(container, *args) ⇒ Object 



201
202
203
 
# File 'lib/tkextlib/blt/table.rb', line 201

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

.containers(arg = {}) ⇒ Object 



390
391
392
 
# File 'lib/tkextlib/blt/table.rb', line 390

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

.containers_pattern(pat) ⇒ Object 



394
395
396
 
# File 'lib/tkextlib/blt/table.rb', line 394

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

.containers_slave(win) ⇒ Object 



398
399
400
 
# File 'lib/tkextlib/blt/table.rb', line 398

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

.create_container(container) ⇒ Object 



319
320
321
322
323
324
325
326
327
328
329
 
# File 'lib/tkextlib/blt/table.rb', line 319

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 



209
210
211
 
# File 'lib/tkextlib/blt/table.rb', line 209

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

.current_itemconfiginfo(container, *args) ⇒ Object 



265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
 
# File 'lib/tkextlib/blt/table.rb', line 265

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 



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

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

.extents(container, item) ⇒ Object 



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

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 



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

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

.info(container) ⇒ Object 



287
288
289
290
291
292
293
294
295
 
# File 'lib/tkextlib/blt/table.rb', line 287

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 



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

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

.insert_after(container, *args) ⇒ Object 



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

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

.insert_before(container, *args) ⇒ Object 



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

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

.itemcget(container, item, option) ⇒ Object 



216
217
218
 
# File 'lib/tkextlib/blt/table.rb', line 216

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

.itemcget_strict(container, item, option) ⇒ Object 



219
220
221
 
# File 'lib/tkextlib/blt/table.rb', line 219

def itemcget_strict(container, item, option)
  __itemcget_strict([container, tagid(item)], option)
end

.itemcget_tkstring(container, item, option) ⇒ Object 



213
214
215
 
# File 'lib/tkextlib/blt/table.rb', line 213

def itemcget_tkstring(container, item, option)
  __itemcget_tkstring([container, tagid(item)], option)
end

.itemconfiginfo(container, *args) ⇒ Object 



243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
 
# File 'lib/tkextlib/blt/table.rb', line 243

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 



223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
 
# File 'lib/tkextlib/blt/table.rb', line 223

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 



297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
 
# File 'lib/tkextlib/blt/table.rb', line 297

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 



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

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

.locate(container, x, y) ⇒ Object 



386
387
388
 
# File 'lib/tkextlib/blt/table.rb', line 386

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

.save(container) ⇒ Object 



402
403
404
 
# File 'lib/tkextlib/blt/table.rb', line 402

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

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



406
407
408
 
# File 'lib/tkextlib/blt/table.rb', line 406

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

.split(container, *args) ⇒ Object 



410
411
412
 
# File 'lib/tkextlib/blt/table.rb', line 410

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

.tagid(tag) ⇒ Object 



166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
 
# File 'lib/tkextlib/blt/table.rb', line 166

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 



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

def tagid2obj(tagid)
  tagid
end