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_optkeysObject



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

def __boolval_optkeys
  super() << 'propagate'
end

.__current_itemconfiginfoObject



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

alias __current_itemconfiginfo current_itemconfiginfo

.__item_cget_cmd(id) ⇒ Object

id := [ container, item ]



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

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, … ]



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

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



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

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

.__itemcgetObject



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

alias __itemcget itemcget

.__itemcget_strictObject



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

alias __itemcget_strict itemcget_strict

.__itemcget_tkstringObject



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

alias __itemcget_tkstring itemcget_tkstring

.__itemconfiginfoObject



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

alias __itemconfiginfo itemconfiginfo

.__itemconfigureObject



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

alias __itemconfigure itemconfigure

.add(container, *args) ⇒ Object



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

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



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

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

.cget(container, option) ⇒ Object



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

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

.cget_strict(container, option) ⇒ Object



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

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

.cget_tkstring(container, option) ⇒ Object



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

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

.configinfo(container, *args) ⇒ Object



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

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

.configure(container, *args) ⇒ Object



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

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

.containers(arg = {}) ⇒ Object



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

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

.containers_pattern(pat) ⇒ Object



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

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

.containers_slave(win) ⇒ Object



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

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

.create_container(container) ⇒ Object



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

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



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

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

.current_itemconfiginfo(container, *args) ⇒ Object



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

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



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

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

.extents(container, item) ⇒ Object



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

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



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

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

.info(container) ⇒ Object



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

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



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

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

.insert_after(container, *args) ⇒ Object



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

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

.insert_before(container, *args) ⇒ Object



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

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

.itemcget(container, item, option) ⇒ Object



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

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

.itemcget_strict(container, item, option) ⇒ Object



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

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

.itemcget_tkstring(container, item, option) ⇒ Object



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

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

.itemconfiginfo(container, *args) ⇒ Object



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

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



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

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



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

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



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

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

.locate(container, x, y) ⇒ Object



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

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

.save(container) ⇒ Object



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

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

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



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

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

.split(container, *args) ⇒ Object



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

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

.tagid(tag) ⇒ Object



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

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



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

def tagid2obj(tagid)
  tagid
end