Create  Edit  FrontPage  Index  Search  Changes  History  RSS  Login

GladeXML

class GladeXML

GladeXML allows dynamic loading of user interfaces from XML descriptions.

Class Methods

GladeXML.new(file_or_buffer, root = nil, domain = nil, source = GladeXML::FILE) {|handler| ... }

Creates a new GladeXML object (and the corresponding widgets) from the Glade XML file or a String representation of the XML. Optionally it will only build the interface from the widget node root (if it is not nil). This feature is useful if you only want to build say a toolbar or menu from the Glade XML file, but not the window it is embedded in. Note also that the XML parse tree is cached to speed up creating another GladeXML object for the same file. locale target directory is picked up from GETTEXT_PATH environment variable, or used system path(e.g. /usr/share/locale).

The additional block is connected to all signal handlers. It receives the signal handler name as the only argument. A common block is

{|handler| method(handler)}

which returns a reference to the instance method if the class with the same name as the signal handler.

  • file_or_buffer: if source is GladeXML::FILE, a file name, if source is GladeXML::BUFFER, a String representation of the Glade XML.
  • root: the widget node in fname to start building from.
  • domain: the translation domain for the XML file
  • source: GladeXML::FILE or GladeXML::BUFFER
  • {|handler| ...}: a handler block. If you don't define this block, you will need to call GladeXML#signal_autoconnect_full
    • handler: the name of the signal handler.
  • Returns: a GladeXML instance
GladeXML.new(file_or_buffer, root = nil, domain = nil, localedir, source = GladeXML::FILE) {|handler| ... }
Creates a new GladeXML object (and the corresponding widgets) from the Glade XML file or a String representation of the XML.
  • file_or_buffer: if source is GladeXML::FILE, a file name, if source is GladeXML::BUFFER, a String representation of the Glade XML.
  • root: the widget node in fname to start building from.
  • domain: the translation domain for the XML file
  • localedir: locale directory. If nil, use GETTEXT_PATH environment variable, or system path(e.g. /usr/share/locale).
  • source: GladeXML::FILE or GladeXML::BUFFER
  • {|handler| ...}: a handler block. If you don't define this block, you will need to call GladeXML#signal_autoconnect_full
    • handler: the name of the signal handler.
  • Returns: a GladeXML instance
GladeXML.require(library)
Ensures that a required library is available. If it is not already available, libglade will attempt to dynamically load a module that contains the handlers for that library.
  • library: the required library.
  • Returns: self
GladeXML.provide(library)
This method should be called by a module to assert that it provides wrappers for a particular library. This should be called by the register_widgets() function of a libglade module so that it isn't loaded twice, for instance.
  • library: the provided library.
  • Returns: self
GladeXML.set_custom_widget_handler(setting)
Turns the custom widget handler on or off. Usually you don't need to call this method by yourself. This is only used by the ruby-glade-create-template program.
  • setting: true or false
  • Returns: self
GladeXML.get_widget_name(widget)
Used to get the name of a widget that was generated by a GladeXML object.
  • widget: the Gtk::Widget
  • Returns: the name of the widget.
GladeXML.get_widget_tree(widget)
Used to get the GladeXML object that built this widget.
  • widget: the Gtk::idget?
  • Returns: the GladeXML object that built this widget.
get_tooltips(toplevel)
Gets the Gtk::Tooltips object.
  • toplevel: the top level widget.
  • Returns: the Gtk::Tooltips object.

Instance Methods

get_widget(name)
This method is used to get a reference to the Gtk::Widget corresponding to name in the XML interface description. You can use it if you need to work with the widgets after the interface has been loaded.
  • name: the name of the widget (as a String) in the glade tree.
  • Returns: a reference to a Gtk::Widget or nil if name does not exist
[name]
This is the same as get_widget(name).
  • name: the widget's name(String) in the glade tree.
  • Returns: a reference(Gtk::Widget) to name or nil if name does not exist
get_widget_prefix(prefix)
Used to get a list of pointers to the Gtk::Widget(s) with names that start with the string name in the interface description. You would use this if you have to do something to all of these widgets after loading.
  • prefix: the prefix of the widget name.
  • Returns: An array of the Gtk::Widget that match name as the start of their name.
filename
Gets the name of the original Glade XML file.
  • Returns: the name of the glade file
  • Returns: self
connect(source, target, signal_name, handler_name, signal_data, after = false)
Connects a handler method to a signal in the Glade XML file with the given signal handler name. Usually, this method is called from GladeXML.new. You don't need to call this method by yourself.
signal_autoconnect_full{|source, target, signal_name, handler_name, signal_data, after| ... }
This method is for connecting each handler methods to each signals from the parameters. Usually you don't need to call this method by yourself. This method is only used by the ruby-glade-create-template program.
canonical_handler(handler_name)
Converts an handler_name to a canonical handler name. '-', ' ' are converted to '_'. You don't need to call this method by yourself. This method is only used by libglade2.rb and ruby-glade-create-template.
  • handler_name: the name which you want to covert
  • Returns: converted name.
custom_creation_methods
Gets an Array of the custom creation methods in the GladeXML object.
  • Returns: a list of custom creation methods, as an Array of String objects.
widget_names
Gets an Array of the widget names in the GladeXML object.
  • Returns: a list of widget names, as an Array of String objects.
handler_proc
Gets the handler_proc.
  • Returns: handler proc.
handler_proc=(proc)
Sets the handler_proc. If target of GladeXML#connect sets nil, this handler_proc is called as the default handler.
filename
Gets the filename which passed to GladeXML.new
  • Returns: filename.
get_tooltips
  • Returns: self: FIXME
xml
  • Returns: self: FIXME

Constants

BUFFER
Buffer mode to create a new GladeXML. This is used with GladeXML.new.
FILE
File mode to create a new GladeXML. This is used with GladeXML.new.
BUILD_VERSION
LOG_DOMAIN

ChangeLog

  • 2005-09-19 Added Gtk::GladeXML#get_widget_prefix?, .get_widget_name, .get_widget_tree, .get_tooltips, #filename. Masao
  • 2004-05-01 Fixed some typos. lrz
  • 2004-04-28 Change pageid. Some modified. Masao
  • 2004-04-27 Revised some methods. Masao
  • 2004-04-24 Initial release. jawebada