Ruby 1.9.3 リファレンスマニュアル > ライブラリ一覧 > tk/variableライブラリ > TkVariableクラス

class TkVariable


extend: TkCore

要約

Tclの変数をアクセスするためのクラスです。 ((-Tclの配列としての振る舞いは仕様が不安定のようです-))

require "tk"
p TkVariable.new(0).value                     # => "0"
p TkVariable.new(1.2).value                   # => "1.2"
p TkVariable.new(["a", "b"]).value            # => {"0"=>"a", "1"=>"b"}
p TkVariable.new(1=>"a", 2=>"b").value        # => {"1"=>"a", "2"=>"b"}

特異メソッド

callback(args)

[TODO]

TkVariable#traceにより登録されたProcオブジェクトを実行します。 args は、 [TkVariableのインスタンス, "キー", "操作"] である配列です。

new(val="")

[TODO]

値がvalであるTkVariableオブジェクトを生成します。valが Array または Hash のオブジェクトである場合、生成されたインス タンスは Tclの配列として振る舞います。

new_hash(val = {})

[TODO]

インスタンスメソッド

self % other

[TODO]

self & other

[TODO]

self * other

[TODO]

self ** other

[TODO]

self + other

[TODO]

self - other

[TODO]

self / other

[TODO]

self <=> other

[TODO]

self == other

[TODO]

値がotherと同じである場合に真です。otherは、 TkVariable, String, Integer, Float, Arrayのいずれかです。

self =~ other

[TODO]

self[index]

[TODO]

index番目の値を返します。 selfはTclの配列でなければなりません。

self[index] = val

[TODO]

index番目の要素をvalにします。 selfはTclの配列でなければなりません。

bool

[TODO]

bool=
set_bool

[TODO]

bool_element

[TODO]

bool_type=
set_bool_type(val)

[TODO]

clear

[TODO]

coerce(other)

[TODO]

default_element_value_type(idxs)

[TODO]

default_proc(cmd = Proc.new)

[TODO]

default_value(val = nil)
default_value(val = nil) { .... }

[TODO]

default_value=

[TODO]

default_value_type

[TODO]

default_value_type=
set_default_value_type(type)

[TODO]

element_lappend(idxs, *elems)

[TODO]

element_lindex(elem_idxs, idx)
element_lget(elem_idxs, idx)

[TODO]

element_lget_f(elem_idxs, idx)

[TODO]

element_lget_i(elem_idxs, idx)

[TODO]

element_lset(elem_idxs, idx, val)

[TODO]

list_element(*idxs)
element_to_a(*idxs)

[TODO]

element_to_f(*idxs)

[TODO]

element_to_i(*idxs)

[TODO]

element_to_s(*idxs)
string_element(*idxs)

[TODO]

element_to_sym(*idxs)

[TODO]

eventloop_tkwait

[TODO]

eventloop_wait(check_root = false)

[TODO]

exist?(*elems)

[TODO]

id

[TODO]

is_hash?

[TODO]

is_scalar?

[TODO]

keys

[TODO]

lappend(*elems)

[TODO]

lindex(idx)
lget(idx)

[TODO]

lget_f(idx)

[TODO]

lget_i(idx)

[TODO]

list

[TODO]

list=

[TODO]

list_type=
set_list_type(val)

[TODO]

lset(idx, val)

[TODO]

nonzero?

[TODO]

numeric

[TODO]

numeric=

[TODO]

numeric_element(*idxs)

[TODO]

set_numeric_type(val)
numeric_type=

[TODO]

numlist

[TODO]

set_numlist(val)
numlist=

[TODO]

numlist_element(*idxs)

[TODO]

set_numlist_type(val)
numlist_type=

[TODO]

procedure

[TODO]

set_procedure(cmd)
procedure=

[TODO]

procedure_element(*idxs)

[TODO]

procedure_type=
set_procedure_type(cmd)

[TODO]

ref(*idxs)

[TODO]

unset(elem=nil)
remove(elem=nil)

[TODO]

値がTcl配列であるとき、elemの値を削除します。

set_bool_element

[TODO]

set_bool_element_type(idxs, val)

[TODO]

set_default_element_value_type(idxs, type)

[TODO]

set_default_value(val)

[TODO]

set_element_value(idxs, val)

[TODO]

set_element_value_type(idxs, val)

[TODO]

set_list(val)

[TODO]

set_list_element(idxs, val)
set_numlist_element(idxs, val)

[TODO]

set_list_element_type(idxs, val)

[TODO]

