[ruby-gnome2-doc-cvs] [Ruby-GNOME2 Project Website] update - tut-gtk2-dynui-libglade

アーカイブの一覧に戻る

ruby-****@sourc***** ruby-****@sourc*****
2009年 3月 6日 (金) 01:19:43 JST


-------------------------
REMOTE_ADDR = 74.15.84.244
REMOTE_HOST = 
        URL = http://ruby-gnome2.sourceforge.jp/hiki.cgi?tut-gtk2-dynui-libglade
-------------------------
@@ -25,7 +25,8 @@
  
    attr :glade
    
-   def initialize(path_or_data, root = nil,
+   def initialize(path_or_data, 
+                  root = nil,
                   domain = nil,
                   localedir = nil,
                   flag = GladeXML::FILE)
@@ -81,6 +82,8 @@
    Gtk.main
  end
 
+
 However you can not yet run this program as is. You must first make your main window visible. To do this you must first capture the (YourApplication)Glade object into a variable. In our case this object is ((*BrowserGlade*)) object. In the above program you would change the following line:
   
    BrowserGlade.new(PROG_PATH, nil, PROG_NAME)
@@ -108,10 +110,21 @@
    Gtk.main
  end
 
-After you add the above " missing" code you may run your output ((*browser.rb*)) program. Indeed, you would need to implement the all the callback methods, but one should be fixed immediately, namely: 
+or the equivalent:
 
+ # Main program
+ if __FILE__ == $0
+   # Set values as your own application. 
+   PROG_PATH = "browser.glade"
+   PROG_NAME = "YOUR_APPLICATION_NAME"
+   o = BrowserGlade.new(PROG_PATH, nil, PROG_NAME)
+   o.glade["window"].show_all
+   Gtk.main
+ end
 
-After you add the necessary code mentioned above to the output ((*(browser.rb)*)) program, you may run it.  Indeed, you would need to implement the all the callback methods, but one should be fixed immediately, namely: 
+After you add the above " missing" code you may run your output ((*browser.rb*)) program. Indeed, you would need to implement the all the callback methods, but one should be fixed immediately, namely: 
 
  def gtk_main_quit(widget)
    puts "gtk_main_quit() is not implemented yet."
@@ -128,3 +139,41 @@
     {{br}}
 
     After all, some reflective thinking  reveals that the way above procedures are set makes sense, namely one should be reminded from the start that there is a Ruby code hidden behind all this Glade convenience, and that you gain access to it by calling GladeXML#get_widget("widget_name"). 
+
+=== Loading a User Interface
+
+Libglade provides the ((<GladeXML>)) object that is used to create and hold the user interface from an XML file. It is also be used to connect signals added in the Glade file to callback methods within your application.
+
+An advantage of Libglade is that a minimal overhead to your application is added only during the application start-up, and is negligible in comparison to an equivalent application created directly from the Ruby code. After the start-up there is virtually no overhead added to the application. For example, GladeXML connects the signal handlers in the same way as your own code, so this too requires no extra processing. Since Libglade handles all of the widget initialization and the layout was already designed in Glade 3, the length of your code base can be significantly reduced.  
+
+
+Loading a Glade user interface is done with GladeXML.new. This code is squirrelled away in (ourApplication)Glade object. GladeXML.new parses the user interface provided by the XML file, creates all the necessary widgets, and provides facilities for translation.
+
+     @glade = GladeXML.new(path_or_data,
+                           root,
+                           domain,
+                           localedir,
+                           flag) {|handler| method(handler)}
+
+The return value of GladeXML.new is an GladeXML object saved in (ourApplication)Glade's attribute called ((*glade*)). This object can be viewed as an array containing all the widgets you created with Glade application. Once you have initialized the user interface by creating a new ((<GladeXML>)) object:
+
+   o = BrowserGlade.new(program_path, nil, program_name)
+
+you can retrieve widgets by either of the two following methods:
+
+   widget = o.glade.get_widget("widget_name")
+or
+   widget = o.glade.["widget_name"]
+
+The widget returned above is already set up with all of the properties that you set up in Glade. You can use this widget like any other Gtk::Widget that was created in your applications using methods provided by Ruby GTK+ (Ruby/GNOME2). This shows one of the main advantages of Libglade - you do not have to provide all the monotonous code for setting up the user interface and can quickly get to developing more interesting aspects of the application.




ruby-gnome2-cvs メーリングリストの案内
アーカイブの一覧に戻る