Module: Tk::BLT::Table

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

Defined Under Namespace

Modules: TableContainer

Constant Summary collapse

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

Constants included from Tk

AUTO_PATH, Checkbutton, CloneMenu, JAPANIZED_TK, LIBRARY_PATH, Labelframe, MenuButton, OptionMenuButton, PACKAGE_PATH, Panedwindow, RELEASE_DATE, Radiobutton, 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

Constants included from TkUtil

TkUtil::None, TkUtil::RELEASE_DATE

Class Method Summary collapse

Methods included from Tk

BinaryString, EncodedString, Grid, Pack, Place, UTF8_String, __set_toplevel_aliases__, add_kinsoku, bell, bell_on_display, const_missing, current_grabs, cursor_display, default_widget_set, default_widget_set=, delete_kinsoku, destroy, 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, 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, ungrid, unload_tcllibrary, unpack, unplace, update, update, update_idletasks, utf_to_backslash, utf_to_backslash_sequence, wakeup

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_str, number, procedure, simplelist, string, #subst, tk_tcl2ruby, uninstall_cmd, #uninstall_cmd, window

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 TkEvent

#install_bind, #install_bind_for_event_class

Methods included from TkItemConfigMethod

__IGNORE_UNKNOWN_CONFIGURE_OPTION__, __check_available_itemconfigure_options, __current_itemconfiginfo, __set_IGNORE_UNKNOWN_CONFIGURE_OPTION__!, current_itemconfiginfo, itemcget, itemcget_strict, itemconfiginfo, itemconfigure, tagid

Methods included from TkItemConfigOptkeys

#__conv_item_keyonly_opts, #itemconfig_hash_kv

Methods included from TkTreatItemFont

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

Class Method Details

.__boolval_optkeysObject



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

def __boolval_optkeys
  super() << 'propagate'
end

.__current_itemconfiginfoObject



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

alias __current_itemconfiginfo current_itemconfiginfo

.__item_cget_cmd(id) ⇒ Object

id := [ container, item ]



125
126
127
128
# File 'ext/lib/tkextlib/blt/table.rb', line 125

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



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

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



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

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

.__itemcgetObject



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

alias __itemcget itemcget

.__itemcget_strictObject



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

alias __itemcget_strict itemcget_strict

.__itemconfiginfoObject



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

alias __itemconfiginfo itemconfiginfo

.__itemconfigureObject



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

alias __itemconfigure itemconfigure

.add(container, *args) ⇒ Object



317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
# File 'ext/lib/tkextlib/blt/table.rb', line 317

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



335
336
337
338
# File 'ext/lib/tkextlib/blt/table.rb', line 335

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

.cget(container, option) ⇒ Object



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

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

.cget_strict(container, option) ⇒ Object



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

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

.configinfo(container, *args) ⇒ Object



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

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

.configure(container, *args) ⇒ Object



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

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

.containers(arg = {}) ⇒ Object



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

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

.containers_pattern(pat) ⇒ Object



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

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

.containers_slave(win) ⇒ Object



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

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

.create_container(container) ⇒ Object



305
306
307
308
309
310
311
312
313
314
315
# File 'ext/lib/tkextlib/blt/table.rb', line 305

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



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

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

.current_itemconfiginfo(container, *args) ⇒ Object



251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
# File 'ext/lib/tkextlib/blt/table.rb', line 251

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



340
341
342
# File 'ext/lib/tkextlib/blt/table.rb', line 340

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

.extents(container, item) ⇒ Object



344
345
346
347
348
349
# File 'ext/lib/tkextlib/blt/table.rb', line 344

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



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

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

.info(container) ⇒ Object



273
274
275
276
277
278
279
280
281
# File 'ext/lib/tkextlib/blt/table.rb', line 273

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



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

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

.insert_after(container, *args) ⇒ Object



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

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

.insert_before(container, *args) ⇒ Object



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

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

.itemcget(container, item, option) ⇒ Object



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

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

.itemcget_strict(container, item, option) ⇒ Object



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

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

.itemconfiginfo(container, *args) ⇒ Object



229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
# File 'ext/lib/tkextlib/blt/table.rb', line 229

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



209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
# File 'ext/lib/tkextlib/blt/table.rb', line 209

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



283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
# File 'ext/lib/tkextlib/blt/table.rb', line 283

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



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

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

.locate(container, x, y) ⇒ Object



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

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

.save(container) ⇒ Object



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

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

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



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

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

.split(container, *args) ⇒ Object



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

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

.tagid(tag) ⇒ Object



158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
# File 'ext/lib/tkextlib/blt/table.rb', line 158

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



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

def tagid2obj(tagid)
  tagid
end