File: libglade-notes.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 (353 lines) | stat: -rw-r--r-- 6,271 bytes
<HTML
><HEAD
><TITLE
>Libglade Programming Notes</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.49"><LINK
REL="HOME"
TITLE="Libglade Reference Manual"
HREF="libglade.html"><LINK
REL="PREVIOUS"
TITLE="Libglade Reference Manual"
HREF="libglade.html"><LINK
REL="NEXT"
TITLE="Adding GNOME Support"
HREF="libglade-gnome.html"></HEAD
><BODY
CLASS="CHAPTER"
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.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
>&nbsp;</B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="libglade-gnome.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="CHAPTER"
><H1
><A
NAME="LIBGLADE-NOTES"
>Libglade Programming Notes</A
></H1
><P
>Libglade is an alternative to using Glade's code generation.
    Instead of generating code from the XML interface description,
    libglade loads and parses the description at runtime.  It also
    provides functions that can be used to connect signal handlers to
    parts of the interface.</P
><P
>In this way, it allows you to separate your program code
    from the interface code.  In fact, if you use the
    glade_xml_signal_autoconnect() function, the GUI code could be as
    simple as the <TT
CLASS="FILENAME"
>test-libglade.c</TT
> example that
    comes with libglade.  Of course, you would also add your own
    signal handlers to the code.  Note that the signals are connected
    the same way as if you had hand coded the interface.  There is no
    extra overhead to interfaces generated by libglade (after the
    initial generating of course, and this is not much of an overhead)
    when compared to a hand crafted interface.</P
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="LIBGLADE-BASICS"
>Libglade Programming Basics</A
></H1
><P
>Your basic libglade program will look something like this:</P
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#include &lt;gtk/gtk.h&gt;
#include &lt;glade/glade.h&gt;

void some_signal_handler_func(GtkWidget *widget, gpointer user_data) {
  /* do something useful here */
}

int main(int argc, char *argv[]) {
    GladeXML *xml;

    gtk_init(&amp;argc, &amp;argv);
    glade_init();

    /* load the interface */
    xml = glade_xml_new("filename-for-interface", NULL);
    /* connect the signals in the interface */
    glade_xml_signal_autoconnect(xml);
    /* start the event loop */
    gtk_main();
    return 0;
}</PRE
></TD
></TR
></TABLE
><P
>This will create the interface from the file
      <TT
CLASS="FILENAME"
>filename-for-interface</TT
>, then connect all
      the signals in the interface.  The automatic signal connection
      is done by looking up function names in the symbol table using
      gmodule.  This means that the interface file can use standard
      GTK functions such as <TT
CLASS="FUNCTION"
>gtk_widget_show</TT
>, or
      <TT
CLASS="FUNCTION"
>gtk_main_quit</TT
>, or others in the interface
      and not have to write any code to connect the signals.</P
><P
>The <TT
CLASS="FUNCTION"
>some_signal_handler_func</TT
> function
      is not referenced anywhere in the program explicitely, but if
      any signals are defined in the interface description that use
      "some_signal_handler_func" as the handler name, then this
      function will automatically be connected.  Note that the
      function can not be static, since we require it to apear in the
      symbol table.  Here is an example of the XML that would cause
      <TT
CLASS="FUNCTION"
>some_signal_handler_func</TT
> to be
      connected:</P
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>&lt;widget&gt;
  &lt;class&gt;GtkWindow&lt;/class&gt;
  &lt;name&gt;MainWindow&lt;/name&gt;
  &lt;signal&gt;
    &lt;name&gt;destroy&lt;/name&gt;
    &lt;handler&gt;some_signal_handler_func&lt;/handler&gt;
  &lt;/signal&gt;
  ...</PRE
></TD
></TR
></TABLE
><P
>To compile the program, we would use the following:</P
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>cc -o testprogram testprogram.c `libglade-config --cflags --libs`</PRE
></TD
></TR
></TABLE
><P
>The <TT
CLASS="FILENAME"
>libglade-config</TT
> script will give
      the correct parameters used to compile the program.  If you are
      using automake or autoconf, you may want to investigate the
      AM_PATH_LIBGLADE macro that is installed as
      <TT
CLASS="FILENAME"
>$(datadir)/aclocal/libglade.m4</TT
>.</P
></DIV
></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.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
>&nbsp;</B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="libglade-gnome.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
>Libglade Reference Manual</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Adding GNOME Support</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>