File: libglade-embedding.html

package info (click to toggle)
libglade 0.11-2
links: PTS
area: main
in suites: potato
size: 1,748 kB
ctags: 660
sloc: ansic: 8,107; sh: 7,135; makefile: 420; python: 152; sed: 93
file content (293 lines) | stat: -rw-r--r-- 4,960 bytes
<HTML
><HEAD
><TITLE
>Embedding Libglade Interfaces</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.49"><LINK
REL="HOME"
TITLE="Libglade Reference Manual"
HREF="libglade.html"><LINK
REL="UP"
TITLE="Libglade Programming Notes"
HREF="libglade-notes.html"><LINK
REL="PREVIOUS"
TITLE="Extending Libglade"
HREF="libglade-extending.html"><LINK
REL="NEXT"
TITLE="Libglade Library Reference"
HREF="libglade-lib.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Libglade Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="libglade-extending.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libglade.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libglade-notes.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="libglade-lib.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="LIBGLADE-EMBEDDING"
>Embedding Libglade Interfaces</A
></H1
><P
>Sometimes you will only want to use libglade for a small
      part of your program.  If it is just for some dialogs, this is
      easy -- you just generate the dialogs from the interface files
      when needed (note that libglade caches the XML parse tree
      between calls to <TT
CLASS="FUNCTION"
>glade_xml_new</TT
>, so you will
      not suffer the performance hit of parsing a particular XML file
      more than once).  On the other hand, you may want to use
      libglade to generate just the menubar or just a notebook for a
      dialog or something.  Libglade allows this as well.</P
><P
>Libglade allows you to build only part of the interface if
      you want to.  The second argument to
      <TT
CLASS="FUNCTION"
>glade_xml_new</TT
> specifies the name of the
      base widget to build the interface from.  This way we can limit
      the widgets that are constructed by libglade.</P
><P
>For the menubar example, we would create a dummy window in
      Glade, and insert a menubar widget into the window.  We would
      then name the menubar in glade ("menubar" isn't a bad name :),
      and customise it as much as we want.  Now in the program, we can
      use the following code:</P
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>GladeXML *xml;
GtkWidget *menubar;

xml = glade_xml_new("some-interface-file", "menubar");
glade_xml_signal_autoconnect(xml);
menubar = glade_xml_get_widget(xml, "menubar");
/* do whatever we want to with the menubar */</PRE
></TD
></TR
></TABLE
><P
>From here, we can do what ever we want with the menubar
      widget.  The dummy window we created in Glade is never created,
      so does not affect the program.  You can also use similar code
      to only build a single dialog from a file that contains many
      dialogs.</P
><P
>One thing to note -- if you don't want a widget to be
      displayed as soon as it is built with
      <TT
CLASS="FUNCTION"
>glade_xml_new</TT
>, you should turn off the
      visible flag on that widget in Glade.  This is the correct
      solution to the problem (putting a hack into libglade so that it
      never shows the toplevel windows is not The Right Thing).</P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="libglade-extending.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libglade.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libglade-notes.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="libglade-lib.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Extending Libglade</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Libglade Library Reference</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>