I've seen some documentation on Ruby and Tk in places like Pickaxe and
Ruby Way, and it seems that they seem to say to use the Perl
documentation for Tk, and covert that to Ruby. Problem is, I have no
clue about Perl. Is there a definitive Ruby/Tk guide or piece of
documentation out there that I'm unaware of?
Thanks,
Jeremy
Jeremy Bear wrote:
I've seen some documentation on Ruby and Tk in places like Pickaxe and
Ruby Way, and it seems that they seem to say to use the Perl
documentation for Tk, and covert that to Ruby. Problem is, I have no
clue about Perl. Is there a definitive Ruby/Tk guide or piece of
documentation out there that I'm unaware of?Thanks,
Jeremy
Check out sites like:
Mitom Tv Bóng Đá Trực Tiếp - Kênh Ttbđ Mitomtv Không Giật Lag-Full Hd Blv
http://members.chello.nl/~k.vangelder/ruby/learntk/
That should get you started...
Zach
Hi,
I think there is no real definitive Ruby/Tk guide out there, but the following sources should help you, after you have read the Pickaxe chapter and the tutorial at http://members.chello.nl/~k.vangelder/ruby/learntk/ :
If you want to see some more examples and get an idea what can be done with tk, get the ruby sources, go to ext/tk/sample/demos-en/ and run "ruby widget". These examples helped me very much and you can view the source easily.
If you need a reference for all tk widgets, check out http://www.tcl.tk/man/tcl8.4/TkCmd/contents.htm\. At the beginning it is a bit difficult to map the tcl commands to ruby, but once you get the idea how it works, it's a really nice reference of the commands and options for all the widgets.
You can also look at the tk documentation at RDoc Documentation, it is not well documented but you can at least see what methods are available and sometimes it helps to look at the source.
Dominik
On Wed, 13 Apr 2005 23:59:26 +0200, Jeremy Bear <jeremy.bear@gmail.com> wrote:
I've seen some documentation on Ruby and Tk in places like Pickaxe and
Ruby Way, and it seems that they seem to say to use the Perl
documentation for Tk, and covert that to Ruby. Problem is, I have no
clue about Perl. Is there a definitive Ruby/Tk guide or piece of
documentation out there that I'm unaware of?Thanks,
Jeremy
Hi,
From: Jeremy Bear <jeremy.bear@gmail.com>
Subject: Definitive Ruby/Tk guide?
Date: Thu, 14 Apr 2005 06:59:26 +0900
Message-ID: <5b46263905041314586b31f356@mail.gmail.com>
Is there a definitive Ruby/Tk guide or piece of
documentation out there that I'm unaware of?
<Class>
TclTkIp :[tcltklib] Tcl/Tk interpreter
MultiTkIp :treat multiple Tcl/Tk interpreters
RemoteTkIp :control other Tk (Tcl/Tk or Ruby/Tk) interpreters on other
processes by Tcl/Tk's 'send' command. (When its own window
and the other's window exist on a same display and the
others accept 'send' command control, the process of the
other can be controlled even if the process exists on the
another machine.)
TkKernel
TkObject
TkWindow
TkRoot :root widget
TkToplevel :toplevel widget
TkFrame :frame widget
TkLabelFrame :frame widget with label
TkMenubar :menubar frame
TkLabel :label widget
TkMessage :message widget
TkEntry :entry widget
TkSpinbox :spinbox widget
TkButton :button widget
TkRadioButton (TkRadiobutton) :radiobutton widget
TkCheckButton (TkCheckbutton) :checkgutton widget
TkMenubutton :menubutton widget
TkOptionMenubutton :option_menu_button
(use Tcl/Tk's 'tk_optionMenu' command)
TkTextWin
TkListbox :listbox widget
TkScrollbox :listbox widget with scrollbar
TkText :text widget
TkCnavas :canvas widget
TkMenu :menu widget
TkMenuClone :clone menu
TkSysMenu_Help :system-dependent 'Help' menu (Unix)
TkSysMenu_System :system-dependent 'System' menu (Windows)
TkSysMenu_Apple :system-dependent 'Apple' menu (Mac)
TkOptionMenubutton::OptionMenu :menu allocated option_menu_button
TkPanedWindow (TkPanedwindow) :paned window widget
TkScale :scale widget
TkScrollbar :scrollbar widget
TkXScrollbar :horizontal scrollbar
TkYScrollbar :vertical scrollbar
TkDialog2 :dialog (reusable)
TkDialog :dialog (disposal)
TkWarning2 :dialog for warning (reusable)
TkWarning :dialog for warning (disposal)
TkcItem :canvas item class (abstract class)
TkcArc :arc
TkcBitmap :bitmap
TkcImage :image
TkcLine :line
TkcOval :oval
TkcPolygon :polygon
TkcRectangle :rectangle
TkcText :text
TkcWindow :embedded window
TkcTag :canvas tag
TkcTagString :canvas tag which has given name
TkcTagAll :'all' tag
TkcTagCurrent :'current' tag
TkcGroup :tag group (treat a set of tags)
TkImage :Image object (abstract class)
TkBitmapImage :bitmap
TkPhotoImage :photo image
TkTextTag :text tag
TkTextNamedTag :text tag which has given name
TkTextTagSel :'sel' tag
TkTextMark :text mark
TkTextNamedMark :text mark which has given name
TkTextMarkInsert :'insert' mark
TkTextMarkCurrent :'current' mark
TkTextMarkAnchor :'anchor' mark
TkTextImage :image object on text widget
TkTextWindow :embedded widget on text widget
TkNamespace :namespace on Tcl/Tk
TkNamespace::NsCode :namespace binding
TkMsgCatalog :message catalog
TkUtil::CallbackSubst :admin '%' substitution on callback
Tk::Event :for event callback
TkValidateCommand::ValidateArgs :for validation of entry widget
TkSpinbox::ValidateArgs :for validation of spinbox widget
TkUtil::CallbackSubst::Info :[internal use](used by TkUtil::CallbackSubst)
TkCallbackEntry :callback object
TkFont :font object
DescendantFont :descendant font (Japanized Tk8.0 only)
TkTimer (TkAfter) :timer object
TkBindTag :bindtag
TkBindTagAll :'all' bindtag
TkDatabaseClass :database class bindtag (or bindtag with given name).
see 'class' option ('classname' option on Ruby/Tk) of
frame widget
TkValidateCommand :validation command (callback with '%' substituteion)
TkSpinbox::SpinCommand :for command option of spinbox widget
String
Tk::EncodedString :string with encoding information
Tk::BinaryString :binary string
Tk::UTF8_String :utf-8 string
Array
TkNamespace::ScopeArgs :[internal use](used by namespace binding)
Hash
Tk::OptionObj :admin options of multiple widgets
Exception
StandardError
TkCallbackReturn :send 'return' code to Tcl/Tk interpreter
TkCallbackBreak :send 'break' code to Tcl/Tk interpreter
TkCallbackContinue :send 'continue' code to Tcl/Tk interpreter
MultiTkIp_OK :[internal use] (used by MultiTkIp)
Standard form::
widget_class.new(parent, arg, ..., options){ ... }
parent :: parent widget ( if nil, denotes the root widget )
arg, ... :: widget dependent arguments ( if required )
options :: a hash { option_name => value, ... }
( option_name is a string or a symbol )
the block is evaled by widget_class#instance_eval method
configure(options) :: options is a hash {opt=>val, ... }. returns self.
configure(option,val):: option is a string or a symbol. returns self.
option_name(val) :: if option_name method is not defined. returns self.
option_name = val :: if option_name method is not defined. returns val.
[option_name] = val :: same to configure(option, val)
cget(option) :: return current value of the option (a string or a symbol)
configinfo :: return a array of array [option_name, database_name,
database_class, default_value, current_value]
configinfo(option) :: return a array [option, database_name, database_class,
default_value, current_value]
current_configinfo :: a hash {option=>current_value, ....}
current_configinfo(option) :: a hash {option=>current_value}
option_name :: same to cget(option_name)
[option_name] :: if method is not defined, same to cget(option_name)
[Example]
[Tcl/Tk] man page of label widget
------------------------------------------------------------------
NAME
label - Create and manipulate label widgets
SYNOPSIS
label pathName ?options?
STANDARD OPTIONS
-anchor -font -image -takefocus
-background -foreground -justify -text
-bitmap -highlightbackground -padx -textvariable
-borderwidth -highlightcolor -pady -underline
-cursor -highlightthickness -relief -wraplength
See the options manual entry for details on the standard
options.
WIDGET-SPECIFIC OPTIONS
Command-Line Name:-height
Database Name: height
Database Class: Height
Specifies a desired height for the label. If an
image or bitmap is being displayed in the label
then the value is in screen units (i.e. any of the
forms acceptable to Tk_GetPixels); for text it is
in lines of text. If this option isn't specified,
the label's desired height is computed from the
size of the image or bitmap or text being displayed
in it.
------------------------------------------------------------------
[Ruby/Tk] class definition of label widget
------------------------------------------------------------------
class TkLabel<TkWindow
TkCommandNames = ['label'.freeze].freeze
WidgetClassName = 'Label'.freeze
WidgetClassNames[WidgetClassName] = self
#def create_self(keys)
# if keys and keys != None
# tk_call_without_enc('label', @path, *hash_kv(keys, true))
# else
# tk_call_without_enc('label', @path)
# end
#end
#private :create_self
def textvariable(v)
configure 'textvariable', tk_trace_variable(v)
end
end
------------------------------------------------------------------
+--> SYNOPSIS :: command format of widget creation
> * 'label' is a command name on the label widget
>
+--> general definition of Ruby/Tk's widget class
* defined by 'TkCommandNames' array
* call Tcl/Tk interpreter in 'create_self' method
( by default, use TkCommandNames[0] )
+--> definitions of Tcl/Tk widget options
> a set of 'Command-Line Name', 'Database Name', and 'Database Class'
>
> e.g. '-height' option
> Command-Line Name:-height
> Database Name: height
> Database Class: Height
>
> define '-height' option and '-text' option on the command line
> label parent.myName -height val -text val
> ==> use 'Command-Line Name'.
> 'parent' is the path of the parent widget.
> 'myName' is the name of the label widget.
> --> 'parent.myName' is the full path name of the widget
>
*--> on Ruby/Tk
give options by a hash
TkLabel.new(parent, :height=>val, :text=>val)
or
TkLabel.new(parent, 'height'=>val, 'text'=>val)
String -> as is (usually convert encoding of the string).
Symbol -> to string
Numeric -> to string
Array -> to a list string of Tcl/Tk
Hash -> convert to [-key, value, -key, value, ...] by TkComm.hash_kv()
TkUtil::None -> a special object. removed from arguments.
( Please try TkComm._get_eval_string() or TkComm.hash_kv(). )
==============================================================================
_invoke(*args) : treat each arguemnt as a token of Tcl/Tk's command line.
--> not use Tcl/Tk's command line parser.
_eval(string) : eval the string on Tcl/Tk.
--> use Tcl/Tk's command line parser.
NOTE:: Some Tcl/Tk's commands which loaded by 'autoload' facility must be
called by _eval method, because the facility works on the command
line parser.
==============================================================================
wrappers of TclTkIp#_invoke
tk_call(*args) : convert arguments and cal TkCore::INTERP._invoke
tk_send(*args) : convert arguments and add self as the 1st argument
and cal TkCore::INTERP._invoke
NOTE:: TkCore::INTERP is a default interpreter created when "requrie 'tk'"
tk_tcl2ruby(str) : estimate the pattern of str and convert to an object
_at(x,y=nil) : convert to "@x,y" or "@x" (index string of some wiget classes)
tk_split_list(val) : convert a Tcl/Tk's list string to a Ruby's array,
and convert each element to an object.
If an element seems like a list, call recursively.
tk_split_simplelist(val) : convert a Tcl/Tk's list string to a Ruby's array
of strings (not call recursively).
array2tk_list(ary) : convert a Ruby's array to a Tcl/Tk's list string
_symbolkey2str(hash) : return new hash which convert each key to a string
hash_kv(hash) : convert {key=>val, ...} to ['-key', val, ... ]
bool(str) : convert to true/false as if the str is a Tcl/Tk's boolean value.
number(str) : convert to a Numeric as if the str is a Tcl/Tk's numeric value.
string(str) : as is, however, if the str is wrapped by { }, remove { }
num_or_str(str) : if the str is assumed a Tcl/Tk's numeric value,
return a numeric object, else return string(str).
list(str) : same to tk_split_list(str)
simplelist(str) : same to tk_split_simplelist(str)
window(str) : return a widget object as if the str is a widget path
procedure(str) : return proc object as if the str is a command string for a
entried callback procedure.
_toUTF8(str, enc=nil) : convert encoding of the str from enc to utf-8
( if enc == nil, use default encoding )
_fromUTF8(str, enc=nil) : convert encoding of the str from utf-8 to enc
( if enc == nil, use default encoding )
_get_eval_string(obj) : convert obj to a string to pass to Tcl/Tk interpreter
<Event sequence>
----------------------------------------------------
Tcl/Tk -> Ruby/Tk
----------------------------------------------------
<event> 'event'
<event><event> ['event', 'event']
<<virtual-event>> '<virtual-event>'
----------------------------------------------------
<Define bind>
target.bind(event-sequence, procedure)
or
target.bind(event-sequence, procedure){ procedure }
or
target.bind(event-sequence, procedure, arg, arg, ... )
or
target.bind(event-sequence, arg, arg, ... ){ procedure }
<Append bind>
use 'bind_append' method
<Remove bind>
use 'bind_remove' method
<Get bind information>
use 'bindinfo' method
<Information of evnet>
(1) without arguments --> get an event object
e.g. proc{|ev| ... }
ev.widget : the widget which get the event
ev.x : x coords on the widget
ev.y : y coords on the widget
ev.x_root : x coords on the full window
ev.y_root : y coords on the full window
ev.char : a character of the pressed key on the keyboard
ev.keysym : a key-symbol of the pressed key on the keyboard
and so on.
(2) with arguments --> get defined arguments with substitution
( if an argument string includes spaces, each of splited string is
treated as an argument. )
* '%' + 1 char in the argument --> do '%' substitution, if available
* '%' + 1 char --> do '%' substitution, if available.
And returns as a proper object.
%W == ev.widget
%x == ev.x
%y == ev.y and so on.
* others --> a string
--
Hidetoshi NAGAI (nagai@ai.kyutech.ac.jp)
Jeremy Bear wrote:
I've seen some documentation on Ruby and Tk in places like Pickaxe and
Ruby Way, and it seems that they seem to say to use the Perl
documentation for Tk, and covert that to Ruby. Problem is, I have no
clue about Perl. Is there a definitive Ruby/Tk guide or piece of
documentation out there that I'm unaware of?
Not sure if it will be a definitive guide, but there is one book on Ruby/Tk that should be out in 2-3 months. Amazon.com has this email alert feature that you can configure to send you an email when a book whose title matches some keywords like 'ruby tk' is in their database.
jacek
I found this reference --> http://www.jbrowse.com/text/rubytk_en.html
<-- handy for getting specific answers. It's not 100% complete but is
very comprehensive. The other URL's folks have listed are great
references as well.