Ruby GUI Toolkits Available GUI toolkits n The

Ruby GUI Toolkits

Available GUI toolkits n The Tk GUI toolkit is a part of the Ruby distribution n Other toolkits are FXRuby, GTK+, FLTK, Gt, probably others n n Tk is badly documented, does not support native widgets, and is generally regarded as ugly However, Tk is perfectly functional and easily available All have some significant disadvantages My less-than-extensive research (about an hour's worth) leads me to think that wx. Ruby 2 is the best choice n n Advantages: Fairly stable, mature, cross-platform, native look-and-feel, good selection of widgets Disadvantage: C++ oriented The home page is at http: //wxrubyforge. org/wiki. pl Download from Ruby. Forge at http: //rubyforge. org/frs/? group_id=35

Modern event-driven programs n Multiple sources of input n n n mouse clicks keyboard timers external events In all modern languages, this is handled with an event loop Wait for event Dispatch event Quit

Java hides the event loop n n The event loop is built into Java GUIs Interacting with a GUI component (such as a button) causes an event to occur n n An Event is an object You create Listeners for interesting events The Listener gets the Event as a parameter In Ruby, the event loop is not built in n However, Ruby GUI systems provide one—you just have to use it

“Hello world” in Tk n n n require 'tk' root = Tk. Root. new { title 'Our first Tk App' } label = Tk. Label. new(root) do text 'Hello, world!' pack("padx" => 90) end Tk. mainloop All subsequent widgets will be contained by root The block uses instance_eval; the title method belongs to the newly created instance pack is a geometry manager; it takes a hash as an argument The mainloop is the event handler

Geometry managers n n Geometry managers are like Java’s layout managers Ruby has three geometry managers: grid, place, and pack n n pack is like Java’s Flow. Layout; things are put into it in the order they are defined grid is like Java’s Gridbag. Layout, and is complex place specifies pixel coordinates, and is tedious pack is the best compromise for ordinary use

Allocation rectangle n n Every Ruby widget has an allocation rectangle, and is put somewhere inside that rectangle Here are the options for the hash argument to pack: n n n The 'side' option tells where the allocation rectangle goes in the container--'top' (default), 'bottom', 'left', or 'right' The 'expand' option tells whether the allocation rectangle should be expanded to fill the remaining space--the value is either '0' (default, meaning don’t expand) or '1' The 'anchor' option tells where the widget goes in the allocation rectangle--'n', 'ne', 'se', 'sw', 'nw', or 'center' The 'fill' option tells how to stretch the widget to fill the container-'none' (default), 'x', 'y', or 'both' The 'padx' and 'pady' options specify margins n n The default is pixels You can suffix a number with a letter: i for inches, p for points, m for millimeters, or c for centimeters

Packing example I n require 'tk' n root = Tk. Root. new() { title "Packing Example" } n n n button = Tk. Button. new(root) { text "First, rightmost" } button. pack("side"=>"right", "fill"=>"y") entry = Tk. Entry. new(root). pack("side"=>"top", "fill"=>"x") entry. insert(0, "Entry on the top") label = Tk. Label. new() { text "to the right" } label. pack("side"=>"right")

Packing example II n n image = Tk. Photo. Image. new('file'=>"background. gif", 'height'=>50) img_label = Tk. Label. new(root) { image }. pack("anchor"=>"e") text = Tk. Text. new(root) { width 20; height 5 }. pack("side"=>"left") text. insert('end', "Left in canvas") n Tk. Message. new(root) { text "Message in the Bottom" }. pack("side"=>"bottom") n Tk. mainloop()

Event handling example n require 'tk' root = Tk. Root. new() { title "Click the Button" } button = Tk. Button. new(root) { text "Hello. . . " command proc { puts ". . . world!" } } button. pack() Tk. mainloop() n n This brings up a window with a button labeled “Hello. . . ” When the button is clicked, “. . . world!” is printed to the console

Ruby. Gems n Ruby. Gems is a standardized way of installing, upgrading, and removing Ruby packages n n n It uses a centralized repository, so you don’t even have to know where to download packages from If you installed Instant. Rails, you already have Ruby. Gems Example: n C: rubyInstant. Railsrails_apps>gem install wxruby 2 -preview Select which gem to install for your platform (i 386 -mswin 32) 1. wxruby 2 -preview 0. 0. 40 (i 686 -darwin 8. 8. 2) 2. wxruby 2 -preview 0. 0. 40 (i 386 -mswin 32) 3. wxruby 2 -preview 0. 0. 40 (powerpc-darwin 7. 9. 0) 4. wxruby 2 -preview 0. 0. 40 (i 686 -linux) 5. Skip this gem 6. Cancel installation >1 Successfully installed wxruby 2 -preview-0. 0. 40 -i 686 -darwin 8. 8. 2

“Hello. World” in wx. Ruby 2 n require 'rubygems' require 'wx' include Wx # Extend the Wx: : App class Hello. World < App # Define what the application is going to do when it starts def on_init # Make a frame with the title "Hello World" helloframe = Frame. new(nil, -1, "Hello World") # Put the text "Hello World" in that frame Static. Text. new(helloframe, -1, "Hello World") # Make the window appear helloframe. show() end # Make the program actually do it! Hello. World. new. main_loop

Using wx. Ruby 2 n n n A tutorial for wx. Ruby 2 is at http: //wxrubyforge. org/wiki. pl? Wx. Ruby_Tutorial Some of the examples don’t work as printed The following code, at the beginning of the file, seems to solve the problem: n begin require 'wx' rescue Load. Error => no_wx_err begin require 'rubygems' require 'wx' rescue Load. Error raise no_wx_err end include Wx

Using a Box. Sizer n # Code from previous slide goes here class My. App < Wx: : App def on_init() frame = Wx: : Frame. new(nil, -1, 'Sizer happiness') frame. set_client_size(Wx: : Size. new(200, 200)) sizer = Wx: : Box. Sizer. new(Wx: : VERTICAL) text = Wx: : Text. Ctrl. new(frame, -1, 'Type in here', Wx: : DEFAULT_POSITION, Wx: : DEFAULT_SIZE, Wx: : TE_MULTILINE) sizer. add(text, 1, Wx: : GROW|Wx: : ALL, 2) button = Wx: : Button. new(frame, -1, 'Click on this') sizer. add(button, 0, Wx: : ALIGN_RIGHT, 2) frame. set_sizer(sizer) frame. show() end My. App. new. main_loop()

Comments n n Ruby has no real “Ruby-like” GUI system Tk is the default if you are OK with just basic functionality and don’t care much about appearance You have several choices if you want something better than Tk This situation may change as Ruby becomes increasingly popular

The End