<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <!--Rendered using the Haskell Html Library v0.2--> <HTML ><HEAD ><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8" ><TITLE >Graphics.UI.Gtk.Builder</TITLE ><LINK HREF="haddock.css" REL="stylesheet" TYPE="text/css" ><SCRIPT SRC="haddock-util.js" TYPE="text/javascript" ></SCRIPT ><SCRIPT TYPE="text/javascript" >window.onload = function () {setSynopsis("mini_Graphics-UI-Gtk-Builder.html")};</SCRIPT ></HEAD ><BODY ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="topbar" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD ><IMG SRC="haskell_icon.gif" WIDTH="16" HEIGHT="16" ALT=" " ></TD ><TD CLASS="title" >gtk-0.11.2: Binding to the Gtk+ graphical user interface library.</TD ><TD CLASS="topbut" ><A HREF="src/Graphics-UI-Gtk-Builder.html" >Source code</A ></TD ><TD CLASS="topbut" ><A HREF="index.html" >Contents</A ></TD ><TD CLASS="topbut" ><A HREF="doc-index.html" >Index</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="modulebar" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD ><FONT SIZE="6" >Graphics.UI.Gtk.Builder</FONT ></TD ><TD ALIGN="right" ><TABLE CLASS="narrow" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="infohead" >Portability</TD ><TD CLASS="infoval" >portable (depends on GHC)</TD ></TR ><TR ><TD CLASS="infohead" >Stability</TD ><TD CLASS="infoval" >provisional</TD ></TR ><TR ><TD CLASS="infohead" >Maintainer</TD ><TD CLASS="infoval" >gtk2hs-users@lists.sourceforge.net</TD ></TR ></TABLE ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="section4" ><B >Contents</B ></TD ></TR ><TR ><TD ><DL ><DT ><A HREF="#1" >Detail </A ></DT ><DT ><A HREF="#2" >Class Hierarchy </A ></DT ><DT ><A HREF="#3" >Types </A ></DT ><DT ><A HREF="#4" >Constructing and adding objects </A ></DT ><DT ><A HREF="#5" >Retrieving objects </A ></DT ></DL ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" >Description</TD ></TR ><TR ><TD CLASS="doc" ><P >Build an interface from an XML UI definition </P ><P >All functions in this module are only available in Gtk 2.12 or higher. </P ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" >Synopsis</TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="decl" ><SPAN CLASS="keyword" >data</SPAN > <A HREF="#t%3ABuilder" >Builder</A > </TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><SPAN CLASS="keyword" >class</SPAN > <A HREF="Graphics-UI-Gtk-Abstract-Object.html#t%3AObjectClass" >ObjectClass</A > o => <A HREF="#t%3ABuilderClass" >BuilderClass</A > o </TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AcastToBuilder" >castToBuilder</A > :: <A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObjectClass" >GObjectClass</A > obj => obj -> <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AgTypeBuilder" >gTypeBuilder</A > :: <A HREF="Graphics-UI-Gtk-Abstract-Widget.html#t%3AGType" >GType</A ></TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AtoBuilder" >toBuilder</A > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilderClass" >BuilderClass</A > o => o -> <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="decl" ><SPAN CLASS="keyword" >data</SPAN > <A HREF="#t%3ABuilderError" >BuilderError</A > </TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="decl" >= <A HREF="#v%3ABuilderErrorInvalidTypeFunction" >BuilderErrorInvalidTypeFunction</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3ABuilderErrorUnhandledTag" >BuilderErrorUnhandledTag</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3ABuilderErrorMissingAttribute" >BuilderErrorMissingAttribute</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3ABuilderErrorInvalidAttribute" >BuilderErrorInvalidAttribute</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3ABuilderErrorInvalidTag" >BuilderErrorInvalidTag</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3ABuilderErrorMissingPropertyValue" >BuilderErrorMissingPropertyValue</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3ABuilderErrorInvalidValue" >BuilderErrorInvalidValue</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3ABuilderErrorVersionMismatch" >BuilderErrorVersionMismatch</A ></TD ></TR ><TR ><TD CLASS="decl" >| <A HREF="#v%3ABuilderErrorDuplicateId" >BuilderErrorDuplicateId</A ></TD ></TR ></TABLE ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AbuilderNew" >builderNew</A > :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AbuilderAddFromFile" >builderAddFromFile</A > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AFilePath" >FilePath</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29" >()</A ></TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AbuilderAddFromString" >builderAddFromString</A > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29" >()</A ></TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AbuilderAddObjectsFromFile" >builderAddObjectsFromFile</A > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AFilePath" >FilePath</A > -> [<A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A >] -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29" >()</A ></TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AbuilderAddObjectsFromString" >builderAddObjectsFromString</A > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A > -> [<A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A >] -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29" >()</A ></TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AbuilderGetObject" >builderGetObject</A > :: <A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObjectClass" >GObjectClass</A > cls => <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> (<A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObject" >GObject</A > -> cls) -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > cls</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AbuilderGetObjects" >builderGetObjects</A > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > [<A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObject" >GObject</A >]</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AbuilderGetObjectRaw" >builderGetObjectRaw</A > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > (<A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Maybe.html#t%3AMaybe" >Maybe</A > <A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObject" >GObject</A >)</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AbuilderSetTranslationDomain" >builderSetTranslationDomain</A > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Maybe.html#t%3AMaybe" >Maybe</A > <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29" >()</A ></TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AbuilderGetTranslationDomain" >builderGetTranslationDomain</A > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > (<A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Maybe.html#t%3AMaybe" >Maybe</A > <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A >)</TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" ><A NAME="1" ><A NAME="1" >Detail </A ></A ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" ><A NAME="2" ><A NAME="2" >Class Hierarchy </A ></A ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="doc" ><PRE > | <TT ><A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObject" >GObject</A ></TT > | +----GtkBuilder </PRE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" ><A NAME="3" ><A NAME="3" >Types </A ></A ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><SPAN CLASS="keyword" >data</SPAN > <A NAME="t:Builder" ><A NAME="t%3ABuilder" ></A ></A ><B >Builder</B > </TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Types.html#Builder" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="section4" ><IMG SRC="minus.gif" CLASS="coll" ONCLICK="toggle(this,'i:Builder')" ALT="show/hide" > Instances</TD ></TR ><TR ><TD CLASS="body" ><DIV ID="i:Builder" STYLE="display:block;" ><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0" ><TR ><TD CLASS="decl" ><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Eq.html#t%3AEq" >Eq</A > <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Ord.html#t%3AOrd" >Ord</A > <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObjectClass" >GObjectClass</A > <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilderClass" >BuilderClass</A > <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="Graphics-UI-Gtk-Abstract-Object.html#t%3AObjectClass" >ObjectClass</A > <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><SPAN CLASS="keyword" >class</SPAN > <A HREF="Graphics-UI-Gtk-Abstract-Object.html#t%3AObjectClass" >ObjectClass</A > o => <A NAME="t:BuilderClass" ><A NAME="t%3ABuilderClass" ></A ></A ><B >BuilderClass</B > o </TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Types.html#BuilderClass" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="section4" ><IMG SRC="minus.gif" CLASS="coll" ONCLICK="toggle(this,'i:BuilderClass')" ALT="show/hide" > Instances</TD ></TR ><TR ><TD CLASS="body" ><DIV ID="i:BuilderClass" STYLE="display:block;" ><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0" ><TR ><TD CLASS="decl" ><A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilderClass" >BuilderClass</A > <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:castToBuilder" ><A NAME="v%3AcastToBuilder" ></A ></A ><B >castToBuilder</B > :: <A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObjectClass" >GObjectClass</A > obj => obj -> <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Types.html#castToBuilder" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:gTypeBuilder" ><A NAME="v%3AgTypeBuilder" ></A ></A ><B >gTypeBuilder</B > :: <A HREF="Graphics-UI-Gtk-Abstract-Widget.html#t%3AGType" >GType</A ></TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Types.html#gTypeBuilder" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:toBuilder" ><A NAME="v%3AtoBuilder" ></A ></A ><B >toBuilder</B > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilderClass" >BuilderClass</A > o => o -> <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Types.html#toBuilder" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><SPAN CLASS="keyword" >data</SPAN > <A NAME="t:BuilderError" ><A NAME="t%3ABuilderError" ></A ></A ><B >BuilderError</B > </TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Builder.html#BuilderError" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="section4" >Constructors</TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0" ><TR ><TD CLASS="arg" ><A NAME="v:BuilderErrorInvalidTypeFunction" ><A NAME="v%3ABuilderErrorInvalidTypeFunction" ></A ></A ><B >BuilderErrorInvalidTypeFunction</B ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:BuilderErrorUnhandledTag" ><A NAME="v%3ABuilderErrorUnhandledTag" ></A ></A ><B >BuilderErrorUnhandledTag</B ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:BuilderErrorMissingAttribute" ><A NAME="v%3ABuilderErrorMissingAttribute" ></A ></A ><B >BuilderErrorMissingAttribute</B ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:BuilderErrorInvalidAttribute" ><A NAME="v%3ABuilderErrorInvalidAttribute" ></A ></A ><B >BuilderErrorInvalidAttribute</B ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:BuilderErrorInvalidTag" ><A NAME="v%3ABuilderErrorInvalidTag" ></A ></A ><B >BuilderErrorInvalidTag</B ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:BuilderErrorMissingPropertyValue" ><A NAME="v%3ABuilderErrorMissingPropertyValue" ></A ></A ><B >BuilderErrorMissingPropertyValue</B ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:BuilderErrorInvalidValue" ><A NAME="v%3ABuilderErrorInvalidValue" ></A ></A ><B >BuilderErrorInvalidValue</B ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:BuilderErrorVersionMismatch" ><A NAME="v%3ABuilderErrorVersionMismatch" ></A ></A ><B >BuilderErrorVersionMismatch</B ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" ><A NAME="v:BuilderErrorDuplicateId" ><A NAME="v%3ABuilderErrorDuplicateId" ></A ></A ><B >BuilderErrorDuplicateId</B ></TD ><TD CLASS="rdoc" ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="section4" ><IMG SRC="minus.gif" CLASS="coll" ONCLICK="toggle(this,'i:BuilderError')" ALT="show/hide" > Instances</TD ></TR ><TR ><TD CLASS="body" ><DIV ID="i:BuilderError" STYLE="display:block;" ><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0" ><TR ><TD CLASS="decl" ><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Prelude.html#t%3AEnum" >Enum</A > <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilderError" >BuilderError</A ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Eq.html#t%3AEq" >Eq</A > <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilderError" >BuilderError</A ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Text-Show.html#t%3AShow" >Show</A > <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilderError" >BuilderError</A ></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" ><A NAME="4" ><A NAME="4" >Constructing and adding objects </A ></A ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:builderNew" ><A NAME="v%3AbuilderNew" ></A ></A ><B >builderNew</B > :: <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Builder.html#builderNew" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="doc" >Creates a new <TT ><A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TT > object. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:builderAddFromFile" ><A NAME="v%3AbuilderAddFromFile" ></A ></A ><B >builderAddFromFile</B > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AFilePath" >FilePath</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29" >()</A ></TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Builder.html#builderAddFromFile" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="doc" ><P >Parses a file containing a GtkBuilder UI definition and merges it with the current contents of the <TT ><A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TT >. </P ><UL ><LI > If an error occurs, the computation will throw an exception that can be caught using e.g. <TT ><A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GError.html#v%3AcatchGErrorJust" >catchGErrorJust</A ></TT > and one of the error codes in <TT ><A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilderError" >BuilderError</A ></TT >. </LI ></UL ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:builderAddFromString" ><A NAME="v%3AbuilderAddFromString" ></A ></A ><B >builderAddFromString</B > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29" >()</A ></TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Builder.html#builderAddFromString" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="doc" ><P >Parses a string containing a GtkBuilder UI definition and merges it with the current contents of the <TT ><A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TT >. </P ><UL ><LI > If an error occurs, the computation will throw an exception that can be caught using e.g. <TT ><A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GError.html#v%3AcatchGErrorJust" >catchGErrorJust</A ></TT > and one of the error codes in <TT ><A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilderError" >BuilderError</A ></TT >. </LI ></UL ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:builderAddObjectsFromFile" ><A NAME="v%3AbuilderAddObjectsFromFile" ></A ></A ><B >builderAddObjectsFromFile</B ></TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Builder.html#builderAddObjectsFromFile" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="arg" >:: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" >-> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AFilePath" >FilePath</A ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" >-> [<A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A >]</TD ><TD CLASS="rdoc" >Object IDs </TD ></TR ><TR ><TD CLASS="arg" >-> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29" >()</A ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="ndoc" COLSPAN="2" ><P >Parses a file containing a GtkBuilder UI definition building only the requested objects and merges them with the current contents of the <TT ><A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TT >. </P ><UL ><LI > If an error occurs, the computation will throw an exception that can be caught using e.g. <TT ><A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GError.html#v%3AcatchGErrorJust" >catchGErrorJust</A ></TT > and one of the error codes in <TT ><A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilderError" >BuilderError</A ></TT >. </LI ></UL ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:builderAddObjectsFromString" ><A NAME="v%3AbuilderAddObjectsFromString" ></A ></A ><B >builderAddObjectsFromString</B ></TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Builder.html#builderAddObjectsFromString" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="arg" >:: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" >-> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" >-> [<A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A >]</TD ><TD CLASS="rdoc" >Object IDs </TD ></TR ><TR ><TD CLASS="arg" >-> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29" >()</A ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="ndoc" COLSPAN="2" ><P >Parses a string containing a GtkBuilder UI definition building only the requested objects and merges them with the current contents of the <TT ><A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TT >. </P ><UL ><LI > If an error occurs, the computation will throw an exception that can be caught using e.g. <TT ><A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GError.html#v%3AcatchGErrorJust" >catchGErrorJust</A ></TT > and one of the error codes in <TT ><A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilderError" >BuilderError</A ></TT >. </LI ></UL ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" ><A NAME="5" ><A NAME="5" >Retrieving objects </A ></A ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:builderGetObject" ><A NAME="v%3AbuilderGetObject" ></A ></A ><B >builderGetObject</B ></TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Builder.html#builderGetObject" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="arg" >:: <A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObjectClass" >GObjectClass</A > cls</TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" >=> <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" >-> <A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObject" >GObject</A > -> cls</TD ><TD CLASS="rdoc" >A dynamic cast function which returns an object of the expected type, eg <TT ><A HREF="Graphics-UI-Gtk-Buttons-Button.html#v%3AcastToButton" >castToButton</A ></TT > </TD ></TR ><TR ><TD CLASS="arg" >-> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A ></TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="arg" >-> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > cls</TD ><TD CLASS="rdoc" ></TD ></TR ><TR ><TD CLASS="ndoc" COLSPAN="2" ><P >Gets the object with the given name, with a conversion function. Note that this computation does not increment the reference count of the returned object. </P ><P >If the object with the given ID is not of the requested type, an exception will be thrown. </P ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:builderGetObjects" ><A NAME="v%3AbuilderGetObjects" ></A ></A ><B >builderGetObjects</B > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > [<A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObject" >GObject</A >]</TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Builder.html#builderGetObjects" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="doc" >Gets all objects that have been constructed by builder. Note that this computation does not increment the reference counts of the returned objects. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:builderGetObjectRaw" ><A NAME="v%3AbuilderGetObjectRaw" ></A ></A ><B >builderGetObjectRaw</B > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > (<A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Maybe.html#t%3AMaybe" >Maybe</A > <A HREF="/usr/share/doc/ghc/html/libraries/glib-0.11.2/System-Glib-GObject.html#t%3AGObject" >GObject</A >)</TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Builder.html#builderGetObjectRaw" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="doc" >Gets the object with the given name. Note that this computation does not increment the reference count of the returned object. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:builderSetTranslationDomain" ><A NAME="v%3AbuilderSetTranslationDomain" ></A ></A ><B >builderSetTranslationDomain</B > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Maybe.html#t%3AMaybe" >Maybe</A > <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > <A HREF="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Unit.html#t%3A%28%29" >()</A ></TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Builder.html#builderSetTranslationDomain" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="doc" >Sets the translation domain of the <TT ><A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TT >. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:builderGetTranslationDomain" ><A NAME="v%3AbuilderGetTranslationDomain" ></A ></A ><B >builderGetTranslationDomain</B > :: <A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A > -> <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/System-IO.html#t%3AIO" >IO</A > (<A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Maybe.html#t%3AMaybe" >Maybe</A > <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Data-Char.html#t%3AString" >String</A >)</TD ><TD CLASS="declbut" ><A HREF="src/Graphics-UI-Gtk-Builder.html#builderGetTranslationDomain" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="doc" >Gets the translation domain of the <TT ><A HREF="Graphics-UI-Gtk-Builder.html#t%3ABuilder" >Builder</A ></TT >. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="botbar" >Produced by <A HREF="http://www.haskell.org/haddock/" >Haddock</A > version 2.6.1</TD ></TR ></TABLE ></BODY ></HTML >