set_numeric(val)

[TODO]

set_numeric_element(idxs, val)

[TODO]

set_numeric_element_type(idxs, val)

[TODO]

set_numlist_element_type(idxs, val)

[TODO]

set_procedure_element(idxs, cmd)

[TODO]

set_procedure_element_type(idxs, cmd)

[TODO]

string=
set_string(val)

[TODO]

set_string_element(idxs, val)

[TODO]

set_string_element_type(idxs, val)

[TODO]

string_type=
set_string_type(val)

[TODO]

symbol=
set_symbol(val)

[TODO]

set_symbol_element(idxs, val)

[TODO]

set_symbol_element_type(idxs, val)

[TODO]

symbol_type=
set_symbol_type(val)

[TODO]

set_value(val)

[TODO]

値を val に設定し、self を返します。

set_value_type(val)
value_type=

[TODO]

set_variable(var)
variable=

[TODO]

set_variable_element(*idxs)

[TODO]

set_variable_element_type(idxs, var)

[TODO]

set_variable_type(var)
variable_type=

[TODO]

set_window(win)
window=

[TODO]

set_window_element(idxs, win)

[TODO]

set_window_element_type(idxs, win)

[TODO]

set_window_type(win)
window_type=

[TODO]

size

[TODO]

string

[TODO]

symbol
to_sym

[TODO]

symbol_element

[TODO]

thread_tkwait

[TODO]

thread_wait(check_root = false)

[TODO]

tkwait(on_thread = true)

[TODO]

to_a

[TODO]

値を配列(Array)として返します。

to_eval

[TODO]

to_f

[TODO]

値を数値(Float)として返します。

to_i

[TODO]

値を数値(Fixnum)として返します。(現状のTkVariableは、 Bignumを値にすることはできません)

to_s

[TODO]

値を文字列(String)として返します。

trace(opts, cmd)

[TODO]

optsは、"r", "w", "u" のいずれか、またはこれらの組み合わせで、それぞれ 変数が参照、設定、削除 されたときにProcオブジェクト cmd を 呼び出します。2回目以降の呼び出しでは、opts が以前の設定と異なれ ばcmdを再設定します。

cmdは、引数に、self、空配列、"操作" を渡されて呼ばれ ます。"配列のキー" は、変数が配列の場合以外は空文字列です。"操作"は、 "r","w","u" のいずれかです。

require "tk"

var = TkVariable.new(0)

var.trace "rwu", proc {|arg| puts "callback called with #{arg.inspect}"}

p var.value
p var.value = 1
p var.unset

=>callback called with [<TkVariable: v00000>, [], "r"]
  "0"
  callback called with [<TkVariable: v00000>, [], "w"]
  "1"
  callback called with [<TkVariable: v00000>, [], "u"]
  ""
trace_callback(elem, op)

[TODO]

TkVariable#traceにより登録されたProcオブジェクトを引数にself, elem, opを指定して実行します。

require "tk"

var = TkVariable.new(0)

var.trace "rwu", proc {|arg| puts "callback called with #{arg.inspect}"}
var.trace_callback([], "r")
trace_element(elem, opts, cmd)

[TODO]

trace_vdelete(opts, cmd)

[TODO]

TkVariable#trace で設定したcmdを削除します。opts が TkVariable#trace で 設定したときと一致しなければ何もしません。

trace_vdelete_for_element(elem, opts, cmd)

[TODO]

trace_vinfo

[TODO]

undef_default

[TODO]

update(hash)

[TODO]

value

[TODO]

値を返します。selfがTclの配列ならば(Tclの配列は連想配列な ので) Hashとして返します。それ以外では常に文字列を返します。

value=(val)

[TODO]

値をvalに設定します。

variable

[TODO]

variable_element(*idxs)

[TODO]

wait

[TODO]

値が変化するまで待ちます。

window

[TODO]

window_element(*idxs)

[TODO]

zero?

[TODO]

self | other

[TODO]

定数

TkCommandNames

[TODO]

TkVar_CB_TBL

[TODO]

コールバック関数を記録するハッシュです。内部で利用しています。

TkVar_ID_TBL

[TODO]

Tk_VARIABLE_ID

[TODO]

Tclレベルの変数名をインスタンスに割り当てるために内部で利用されています。

Tk_VARIABLE_IDは、配列ですが0番目の要素しか使われていません。 Rubyにおける定数が値を変更できないためです。

USE_TCLs_SET_VARIABLE_FUNCTIONS

[TODO]

class TkVariable