diff options
Diffstat (limited to 'ext/tk/MANUAL_tcltklib.eucj')
| -rw-r--r-- | ext/tk/MANUAL_tcltklib.eucj | 822 |
1 files changed, 411 insertions, 411 deletions
diff --git a/ext/tk/MANUAL_tcltklib.eucj b/ext/tk/MANUAL_tcltklib.eucj index 1ff5dddde4..1de1736f9f 100644 --- a/ext/tk/MANUAL_tcltklib.eucj +++ b/ext/tk/MANUAL_tcltklib.eucj @@ -1,525 +1,525 @@ (tof) 2005/07/05 Hidetoshi NAGAI -本ドキュメントには古い tcltk ライブラリ，tcltklib ライブラリの説明 -が含まれていますが，その記述内容は古いものとなっています． +ャ＜潟ゃ tcltk ゃ鐚tcltklib ゃ茯 +障障鐚荐菴医絎鴻ゃｃ障鐚 -tcltk ライブラリ（tcltk.rb）は現在ではメンテナンスが事実上行われて -いないため，古いドキュメントの説明がそのまま有効です．それに対し， -tcltklib ライブラリについては，現在の Ruby/Tk（tk.rb 以下のライブラ -リ群）を稼働させるための中心としてメンテナンスされているため，少々 -違いが生じています． +tcltk ゃ鐚tcltk.rb鐚憜с＜潟潟鴻篋絎筝茵 +鐚ゃャ＜潟茯障丈鴻с鐚絲障鐚 +tcltklib ゃゃ鐚憜 Ruby/Tk鐚tk.rb 篁ヤゃ +臂わ腮弱筝綽＜潟潟鴻鐚絨 +障鐚 -そこで，まず古い説明文書を示した後，現在の tcltklib ライブラリにつ -いての説明を加えます． +э障ゃ茯吾腓冴緇鐚憜 tcltklib ゃ +茯障鐚 -以下がライブラリの古い説明文書です． +篁ヤゃゃ茯吾с鐚 ============================================================== MANUAL.euc Sep. 19, 1997 Y. Shigehiro -以下, 「tcl/tk」という表記は, tclsh や wish を実現している, 一般でいう -ところの tcl/tk を指します. 「tcltk ライブラリ」, 「tcltklib ライブラ -リ」という表記は, 本パッケージに含まれる ruby 用のライブラリを指します. +篁ヤ, tcl/tk茵荐, tclsh wish 絎憗, 筝с + tcl/tk 障. tcltk ゃ, tcltklib ゃ +茵荐, 宴若吾障 ruby ゃ障. -<< tcltk ライブラリ >> +<< tcltk ゃ >> -tcl/tk の C ライブラリを利用するための高(中?)水準インターフェースを提 -供します. +tcl/tk C ゃ蕭(筝?)羂贋ゃ潟帥若с若鴻 +箴障. -このライブラリは ruby から tcl/tk ライブラリを利用するためのもので, 内 -部で tcltklib ライブラリを利用しています. +ゃ ruby tcl/tk ゃ, + tcltklib ゃ障. -[説明] +[茯] -tcl/tk インタプリタでは, ウィジェットに何か指示を送るには, ウィジェッ -ト名に続いてパラメータを書きます. したがって, ウィジェットがオブジェク -トであり, それに対してメソッドを送っている, とみなすことができます. さ -て, tcl/tk インタプリタでは, 組み込みコマンドも, 前述のウィジェットと -同じような書式の命令で実行されます. すなわち, コマンドもオブジェクトで -あると考えることができます. +tcl/tk ゃ潟帥帥с, ｃ吾с篏腓冴, ｃ吾с +膓＜若帥吾障. ｃ, ｃ吾с吾с +с, 絲障＜純ｃ, 帥с障. +, tcl/tk ゃ潟帥帥с, 腟粋昭帥潟潟, 菴違ｃ吾с +後巡擦у茵障. , 潟潟吾с +с障. -このような考えに基づき, tcltk ライブラリでは, tcl/tk のコマンドやウィ -ジェットに対応するオブジェクトを生成します. オブジェクトに対するメソッ -ド呼び出しは, e() メソッドにより実行されます. 例えば, tcl/tk の info -コマンドに対応する ruby のオブジェクトが info という名前であるとすると, -tcl/tk の +冴ャ, tcltk ゃс, tcl/tk 潟潟 +吾с絲上吾с障. 吾с絲障＜純 +若喝冴, e() ＜純絎茵障. 箴, tcl/tk info +潟潟絲上 ruby 吾с info с, +tcl/tk info commands -という命令は tcltk ライブラリでは +巡擦 tcltk ゃс info.e("commands") -と記述されます. また, 「.」というウィジェット (wish 実行時に自動的に生 -成されるルートウィジェット) に対応する ruby のオブジェクトが root とい -う名前であるとすると, +荐菴違障. 障, .ｃ吾с (wish 絎茵 +若ｃ吾с) 絲上 ruby 吾с root +с, . configure -height 300 -width 300 -という tcl/tk の命令は + tcl/tk 巡擦 root.e("configure -height 300 -width 300") -と記述されます. このような記述は, 見ためには美しくありませんが, そして, -スクリプトを読む人には見づらいかも知れませんが, 実際にスクリプトを書い -てみると予想外に手軽です. +荐菴違障. 荐菴違, 荀臂障, , +鴻茯篋冴荀ャャ障, 絎鴻吾 +帥篋喝荵純с. -[使用法] +[篏睡羈] -1. ライブラリを読み込む. +1. ゃ茯粋昭. require "tcltk" -2. tcl/tk インタプリタを生成する. +2. tcl/tk ゃ潟帥帥. ip = TclTkInterpreter.new() -3. tcl/tk のコマンドに対応するオブジェクトを変数に代入しておく. - # コマンドに対応するオブジェクトが入った Hash を取り出す. +3. tcl/tk 潟潟絲上吾с紊違篁ｅャ. + # 潟潟絲上吾сャｃ Hash 冴. c = ip.commands() - # 使いたいコマンドに対応するオブジェクトを個別の変数に代入する. + # 篏帥潟潟絲上吾сャ紊違篁ｅャ. bind, button, info, wm = c.indexes("bind", "button", "info", "wm") -4. 必要な処理を行う. - 詳しくは, サンプルを参照のこと. +4. 綽荀茵. + 荅潟, 泣潟с. -5. 準備ができたら, イベントループに入る. +5. 羣с, ゃ潟若ャ. TclTk.mainloop() -(( 以下, モジュール, クラス等の説明を書く予定.)) +(( 篁ヤ, ≪吾ャ若, 合茯吾鋋絎.)) -<< tcltklib ライブラリ >> +<< tcltklib ゃ >> -tcl/tk の C ライブラリを利用するための低水準インターフェースを提供しま -す. +tcl/tk C ゃ篏羂贋ゃ潟帥若с若鴻箴 +. -コンパイル/実行には, tcl/tk の C ライブラリが必要です. +潟潟ゃ/絎茵, tcl/tk C ゃ綽荀с. -[説明] +[茯] -このライブラリを用いると, ruby から tcl/tk の C ライブラリを利用できま -す. 具体的には, ruby インタプリタから tcl/tk インタプリタを呼び出すこ -とができます. さらに, その(ruby インタプリタから呼び出した) tcl/tk イ -ンタプリタから, 逆に ruby インタプリタを呼び出すこともできます. +ゃ, ruby tcl/tk C ゃс +. 隙, ruby ゃ潟帥帥 tcl/tk ゃ潟帥帥若喝冴 +с障. , (ruby ゃ潟帥帥若喝冴) tcl/tk +潟帥帥, ruby ゃ潟帥帥若喝冴с障. -[使用法] +[篏睡羈] -require "tcltklib" すると, 以下のモジュール, クラスが利用可能です. +require "tcltklib" , 篁ヤ≪吾ャ若, 鴻純с. -モジュール TclTkLib - tcl/tk ライブラリを呼び出すメソッドを集めたモジュールです. ただし, - tcl/tk インタプリタ関係のメソッドはクラス TclTkIp にあります. +≪吾ャ若 TclTkLib + tcl/tk ゃ若喝冴＜純≪吾ャ若с. , + tcl/tk ゃ潟帥翠≫＜純 TclTkIp 障. - モジュールメソッド mainloop() - Tk_MainLoop を実行します. 全ての tk のウインドウが無くなると終了 - します(例えば, tcl/tk で書くところの "destroy ." をした場合等). - 引数: 無し - 戻り値: nil + ≪吾ャ若＜純 mainloop() + Tk_MainLoop 絎茵障. tk ゃ潟＜腟篋 + 障(箴, tcl/tk ф吾 "destroy ." 翫膈). + 綣: ＜ + 祉: nil -クラス TclTkIp - インスタンスが tcl/tk のインタプリタに対応します. tcl/tk のライブ - ラリの仕様通り, インスタンスを複数個生成しても正しく動作します(そ - んなことをする必要はあまり無いはずですが). インタプリタは wish の - tcl/tk コマンドを実行できます. さらに, 以下のコマンドを実行できま - す. - コマンド ruby - 引数を ruby で実行します(ruby_eval_string を実行します). 引数 - は 1 つでなければなりません. 戻り値は ruby の実行結果です. - ruby の実行結果は nil か String でなければなりません. + TclTkIp + ゃ潟鴻帥潟鴻 tcl/tk ゃ潟帥帥絲上障. tcl/tk ゃ + 篁罕, ゃ潟鴻帥潟鴻茲医罩ｃ篏障( + 綽荀障＜с). ゃ潟帥帥 wish + tcl/tk 潟潟絎茵с障. , 篁ヤ潟潟絎茵с + . + 潟潟 ruby + 綣違 ruby у茵障(ruby_eval_string 絎茵障). 綣 + 1 ゃс違障. 祉ゃ ruby 絎茵腟с. + ruby 絎茵腟 nil String с違障. - クラスメソッド new() - TclTkIp クラスのインスタンスを生成します - 引数: 無し - 戻り値 (TclTkIp): 生成されたインスタンス + 鴻＜純 new() + TclTkIp 鴻ゃ潟鴻帥潟鴻障 + 綣: ＜ + 祉 (TclTkIp): ゃ潟鴻帥潟 - メソッド _eval(script) - インタプリタで script を評価します(Tcl_Eval を実行します). 前述 - のように, ruby コマンドにより script 内から ruby スクリプトを実 - 行できます. - 引数: script (String) - インタプリタで評価するスクリプト文字列 - 戻り値 (String): 評価結果 ((Tcl_Interp *)->result) + ＜純 _eval(script) + ゃ潟帥帥 script 荅箴＜障(Tcl_Eval 絎茵障). 菴 + , ruby 潟潟 script ruby 鴻絎 + 茵с障. + 綣: script (String) - ゃ潟帥帥ц箴＜鴻絖 + 祉 (String): 荅箴∞ ((Tcl_Interp *)->result) - メソッド _return_value() - 直前の Tcl_Eval の戻り値を返します. 0(TCL_OK) で正常終了です. - 引数: 無し - 戻り値 (Fixnum): 直前の Tcl_Eval() が返した値. + ＜純 _return_value() + 翫 Tcl_Eval 祉ゃ菴障. 0(TCL_OK) фｅ幻腟篋с. + 綣: ＜ + 祉 (Fixnum): 翫 Tcl_Eval() 菴. ============================================================== -以下が本ドキュメント作成時点での tcltklib ライブラリの説明です． +篁ヤャ＜潟篏鴻с tcltklib ゃ茯с鐚 ============================================================== -モジュール TclTkLib - : 個々の Tcl/Tk インタープリタに依存しない処理 ( == イベントルー - : プに関する処理 ) を呼び出すメソッドを定義したモジュール． - - モジュール TclTkLib::EventFlag - : do_one_event を呼び出す際の処理対象イベントを指定するための - : フラグ ( WINDOW|DONT_WAIT というようにビット演算子で連結して - : 指定 ) を定数として定義したモジュール．以下の定数が含まれる． - - 定数 NONE - : 値は 0 で，値としてはいかなる種類のイベントも指定していない - : ことになるが，実際の処理上は ALL と同じとして扱われる． - - 定数 WINDOW - : window イベントを処理対象とする - - 定数 FILE - : file イベントを処理対象とする - - 定数 TIMER - : timer イベントを処理対象とする - - 定数 IDLE - : アイドルループ処理 ( 再描画など，他の種類のイベントが発生 - : していないときに行われる処理 ) を処理対象とする - - 定数 ALL - : すべての種類のイベントを処理対象とする - : WINDOW|FILE|TIMER|IDLE と同じ - - 定数 DONT_WAIT - : 処理対象イベントが存在しない場合に，イベント発生を待たず - : に do_one_event を終了 ( false を返す ) する - - モジュール TclTkLib::VarAccessFlag - : _get_variable などでのフラグを指定するためのもの．フラグに - : は以下の定数を OR で連結して与える． - - 定数 NONE - : 値は 0 で，何もフラグを指定していないのに等しい． - - 定数 GLOBAL_ONLY - : 通常，変数の検索はまず手続き呼び出しを行ったレベルで検 - : 索し，次に現在の名前空間で検索，最後にグローバル空間で - : 検索を行う．しかし，このフラグが指定された場合には，グ - : ローバル空間でのみ検索する． - : もし GLOBAL_ONLY と NAMESPACE_ONLY とが両方指定された場 - : 合には，GLOBAL_ONLY の指定は無視される． - - 定数 NAMESPACE_ONLY - : このフラグが指定された場合には，現在の名前空間でのみ変 - : 数の検索を行う．GLOBAL_ONLY の説明も参照すること． - - 定数 LEAVE_ERR_MSG - : 変数アクセスにおいてエラーが発生した場合，このフラグが - : 指定されていれば，実行結果として Tcl インタープリタにエ - : ラーメッセージが残される．このフラグが指定されていなけ - : れば，エラーメッセージは一切残されない． - - 定数 APPEND_VALUE - : このフラグが指定されていた場合，変数の値を置き換えので - : はなく，現在の値に代入値が追加 (append; 文字列連結) さ - : れる．変数が未定義あった場合，このフラグは無視される． - - 定数 LIST_ELEMENT - : このフラグが指定されていた場合，代入値はまず Tcl のリス - : ト要素として適切となるように変換される．代入値がリスト - : (またはサブリスト) の最初の要素となるのでない限り，代入 - : 値の直前には空白文字が追加される． - - 定数 PARSE_VARNAME - : _set_variable などの呼び出しにおいてこのフラグが指定さ - : れていた場合，var_name 引数が連想配列名と要素名とを両方 - : 含む可能性がある (開き括弧を含み，閉じ括弧で終わる) こ - : とを示す．その場合，括弧の間が要素名指定，最初の開き括 - : 弧までが連想配列名として扱われる．_set_variable2 などで - : このフラグを指定する場合，連想配列名と要素名は var_name - : から抽出されるはずであるから，index_name 引数は nil と - : せねばならない． - - モジュール TclTkLib::RELEASE_TYPE - : Tcl/Tk のリリースタイプ番号の定義 - - 定数 ALPHA - : ALPHA リリース - - 定数 BETA - : BETA リリース - - 定数 FINAL - : FINAL リリース - - モジュールメソッド +≪吾ャ若 TclTkLib + : Tcl/Tk ゃ潟帥若帥箴絖 ( == ゃ潟 + : ≪ ) 若喝冴＜純絎臂≪吾ャ若鐚 + + ≪吾ャ若 TclTkLib::EventFlag + : do_one_event 若喝冴絲乗院ゃ潟絎 + : ( WINDOW|DONT_WAIT 羲膊絖чｇ + : 絎 ) 絎違絎臂≪吾ャ若鐚篁ヤ絎違障鐚 + + 絎 NONE + : ゃ 0 эゃ腮蕁ゃ潟絎 + : 鐚絎筝 ALL 宴鐚 + + 絎 WINDOW + : window ゃ潟絲乗院 + + 絎 FILE + : file ゃ潟絲乗院 + + 絎 TIMER + : timer ゃ潟絲乗院 + + 絎 IDLE + : ≪ゃ若 ( 祉鐚篁腮蕁ゃ潟榊 + : 茵 ) 絲乗院 + + 絎 ALL + : 鴻腮蕁ゃ潟絲乗院 + : WINDOW|FILE|TIMER|IDLE + + 絎 DONT_WAIT + : 絲乗院ゃ潟絖翫鐚ゃ潟榊緇 + : do_one_event 腟篋 ( false 菴 ) + + ≪吾ャ若 TclTkLib::VarAccessFlag + : _get_variable с違絎鐚違 + : 篁ヤ絎違 OR чｇ筝鐚 + + 絎 NONE + : ゃ 0 э篏違絎膈鐚 + + 絎 GLOBAL_ONLY + : 絽醐紊違罎膣≪障膓若喝冴茵ｃф + : 膣≪鐚罨＜憜腥咲ф膣鐚緇違若腥咲 + : 罎膣≪茵鐚鐚違絎翫鐚 + : 若腥咲с炊膣≪鐚 + : GLOBAL_ONLY NAMESPACE_ONLY 筝≧号絎 + : 鐚GLOBAL_ONLY 絎∴鐚 + + 絎 NAMESPACE_ONLY + : 違絎翫鐚憜腥咲с水 + : 違罎膣≪茵鐚GLOBAL_ONLY 茯с鐚 + + 絎 LEAVE_ERR_MSG + : 紊違≪祉鴻若榊翫鐚違 + : 絎逸絎茵腟 Tcl ゃ潟帥若帥 + : 若＜祉若吾罧鐚違絎 + : 逸若＜祉若吾筝罧鐚 + + 絎 APPEND_VALUE + : 違絎翫鐚紊違ゃ臀 + : 鐚憜ゃ篁ｅュゃ菴遵 (append; 絖ｇ) + : 鐚紊違絎臂ｃ翫鐚違∴鐚 + + 絎 LIST_ELEMENT + : 違絎翫鐚篁ｅュゃ障 Tcl + : 荀膣紊鐚篁ｅュゃ鴻 + : (障泣鴻) 荀膣с鐚篁ｅ + : ゃ翫腥榊醇絖菴遵鐚 + + 絎 PARSE_VARNAME + : _set_variable 若喝冴違絎 + : 翫鐚var_name 綣違ｆ渇荀膣筝≧ + : 醇с (綣с随綣сх) + : 腓冴鐚翫鐚綣с荀膣絎鐚 + : 綣с障сｆ渇宴鐚_set_variable2 + : 違絎翫鐚ｆ渇荀膣 var_name + : 遵冴с鐚index_name 綣違 nil + : 違鐚 + + ≪吾ャ若 TclTkLib::RELEASE_TYPE + : Tcl/Tk 若鴻帥ゃ垩絎臂 + + 絎 ALPHA + : ALPHA 若 + + 絎 BETA + : BETA 若 + + 絎 FINAL + : FINAL 若 + + ≪吾ャ若＜純 get_version() - : Tcl/Tk の major, minor, release-type 番号, patchlevel を - : 配列にして返す． + : Tcl/Tk major, minor, release-type , patchlevel + : 菴鐚 mainloop(check_root = true) - : イベントループを起動する．check_root が true であれば， - : root widget が存在する限り，このメソッドは終了しない． - : check_root が false の場合は，root widget が消滅しても - : このメソッドは終了しない ( root widget が消滅しても， - : WINDOW 以外のイベントは発生しうるため )．終了には，外部 - : からの働き掛け ( スレッドを活用するなど ) が必要． + : ゃ潟若莎桁鐚check_root true с逸 + : root widget 絖鐚＜純腟篋鐚 + : check_root false 翫鐚root widget 羔羯 + : ＜純腟篋 ( root widget 羔羯鐚 + : WINDOW 篁ュゃ潟榊 )鐚腟篋鐚紊 + : ( 鴻羇紫 ) 綽荀鐚 mainloop_thread? - : カレントスレッドがイベントループを実行しているスレッド - : かどうかを返す． - : イベントループを実行しているスレッドであれば true を， - : どのスレッドでもイベントループが実行されていない場合は - : nil を，他のスレッドでイベントループが実行されている場 - : 合は false を返す． - : false の際に Tk インタープリタを直接呼ぶのは危険である． + : 潟鴻ゃ潟若絎茵鴻 + : 菴鐚 + : ゃ潟若絎茵鴻с true 鐚 + : 鴻сゃ潟若絎茵翫 + : nil 鐚篁鴻сゃ潟若絎茵 + : false 菴鐚 + : false Tk ゃ潟帥若帥贋･若吟演冴с鐚 mainloop_watchdog(check_root = true) - : 通常のイベントループでは，イベント処理の内容によっては - : デッドロックを引き起こす可能性がある (例えばイベントに - : 対するコールバック処理中で widget 操作をし，その終了を - : 待つなど)．このメソッドは，そうしたデッドロックを回避す - : るための監視スレッド付きでイベントループを起動する - : ( 監視スレッドを生成した後にイベントループを実行する )． - : 引数の意味は mainloop と同じである． + : 絽吾ゃ潟若с鐚ゃ潟絎鴻ｃ + : 綣莎激醇с (箴違ゃ潟 + : 絲障潟若筝 widget 篏鐚腟篋 + : 緇ゃ)鐚＜純鐚帥 + : ｈ鴻篁сゃ潟若莎桁 + : ( ｈ鴻緇ゃ潟若絎茵 )鐚 + : 綣違潟 mainloop с鐚 do_one_event(flag = TclTkLib::EventFlag::ALL | TclTkLib::EventFlag::DONT_WAIT) - : 処理待ちのイベント 1 個を実行する． - : イベントを処理した場合は true を返す． - : フラグで DONT_WAIT を指定していない場合，フラグで処理対 - : 象となっている種類のイベントが発生するまで待ち続ける． - : DONT_WAIT を指定していた場合，処理対象イベントがなくても - : すぐに終了し false を返す． - : $SAFE >= 4 か，$SAFE >= 1 かつ flag が汚染されているならば - : flag には DONT_WAIT が強制的に付けられる． + : 緇＜ゃ潟 1 絎茵鐚 + : ゃ潟翫 true 菴鐚 + : 違 DONT_WAIT 絎翫鐚違у絲 + : 莟＜ｃ腮蕁ゃ潟榊障у∞鐚 + : DONT_WAIT 絎翫鐚絲乗院ゃ潟 + : 腟篋 false 菴鐚 + : $SAFE >= 4 鐚$SAFE >= 1 flag 羆 + : flag DONT_WAIT 綣桁句篁鐚 set_eventloop_tick(timer_tick) - : イベントループと同時に別スレッドが稼働している場合に，時 - : 間に基づいた強制的なスレッドスイッチングをどの程度の頻度 - : ( 時間間隔 ) で発生させるかをミリ秒単位の整数値で指定する． - : 0 を指定すると，この強制的なスイッチングは行われない． - : 標準では 0 に設定されており，イベント処理数に基づくスイッ - : チングだけが行われる ( see set_eventloop_weight )． - : ただし，稼働しているスレッドがイベントループだけの場合， - : timer_tick を 0 に設定することはできない．もし設定されて - : いたら，100 ms ( see NO_THREAD_INTERRUPT_TIME ) に自動設 - : 定される． - : 詳細な説明は略すが，これは CPU パワーを節約しつつ安全で - : 安定した動作を実現するために実装した仕様である． - : $SAFE >= 4 では実行が禁止される． + : ゃ潟若ャ鴻腮弱翫鐚 + : 冴ャ綣桁句鴻鴻ゃ潟違腮綺糸墾 + : ( ) х榊腱篏贋医ゃф絎鐚 + : 0 絎鐚綣桁句鴻ゃ潟違茵鐚 + : 罔羣с 0 荐絎鐚ゃ潟違冴ャ鴻ゃ + : 潟違茵 ( see set_eventloop_weight )鐚 + : 鐚腮弱鴻ゃ潟若翫鐚 + : timer_tick 0 荐絎с鐚荐絎 + : 鐚100 ms ( see NO_THREAD_INTERRUPT_TIME ) 荐 + : 絎鐚 + : 荅括完茯ャ鐚 CPU 若膀膣ゃゅ + : 絎絎篏絎憗絎茖篁罕с鐚 + : $SAFE >= 4 с絎茵胼罩≪鐚 get_eventloop_tick - : timer_tick の現在値を返す． + : timer_tick 憜ゃ菴鐚 set_no_event_wait(no_event_wait) - : 複数のスレッドが稼働している場合で，処理待ちイベントが全 - : く存在しなかった際に sleep 状態に入る時間長を指定する． - : 稼働スレッドがイベントループだけの場合には意味をなさない． - : デフォルトの値は 20 (ms) - : $SAFE >= 4 では実行が禁止される． + : 茲違鴻腮弱翫э緇＜ゃ潟 + : 鎕ｃ sleep 倶ャ激絎鐚 + : 腮弱鴻ゃ潟若翫潟鐚 + : ゃ 20 (ms) + : $SAFE >= 4 с絎茵胼罩≪鐚 get_no_event_wait - : no_event_wait の現在値を返す． + : no_event_wait 憜ゃ菴鐚 set_eventloop_weight(loop_max, no_event_tick) - : 複数のスレッドが稼働している際に Ruby/Tk のイベントルー - : プに割り当てる比重を定めるためのパラメータを設定する． - : 稼働スレッドがイベントループだけの場合には意味をなさない． - : 一度のスレッド切り替えの間に処理するイベントの最大数と， - : 処理待ちのイベントが存在しない際の加算数とを設定する． - : 処理待ちイベントが存在しない場合は no_event_wait ( see - : set_no_event_wait ) だけの間 sleep 状態に入る． - : デフォルトではそれぞれ 800 回と 10 回，つまり，800 個のイ - : ベント (アイドルイベントを含む) を処理するとか，イベント - : が全く発生しないままに 80 回の処理待ちイベント検査が完了 - : するとかでカウントが 800 以上になるとスレッドスイッチング - : が発生することになる． - : $SAFE >= 4 では実行が禁止される． + : 茲違鴻腮弱 Ruby/Tk ゃ潟 + : 蚊綵罸絎＜若帥荐絎鐚 + : 腮弱鴻ゃ潟若翫潟鐚 + : 筝綺鴻帥ゃ潟紊ф違鐚 + : 緇＜ゃ潟絖膊違荐絎鐚 + : 緇＜ゃ潟絖翫 no_event_wait ( see + : set_no_event_wait ) sleep 倶ャ鐚 + : с 800 10 鐚ゃ障鐚800 + : 潟 (≪ゃゃ潟) 鐚ゃ潟 + : 榊障障 80 緇＜ゃ潟罎祉絎篋 + : с潟 800 篁ヤ鴻鴻ゃ潟 + : 榊鐚 + : $SAFE >= 4 с絎茵胼罩≪鐚 get_eventloop_weight - : 現在の loop_max と no_event_tick との値を返す． + : 憜 loop_max no_event_tick ゃ菴鐚 : ( see set_eventloop_wait ) mainloop_abort_on_exception=(bool) - : Tk インタープリタ上で例外を発生した際に，イベントループを - : エラー停止させるかどうかを指定する．true を指定した場合は - : エラー停止するが，false の場合は例外を無視してイベントルー - : プを継続する．さらに nil の場合は警告モードでない限りはエ - : ラーメッセージの出力すら省略して，例外を無視する． - : デフォルトでは true に設定されている． - : １個のインタープリタだけを使っている場合にはエラー時にその - : まま停止しても通常は問題ないが，複数のインタープリタが同時 - : に動作している場合には，それらを管理するイベントループは１ - : 個だけであるため，いずれかのインタープリタのエラーが原因で， - : 他のインタープリタの処理継続が不可能になることがある．その - : ような場合でもエラーを無視してイベントループが稼働を続ける - : ことで，他のインタープリタが正常に動作し続けることができる． - : $SAFE >= 4 では実行が禁止される． + : Tk ゃ潟帥若推т紊榊鐚ゃ潟若 + : 弱罩≪絎鐚true 絎翫 + : 弱罩≪鐚false 翫箴紊∴ゃ潟 + : 膓膓鐚 nil 翫茘≪若с + : 若＜祉若吾阪ャ鐚箴紊∴鐚 + : с true 荐絎鐚 + : 鐚ゃ潟帥若帥篏帥ｃ翫惹 + : 障上罩≪絽吾馹鐚茲違ゃ潟帥若帥 + : 篏翫鐚膊∞ゃ潟若鐚 + : с鐚ゃ潟帥若帥若э + : 篁ゃ潟帥若帥膓膓筝純鐚 + : 翫с若∴ゃ潟若腮弱膓 + : э篁ゃ潟帥若帥罩ｅ幻篏膓с鐚 + : $SAFE >= 4 с絎茵胼罩≪鐚 mainloop_abort_on_exception - : Tk インタープリタ上で例外を発生した際に，イベントループをエ - : ラー停止させるかどうかの設定状態を true/false で得る． + : Tk ゃ潟帥若推т紊榊鐚ゃ潟若 + : 弱罩≪荐絎倶 true/false у鐚 num_of_mainwindows - : 現在のメインウィンドウ (ルートウィジェット) の数を返す． - : メインウィンドウは一つのインタープリタに付き最大一つである - : ので，この値は現在 Tk の機能が有効であるインタープリタの総 - : 数に等しい． + : 憜＜ゃ潟ｃ潟 (若ｃ吾с) 違菴鐚 + : ＜ゃ潟ｃ潟筝ゃゃ潟帥若帥篁紊тゃс + : эゃ憜 Tk 罘純鴻сゃ潟帥若帥膩 + : 違膈鐚 _merge_tklist(str, str, ... ) - : Tcl/Tk のライブラリ関数を使って，引数の文字列がそれぞれ - : 正しく一つのリスト要素となるように連結した文字列を返す． + : Tcl/Tk ゃ∽違篏帥ｃ鐚綣違絖 + : 罩ｃ鋇ゃ鴻荀膣ｇ絖菴鐚 _conv_listelement(str) - : Tcl/Tk のライブラリ関数を使って，引数の文字列が Tcl の - : 一つのリスト要素として適切な表現になるように変換した文 - : 字列を返す． + : Tcl/Tk ゃ∽違篏帥ｃ鐚綣違絖 Tcl + : 筝ゃ鴻荀膣茵憗紊 + : 絖菴鐚 _toUTF8(str, encoding=nil) _fromUTF8(str, encoding=nil) - : Tcl/Tk が内蔵している UTF8 変換処理を呼び出す． + : Tcl/Tk 泣 UTF8 紊若喝冴鐚 _subst_UTF_backslash(str) _subst_Tcl_backslash(str) - : Tcl のルールでバックスラッシュ記法 ( \uhhhh による - : Unicode 文字表現を含む ) を解析する． - : _subst_Tcl_backslash はすべてのバックスラッシュ記法を - : 置き換えるのに対し，_subst_UTF_backslash は \uhhhh - : による Unicode 文字表現だけを置き換える． + : Tcl 若с鴻激ヨ羈 ( \uhhhh + : Unicode 絖茵憗 ) 茹ｆ鐚 + : _subst_Tcl_backslash 鴻鴻激ヨ羈 + : 臀絲障鐚_subst_UTF_backslash \uhhhh + : Unicode 絖茵憗臀鐚 encoding_system encoding_system=(encoding) - : Tcl の system encoding の獲得および設定 + : Tcl system encoding 峨活┃絎 encoding encoding=(encoding) - : encoding_system / encoding_system= の alias - : ( Ruby/Tk の tk.rb では置き換えられる予定のもの．) + : encoding_system / encoding_system= alias + : ( Ruby/Tk tk.rb с臀篋絎鐚) -クラス TclTkIp - クラスメソッド + TclTkIp + 鴻＜純 new(ip_name=nil, options='') - : TclTkIp クラスのインスタンスを生成する． - : ip_name に文字列を与えた場合は，それが winfo interps などで - : 表示される名前になる． - : options には，-geometry や -use など，wish のコマンドライン - : 引数として与えるオプションと同様の情報を文字列として与える． - : 与えられた情報は，root widget 生成の際に用いられる． + : TclTkIp 鴻ゃ潟鴻帥潟鴻鐚 + : ip_name 絖筝翫鐚 winfo interps + : 茵腓冴鐚 + : options 鐚-geometry -use 鐚wish 潟潟ゃ + : 綣違筝激с潟罕宴絖筝鐚 + : 筝宴鐚root widget 鐚 : ( e.g. TclTkIp.new('FOO', '-geometry 500x200 -use 0x2200009') ) - : もし options に敢えて nil または false を与えた場合，Tk ライ - : ブラリが導入されていない (つまりは Tcl のみの) インタープリ - : タを生成する．この場合は GUI 環境は必要ないため，ウインドウ - : システムが存在しない，または使用できない環境でも Tcl インター - : プリタを生成し，Tcl やその拡張ライブラリを活用することができる． + : options ≪ nil 障 false 筝翫鐚Tk + : 絨ャ (ゃ障 Tcl 帥) ゃ潟帥若 + : 帥鐚翫 GUI 医綽荀鐚ゃ潟 + : 激鴻絖鐚障篏睡с医с Tcl ゃ潟帥 + : 帥鐚Tcl ≦宍ゃ羇紫с鐚 - インスタンスメソッド + ゃ潟鴻帥潟鴻＜純 create_slave(name, safe=false) - : レシーバを親とする name という名前のスレーブインタープリタを - : 生成する． - : safe には生成するインタープリタを safe インタープリタとする - : かを指定する．デフォルトは false ということになっているが， - : たとえ明確に false を指定していたとしても，親となるインター - : プリタが safe インタープリタであれば，その設定を引き継いで - : safe インタープリタとして生成される． - : $SAFE >= 4 では，safe インタープリタ以外の生成が禁止される． + : 激若荀 name 鴻若ゃ潟帥若帥 + : 鐚 + : safe ゃ潟帥若帥 safe ゃ潟帥若帥 + : 絎鐚 false ｃ鐚 + : 腆冴 false 絎鐚荀ゃ潟帥 + : 帥 safe ゃ潟帥若帥с逸荐絎綣膓 + : safe ゃ潟帥若帥鐚 + : $SAFE >= 4 с鐚safe ゃ潟帥若推札紊胼罩≪鐚 make_safe - : Tcl/Tk インタープリタを safe インタープリタに変更する． - : 戻り値はレシーバであるインタープリタ自身である． - : 失敗した場合は RuntimeError の例外を発生する． + : Tcl/Tk ゃ潟帥若帥 safe ゃ潟帥若帥紊眼鐚 + : 祉ゃ激若сゃ潟帥若粋荳с鐚 + : 紊掩翫 RuntimeError 箴紊榊鐚 safe? - : Tcl/Tk インタープリタが safe インタープリタであるかを調べる． - : safe インタープリタであれば true を返す． + : Tcl/Tk ゃ潟帥若帥 safe ゃ潟帥若帥с茯帥鴻鐚 + : safe ゃ潟帥若帥с true 菴鐚 allow_ruby_exit? - : 対象となるインタープリタ上の評価で，ruby の exit 関数または - : Tcl/Tk 上の exit コマンドによって ruby 自体を終了させること - : を許すかどうかを返す． - : 許さない場合は対象のインタープリタだけが終了する． - : マスターインタープリタのデフォルト値は true，スレーブインター - : プリタのデフォルト値は false である． + : 絲乗院ゃ潟帥若推荅箴＜эruby exit ∽違障 + : Tcl/Tk 筝 exit 潟潟ｃ ruby 篏腟篋 + : 荐宴菴鐚 + : 荐宴翫絲乗院ゃ潟帥若帥腟篋鐚 + : 鴻帥若ゃ潟帥若帥ゃ true鐚鴻若ゃ潟帥 + : 帥ゃ false с鐚 allow_ruby_exit=(mode) - : 対象となるインタープリタの allow_ruby_exit? の状態を変更する． - : $SAFE >= 4 またはインタープリタが safe インタープリタの場合は - : 変更が許されない (例外を発生)． + : 絲乗院ゃ潟帥若帥 allow_ruby_exit? 倶紊眼鐚 + : $SAFE >= 4 障ゃ潟帥若帥 safe ゃ潟帥若帥翫 + : 紊眼荐宴 (箴紊榊)鐚 delete - : Tcl/Tk インタープリタを delete する． - : delete されたインタープリタは，以後一切の操作ができなくなり， - : コマンドを送っても例外を発生するようになる． + : Tcl/Tk ゃ潟帥若帥 delete 鐚 + : delete ゃ潟帥若帥鐚篁ュ筝篏с鐚 + : 潟潟ｃ箴紊榊鐚 deleted? - : Tcl/Tk インタープリタがすでに delete されているかを調べる． - : delete 済みでコマンドを受け付けない状態になっているならば - : true を返す． + : Tcl/Tk ゃ潟帥若帥с delete 茯帥鴻鐚 + : delete 羝帥с潟潟篁倶ｃ + : true 菴鐚 has_mainwindow? - : Tcl/Tk インタープリタにメインウィンドウ (root widget) が - : 存在すれば true を，存在しなければ false を返す． - : インタープリタが既に delete 済みであれば nil を返す． + : Tcl/Tk ゃ潟帥若帥＜ゃ潟ｃ潟 (root widget) + : 絖 true 鐚絖 false 菴鐚 + : ゃ潟帥若帥≪ delete 羝帥с nil 菴鐚 restart - : Tcl/Tk インタープリタの Tk 部分の初期化，再起動を行う． - : 一旦 root widget を破壊した後に再度 Tk の機能が必要と - : なった場合に用いる． - : $SAFE >= 4 では実行が禁止される． + : Tcl/Tk ゃ潟帥若帥 Tk 鐚莎桁茵鐚 + : 筝 root widget 翫緇綺 Tk 罘純綽荀 + : ｃ翫鐚 + : $SAFE >= 4 с絎茵胼罩≪鐚 _eval(str) _invoke(*args) - : Tcl/Tk インタープリタ上で評価を行う． - : _eval は評価スクリプトが一つの文字列であることに対し， - : _invoke は評価スクリプトの token ごとに一つの引数とな - : るように与える． - : _invoke の方は Tcl/Tk インタープリタの字句解析器を用い - : ないため，評価の負荷がより少なくてすむ．ただし，その代 - : わりに auto_load のような機構は働かず，load 等によって - : Tcl/Tk インタープリタ上に既に登録済みのコマンドしか呼 - : び出すことができない． - : _eval では auto_load 機構が働くため，一度 _eval を実行 - : して登録に成功しさえすれば，以降は _invoke でも利用で - : きるようになる． + : Tcl/Tk ゃ潟帥若推ц箴＜茵鐚 + : _eval 荅箴＜鴻筝ゃ絖с絲障鐚 + : _invoke 荅箴＜鴻 token 筝ゃ綣違 + : 筝鐚 + : _invoke 鴻 Tcl/Tk ゃ潟帥若帥絖ヨВ + : 鐚荅箴＜莢激絨鐚鐚篁 + : auto_load 罘罕鐚load 膈ｃ + : Tcl/Tk ゃ潟帥若推≪脂我帥潟潟 + : 喝冴с鐚 + : _eval с auto_load 罘罕鐚筝綺 _eval 絎茵 + : 脂蚊逸篁ラ _invoke с + : 鐚 _cancel_eval(str) _cancel_eval_unwind(str) : (Tcl/Tk8.6 or later) - : Tcl_CancelEval() 関数を呼び出し，eval の実行を打ち切る． + : Tcl_CancelEval() ∽違若喝冴鐚eval 絎茵≦鐚 _toUTF8(str, encoding=nil) _fromUTF8(str, encoding=nil) - : Tcl/Tk が内蔵している UTF8 変換処理を呼び出す． + : Tcl/Tk 泣 UTF8 紊若喝冴鐚 _thread_vwait(var_name) _thread_tkwait(mode, target) - : スレッド対応の vwait あるいは tkwait 相当のメソッド． - : 通常の vwait あるいは tkwait コマンドと異なるのは，イベン - : トループとは異なるスレッドから呼び出した場合に vwait 等の - : スタックとは独立に条件の成立待ちがなされることである． - : 通常の vwait / tkwait では，vwait / tkwait (1) の待ちの途 - : 中でさらに vwait / tkwait (2) が呼ばれた場合，待ちの対象 - : となっている条件の成立順序がどうあれ，(2)->(1) の順で待ち - : を終了して戻ってくる． - : _thread_vwait / _thread_tkwait は，イベントループのスレッ - : ドで呼ばれた場合は通常の vwait / tkwait と同様に動作する - : が，イベントループ以外のスレッドで呼ばれた場合にはそのス - : レッドを停止させて待ちに入り，条件が成立した時にスレッド - : の実行を再開する．「vwait 等の待ちスタックとは独立」とい - : う意味は，この再開のタイミングが他のスレッドでの待ち状況 - : とは無関係ということである．つまり，イベントループ等の他 - : のスレッドで vwait 等で待ちの状態にあったとしてもその完了 - : を待つことなく，自らの待ち条件が成立次第，処理を継続する - : ことになる． + : 鴻絲上 vwait tkwait 後＜純鐚 + : 絽吾 vwait tkwait 潟潟違鐚ゃ + : 若違鴻若喝冴翫 vwait 膈 + : 鴻帥腴＞散腴緇＜с鐚 + : 絽吾 vwait / tkwait с鐚vwait / tkwait (1) 緇＜ + : 筝с vwait / tkwait (2) 若違翫鐚緇＜絲乗院 + : ｃ＞散腴綺鐚(2)->(1) у + : 腟篋祉ｃ鐚 + : _thread_vwait / _thread_tkwait 鐚ゃ潟若鴻 + : у若違翫絽吾 vwait / tkwait 罕篏 + : 鐚ゃ潟若篁ュ鴻у若違翫 + : 罩≪緇＜ャ鐚＞散腴鴻 + : 絎茵鐚vwait 膈緇＜鴻帥腴 + : 潟鐚帥ゃ潟違篁鴻с緇∞倶 + : ♂≫с鐚ゃ障鐚ゃ潟若膈篁 + : 鴻 vwait 膈у＜倶ｃ絎篋 + : 緇ゃ鐚緇≧＞散腴罨∞鐚膓膓 + : 鐚 _return_value - : 直前の Tcl/Tk 上での評価の実行結果としての戻り値を返す． + : 翫 Tcl/Tk 筝с荅箴＜絎茵腟祉ゃ菴鐚 _get_variable(var_name, flag) _get_variable2(var_name, index_name, flag) - : Tcl/Tk 上の var という変数名の変数の値を返す． - : もし index_name が指定 (PARSE_VARNAME フラグの説明も参照) - : された場合は連想配列 var_name の index_name の要素を返す． - : flag には変数を検索する際の条件を指定する．flag に与える - : 値はモジュール TclTkLib::VarAccessFlag を参照すること． + : Tcl/Tk 筝 var 紊医紊違ゃ菴鐚 + : index_name 絎 (PARSE_VARNAME 違茯) + : 翫ｆ渇 var_name index_name 荀膣菴鐚 + : flag 紊違罎膣≪＞散絎鐚flag 筝 + : ゃ≪吾ャ若 TclTkLib::VarAccessFlag с鐚 _set_variable(var_name, value, flag) _set_variable2(var_name, index_name, value, flag) - : Tcl/Tk 上の var という変数名の変数に値を設定する． - : もし index_name が指定 (PARSE_VARNAME フラグの説明も参照) - : された場合は連想配列 var_name の index_name の要素を設定 - : する． - : flag には変数を検索する際の条件を指定する．flag に与える - : 値はモジュール TclTkLib::VarAccessFlag を参照すること． + : Tcl/Tk 筝 var 紊医紊違ゃ荐絎鐚 + : index_name 絎 (PARSE_VARNAME 違茯) + : 翫ｆ渇 var_name index_name 荀膣荐絎 + : 鐚 + : flag 紊違罎膣≪＞散絎鐚flag 筝 + : ゃ≪吾ャ若 TclTkLib::VarAccessFlag с鐚 _unset_variable(var_name) _unset_variable2(var_name, index_name) - : Tcl/Tk 上の var_name という変数名の変数を消去する． - : もし index_name が指定 (PARSE_VARNAME フラグの説明も参照) - : された場合は連想配列 var_name から index_name の要素だけ - : を消去する． + : Tcl/Tk 筝 var_name 紊医紊違羔ｻ鐚 + : index_name 絎 (PARSE_VARNAME 違茯) + : 翫ｆ渇 var_name index_name 荀膣 + : 羔ｻ鐚 _get_global_var(var_name) _get_global_var2(var_name, index_name) @@ -527,31 +527,31 @@ require "tcltklib" すると, 以下のモジュール, クラスが利用可能です. _set_global_var2(var_name, index_name, value) _unset_global_var(var_name) _unset_global_var2(var_name, index_name) - : それぞれ，対応する変数アクセスメソッドの flag に対して - : (GLOBAL_ONLY | LEAVE_ERR_MSG) を与えたもの． + : 鐚絲上紊違≪祉鴻＜純 flag 絲障 + : (GLOBAL_ONLY | LEAVE_ERR_MSG) 筝鐚 _split_tklist(str) - : Tcl/Tk のライブラリ関数を使って，文字列 str をリストに - : 分割する (文字列の配列として返す)． + : Tcl/Tk ゃ∽違篏帥ｃ鐚絖 str 鴻 + : 蚊 (絖菴)鐚 _merge_tklist(str, str, ... ) - : Tcl/Tk のライブラリ関数を使って，引数の文字列がそれぞれ - : 正しく一つのリスト要素となるように連結した文字列を返す． + : Tcl/Tk ゃ∽違篏帥ｃ鐚綣違絖 + : 罩ｃ鋇ゃ鴻荀膣ｇ絖菴鐚 _conv_listelement(str) - : Tcl/Tk のライブラリ関数を使って，引数の文字列が Tcl の - : 一つのリスト要素として適切な表現になるように変換した文 - : 字列を返す． + : Tcl/Tk ゃ∽違篏帥ｃ鐚綣違絖 Tcl + : 筝ゃ鴻荀膣茵憗紊 + : 絖菴鐚 mainloop mainloop_watchdog - : スレーブ IP の場合にはイベントループを起動せずに nil を返す． - : それ以外の点では引数を含めて TclTkLib の同名メソッドに同じ． + : 鴻若 IP 翫ゃ潟若莎桁 nil 菴鐚 + : 篁ュ鴻с綣違 TclTkLib ＜純鐚 do_one_event - : スレーブ IP の場合には引数のイベントフラグに DONT_WAIT が - : 強制的に追加される (イベント待ちでスリープすることは禁止)． - : それ以外の点では引数を含めて TclTkLib の同名メソッドに同じ． + : 鴻若 IP 翫綣違ゃ潟違 DONT_WAIT + : 綣桁句菴遵 (ゃ潟緇＜с鴻若胼罩)鐚 + : 篁ュ鴻с綣違 TclTkLib ＜純鐚 set_eventloop_tick get_eventloop_tick @@ -561,24 +561,24 @@ require "tcltklib" すると, 以下のモジュール, クラスが利用可能です. get_eventloop_weight mainloop_abort_on_exception mainloop_abort_on_exception= - : スレーブ IP の場合には値の設定が許されない (無視される)． - : それ以外の点では引数を含めて TclTkLib の同名メソッドに同じ． + : 鴻若 IP 翫ゃ荐絎荐宴 (∴)鐚 + : 篁ュ鴻с綣違 TclTkLib ＜純鐚 encoding_table - : Ruby m17n 用に Ruby と Tk との間の encoding 対応表を返す． - -クラス TkCallbackBreak < StandardError -クラス TkCallbackContinue < StandardError - : これらはイベントコールバックにおいて，コールバック処理を適切に中 - : 断したり，次のバインドタグのバインディング処理に進めたりすること - : を可能にするための例外クラスである． - : コールバックで break や continue を実現するためには，コールバック - : である Ruby 手続きが Tcl/Tk インタープリタ側に適切なリターンコー - : ドを返す必要がある．Ruby の手続きが普通に値を返すのでは，それが普 - : 通の戻り値であるのか否かを区別ができないため，例外発生を利用した - : 実装を行っている． - : ただし現在では，コールバック手続きを Ruby の break, next で終了す - : ることで同等の結果を得ることができるようになっている．それゆえ， - : これらは必要ないものではあるが，互換性のために残してある． + : Ruby m17n Ruby Tk encoding 絲上茵菴鐚 + + TkCallbackBreak < StandardError + TkCallbackContinue < StandardError + : ゃ潟潟若鐚潟若筝 + : 鐚罨＜ゃ潟帥違ゃ潟ｃ潟医蚊 + : 純箴紊鴻с鐚 + : 潟若 break continue 絎憗鐚潟若 + : с Ruby 膓 Tcl/Tk ゃ潟帥若水眼帥若潟潟 + : 菴綽荀鐚Ruby 膓ゃ菴с鐚 + : 祉ゃс阪ャс鐚箴紊榊 + : 絎茖茵ｃ鐚 + : 憜с鐚潟若膓 Ruby break, next х篋 + : у膈腟緇сｃ鐚鐚 + : 綽荀с鐚篋с罧鐚 (eof) |