Ruby-GNOME2 Tutorial

Joshua Keith (joshuakeith at linuxmail dot org)
Last Update: December 05, 2002

Table of Contents

1. Tutorial Availability
2. Introduction
3. Getting Started
   
   • Hello World in Ruby-GNOME2
   • Theory of Signals and Callbacks
   • Events
   • Stepping Through Hello World
4. Moving On
   
   • More on Signal Handlers
   • An Upgraded Hello World
5. Packing Widgets
   
   • Theory of Packing Boxes
   • Details of Packing Boxes
   • Packing Demonstration Program
   • Packing Using Tables
   • Table Packing Example
6. Widget Overview
   
   • Widget Hierarchy
   • Widgets Without Windows
7. The Button Widget
   
   • Normal Buttons
   • Toggle Buttons
   • Check Buttons
   • Radio Buttons
8. Adjustments
   
   • Creating an Adjustment
   • Using Adjustments the Easy Way
   • Adjustment Internals
9. Range Widgets
   
   • Scrollbar Widgets
   • Scale Widgets
     
     • Creating a Scale Widget
     • Methods
   • Common Range Methods
     
     • Setting the Update Policy
     • Getting and Setting Adjustments
   • Key and Mouse Bindings
   • Example
10. Miscellaneous Widgets
• Labels
• Arrows
• The ToolTips Object
• Progress Bar
• Dialogs
• Rulers
• Statusbars
• Text Entries
• Spin Buttons
• Combo Box
• Calendar
• Color Selection
• File Selection
11. Container Widgets
    
    • The EventBox
    • The Alignment Widget
    • Fixed Container
    • Layout Container
    • Frames
    • Aspect Frame
    • Paned Window Widgets
    • Viewports
    • Scrolled Windows
    • Button Boxes
    • Toolbar
    • Notebooks
12. Menu Widgets
    
    • Manual Menu Creation
    • Manual Menu Example
    • Using ItemFactory
      
      • ItemFactory entries
      • Creating an ItemFactory
      • Making use of the menu and its menu items
    • ItemFactory Example
13. Undocumented Widgets
    
    • Accel Label
    • Option Menu
    • Menu Items
      
      • Check Menu Item
      • Radio Menu Item
      • Separator Menu Item
      • Tearoff Menu Item
    • Curves
    • Drawing Area
    • Font Selection Dialog
    • Message Dialog
    • Gamma Curve
    • Image
    • Plugs and Sockets
    • Tree View
    • Text View
14. Setting Widget Attributes
    
    • Widget Flag Methods
    • Widget Display Methods
    • Widget Accelerators
    • Widget Name Methods
    • Widget Styles
15. Timeouts, IO, and Idle Methods
    
    • Timeouts
    • Monitoring IO
    • Idle Methods
16. Advanced Event and Signal Handling
    
    • Signal Methods
      
      • Connecting and Disconnecting Signal Handlers
      • Blocking and Unblocking Signal Handlers
      • Emitting and Stopping Signals
    • Signal Emission and Propagation
17. Managing Selections
    
    • Overview
    • Retrieving the Selection
    • Supplying the Selection
18. Drag-and-Drop (DND)
    
    • Overview
    • Properties
    • Methods
19. Glib
20. GTK's rc Files
    
    • Methods for rc Files
    • Ruby-GNOME2's rc File Format
    • Example rc File
21. Writing Your Own Widgets
22. Scribble, A Simple Example Drawing Program
23. Tips for Writing Ruby-GNOME2 Applications
24. Contributing
25. Credits
26. Tutorial Copyright and Permissions Notice
27. GTK Signals
    
    • Gtk::Object
    • Gtk::Widget
    • Gtk::Data
    • Gtk::Container
    • Gtk::Calendar
    • Gtk::Editable
    • Gtk::Notebook
    • Gtk::List
    • Gtk::MenuShell
    • Gtk::Toolbar
    • Gtk::Button
    • Gtk::Item
    • Gtk::Window
    • Gtk::HandleBox
    • Gtk::ToggleButton
    • Gtk::MenuItem
    • Gtk::CheckMenuItem
    • Gtk::InputDialog
    • Gtk::ColorSelection
    • Gtk::StatusBar
    • Gtk::Curve
    • Gtk::Adjustment
28. GDK Event Types
29. Code Examples
    
    • Tictactoe
    • GtkDial
    • Scribble