<HTML
><HEAD
><TITLE
>Gnome User Interface Library Reference Manual</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="NEXT"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"></HEAD
><BODY
CLASS="BOOK"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="BOOK"
><DIV
CLASS="TITLEPAGE"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
ALIGN="center"
VALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="7"
><P
CLASS="TITLE"
><A
NAME="AEN2"
>Gnome User Interface Library Reference Manual</A
></P
></FONT
></TH
></TR
></TABLE
></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="libgnomeui.html"
>Gnome User Interface Library</A
></DT
><DD
><DL
><DT
><A
HREF="gnomeui-gnome-app-helper.html"
>gnome-app-helper</A
> &#8212; Simplified menu and toolbar creation.</DT
><DT
><A
HREF="gnomeui-gnome-app-util.html"
>gnome-app-util</A
> &#8212; Utility functions for manipulating GnomeApp container widgets.</DT
><DT
><A
HREF="gnomeui-gnome-canvas-util.html"
>gnome-canvas-util</A
> &#8212; Auxiliary canvas functions.</DT
><DT
><A
HREF="gnomeui-gnome-dialog-util.html"
>gnome-dialog-util</A
> &#8212; Convenience functions for making dialogs.</DT
><DT
><A
HREF="gnomeui-gnome-dns.html"
>gnome-dns</A
> &#8212; Non-blocking name resolver interface.</DT
><DT
><A
HREF="gnomeui-gnome-geometry.html"
>gnome-geometry</A
> &#8212; Window geometry utility functions.</DT
><DT
><A
HREF="gnomeui-gnome-ice.html"
>gnome-ice</A
> &#8212; Integrates the ICE library with the GTK+ event loop</DT
><DT
><A
HREF="gnomeui-gnome-icon-text.html"
>gnome-icon-text</A
> &#8212; Text wrapping functions for icon captions.</DT
><DT
><A
HREF="gnomeui-gnome-init.html"
>gnome-init</A
> &#8212; Initialize GNOME libraries.</DT
><DT
><A
HREF="gnomeui-gnome-mdi-session.html"
>gnome-mdi-session</A
> &#8212; Routines providing <SPAN
CLASS="TYPE"
>GnomeMDI</SPAN
> state saving and restoration</DT
><DT
><A
HREF="gnomeui-gnome-popup-help.html"
>gnome-popup-help</A
> &#8212;   A popup-help system for GtkWidgets.</DT
><DT
><A
HREF="gnomeui-gnome-popup-menu.html"
>gnome-popup-menu</A
> &#8212; Routines for attaching popup menus to widgets.</DT
><DT
><A
HREF="gnomeui-gnome-preferences.html"
>gnome-preferences</A
> &#8212; Fetching and setting GNOME preferences</DT
><DT
><A
HREF="gnomeui-gnome-properties.html"
>gnome-properties</A
> &#8212; deprecated/experimental/unfinished</DT
><DT
><A
HREF="gnomeui-gnome-property-entries.html"
>gnome-property-entries</A
> &#8212; deprecated/experimental/unfinished</DT
><DT
><A
HREF="gnomeui-gnome-startup.html"
>gnome-startup</A
> &#8212; Internal routines for session management.</DT
><DT
><A
HREF="gnomeui-gnome-types.html"
>gnome-types</A
> &#8212; Some global types used by the GNOME libraries.</DT
><DT
><A
HREF="gnomeui-gnome-uidefs.html"
>gnome-uidefs</A
> &#8212; Useful GNOME macros</DT
><DT
><A
HREF="gnomeui-gnome-window-icon.html"
>gnome-window-icon</A
> &#8212; Convenience functions for window mini-icons</DT
><DT
><A
HREF="gnomeui-gnome-winhints.html"
>gnome-winhints</A
> &#8212; Manipulate GNOME-specific window manager hints.</DT
><DT
><A
HREF="gnomeui-gtkcauldron.html"
>gtkcauldron</A
> &#8212; Produce gtk/gnome dialog boxes from format strings.</DT
></DL
></DD
><DT
><A
HREF="gnome-objects.html"
>GNOME Widgets and Objects</A
></DT
><DD
><DL
><DT
><A
HREF="gnomeabout.html"
>GnomeAbout</A
> &#8212; Simple way to provide an About box for your application.</DT
><DT
><A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> &#8212; A widget for adding simple animations to GNOME applications.</DT
><DT
><A
HREF="gnomeapp.html"
>GnomeApp</A
> &#8212; The toplevel GNOME container</DT
><DT
><A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> &#8212; Statusbar/Progress/Minibuffer widget</DT
><DT
><A
HREF="gnomecalculator.html"
>GnomeCalculator</A
> &#8212; Calculator widget.</DT
><DT
><A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> &#8212;   A generic engine for structured graphics.</DT
><DT
><A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvasline.html"
>GnomeCanvasLine</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvaspolygon.html"
>GnomeCanvasPolygon</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvasre.html"
>GnomeCanvasRE</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvasrect.html"
>GnomeCanvasRect</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvasellipse.html"
>GnomeCanvasEllipse</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvastext.html"
>GnomeCanvasText</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvasimage.html"
>GnomeCanvasImage</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvaswidget.html"
>GnomeCanvasWidget</A
> &#8212; </DT
><DT
><A
HREF="gnomeclient.html"
>GnomeClient</A
> &#8212; Routines to provide session management support in your application</DT
><DT
><A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> &#8212; Widget for selecting colors.</DT
><DT
><A
HREF="gnomedateedit.html"
>GnomeDateEdit</A
> &#8212; Date and time entry widget.</DT
><DT
><A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> &#8212; Editing object for dentries (.desktop files)</DT
><DT
><A
HREF="gnomedialog.html"
>GnomeDialog</A
> &#8212; Transient ("popup") dialogs.</DT
><DT
><A
HREF="gnomedockband.html"
>GnomeDockBand</A
> &#8212; A widget implementing dock bands.</DT
><DT
><A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> &#8212; A dockable widget.</DT
><DT
><A
HREF="gnomedock.html"
>GnomeDock</A
> &#8212; A widget supporting movable and detachable widgets.</DT
><DT
><A
HREF="gnomedruid.html"
>GnomeDruid</A
> &#8212;   The main widget of the GNOME druid system.</DT
><DT
><A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> &#8212; A virtual widget defining the druid page.</DT
><DT
><A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> &#8212; A GnomeDruidPage for the beginning of a DRUID.</DT
><DT
><A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
> &#8212; </DT
><DT
><A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> &#8212; </DT
><DT
><A
HREF="gnomeentry.html"
>GnomeEntry</A
> &#8212; Entry widget with history tracking.</DT
><DT
><A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> &#8212; An entry widget for file names.</DT
><DT
><A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> &#8212; Button that displays current font; click to select new font.</DT
><DT
><A
HREF="gnomefontselector.html"
>GnomeFontSelector</A
> &#8212; Deprecated, use GtkFontSelection in a GnomeDialog or GnomeFontPicker</DT
><DT
><A
HREF="gnomehref.html"
>GnomeHRef</A
> &#8212; A clickable URL button.</DT
><DT
><A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
> &#8212; A widget to select an icon.</DT
><DT
><A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> &#8212; Canvas item for editable text captions in icon lists.</DT
><DT
><A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> &#8212; A list of icons with captions, with optional caption editing.</DT
><DT
><A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> &#8212; An icon listing/chooser display.</DT
><DT
><A
HREF="gnomeless.html"
>GnomeLess</A
> &#8212; Simple file content browser widget.</DT
><DT
><A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> &#8212; An abstract MDI child class</DT
><DT
><A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> &#8212; A generic <SPAN
CLASS="TYPE"
>GnomeMDI</SPAN
> child</DT
><DT
><A
HREF="gnomemdi.html"
>GnomeMDI</A
> &#8212; GNOME Multiple Document Interface</DT
><DT
><A
HREF="gnomemessagebox.html"
>GnomeMessageBox</A
> &#8212; Message box display routines</DT
><DT
><A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
> &#8212; An entry line for number input.</DT
><DT
><A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> &#8212; </DT
><DT
><A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> &#8212; Entry widget for selection of large images.</DT
><DT
><A
HREF="gnomepixmap.html"
>GnomePixmap</A
> &#8212; A widget to display and load images (pixmaps)</DT
><DT
><A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> &#8212; Standarized dialog box for handling configuration</DT
><DT
><A
HREF="gnomescores.html"
>GnomeScores</A
> &#8212; Dialog box which displays high scores</DT
><DT
><A
HREF="gnomestock.html"
>GnomeStock</A
> &#8212; 50% finished, API-docs not done; Default icons for toolbars, menus and buttons.</DT
><DT
><A
HREF="gtkclock.html"
>GtkClock</A
> &#8212; A small text clock widget, capable of realtime, count-up and count-down modes</DT
><DT
><A
HREF="gtkted.html"
>GtkTed</A
> &#8212; Deprecated.</DT
><DT
><A
HREF="gtkdial.html"
>GtkDial</A
> &#8212; Analog dial widget for number selection.</DT
><DT
><A
HREF="gtkpixmapmenuitem.html"
>GtkPixmapMenuItem</A
> &#8212; A special widget for GNOME menus.</DT
><DT
><A
HREF="gnomespell.html"
>GnomeSpell</A
> &#8212; Deprecated.</DT
><DT
><A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> &#8212; A widget for saving and retrieving the layout of a
<SPAN
CLASS="TYPE"
>GnomeDock</SPAN
> widget.</DT
><DT
><A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> &#8212; Gnome Process Bar</DT
></DL
></DD
></DL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
>&nbsp;</TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&nbsp;</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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
>&nbsp;</TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Gnome User Interface Library</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeAbout</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="NEXT"
TITLE="GnomeAnimator"
HREF="gnomeanimator.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnome-objects.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeanimator.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEABOUT"
>GnomeAbout</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7972"
></A
><H2
>Name</H2
>GnomeAbout&nbsp;--&nbsp;Simple way to provide an About box for your application.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN7975"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeabout.html#GNOMEABOUT-STRUCT"
>GnomeAbout</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeabout.html#GNOME-ABOUT-NEW"
>gnome_about_new</A
>                 (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *version,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *copyright,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **authors,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *comments,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *logo);
void        <A
HREF="gnomeabout.html#GNOME-ABOUT-CONSTRUCT"
>gnome_about_construct</A
>           (<A
HREF="gnomeabout.html"
>GnomeAbout</A
> *about,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *version,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *copyright,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **authors,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *comments,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *logo);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7995"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----<A
HREF=../gtk/gtkwindow.html
>GtkWindow</A>
                           +----<A
HREF="gnomedialog.html"
>GnomeDialog</A
>
                                 +----GnomeAbout</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN8004"
></A
><H2
>Description</H2
><P
>A standard way of providing a small about box for your application.
You provide the name of your application, version, copyright, a list
of authors and some comments about your application.  It also allows
the programmer to provide a logo to be displayed.</P
><P
>The following is a simple example of its use, note that the descriptive
text is surrounded by the <A
HREF=../gnome/gnome-gnome-i18n.html#GETTEXT-MACRO
>_</A>(). This
will have the text translated to the the user's language at runtime.</P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN8009"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>const gchar *authors[] = {
   "Wanda the sexy fish",
   NULL
  };
gtk_widget_show (gnome_about_new ("Gnome Wizit", VERSION,
                 "Copyright 1999 Gnome Programming Inc.",
                  (const gchar **) authors,
                 _("The gnome wizit is the most fabulous thing ever "
                   "written for the GNOME desktop environment. You must "
                   "use this everyday."),
                   NULL));
 </PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN8011"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN8013"
></A
><H3
><A
NAME="GNOMEABOUT-STRUCT"
></A
>struct GnomeAbout</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeAbout;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8018"
></A
><H3
><A
NAME="GNOME-ABOUT-NEW"
></A
>gnome_about_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_about_new                 (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *version,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *copyright,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **authors,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *comments,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *logo);</PRE
></TD
></TR
></TABLE
><P
>Creates a new GNOME About dialog.  <TT
CLASS="PARAMETER"
><I
>title</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>version</I
></TT
>,
<TT
CLASS="PARAMETER"
><I
>copyright</I
></TT
>, and <TT
CLASS="PARAMETER"
><I
>authors</I
></TT
> are displayed first, in that order.
<TT
CLASS="PARAMETER"
><I
>comments</I
></TT
> is typically the location for multiple lines of text, if
necessary.  (Separate with "\n".)  <TT
CLASS="PARAMETER"
><I
>logo</I
></TT
> is the filename of a
optional pixmap to be displayed in the dialog, typically a product or
company logo of some sort; set to <TT
CLASS="LITERAL"
>NULL</TT
> if no logo file is available.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8038"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of app.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>version</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> version number</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>copyright</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> copyright string</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>authors</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>NULL</TT
> terminated list of authors</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>comments</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Other comments</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>logo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a logo pixmap file.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&amp;GtkWidget pointer to new dialog</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8072"
></A
><H3
><A
NAME="GNOME-ABOUT-CONSTRUCT"
></A
>gnome_about_construct ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_about_construct           (<A
HREF="gnomeabout.html"
>GnomeAbout</A
> *about,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *version,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *copyright,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **authors,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *comments,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *logo);</PRE
></TD
></TR
></TABLE
><P
>Constructs a new GNOME About dialog, given an object
<TT
CLASS="PARAMETER"
><I
>about</I
></TT
> newly created via the Gtk type system.  <TT
CLASS="PARAMETER"
><I
>title</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>version</I
></TT
>,
<TT
CLASS="PARAMETER"
><I
>copyright</I
></TT
>, and <TT
CLASS="PARAMETER"
><I
>authors</I
></TT
> are displayed first, in that order.
<TT
CLASS="PARAMETER"
><I
>comments</I
></TT
> is typically the location for multiple lines of text, if
necessary.  (Separate with "\n".)  <TT
CLASS="PARAMETER"
><I
>logo</I
></TT
> is the filename of a
optional pixmap to be displayed in the dialog, typically a product or
company logo of some sort; set to <TT
CLASS="LITERAL"
>NULL</TT
> if no logo file is available.</P
><P
>Note:
Only for use by bindings to languages other than C; don't use
in applications.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8094"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>about</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to new GNOME about object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of app.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>version</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> version number</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>copyright</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> copyright string</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>authors</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>NULL</TT
> terminated list of authors</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>comments</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Other comments</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>logo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a logo pixmap file.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnome-objects.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeanimator.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
>GNOME Widgets and Objects</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeAnimator</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeAnimator</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeAbout"
HREF="gnomeabout.html"><LINK
REL="NEXT"
TITLE="GnomeApp"
HREF="gnomeapp.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeabout.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeapp.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEANIMATOR"
>GnomeAnimator</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN8133"
></A
><H2
>Name</H2
>GnomeAnimator&nbsp;--&nbsp;A widget for adding simple animations to GNOME applications.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN8136"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeanimator.html#GNOMEANIMATOR-STRUCT"
>GnomeAnimator</A
>;
enum        <A
HREF="gnomeanimator.html#GNOMEANIMATORSTATUS"
>GnomeAnimatorStatus</A
>;
enum        <A
HREF="gnomeanimator.html#GNOMEANIMATORLOOPTYPE"
>GnomeAnimatorLoopType</A
>;
struct      <A
HREF="gnomeanimator.html#GNOMEANIMATORFRAME"
>GnomeAnimatorFrame</A
>;
struct      <A
HREF="gnomeanimator.html#GNOMEANIMATORPRIVATE"
>GnomeAnimatorPrivate</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-NEW-WITH-SIZE"
>gnome_animator_new_with_size</A
>    (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> width,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> height);
void        <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-SET-LOOP-TYPE"
>gnome_animator_set_loop_type</A
>    (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF="gnomeanimator.html#GNOMEANIMATORLOOPTYPE"
>GnomeAnimatorLoopType</A
> loop_type);
<A
HREF="gnomeanimator.html#GNOMEANIMATORLOOPTYPE"
>GnomeAnimatorLoopType</A
> <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-GET-LOOP-TYPE"
>gnome_animator_get_loop_type</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);
void        <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-SET-PLAYBACK-DIRECTION"
>gnome_animator_set_playback_direction</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> playback_direction);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-GET-PLAYBACK-DIRECTION"
>gnome_animator_get_playback_direction</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAME-FROM-IMLIB-AT-SIZE"
>gnome_animator_append_frame_from_imlib_at_size</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             GdkImlibImage *image,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> width,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> height);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAME-FROM-IMLIB"
>gnome_animator_append_frame_from_imlib</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             GdkImlibImage *image,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAME-FROM-FILE-AT-SIZE"
>gnome_animator_append_frame_from_file_at_size</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> width,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> height);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAME-FROM-FILE"
>gnome_animator_append_frame_from_file</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAMES-FROM-IMLIB-AT-SIZE"
>gnome_animator_append_frames_from_imlib_at_size</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             GdkImlibImage *image,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_unit,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> width,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> height);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAMES-FROM-IMLIB"
>gnome_animator_append_frames_from_imlib</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             GdkImlibImage *image,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_unit);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAMES-FROM-FILE-AT-SIZE"
>gnome_animator_append_frames_from_file_at_size</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_unit,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> width,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> height);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAMES-FROM-FILE"
>gnome_animator_append_frames_from_file</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_unit);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAME-FROM-GNOME-PIXMAP"
>gnome_animator_append_frame_from_gnome_pixmap</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *pixmap,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval);
void        <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-START"
>gnome_animator_start</A
>            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);
void        <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-STOP"
>gnome_animator_stop</A
>             (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-ADVANCE"
>gnome_animator_advance</A
>          (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> num);
void        <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-GOTO-FRAME"
>gnome_animator_goto_frame</A
>       (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> frame_number);
<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>       <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-GET-CURRENT-FRAME-NUMBER"
>gnome_animator_get_current_frame_number</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);
<A
HREF="gnomeanimator.html#GNOMEANIMATORSTATUS"
>GnomeAnimatorStatus</A
> <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-GET-STATUS"
>gnome_animator_get_status</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);
void        <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-SET-PLAYBACK-SPEED"
>gnome_animator_set_playback_speed</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> speed);
<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>     <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-GET-PLAYBACK-SPEED"
>gnome_animator_get_playback_speed</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN8258"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----GnomeAnimator</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN8263"
></A
><H2
>Description</H2
><P
><SPAN
CLASS="TYPE"
>GnomeAnimator</SPAN
> is a widget that is able to play simple
animations in the GTK+ event loop.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN8267"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN8269"
></A
><H3
><A
NAME="GNOMEANIMATOR-STRUCT"
></A
>struct GnomeAnimator</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeAnimator;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8274"
></A
><H3
><A
NAME="GNOMEANIMATORSTATUS"
></A
>enum GnomeAnimatorStatus</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
    GNOME_ANIMATOR_STATUS_STOPPED,
    GNOME_ANIMATOR_STATUS_RUNNING
} GnomeAnimatorStatus;</PRE
></TD
></TR
></TABLE
><P
>This enumeration is used to determine if the animator object is running or
not. Use <TT
CLASS="FUNCTION"
><A
HREF="gnomeanimator.html#GNOME-ANIMATOR-GET-STATUS"
>gnome_animator_get_status</A
>()</TT
> to
retrieve it.</P
><P
></P
><UL
><LI
><P
>      <TT
CLASS="LITERAL"
>GNOME_ANIMATOR_STATUS_STOPPED</TT
>: The value used 
      when the GnomeAnimator object is not running.
    </P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_ANIMATOR_STATUS_RUNNING</TT
>: The value used
		when the GnomeAnimator object is running.
	</P
></LI
></UL
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8288"
></A
><H3
><A
NAME="GNOMEANIMATORLOOPTYPE"
></A
>enum GnomeAnimatorLoopType</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
    /* No loop: after the last (first) frame is played, the animation
       is stopped.  */
    GNOME_ANIMATOR_LOOP_NONE,

    /* After the last (first) frame is played, restart from the first
       (last) frame.  */
    GNOME_ANIMATOR_LOOP_RESTART,

    /* After the last (first) frame is played, the playback direction
       is reversed.  */
    GNOME_ANIMATOR_LOOP_PING_PONG
} GnomeAnimatorLoopType;</PRE
></TD
></TR
></TABLE
><P
>This enumeration is used to set the type of animation loop desired in the
GnomeAnimator object.</P
><P
></P
><UL
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_NONE</TT
>: Do not use a loop in
		the animation. When the animation is played, it will not
		repeat when it is completed.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_RESTART</TT
>: After the animation
		is played, loop back to the beginning of the animation and
		replay it. If the animation is playing forward, the loop
		will return to the first frame; if it is being played
		backward, the loop will return to the last frame in the
		sequence.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_PING_PONG</TT
>: When the animation
		sequence is completed, the playback direction is reversed.
		</P
></LI
></UL
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8303"
></A
><H3
><A
NAME="GNOMEANIMATORFRAME"
></A
>struct GnomeAnimatorFrame</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeAnimatorFrame;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8308"
></A
><H3
><A
NAME="GNOMEANIMATORPRIVATE"
></A
>struct GnomeAnimatorPrivate</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeAnimatorPrivate;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8313"
></A
><H3
><A
NAME="GNOME-ANIMATOR-NEW-WITH-SIZE"
></A
>gnome_animator_new_with_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_animator_new_with_size    (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> width,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> height);</PRE
></TD
></TR
></TABLE
><P
>Creates a new animator widget of the specified size.</P
><P
>Create a GnomeAnimator object of the specified size.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8322"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel height of animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to new animator widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8339"
></A
><H3
><A
NAME="GNOME-ANIMATOR-SET-LOOP-TYPE"
></A
>gnome_animator_set_loop_type ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_animator_set_loop_type    (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF="gnomeanimator.html#GNOMEANIMATORLOOPTYPE"
>GnomeAnimatorLoopType</A
> loop_type);</PRE
></TD
></TR
></TABLE
><P
>Sets desired animation loop type.  Available loop
types are <TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_NONE</TT
> (play animation once only),
<TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_RESTART</TT
> (play animation over and over again),
and <TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_PING_PONG</TT
> (play animation over and over
again, reversing the playing direction every time.)</P
><P
>Sets the type of loop the animator will use.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8350"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>loop_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Type of animation loop desired</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8363"
></A
><H3
><A
NAME="GNOME-ANIMATOR-GET-LOOP-TYPE"
></A
>gnome_animator_get_loop_type ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeanimator.html#GNOMEANIMATORLOOPTYPE"
>GnomeAnimatorLoopType</A
> gnome_animator_get_loop_type
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);</PRE
></TD
></TR
></TABLE
><P
>Obtains current animator loop type.  Available loop
types are <TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_NONE</TT
> (play animation once only),
<TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_RESTART</TT
> (play animation over and over again),
and <TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_PING_PONG</TT
> (play animation over and over
again, reversing the playing direction every time.)</P
><P
>Determine the type of loop being used on the animator object.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8374"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be queried</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Loop type.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8387"
></A
><H3
><A
NAME="GNOME-ANIMATOR-SET-PLAYBACK-DIRECTION"
></A
>gnome_animator_set_playback_direction ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_animator_set_playback_direction
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> playback_direction);</PRE
></TD
></TR
></TABLE
><P
>Sets direction (forwards or backwards) to play the
animation.  If <TT
CLASS="PARAMETER"
><I
>playback_direction</I
></TT
> is a positive number, the
animation is played from the first to the last frame.  If
<TT
CLASS="PARAMETER"
><I
>playback_direction</I
></TT
> is negative, the animation is played from the
last to the first frame.</P
><P
>Set the direction the animation should be played back. Setting a positive
value will cause the animator to play forward; a negative value will cause
it to play backward.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8397"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>playback_direction</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Direction animation should be played.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8410"
></A
><H3
><A
NAME="GNOME-ANIMATOR-GET-PLAYBACK-DIRECTION"
></A
>gnome_animator_get_playback_direction ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_animator_get_playback_direction
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);</PRE
></TD
></TR
></TABLE
><P
>Returns the current playing direction (forwards or
backwards) for the animation.  If the returned value is a positive
number, the animation is played from the first to the last frame.
If it is negative, the animation is played from the last to the
first frame.</P
><P
>Determines the direction of playback.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8418"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Positive or negative number indicating direction.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8431"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAME-FROM-IMLIB-AT-SIZE"
></A
>gnome_animator_append_frame_from_imlib_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_animator_append_frame_from_imlib_at_size
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             GdkImlibImage *image,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> width,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> height);</PRE
></TD
></TR
></TABLE
><P
>Adds frame contained within a &amp;GdkImlibImage image at
the end of the current animation.  If <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> are
different from the actual <TT
CLASS="PARAMETER"
><I
>image</I
></TT
> size, the image is scaled
proportionally.  The frame display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> is divided
by the playback speed.</P
><P
>Append a frame from a GdkImlibImage to the GnomeAnimator object and render
it.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8449"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>image</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Image to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel height of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8487"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAME-FROM-IMLIB"
></A
>gnome_animator_append_frame_from_imlib ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_animator_append_frame_from_imlib
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             GdkImlibImage *image,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval);</PRE
></TD
></TR
></TABLE
><P
>Adds frame contained within a &amp;GdkImlibImage image at
the end of the current animation.  The frame display interval is
<TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> is divided by the playback speed.</P
><P
>Adds frame contained within a GdkImlibImage image at the end of the
current animation.  The frame display interval is divided by the playback
speed.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8500"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>image</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Image to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8530"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAME-FROM-FILE-AT-SIZE"
></A
>gnome_animator_append_frame_from_file_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_animator_append_frame_from_file_at_size
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> width,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> height);</PRE
></TD
></TR
></TABLE
><P
>Adds frame from the given file to the end of the
current animation.  If <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> are different from the
actual <TT
CLASS="PARAMETER"
><I
>image</I
></TT
> size, the image is scaled proportionally.  The frame
display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><P
>Appends a frame from a file to a GnomeAnimator widget. If the specified
width and height variables are different from the actual size of the
image, it is scaled proportionally. The frame display interval is
<TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8549"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> File path of image to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel height of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8587"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAME-FROM-FILE"
></A
>gnome_animator_append_frame_from_file ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_animator_append_frame_from_file
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval);</PRE
></TD
></TR
></TABLE
><P
>Adds frame from the given file to the end of the
current animation.  The frame display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided
by the playback speed.</P
><P
>Append a frame from a given file to a GnomeAnimator widget. The frame
display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8601"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> File path of image to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8631"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAMES-FROM-IMLIB-AT-SIZE"
></A
>gnome_animator_append_frames_from_imlib_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_animator_append_frames_from_imlib_at_size
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             GdkImlibImage *image,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_unit,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> width,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> height);</PRE
></TD
></TR
></TABLE
><P
>Adds multiple frames contained within a &amp;GdkImlibImage
image at the end of the current animation.  Each frame within the
image should be next to one another in a single, horizontal row.
If <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> are different from the actual frame size, the
image is scaled proportionally.  The frame display interval is
<TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><P
>Appends multiple frames contained within a GdkImlibImage image to a
GnomeAnimator widget. Each frame within the image should be next to one
another in a single, horizontal row.  If <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and/or <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> are
different from the actual size of the frame, the image will be scaled
proportionally.  The frame display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the
playback speed.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8652"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>image</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Image containing frames to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_unit</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of a single frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel height of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8694"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAMES-FROM-IMLIB"
></A
>gnome_animator_append_frames_from_imlib ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_animator_append_frames_from_imlib
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             GdkImlibImage *image,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_unit);</PRE
></TD
></TR
></TABLE
><P
>Adds multiple frames contained within a &amp;GdkImlibImage
image to the end of the current animation.  Each frame within the
image should be next to one another in a single, horizontal row.
The frame display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the
playbackspeed.</P
><P
>Append multiple frames contained within a GdkImlibImage image to the end
of a GnomeAnimator widget. Each frame within the image should be next to
one another in a single, horizontal row.  The frame display interval is
<TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8709"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>image</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Image containing frames to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_unit</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of a single frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8743"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAMES-FROM-FILE-AT-SIZE"
></A
>gnome_animator_append_frames_from_file_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_animator_append_frames_from_file_at_size
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_unit,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> width,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> height);</PRE
></TD
></TR
></TABLE
><P
>Adds multiple frames contained within a single image
file to the end of the current animation.  Each frame within the
image should be next to one another in a single, horizontal row.
If <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> are different from the actual frame size, the
image is scaled proportionally.  The frame display interval is
<TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><P
>Load and render an image containing multiple frames, and append those
frames to the animator widget. Each frame within the image should be
next to one another in a single, horizontal row. If <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and/or <TT
CLASS="PARAMETER"
><I
>height</I
></TT
>
are different from the actual frame size, the image is scaled
proportionally.  The frame display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the
playback speed.&#13;</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8764"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> File path to image containing frames to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_unit</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of a single frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel height of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8806"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAMES-FROM-FILE"
></A
>gnome_animator_append_frames_from_file ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_animator_append_frames_from_file
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_unit);</PRE
></TD
></TR
></TABLE
><P
>Adds multiple frames contained within a single image file
to the end of the current animation.  Each frame within the image
should be next to one another in a single, horizontal row.
The frame display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback_speed.</P
><P
>Load and render an image containing multiple frames, and append those
frames to the animator widget. Each frame within the image should be
next to one another in a single, horizontal row. The frame display
interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8821"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> File path to image containing frames to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_unit</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of a single frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8855"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAME-FROM-GNOME-PIXMAP"
></A
>gnome_animator_append_frame_from_gnome_pixmap ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_animator_append_frame_from_gnome_pixmap
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *pixmap,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y_offset,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval);</PRE
></TD
></TR
></TABLE
><P
>Adds frame contained within a &amp;GnomePixmap image to
the end of the current animation.  The frame display interval is
<TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><P
>Appends a frame from a GnomePixmap image to the animator widget.  The
frame display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8869"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GNOME pixmap to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8899"
></A
><H3
><A
NAME="GNOME-ANIMATOR-START"
></A
>gnome_animator_start ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_animator_start            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);</PRE
></TD
></TR
></TABLE
><P
>Initiate display of animated frames.</P
><P
>Begin animating the widget.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8906"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be started</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8915"
></A
><H3
><A
NAME="GNOME-ANIMATOR-STOP"
></A
>gnome_animator_stop ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_animator_stop             (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);</PRE
></TD
></TR
></TABLE
><P
>Halts display of animated frames.  The current frame
in the animation will remain in the animator widget.</P
><P
>Stop an animator that is running.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8922"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be stopped</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8931"
></A
><H3
><A
NAME="GNOME-ANIMATOR-ADVANCE"
></A
>gnome_animator_advance ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_animator_advance          (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> num);</PRE
></TD
></TR
></TABLE
><P
>Advance the animator <TT
CLASS="PARAMETER"
><I
>num</I
></TT
> frames.  If <TT
CLASS="PARAMETER"
><I
>num</I
></TT
> is
positive, use the specified <TT
CLASS="PARAMETER"
><I
>playback_direction</I
></TT
>; if it is negative,
go in the opposite direction.  After the call, the animator is in
the same state it would be if it had actually executed the specified
number of iterations.</P
><P
>Advance the animator widget <TT
CLASS="PARAMETER"
><I
>num</I
></TT
> frames.  If <TT
CLASS="PARAMETER"
><I
>num</I
></TT
> is positive, use the
specified <TT
CLASS="PARAMETER"
><I
>playback_direction</I
></TT
>; if it is negative, go in the opposite
direction.  After the call, the animator is in the same state it would be
if it had actually executed the sppecified number of iterations.&#13;</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8946"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of frames to advance by</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  <TT
CLASS="LITERAL"
>TRUE</TT
> if the animator is now stopped.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8964"
></A
><H3
><A
NAME="GNOME-ANIMATOR-GOTO-FRAME"
></A
>gnome_animator_goto_frame ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_animator_goto_frame       (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> frame_number);</PRE
></TD
></TR
></TABLE
><P
>Jump to the specified <TT
CLASS="PARAMETER"
><I
>frame_number</I
></TT
> and display it.</P
><P
>Jump to the specified frame.  If <TT
CLASS="PARAMETER"
><I
>num_frame</I
></TT
> is greater than the total
number of frames, no action is taken.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8974"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>num_frame</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Frame number to be made current.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8987"
></A
><H3
><A
NAME="GNOME-ANIMATOR-GET-CURRENT-FRAME-NUMBER"
></A
>gnome_animator_get_current_frame_number ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>       gnome_animator_get_current_frame_number
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);</PRE
></TD
></TR
></TABLE
><P
>Obtains current frame number from animator widget.</P
><P
>Determine the current frame number of the animator widget.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN8995"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be queried</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Current frame number.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9008"
></A
><H3
><A
NAME="GNOME-ANIMATOR-GET-STATUS"
></A
>gnome_animator_get_status ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeanimator.html#GNOMEANIMATORSTATUS"
>GnomeAnimatorStatus</A
> gnome_animator_get_status
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);</PRE
></TD
></TR
></TABLE
><P
>Obtains current status from animator widget.  Possible
return values include <TT
CLASS="LITERAL"
>GNOME_ANIMATOR_STATUS_STOPPED</TT
> and
<TT
CLASS="LITERAL"
>GNOME_ANIMATOR_STATUS_RUNNING</TT
>.</P
><P
>Obtain the current status from the animator widget.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9018"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be queried</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Status constant.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9031"
></A
><H3
><A
NAME="GNOME-ANIMATOR-SET-PLAYBACK-SPEED"
></A
>gnome_animator_set_playback_speed ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_animator_set_playback_speed
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> speed);</PRE
></TD
></TR
></TABLE
><P
>Sets the playback speed.  The delay between every
frame is divided by this value before being used.  As a
consequence, higher values give higher playback speeds.</P
><P
>Sets the playback speed.  The delay between every frame is divided by this
value before being used.  As a consequence, higher values give higher
playback speeds.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9039"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>speed</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Rate multiplier for playback speed</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9052"
></A
><H3
><A
NAME="GNOME-ANIMATOR-GET-PLAYBACK-SPEED"
></A
>gnome_animator_get_playback_speed ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>     gnome_animator_get_playback_speed
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);</PRE
></TD
></TR
></TABLE
><P
>Returns the current playback speed.</P
><P
>Obtain the current playback speed.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9060"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be queried</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> &amp;double indicating the playback speed.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeabout.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeapp.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
>GnomeAbout</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeApp</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeAppBar</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeApp"
HREF="gnomeapp.html"><LINK
REL="NEXT"
TITLE="GnomeCalculator"
HREF="gnomecalculator.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeapp.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecalculator.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEAPPBAR"
>GnomeAppBar</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN9549"
></A
><H2
>Name</H2
>GnomeAppBar&nbsp;--&nbsp;Statusbar/Progress/Minibuffer widget</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN9552"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeappbar.html#GNOMEAPPBAR-STRUCT"
>GnomeAppBar</A
>;
#define     <A
HREF="gnomeappbar.html#GNOME-APPBAR-HAS-STATUS-CAPS"
>GNOME_APPBAR_HAS_STATUS</A
>         (appbar)
#define     <A
HREF="gnomeappbar.html#GNOME-APPBAR-HAS-PROGRESS-CAPS"
>GNOME_APPBAR_HAS_PROGRESS</A
>       (appbar)
struct      <A
HREF="gnomeappbar.html#GNOMEAPPBARMSG"
>GnomeAppBarMsg</A
>;
#define     <A
HREF="gnomeappbar.html#GNOME-APPBAR-INTERACTIVE-CAPS"
>GNOME_APPBAR_INTERACTIVE</A
>        (ab)
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeappbar.html#GNOME-APPBAR-NEW"
>gnome_appbar_new</A
>                (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> has_progress,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> has_status,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEPREFERENCESTYPE"
>GnomePreferencesType</A
> interactivity);
void        <A
HREF="gnomeappbar.html#GNOME-APPBAR-SET-STATUS"
>gnome_appbar_set_status</A
>         (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *status);
void        <A
HREF="gnomeappbar.html#GNOME-APPBAR-SET-DEFAULT"
>gnome_appbar_set_default</A
>        (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *default_status);
void        <A
HREF="gnomeappbar.html#GNOME-APPBAR-PUSH"
>gnome_appbar_push</A
>               (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *status);
void        <A
HREF="gnomeappbar.html#GNOME-APPBAR-POP"
>gnome_appbar_pop</A
>                (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar);
void        <A
HREF="gnomeappbar.html#GNOME-APPBAR-CLEAR-STACK"
>gnome_appbar_clear_stack</A
>        (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar);
void        <A
HREF="gnomeappbar.html#GNOME-APPBAR-SET-PROGRESS"
>gnome_appbar_set_progress</A
>       (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                             <A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A> percentage);
<A
HREF=../gtk/gtkprogress.html
>GtkProgress</A>* <A
HREF="gnomeappbar.html#GNOME-APPBAR-GET-PROGRESS"
>gnome_appbar_get_progress</A
>      (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar);
void        <A
HREF="gnomeappbar.html#GNOME-APPBAR-REFRESH"
>gnome_appbar_refresh</A
>            (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar);
void        <A
HREF="gnomeappbar.html#GNOME-APPBAR-SET-PROMPT"
>gnome_appbar_set_prompt</A
>         (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> modal);
void        <A
HREF="gnomeappbar.html#GNOME-APPBAR-CLEAR-PROMPT"
>gnome_appbar_clear_prompt</A
>       (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomeappbar.html#GNOME-APPBAR-GET-RESPONSE"
>gnome_appbar_get_response</A
>       (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar);
void        <A
HREF="gnomeappbar.html#GNOME-APPBAR-CONSTRUCT"
>gnome_appbar_construct</A
>          (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *ab,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> has_progress,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> has_status,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEPREFERENCESTYPE"
>GnomePreferencesType</A
> interactivity);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9600"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbox.html
>GtkBox</A>
                     +----<A
HREF=../gtk/gtkhbox.html
>GtkHBox</A>
                           +----GnomeAppBar</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9608"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomeappbar.html#GNOMEAPPBAR-USER-RESPONSE"
>user-response</A
>&quot;
            void        user_function      (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomeappbar.html#GNOMEAPPBAR-CLEAR-PROMPT"
>clear-prompt</A
>&quot;
            void        user_function      (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9617"
></A
><H2
>Description</H2
><P
>  A bar that GNOME applications put on the bottom of the windows to display
  status, progress, hints for menu items or a minibuffer for getting some
  sort of response. It has a stack for status messages</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9620"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN9622"
></A
><H3
><A
NAME="GNOMEAPPBAR-STRUCT"
></A
>struct GnomeAppBar</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeAppBar;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9627"
></A
><H3
><A
NAME="GNOME-APPBAR-HAS-STATUS-CAPS"
></A
>GNOME_APPBAR_HAS_STATUS()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_APPBAR_HAS_STATUS(appbar) (GNOME_APPBAR(appbar)-&gt;status != NULL)</PRE
></TD
></TR
></TABLE
><P
>Returns whether the appbar contains a statusbar widget. For internal use. Don't use.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9632"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>appbar to check
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9641"
></A
><H3
><A
NAME="GNOME-APPBAR-HAS-PROGRESS-CAPS"
></A
>GNOME_APPBAR_HAS_PROGRESS()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_APPBAR_HAS_PROGRESS(appbar) (GNOME_APPBAR(appbar)-&gt;progress != NULL)</PRE
></TD
></TR
></TABLE
><P
>Returns whether the appbar has a progress widget. For internal use. Don't use.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9646"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>appbar to check&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9655"
></A
><H3
><A
NAME="GNOMEAPPBARMSG"
></A
>struct GnomeAppBarMsg</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeAppBarMsg;</PRE
></TD
></TR
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9659"
></A
><H3
><A
NAME="GNOME-APPBAR-INTERACTIVE-CAPS"
></A
>GNOME_APPBAR_INTERACTIVE()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_APPBAR_INTERACTIVE(ab) ((ab) ? (ab)-&gt;interactive : FALSE)</PRE
></TD
></TR
></TABLE
><P
>Returns whether the appbar has a minibuffer-style interactive status display.
For internal use. Don't use.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9664"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ab</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>appbar to check
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9673"
></A
><H3
><A
NAME="GNOME-APPBAR-NEW"
></A
>gnome_appbar_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_appbar_new                (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> has_progress,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> has_status,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEPREFERENCESTYPE"
>GnomePreferencesType</A
> interactivity);</PRE
></TD
></TR
></TABLE
><P
>Create a new GNOME application status bar.  If <TT
CLASS="PARAMETER"
><I
>has_progress</I
></TT
> is
<TT
CLASS="LITERAL"
>TRUE</TT
>, a small progress bar widget will be created, and placed on the
left side of the appbar.  If <TT
CLASS="PARAMETER"
><I
>has_status</I
></TT
> is <TT
CLASS="LITERAL"
>TRUE</TT
>, a status bar,
possibly an editable one, is created.</P
><P
><TT
CLASS="PARAMETER"
><I
>interactivity</I
></TT
> determines whether the appbar is an interactive
"minibuffer" or just a status bar.  If it is set to
<TT
CLASS="LITERAL"
>GNOME_PREFERENCES_NEVER</TT
>, it is never interactive.  If it is set to
<TT
CLASS="LITERAL"
>GNOME_PREFERENCES_USER</TT
> we respect user preferences from
ui-properties. If it's <TT
CLASS="LITERAL"
>GNOME_PREFERENCES_ALWAYS</TT
> we are interactive
whether the user likes it or not. Basically, if your app supports
both interactive and not (for example, if you use the
gnome-app-util interfaces), you should use
<TT
CLASS="LITERAL"
>GNOME_PREFERENCES_USER</TT
>. Otherwise, use the setting you
support. Please note that "interactive" mode is not functional now;
GtkEntry is inadequate and so a custom widget will be written
eventually.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9693"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>has_progress</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if appbar needs progress bar widget, <TT
CLASS="LITERAL"
>FALSE</TT
> if not</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>has_status</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if appbar needs status bar widget, <TT
CLASS="LITERAL"
>FALSE</TT
> if not</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interactivity</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Level of user activity required</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME appbar widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9718"
></A
><H3
><A
NAME="GNOME-APPBAR-SET-STATUS"
></A
>gnome_appbar_set_status ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_appbar_set_status         (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *status);</PRE
></TD
></TR
></TABLE
><P
>Sets the status label without changing widget state; next set or push
will destroy this permanently.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9726"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME appbar object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>status</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text to which status label will be set.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9739"
></A
><H3
><A
NAME="GNOME-APPBAR-SET-DEFAULT"
></A
>gnome_appbar_set_default ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_appbar_set_default        (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *default_status);</PRE
></TD
></TR
></TABLE
><P
>What to show when showing nothing else; defaults to nothing.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9747"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME appbar object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>default_status</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text for status label</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9760"
></A
><H3
><A
NAME="GNOME-APPBAR-PUSH"
></A
>gnome_appbar_push ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_appbar_push               (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *status);</PRE
></TD
></TR
></TABLE
><P
>Push a new status message onto the status bar stack, and
display it.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9768"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME appbar object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>status</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text of status message.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9781"
></A
><H3
><A
NAME="GNOME-APPBAR-POP"
></A
>gnome_appbar_pop ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_appbar_pop                (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar);</PRE
></TD
></TR
></TABLE
><P
>Remove current status message, and display previous status
message, if any.  It is OK to call this with an empty stack.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9788"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME appbar object</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9797"
></A
><H3
><A
NAME="GNOME-APPBAR-CLEAR-STACK"
></A
>gnome_appbar_clear_stack ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_appbar_clear_stack        (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar);</PRE
></TD
></TR
></TABLE
><P
>Remove all status messages from appbar, and display default status
message (if present).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9804"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME appbar object</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9813"
></A
><H3
><A
NAME="GNOME-APPBAR-SET-PROGRESS"
></A
>gnome_appbar_set_progress ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_appbar_set_progress       (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                             <A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A> percentage);</PRE
></TD
></TR
></TABLE
><P
>Sets progress bar to the given percentage.
Pure sugar - with a bad name, in light of the get_progress name
which is not the opposite of set_progress. Maybe this function
should die.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9821"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME appbar object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>percentage</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Percentage to which progress bar should be set.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9834"
></A
><H3
><A
NAME="GNOME-APPBAR-GET-PROGRESS"
></A
>gnome_appbar_get_progress ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkprogress.html
>GtkProgress</A>* gnome_appbar_get_progress      (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar);</PRE
></TD
></TR
></TABLE
><P
>Returns &amp;GtkProgress widget pointer, so that the progress bar may be
manipulated further.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9842"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME appbar object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to appbar's progress bar object. May be NULL if the appbar
has no progress object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9855"
></A
><H3
><A
NAME="GNOME-APPBAR-REFRESH"
></A
>gnome_appbar_refresh ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_appbar_refresh            (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar);</PRE
></TD
></TR
></TABLE
><P
>Reflect the current state of stack/default. Useful to force a
set_status to disappear.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9862"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME appbar object</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9871"
></A
><H3
><A
NAME="GNOME-APPBAR-SET-PROMPT"
></A
>gnome_appbar_set_prompt ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_appbar_set_prompt         (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> modal);</PRE
></TD
></TR
></TABLE
><P
>Put a prompt in the appbar and wait for a response. When the
user responds or cancels, a user_response signal is emitted.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9880"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME appbar object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>prompt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text of the prompt message.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>modal</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> If <TT
CLASS="LITERAL"
>TRUE</TT
>, grabs input.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9898"
></A
><H3
><A
NAME="GNOME-APPBAR-CLEAR-PROMPT"
></A
>gnome_appbar_clear_prompt ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_appbar_clear_prompt       (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar);</PRE
></TD
></TR
></TABLE
><P
>Remove any prompt.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9905"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME appbar object</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9914"
></A
><H3
><A
NAME="GNOME-APPBAR-GET-RESPONSE"
></A
>gnome_appbar_get_response ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_appbar_get_response       (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar);</PRE
></TD
></TR
></TABLE
><P
>Get the response to the prompt, if any. Result must be g_free'd.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9922"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME appbar object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Text from appbar entry widget, as entered by user.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9935"
></A
><H3
><A
NAME="GNOME-APPBAR-CONSTRUCT"
></A
>gnome_appbar_construct ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_appbar_construct          (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *ab,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> has_progress,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> has_status,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEPREFERENCESTYPE"
>GnomePreferencesType</A
> interactivity);</PRE
></TD
></TR
></TABLE
><P
>For use to bindings in languages other than C. Don't use.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9945"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ab</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME appbar object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>has_progress</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if appbar needs progress bar widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>has_status</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if appbar needs status bar widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interactivity</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> See <A
HREF="gnomeappbar.html#GNOME-APPBAR-NEW"
>gnome_appbar_new</A
>() explanation.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9969"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN9971"
></A
><H3
><A
NAME="GNOMEAPPBAR-USER-RESPONSE"
></A
>The &quot;user-response&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>  Emitted when the user hits enter after a prompt</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9978"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9991"
></A
><H3
><A
NAME="GNOMEAPPBAR-CLEAR-PROMPT"
></A
>The &quot;clear-prompt&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>  Emitted when the prompt is cleared</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9998"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10011"
></A
><H2
>See Also</H2
><P
>  <A
HREF="gnomeapp.html"
>GnomeApp</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeapp.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecalculator.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
>GnomeApp</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeCalculator</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeApp</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeAnimator"
HREF="gnomeanimator.html"><LINK
REL="NEXT"
TITLE="GnomeAppBar"
HREF="gnomeappbar.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeanimator.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeappbar.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEAPP"
>GnomeApp</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN9078"
></A
><H2
>Name</H2
>GnomeApp&nbsp;--&nbsp;The toplevel GNOME container</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN9081"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeapp.html#GNOMEAPP-STRUCT"
>GnomeApp</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeapp.html#GNOME-APP-NEW"
>gnome_app_new</A
>                   (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *appname,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);
void        <A
HREF="gnomeapp.html#GNOME-APP-CONSTRUCT"
>gnome_app_construct</A
>             (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *appname,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);
#define     <A
HREF="gnomeapp.html#GNOME-APP-MENUBAR-NAME-CAPS"
>GNOME_APP_MENUBAR_NAME</A
>
#define     <A
HREF="gnomeapp.html#GNOME-APP-TOOLBAR-NAME-CAPS"
>GNOME_APP_TOOLBAR_NAME</A
>
void        <A
HREF="gnomeapp.html#GNOME-APP-SET-MENUS"
>gnome_app_set_menus</A
>             (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF=../gtk/gtkmenubar.html
>GtkMenuBar</A> *menubar);
void        <A
HREF="gnomeapp.html#GNOME-APP-SET-TOOLBAR"
>gnome_app_set_toolbar</A
>           (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF=../gtk/gtktoolbar.html
>GtkToolbar</A> *toolbar);
void        <A
HREF="gnomeapp.html#GNOME-APP-SET-STATUSBAR"
>gnome_app_set_statusbar</A
>         (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *statusbar);
void        <A
HREF="gnomeapp.html#GNOME-APP-SET-CONTENTS"
>gnome_app_set_contents</A
>          (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *contents);
void        <A
HREF="gnomeapp.html#GNOME-APP-ADD-TOOLBAR"
>gnome_app_add_toolbar</A
>           (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF=../gtk/gtktoolbar.html
>GtkToolbar</A> *toolbar,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gnomedockitem.html#GNOMEDOCKITEMBEHAVIOR"
>GnomeDockItemBehavior</A
> behavior,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_num,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_position,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> offset);
void        <A
HREF="gnomeapp.html#GNOME-APP-ADD-DOCKED"
>gnome_app_add_docked</A
>            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gnomedockitem.html#GNOMEDOCKITEMBEHAVIOR"
>GnomeDockItemBehavior</A
> behavior,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_num,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_position,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> offset);
void        <A
HREF="gnomeapp.html#GNOME-APP-ADD-DOCK-ITEM"
>gnome_app_add_dock_item</A
>         (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_num,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_position,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> offset);
void        <A
HREF="gnomeapp.html#GNOME-APP-ENABLE-LAYOUT-CONFIG"
>gnome_app_enable_layout_config</A
>  (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> enable);
<A
HREF="gnomedock.html"
>GnomeDock</A
>*  <A
HREF="gnomeapp.html#GNOME-APP-GET-DOCK"
>gnome_app_get_dock</A
>              (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app);
<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
>* <A
HREF="gnomeapp.html#GNOME-APP-GET-DOCK-ITEM-BY-NAME"
>gnome_app_get_dock_item_by_name</A
>
                                            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9142"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----<A
HREF=../gtk/gtkwindow.html
>GtkWindow</A>
                           +----GnomeApp</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9150"
></A
><H2
>Description</H2
><P
>Toplevel GNOME applications would normally use one
<SPAN
CLASS="TYPE"
>GnomeApp</SPAN
> widget as their toplevel window.  You can create
as many <SPAN
CLASS="TYPE"
>GnomeApp</SPAN
> widgets as you want, for example, some
people use one GnomeApp per document their application loads.</P
><P
>Once you have created one instance of this widget, you would add
your main application view information to this window by using
<A
HREF="gnomeapp.html#GNOME-APP-SET-CONTENTS"
>gnome_app_set_contents</A
>() routine.</P
><P
> The <SPAN
CLASS="TYPE"
>GnomeApp</SPAN
> has support for including a menubar,
one or more toolbars and a statusbar for your application. It also
takes care of intalling the accelerators for you when used in
conjuction with the gnome-app-helper routines.  The toolbars are
inserted into <SPAN
CLASS="TYPE"
>GnomeDock</SPAN
> widgets.</P
><P
>The <TT
CLASS="FILENAME"
>gnome-app-helper</TT
> module provides
various helper routines to simplify the configuration of your menus
and toolbars, but you can create those yourself and use the
<A
HREF="gnomeapp.html#GNOME-APP-SET-MENUS"
>gnome_app_set_menus</A
>(), <A
HREF="gnomeapp.html#GNOME-APP-ADD-TOOLBAR"
>gnome_app_add_toolbar</A
>(),
<A
HREF="gnomeapp.html#GNOME-APP-SET-TOOLBAR"
>gnome_app_set_toolbar</A
>(), <A
HREF="gnomeapp.html#GNOME-APP-ADD-DOCK-ITEM"
>gnome_app_add_dock_item</A
>(),
and <A
HREF="gnomeapp.html#GNOME-APP-ADD-DOCKED"
>gnome_app_add_docked</A
>().</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9167"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN9169"
></A
><H3
><A
NAME="GNOMEAPP-STRUCT"
></A
>struct GnomeApp</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeApp;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9174"
></A
><H3
><A
NAME="GNOME-APP-NEW"
></A
>gnome_app_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_app_new                   (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *appname,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);</PRE
></TD
></TR
></TABLE
><P
>Create a new (empty) application window.  You must specify the
application's name (used internally as an identifier).
<TT
CLASS="PARAMETER"
><I
>title</I
></TT
> can be left as NULL, in which case the window's title will
not be set.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9184"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appname</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of program, using in file names and paths.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Window title for application.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to new GNOME app object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9201"
></A
><H3
><A
NAME="GNOME-APP-CONSTRUCT"
></A
>gnome_app_construct ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_construct             (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *appname,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);</PRE
></TD
></TR
></TABLE
><P
>Constructor for language bindings; you don't normally need this.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9210"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to newly-created GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appname</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of program, using in file names and paths.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Window title for application.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9227"
></A
><H3
><A
NAME="GNOME-APP-MENUBAR-NAME-CAPS"
></A
>GNOME_APP_MENUBAR_NAME</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_APP_MENUBAR_NAME "Menubar"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9232"
></A
><H3
><A
NAME="GNOME-APP-TOOLBAR-NAME-CAPS"
></A
>GNOME_APP_TOOLBAR_NAME</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_APP_TOOLBAR_NAME "Toolbar"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9237"
></A
><H3
><A
NAME="GNOME-APP-SET-MENUS"
></A
>gnome_app_set_menus ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_set_menus             (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF=../gtk/gtkmenubar.html
>GtkMenuBar</A> *menubar);</PRE
></TD
></TR
></TABLE
><P
>Sets the menu bar of the application window.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9245"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>menubar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Menu bar widget for main app window.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9258"
></A
><H3
><A
NAME="GNOME-APP-SET-TOOLBAR"
></A
>gnome_app_set_toolbar ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_set_toolbar           (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF=../gtk/gtktoolbar.html
>GtkToolbar</A> *toolbar);</PRE
></TD
></TR
></TABLE
><P
>Sets the main toolbar of the application window.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9266"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>toolbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Toolbar widget for main app window.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9279"
></A
><H3
><A
NAME="GNOME-APP-SET-STATUSBAR"
></A
>gnome_app_set_statusbar ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_set_statusbar         (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *statusbar);</PRE
></TD
></TR
></TABLE
><P
>Sets the status bar of the application window.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9287"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>statusbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Statusbar widget for main app window</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9300"
></A
><H3
><A
NAME="GNOME-APP-SET-CONTENTS"
></A
>gnome_app_set_contents ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_set_contents          (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *contents);</PRE
></TD
></TR
></TABLE
><P
>Sets the content area of the GNOME app's main window.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9308"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>contents</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Widget to be application content area.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9321"
></A
><H3
><A
NAME="GNOME-APP-ADD-TOOLBAR"
></A
>gnome_app_add_toolbar ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_add_toolbar           (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF=../gtk/gtktoolbar.html
>GtkToolbar</A> *toolbar,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gnomedockitem.html#GNOMEDOCKITEMBEHAVIOR"
>GnomeDockItemBehavior</A
> behavior,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_num,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_position,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> offset);</PRE
></TD
></TR
></TABLE
><P
>Create a new &amp;GnomeDockItem widget containing <TT
CLASS="PARAMETER"
><I
>toolbar</I
></TT
>, and add it
to <TT
CLASS="PARAMETER"
><I
>app</I
></TT
>'s dock with the specified layout information.  Notice that,
if automatic layout configuration is enabled, the layout is
overridden by the saved configuration, if any.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9337"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &amp;GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>toolbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Toolbar to be added to <TT
CLASS="PARAMETER"
><I
>app</I
></TT
>'s dock</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name for the dock item that will contain <TT
CLASS="PARAMETER"
><I
>toolbar</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>behavior</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Behavior for the new dock item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>placement</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Placement for the new dock item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of the band where the dock item should be placed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_position</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Position of the new dock item in band <TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Offset from the previous dock item in the band; if there is
no previous item, offset from the beginning of the band.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9377"
></A
><H3
><A
NAME="GNOME-APP-ADD-DOCKED"
></A
>gnome_app_add_docked ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_add_docked            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gnomedockitem.html#GNOMEDOCKITEMBEHAVIOR"
>GnomeDockItemBehavior</A
> behavior,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_num,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_position,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> offset);</PRE
></TD
></TR
></TABLE
><P
>Add <TT
CLASS="PARAMETER"
><I
>widget</I
></TT
> as a dock item according to the specified layout
information.  Notice that, if automatic layout configuration is
enabled, the layout is overridden by the saved configuration, if
any.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9392"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &amp;GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Widget to be added to the &amp;GnomeApp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name for the new dock item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>behavior</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Behavior for the new dock item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>placement</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Placement for the new dock item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of the band where the dock item should be placed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_position</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Position of the new dock item in band <TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Offset from the previous dock item in the band; if there is
no previous item, offset from the beginning of the band.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9430"
></A
><H3
><A
NAME="GNOME-APP-ADD-DOCK-ITEM"
></A
>gnome_app_add_dock_item ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_add_dock_item         (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_num,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_position,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> offset);</PRE
></TD
></TR
></TABLE
><P
>Add <TT
CLASS="PARAMETER"
><I
>item</I
></TT
> according to the specified layout information.  Notice
that, if automatic layout configuration is enabled, the layout is
overridden by the saved configuration, if any.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9443"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &amp;GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Dock item to be added to <TT
CLASS="PARAMETER"
><I
>app</I
></TT
>'s dock.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>placement</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Placement for the dock item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of the band where the dock item should be placed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_position</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Position of the dock item in band <TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Offset from the previous dock item in the band; if there is
no previous item, offset from the beginning of the band.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9474"
></A
><H3
><A
NAME="GNOME-APP-ENABLE-LAYOUT-CONFIG"
></A
>gnome_app_enable_layout_config ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_enable_layout_config  (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> enable);</PRE
></TD
></TR
></TABLE
><P
>Specify whether <TT
CLASS="PARAMETER"
><I
>app</I
></TT
> should automatically save the dock's
layout configuration via gnome-config whenever it changes or not.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9483"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &amp;GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>enable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Boolean specifying whether automatic configuration saving
is enabled</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9496"
></A
><H3
><A
NAME="GNOME-APP-GET-DOCK"
></A
>gnome_app_get_dock ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomedock.html"
>GnomeDock</A
>*  gnome_app_get_dock              (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app);</PRE
></TD
></TR
></TABLE
><P
>Retrieves the &amp;GnomeDock widget contained in the &amp;GnomeApp.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9504"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &amp;GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The &amp;GnomeDock widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9517"
></A
><H3
><A
NAME="GNOME-APP-GET-DOCK-ITEM-BY-NAME"
></A
>gnome_app_get_dock_item_by_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomedockitem.html"
>GnomeDockItem</A
>* gnome_app_get_dock_item_by_name
                                            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the dock item whose name matches <TT
CLASS="PARAMETER"
><I
>name</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN9527"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A &amp;GnomeApp widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of the dock item to retrieve</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The retrieved dock item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeanimator.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeappbar.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
>GnomeAnimator</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeAppBar</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeCalculator</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeAppBar"
HREF="gnomeappbar.html"><LINK
REL="NEXT"
TITLE="GnomeCanvas"
HREF="gnomecanvas.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeappbar.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvas.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMECALCULATOR"
>GnomeCalculator</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN10020"
></A
><H2
>Name</H2
>GnomeCalculator&nbsp;--&nbsp;Calculator widget.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN10023"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomecalculator.html#GNOMECALCULATOR-STRUCT"
>GnomeCalculator</A
>;
enum        <A
HREF="gnomecalculator.html#GNOMECALCULATORMODE"
>GnomeCalculatorMode</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomecalculator.html#GNOME-CALCULATOR-NEW"
>gnome_calculator_new</A
>            (void);
void        <A
HREF="gnomecalculator.html#GNOME-CALCULATOR-CLEAR"
>gnome_calculator_clear</A
>          (<A
HREF="gnomecalculator.html"
>GnomeCalculator</A
> *gc,
                                             const <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> reset);
void        <A
HREF="gnomecalculator.html#GNOME-CALCULATOR-SET"
>gnome_calculator_set</A
>            (<A
HREF="gnomecalculator.html"
>GnomeCalculator</A
> *gc,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> result);
#define     <A
HREF="gnomecalculator.html#GNOME-CALCULATOR-GET-RESULT"
>gnome_calculator_get_result</A
>     (gc)&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10037"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbox.html
>GtkBox</A>
                     +----<A
HREF=../gtk/gtkvbox.html
>GtkVBox</A>
                           +----GnomeCalculator</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10045"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomecalculator.html#GNOMECALCULATOR-RESULT-CHANGED"
>result-changed</A
>&quot;
            void        user_function      (<A
HREF="gnomecalculator.html"
>GnomeCalculator</A
> *calculator,
                                            <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10052"
></A
><H2
>Description</H2
><P
>  This widget provides a simple calculator that you can embed in your
  applications for doing quick computations.</P
><P
>  The widget consists of a fully functional calculator including
  standard arithmetic functions as well as trigonometric capabilities,
  exponents, factorials, nested equations, and others.</P
><DIV
CLASS="REFSECT2"
><A
NAME="AEN10056"
></A
><H3
><SPAN
CLASS="STRUCTNAME"
>GnomeCalculator</SPAN
> functions</H3
><P
>The following is a list and description of each button represented on the GnomeCalculator widget</P
><P
></P
><UL
><LI
><P
>		Calculations accurate to a maximum of 10 digits, or 9 decimal places.</P
></LI
><LI
><P
>      		Numbers <TT
CLASS="LITERAL"
>0</TT
>-<TT
CLASS="LITERAL"
>9</TT
> for numerical input</P
></LI
><LI
><P
>		Decimal point for decimal calculations</P
></LI
><LI
><P
>		+/- button for positive/negative number entry</P
></LI
><LI
><P
>		/ for Division, * for Multiplication, - for Subtraction, and + for Addition</P
></LI
><LI
><P
>		<TT
CLASS="LITERAL"
>PI</TT
> feature to automatically use the value of <TT
CLASS="LITERAL"
>PI</TT
> at the touch of a button</P
></LI
><LI
><P
>		<TT
CLASS="LITERAL"
>X</TT
>! calculates the factorial for the current resultant</P
><P
>i.e: If resultant is 5, 5 factorial is 5*4*3*2*1 = 120</P
></LI
><LI
><P
>		( and )</P
><P
>Parenthesis used to force grouping of expressions to be evaluated in a
		certain order.</P
><P
>5 + 6 * 8 = 53 is ambiguous, if you really meant to add 5 + 6 together first.</P
><P
>Use (5 + 6) * 8 = 88, to make sure your meaning is understood</P
></LI
><LI
><P
>		The <TT
CLASS="LITERAL"
>DEG</TT
> or <TT
CLASS="LITERAL"
>RAD</TT
> button will switch between the degree or radians mode.  Its often needed to measure in one mode or the other.  As an example, 90 degrees is the same as <TT
CLASS="LITERAL"
>PI</TT
>/2, 180 degrees is <TT
CLASS="LITERAL"
>PI</TT
>, 270 degrees is 3 PI/2, and 360 degrees is 2 <TT
CLASS="LITERAL"
>PI</TT
>.</P
></LI
><LI
><P
>		<TT
CLASS="LITERAL"
>C</TT
> will clear the current result value.  <TT
CLASS="LITERAL"
>AC</TT
> will clear the current result, but will also clear all values stored in memory.</P
></LI
></UL
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10097"
></A
><H3
>Memory Functions</H3
><P
>The following are <SPAN
CLASS="STRUCTNAME"
>GnomeCalculator</SPAN
> widget's memory functions</P
><P
></P
><UL
><LI
><P
>		<TT
CLASS="LITERAL"
>STO</TT
> stores the current result in the display into memory.</P
></LI
><LI
><P
>		<TT
CLASS="LITERAL"
>RCL</TT
> will take the value stored in memory, and display it in the resultant.</P
></LI
><LI
><P
>		<TT
CLASS="LITERAL"
>SUM</TT
> will take the current result in the display and add it to the current value stored in memory.  If nothing is in the memory, the current value will be placed in memory as it is.</P
></LI
><LI
><P
>		<TT
CLASS="LITERAL"
>EXC</TT
> will take the current value in memory and exchange it with the current resultant.  The previous current result will be placed back in memory.</P
></LI
></UL
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10114"
></A
><H3
>Exponential functions</H3
><P
>The following are <SPAN
CLASS="STRUCTNAME"
>GnomeCalculator</SPAN
> widget's exponential functions</P
><P
></P
><UL
><LI
><P
>		<TT
CLASS="LITERAL"
>SQRT</TT
> raises the current value to the 1/2 power.  This is the opposite of
		squaring the number, seen below.</P
><P
>For example, the SQRT of 4 is 4^(1/2) = 2.</P
></LI
><LI
><P
>		<TT
CLASS="LITERAL"
>EE</TT
> is used for scientific notation.  Use this for manipulating numbers such 
		as 1e+50, 9e+10, and so forth.</P
></LI
><LI
><P
>		<TT
CLASS="LITERAL"
>x</TT
>^2 is used to square the current number.  The square of a number is that 
		same number multiplied by itself.  2^2 is 2 * 2 = 4.</P
></LI
><LI
><P
>		<TT
CLASS="LITERAL"
>x</TT
>^y is used to take a number and raise it to the power of the 2nd number.</P
><P
>For example, entering a 3, pressing the x^y button, entering another 3
		will lead to the result of 27.  In other words, 3^3, or 3 * 3 * 3, or 27.</P
></LI
></UL
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10133"
></A
><H3
>Trigonometric functions</H3
><P
></P
><UL
><LI
><P
>		<TT
CLASS="LITERAL"
>SIN</TT
> calculates the trigonometric sine function on the current value</P
></LI
><LI
><P
>		<TT
CLASS="LITERAL"
>COS</TT
> calculates the trigonometric cosine function on the current value</P
></LI
><LI
><P
>		<TT
CLASS="LITERAL"
>TAN</TT
> calculates the trigonometric tangent function on the current value</P
></LI
><LI
><P
>		The <TT
CLASS="LITERAL"
>INV</TT
> button will reversie the previous three trig functions.  If the <TT
CLASS="LITERAL"
>INV</TT
> button is pressed, the <TT
CLASS="LITERAL"
>SIN</TT
> button will instead calculate the Inverse-Sine.  <TT
CLASS="LITERAL"
>COS</TT
> will calculate the Inverse-Cosine, and the <TT
CLASS="LITERAL"
>TAN</TT
> will calculate the Inverse-Tangent.</P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10152"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN10154"
></A
><H3
><A
NAME="GNOMECALCULATOR-STRUCT"
></A
>struct GnomeCalculator</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeCalculator;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10159"
></A
><H3
><A
NAME="GNOMECALCULATORMODE"
></A
>enum GnomeCalculatorMode</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum {
	GNOME_CALCULATOR_DEG,
	GNOME_CALCULATOR_RAD,
	GNOME_CALCULATOR_GRAD
} GnomeCalculatorMode;</PRE
></TD
></TR
></TABLE
><P
>   The way in which degrees are handled by the calculator, possible
   values include: <TT
CLASS="LITERAL"
>GNOME_CALCULATOR_DEG</TT
>, <TT
CLASS="LITERAL"
>GNOME_CALCULATOR_DEG</TT
>,
   <TT
CLASS="LITERAL"
>GNOME_CACLULATOR_DRAG</TT
>.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10167"
></A
><H3
><A
NAME="GNOME-CALCULATOR-NEW"
></A
>gnome_calculator_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_calculator_new            (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a calculator widget, a window with all the common buttons and
functions found on a standard pocket calculator.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10174"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to newly-created calculator widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10183"
></A
><H3
><A
NAME="GNOME-CALCULATOR-CLEAR"
></A
>gnome_calculator_clear ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_calculator_clear          (<A
HREF="gnomecalculator.html"
>GnomeCalculator</A
> *gc,
                                             const <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> reset);</PRE
></TD
></TR
></TABLE
><P
>Resets the calculator back to zero.  If <TT
CLASS="PARAMETER"
><I
>reset</I
></TT
> is <TT
CLASS="LITERAL"
>TRUE</TT
>, results
stored in memory and the calculator mode are cleared also.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10193"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME calculator widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>reset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>FALSE</TT
> to zero, <TT
CLASS="LITERAL"
>TRUE</TT
> to reset calculator completely</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10208"
></A
><H3
><A
NAME="GNOME-CALCULATOR-SET"
></A
>gnome_calculator_set ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_calculator_set            (<A
HREF="gnomecalculator.html"
>GnomeCalculator</A
> *gc,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> result);</PRE
></TD
></TR
></TABLE
><P
>Sets the value stored in the calculator's result buffer to the given
<TT
CLASS="PARAMETER"
><I
>result</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10217"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME calculator widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>result</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New value of calculator buffer.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10230"
></A
><H3
><A
NAME="GNOME-CALCULATOR-GET-RESULT"
></A
>gnome_calculator_get_result()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_calculator_get_result(gc)</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10236"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME calculator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Value currently stored in calculator buffer.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10249"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN10251"
></A
><H3
><A
NAME="GNOMECALCULATOR-RESULT-CHANGED"
></A
>The &quot;result-changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomecalculator.html"
>GnomeCalculator</A
> *calculator,
                                            <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>   This signal is emited by the widget when the result has been
   changed.  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10259"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>calculator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A double value with the new result.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10276"
></A
><H2
>See Also</H2
><P
>  <A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeappbar.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvas.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
>GnomeAppBar</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeCanvas</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeCanvasEllipse</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeCanvasRect"
HREF="gnomecanvasrect.html"><LINK
REL="NEXT"
TITLE="GnomeCanvasText"
HREF="gnomecanvastext.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvasrect.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvastext.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMECANVASELLIPSE"
>GnomeCanvasEllipse</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN12572"
></A
><H2
>Name</H2
>GnomeCanvasEllipse&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN12575"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomecanvasellipse.html#GNOMECANVASELLIPSE-STRUCT"
>GnomeCanvasEllipse</A
>;&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12579"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>
         +----<A
HREF="gnomecanvasre.html"
>GnomeCanvasRE</A
>
               +----GnomeCanvasEllipse</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12585"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12588"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN12590"
></A
><H3
><A
NAME="GNOMECANVASELLIPSE-STRUCT"
></A
>struct GnomeCanvasEllipse</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeCanvasEllipse;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvasrect.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvastext.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
>GnomeCanvasRect</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeCanvasText</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeCanvasGroup</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeCanvasItem"
HREF="gnomecanvasitem.html"><LINK
REL="NEXT"
TITLE="GnomeCanvasLine"
HREF="gnomecanvasline.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvasitem.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvasline.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMECANVASGROUP"
>GnomeCanvasGroup</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN12010"
></A
><H2
>Name</H2
>GnomeCanvasGroup&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN12013"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomecanvasgroup.html#GNOMECANVASGROUP-STRUCT"
>GnomeCanvasGroup</A
>;
void        <A
HREF="gnomecanvasgroup.html#GNOME-CANVAS-GROUP-CHILD-BOUNDS"
>gnome_canvas_group_child_bounds</A
> (<A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
> *group,
                                             <A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12020"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>
         +----GnomeCanvasGroup</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12025"
></A
><H2
>Args</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  &quot;<A
HREF="gnomecanvasgroup.html#GNOMECANVASGROUP--X"
>x</A
>&quot;                    <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvasgroup.html#GNOMECANVASGROUP--Y"
>y</A
>&quot;                    <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12032"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12035"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN12037"
></A
><H3
><A
NAME="GNOMECANVASGROUP-STRUCT"
></A
>struct GnomeCanvasGroup</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeCanvasGroup;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN12042"
></A
><H3
><A
NAME="GNOME-CANVAS-GROUP-CHILD-BOUNDS"
></A
>gnome_canvas_group_child_bounds ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_group_child_bounds (<A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
> *group,
                                             <A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);</PRE
></TD
></TR
></TABLE
><P
>Deprecated.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN12050"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>group</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12063"
></A
><H2
>Args</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
NAME="GNOMECANVASGROUP--X"
></A
>&quot;<TT
CLASS="LITERAL"
>x</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASGROUP--Y"
></A
>&quot;<TT
CLASS="LITERAL"
>y</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvasitem.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvasline.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
>GnomeCanvasItem</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeCanvasLine</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeCanvas</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeCalculator"
HREF="gnomecalculator.html"><LINK
REL="NEXT"
TITLE="GnomeCanvasItem"
HREF="gnomecanvasitem.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecalculator.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvasitem.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMECANVAS"
>GnomeCanvas</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN10285"
></A
><H2
>Name</H2
>GnomeCanvas&nbsp;--&nbsp;  A generic engine for structured graphics.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN10288"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomecanvas.html#GNOMECANVAS-STRUCT"
>GnomeCanvas</A
>;
#define     <A
HREF="gnomecanvas.html#GNOME-CANVAS-EPSILON-CAPS"
>GNOME_CANVAS_EPSILON</A
>
#define     <A
HREF="gnomecanvas.html#GNOME-CANVAS-COLOR-CAPS"
>GNOME_CANVAS_COLOR</A
>              (r, g, b)
#define     <A
HREF="gnomecanvas.html#GNOME-CANVAS-COLOR-A-CAPS"
>GNOME_CANVAS_COLOR_A</A
>            (r, g, b, a)
typedef     <A
HREF="gnomecanvas.html#GNOMECANVASBUF"
>GnomeCanvasBuf</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomecanvas.html#GNOME-CANVAS-NEW"
>gnome_canvas_new</A
>                (void);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomecanvas.html#GNOME-CANVAS-NEW-AA"
>gnome_canvas_new_aa</A
>             (void);
<A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
>* <A
HREF="gnomecanvas.html#GNOME-CANVAS-ROOT"
>gnome_canvas_root</A
>         (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-SET-SCROLL-REGION"
>gnome_canvas_set_scroll_region</A
>  (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double x1,
                                             double y1,
                                             double x2,
                                             double y2);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-GET-SCROLL-REGION"
>gnome_canvas_get_scroll_region</A
>  (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double *x1,
                                             double *y1,
                                             double *x2,
                                             double *y2);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-SET-PIXELS-PER-UNIT"
>gnome_canvas_set_pixels_per_unit</A
>
                                            (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double n);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-SCROLL-TO"
>gnome_canvas_scroll_to</A
>          (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             int cx,
                                             int cy);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-GET-SCROLL-OFFSETS"
>gnome_canvas_get_scroll_offsets</A
> (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             int *cx,
                                             int *cy);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-UPDATE-NOW"
>gnome_canvas_update_now</A
>         (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas);
<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>* <A
HREF="gnomecanvas.html#GNOME-CANVAS-GET-ITEM-AT"
>gnome_canvas_get_item_at</A
>   (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double x,
                                             double y);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-REQUEST-REDRAW-UTA"
>gnome_canvas_request_redraw_uta</A
> (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             ArtUta *uta);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-REQUEST-REDRAW"
>gnome_canvas_request_redraw</A
>     (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             int x1,
                                             int y1,
                                             int x2,
                                             int y2);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-W2C-AFFINE"
>gnome_canvas_w2c_affine</A
>         (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double affine[6]);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-W2C"
>gnome_canvas_w2c</A
>                (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double wx,
                                             double wy,
                                             int *cx,
                                             int *cy);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-W2C-D"
>gnome_canvas_w2c_d</A
>              (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double wx,
                                             double wy,
                                             double *cx,
                                             double *cy);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-C2W"
>gnome_canvas_c2w</A
>                (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             int cx,
                                             int cy,
                                             double *wx,
                                             double *wy);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-WINDOW-TO-WORLD"
>gnome_canvas_window_to_world</A
>    (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double winx,
                                             double winy,
                                             double *worldx,
                                             double *worldy);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-WORLD-TO-WINDOW"
>gnome_canvas_world_to_window</A
>    (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double worldx,
                                             double worldy,
                                             double *winx,
                                             double *winy);
int         <A
HREF="gnomecanvas.html#GNOME-CANVAS-GET-COLOR"
>gnome_canvas_get_color</A
>          (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             const char *spec,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-SET-STIPPLE-ORIGIN"
>gnome_canvas_set_stipple_origin</A
> (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             <A
HREF=../gdk/gdk-graphics-contexts.html#GDKGC
>GdkGC</A> *gc);
void        <A
HREF="gnomecanvas.html#GNOME-CANVAS-SET-DITHER"
>gnome_canvas_set_dither</A
>         (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             <A
HREF=../gdk/gdk-gdkrgb.html#GDKRGBDITHER
>GdkRgbDither</A> dither);
<A
HREF=../gdk/gdk-gdkrgb.html#GDKRGBDITHER
>GdkRgbDither</A> <A
HREF="gnomecanvas.html#GNOME-CANVAS-GET-DITHER"
>gnome_canvas_get_dither</A
>        (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10375"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtklayout.html
>GtkLayout</A>
                     +----GnomeCanvas</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10382"
></A
><H2
>Description</H2
><P
>    The GNOME canvas is an engine for displaying structured graphics
    and simplifying the development of complex graphic-based
    applications.  
  </P
><DIV
CLASS="REFSECT2"
><A
NAME="AEN10385"
></A
><H3
>Canvas Items</H3
><P
>      The GNOME Canvas basic building blocks are the GNOME Canvas
      Items (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>): lines, rectangles, text, ellipses,
      polylines, images and embedded widgets.  You can use any of
      those directly in your application.
    </P
><P
>      The CanvasItem system is designed to be extensible.
      Applications can define their own <A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> objects for
      special purpose tasks.  For example, the GNOME Gnumeric
      spreadsheet defines a number of special Canvas Items that are
      specialized for the task of spreadsheets.
    </P
><P
>      Specialized canvas items allow the developer to write
      custom items that can adapt to their needs for speed,
      scalability and gives the user the power to extend the
      canvas. 
    </P
><P
>      Items on the canvas can be reconfigured by using the Gtk
      argument system.  Users can reconfigure the parameters of
      the canvas items and the changes on the parameters will be
      reflected immediately on the screen.
    </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10393"
></A
><H3
>Flicker free display</H3
><P
>      The GNOME Canvas uses off-screen buffers to render the images
      before transferring them to the screen.  Transfers can take
      place at the command of the programmer (by explicitly
      requesting a repaint update) or done automatically by the
      engine (during the idle look handler).
    </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10396"
></A
><H3
>Event dispatching</H3
><P
>Each 
      GnomeCanvasItem can receive mouse events, keyboard events,
      mouse-enter and mouse leave events.  In addition a canvas
      item can grab the mouse (for example to implement reliable
      dragging of objects).
    </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10399"
></A
><H3
>Canvas types</H3
><P
>      The Canvas can be run in two different modes: X11 mode and Art
      mode.  The mode is chosen at the creation time of the widget
      by either calling <A
HREF="gnomecanvas.html#GNOME-CANVAS-NEW"
>gnome_canvas_new</A
>() or <A
HREF="gnomecanvas.html#GNOME-CANVAS-NEW-AA"
>gnome_canvas_new_aa</A
>(),
      the former creates an X11 canvas, while the latter creates an
      Art-based canvas.
    </P
><P
>      The X11 mode uses the X server to draw the items and it takes
      advantage of the X server acceleration features for drawing on
      the screen.  The only drawback is that the output quality and
      the imaging model are restricted to the X11 quality and
      imaging model.
    </P
><P
>      The Art mode of the canvas has an advanced imaging model based
      on LibArt and it allows any GnomeCanvasItem (with the
      exception of the embedded widget item) to be rotated, scaled
      and translated (this is done by means of applying an affine
      transformation on the object).
    </P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10406"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN10408"
></A
><H3
><A
NAME="GNOMECANVAS-STRUCT"
></A
>struct GnomeCanvas</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeCanvas;</PRE
></TD
></TR
></TABLE
><P
>    Most of the fields in this structure are for private use only.
    However, canvas item implementations may make use of some of them.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10413"
></A
><H3
><A
NAME="GNOME-CANVAS-EPSILON-CAPS"
></A
>GNOME_CANVAS_EPSILON</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_CANVAS_EPSILON 1e-10</PRE
></TD
></TR
></TABLE
><P
>    This macro defines a &lsquo;small&rsquo; floating-point value for
    the internal computations that the canvas performs.  It can be
    used by item implementations as a test to see whether a number is
    &ldquo;almost zero&rdquo;.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10418"
></A
><H3
><A
NAME="GNOME-CANVAS-COLOR-CAPS"
></A
>GNOME_CANVAS_COLOR()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOME_CANVAS_COLOR(r, g, b)</PRE
></TD
></TR
></TABLE
><P
>    This macro is used to build a 32-bit integer with an RGB color
    specification.  The specified values must be integers in the range
    [0, 255].
  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10423"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>r</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Red component of the color.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>g</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Green component of the color.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Blue component of the color.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10440"
></A
><H3
><A
NAME="GNOME-CANVAS-COLOR-A-CAPS"
></A
>GNOME_CANVAS_COLOR_A()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOME_CANVAS_COLOR_A(r, g, b, a)</PRE
></TD
></TR
></TABLE
><P
>    This macro is used to build a 32-bit integer with an RGBA color
    specification.  This is the same as an RGB color specification,
    but with an added alpha or opacity value.  The specified values
    must be integers in the range [0, 255].
  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10445"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>r</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Red component of the color.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>g</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Green component of the color.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Blue component of the color.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>a</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Opacity component of the color.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10466"
></A
><H3
><A
NAME="GNOMECANVASBUF"
></A
>GnomeCanvasBuf</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct {
	/* 24-bit RGB buffer for rendering */
	guchar *buf;

	/* Rowstride for the buffer */
	int buf_rowstride;

	/* Rectangle describing the rendering area */
	ArtIRect rect;

	/* Background color, given as 0xrrggbb */
	guint32 bg_color;

	/* Invariant: at least one of the following flags is true. */

	/* Set when the render rectangle area is the solid color bg_color */
	unsigned int is_bg : 1;

	/* Set when the render rectangle area is represented by the buf */
	unsigned int is_buf : 1;
} GnomeCanvasBuf;</PRE
></TD
></TR
></TABLE
><P
>    This structure is passed to the <TT
CLASS="FUNCTION"
>render</TT
> method
    of canvas items when they need to paint themselves on an
    antialiased canvas.  The <TT
CLASS="STRUCTFIELD"
><I
>buf</I
></TT
> field
    points to a 24-bit RGB buffer for rendering.  The
    <TT
CLASS="STRUCTFIELD"
><I
>buf_rowstride</I
></TT
> field specifies the
    number of bytes in each row in the buffer, which should be used to
    calculate byte offsets inside it.  The buffer's pixel offsets in
    canvas pixel coordinates are given by the
    <TT
CLASS="STRUCTFIELD"
><I
>rect</I
></TT
> rectangle.  The
    <TT
CLASS="STRUCTFIELD"
><I
>is_bg</I
></TT
> and
    <TT
CLASS="STRUCTFIELD"
><I
>is_buf</I
></TT
> fields are flags that items can
    use to implement rendering optimizations, and they are used in
    conjunction with the <TT
CLASS="STRUCTFIELD"
><I
>bg_color</I
></TT
> field.
  </P
><P
>    The <TT
CLASS="STRUCTFIELD"
><I
>is_buf</I
></TT
> flag specifies whether the
    contents of the buffer are an accurate representation of the state
    of the canvas.  If this flag is true, then the RGB data in the
    <TT
CLASS="STRUCTFIELD"
><I
>buf</I
></TT
> is valid, that is, it contains
    meaningful data.
  </P
><P
>    The <TT
CLASS="STRUCTFIELD"
><I
>is_bg</I
></TT
> flag specifies whether the
    buffer has all its pixels set to the same color.  This allows
    canvas items to optimize for this case by doing alpha compositing
    for a smaller set of values than if the buffer had pixels of
    different colors.
  </P
><P
>    At least one of these flags is on at any one time.  The meaning of
    their combinations is as follows:

    <DIV
CLASS="TABLE"
><A
NAME="AEN10484"
></A
><P
><B
>Table 1. 	Values for <TT
CLASS="STRUCTFIELD"
><I
>is_bg</I
></TT
> and
	<TT
CLASS="STRUCTFIELD"
><I
>is_buf</I
></TT
>
      </B
></P
><TABLE
BORDER="1"
BGCOLOR="#FFFFFF"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><THEAD
><TR
><TH
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="STRUCTFIELD"
><I
>is_buf</I
></TT
></TH
><TH
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="STRUCTFIELD"
><I
>is_bg</I
></TT
></TH
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Meaning</TH
></TR
></THEAD
><TBODY
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="SYMBOL"
>FALSE</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="SYMBOL"
>TRUE</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>	      The buffer does not contain meaningful data.  However,
	      it should be considered as if it were filled with the
	      solid color specified in the
	      <TT
CLASS="STRUCTFIELD"
><I
>bg_color</I
></TT
> field.  Item
	      implementations may want to call
	      <TT
CLASS="FUNCTION"
><A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-BUF-ENSURE-BUF"
>gnome_canvas_buf_ensure_buf</A
>()</TT
> to
	      fill the buffer automatically.
	    </TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="SYMBOL"
>TRUE</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="SYMBOL"
>FALSE</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>	      The buffer contains meaningful data and not all of its
	      pixels may be the same color.  Item implementations can
	      use the buffer data as-is for alpha compositing.
	    </TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="SYMBOL"
>TRUE</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><SPAN
CLASS="SYMBOL"
>TRUE</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>	      The buffer contains meaningful data, and all the pixels
	      are of the same color.  Item implementations can use the
	      buffer data as-is for alpha compositing, or be smarter
	      and do less operations since they can just composite
	      over a single color.
	    </TD
></TR
></TBODY
></TABLE
></DIV
>
  </P
><P
>    Whenever an item paints to an RGB buffer in which the
    <TT
CLASS="STRUCTFIELD"
><I
>is_bg</I
></TT
> field was true, the item is then
    responsible for turning off this flag if it knows that the result
    will not be pixels all of the same color.  If a large item, like a
    solid rectangle, knows that it will be filling the buffer with a
    solid color, then it take any one of the following actions:

    <P
></P
><UL
><LI
><P
>	  Fill the actual pixels in the buffer with the solid color
	  and turn off the <TT
CLASS="STRUCTFIELD"
><I
>is_bg</I
></TT
> flag.  It
	  should then turn on the <TT
CLASS="STRUCTFIELD"
><I
>is_buf</I
></TT
>
	  flag.
	</P
></LI
><LI
><P
>	  Fill the actual pixels in the buffer with the solid color,
	  set the <TT
CLASS="STRUCTFIELD"
><I
>bg_color</I
></TT
> field to that
	  same color, and turn on both the
	  <TT
CLASS="STRUCTFIELD"
><I
>is_bg</I
></TT
> and
	  <TT
CLASS="STRUCTFIELD"
><I
>is_buf</I
></TT
> flags.  This is correct,
	  but is wasteful, since it could have done just the following
	  instead.
	</P
></LI
><LI
><P
>	  Just set the <TT
CLASS="STRUCTFIELD"
><I
>bg_color</I
></TT
> to the
	  solid color, turn on the <TT
CLASS="STRUCTFIELD"
><I
>is_bg</I
></TT
>
	  flag, and turn off the <TT
CLASS="STRUCTFIELD"
><I
>is_buf</I
></TT
>
	  flag.  This means that the buffer does not contain the
	  actual meaningful data, and the next item to be repainted
	  should look at the solid color instead.  This is the most
	  efficient version.
	</P
></LI
></UL
>
  </P
><P
>    Most item implementations may only need to perform the actions for
    the first case described above.  The other two are simply
    optimizations they can perform.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10536"
></A
><H3
><A
NAME="GNOME-CANVAS-NEW"
></A
>gnome_canvas_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_canvas_new                (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a new empty canvas in non-antialiased mode.  If you wish to use the
&amp;GnomeCanvasImage item inside this canvas, then you must push the gdk_imlib
visual and colormap before calling this function, and they can be popped
afterwards.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10543"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A newly-created canvas.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10552"
></A
><H3
><A
NAME="GNOME-CANVAS-NEW-AA"
></A
>gnome_canvas_new_aa ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_canvas_new_aa             (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a new empty canvas in antialiased mode.  You should push the GdkRGB
visual and colormap before calling this functions, and they can be popped
afterwards.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10559"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A newly-created antialiased canvas.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10568"
></A
><H3
><A
NAME="GNOME-CANVAS-ROOT"
></A
>gnome_canvas_root ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
>* gnome_canvas_root         (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas);</PRE
></TD
></TR
></TABLE
><P
>Queries the root group of a canvas.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10576"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The root group of the specified canvas.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10589"
></A
><H3
><A
NAME="GNOME-CANVAS-SET-SCROLL-REGION"
></A
>gnome_canvas_set_scroll_region ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_set_scroll_region  (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double x1,
                                             double y1,
                                             double x2,
                                             double y2);</PRE
></TD
></TR
></TABLE
><P
>Sets the scrolling region of a canvas to the specified rectangle.  The canvas
will then be able to scroll only within this region.  The view of the canvas
is adjusted as appropriate to display as much of the new region as possible.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10600"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Leftmost limit of the scrolling region.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Upper limit of the scrolling region.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Rightmost limit of the scrolling region.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Lower limit of the scrolling region.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10625"
></A
><H3
><A
NAME="GNOME-CANVAS-GET-SCROLL-REGION"
></A
>gnome_canvas_get_scroll_region ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_get_scroll_region  (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double *x1,
                                             double *y1,
                                             double *x2,
                                             double *y2);</PRE
></TD
></TR
></TABLE
><P
>Queries the scrolling region of a canvas.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10636"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Leftmost limit of the scrolling region (return value).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Upper limit of the scrolling region (return value).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Rightmost limit of the scrolling region (return value).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Lower limit of the scrolling region (return value).</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10661"
></A
><H3
><A
NAME="GNOME-CANVAS-SET-PIXELS-PER-UNIT"
></A
>gnome_canvas_set_pixels_per_unit ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_set_pixels_per_unit
                                            (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double n);</PRE
></TD
></TR
></TABLE
><P
>Sets the zooming factor of a canvas by specifying the number of pixels that
correspond to one canvas unit.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10669"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>n</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The number of pixels that correspond to one canvas unit.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10682"
></A
><H3
><A
NAME="GNOME-CANVAS-SCROLL-TO"
></A
>gnome_canvas_scroll_to ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_scroll_to          (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             int cx,
                                             int cy);</PRE
></TD
></TR
></TABLE
><P
>Makes a canvas scroll to the specified offsets, given in canvas pixel units.
The canvas will adjust the view so that it is not outside the scrolling
region.  This function is typically not used, as it is better to hook
scrollbars to the canvas layout's scrolling adjusments.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10689"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Horizontal scrolling offset in canvas pixel units.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Vertical scrolling offset in canvas pixel units.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10706"
></A
><H3
><A
NAME="GNOME-CANVAS-GET-SCROLL-OFFSETS"
></A
>gnome_canvas_get_scroll_offsets ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_get_scroll_offsets (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             int *cx,
                                             int *cy);</PRE
></TD
></TR
></TABLE
><P
>Queries the scrolling offsets of a canvas.  The values are returned in canvas
pixel units.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10713"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Horizontal scrolling offset (return value).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Vertical scrolling offset (return value).</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10730"
></A
><H3
><A
NAME="GNOME-CANVAS-UPDATE-NOW"
></A
>gnome_canvas_update_now ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_update_now         (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas);</PRE
></TD
></TR
></TABLE
><P
>Forces an immediate update and redraw of a canvas.  If the canvas does not
have any pending update or redraw requests, then no action is taken.  This is
typically only used by applications that need explicit control of when the
display is updated, like games.  It is not needed by normal applications.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10737"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10746"
></A
><H3
><A
NAME="GNOME-CANVAS-GET-ITEM-AT"
></A
>gnome_canvas_get_item_at ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>* gnome_canvas_get_item_at   (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double x,
                                             double y);</PRE
></TD
></TR
></TABLE
><P
>Looks for the item that is under the specified position, which must be
specified in world coordinates.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10756"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X position in world coordinates.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y position in world coordinates.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The sought item, or NULL if no item is at the specified
coordinates.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10777"
></A
><H3
><A
NAME="GNOME-CANVAS-REQUEST-REDRAW-UTA"
></A
>gnome_canvas_request_redraw_uta ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_request_redraw_uta (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             ArtUta *uta);</PRE
></TD
></TR
></TABLE
><P
>Informs a canvas that the specified area, given as a microtile array, needs
to be repainted.  To be used only by item implementations.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10785"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uta</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Microtile array that specifies the area to be redrawn.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10798"
></A
><H3
><A
NAME="GNOME-CANVAS-REQUEST-REDRAW"
></A
>gnome_canvas_request_redraw ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_request_redraw     (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             int x1,
                                             int y1,
                                             int x2,
                                             int y2);</PRE
></TD
></TR
></TABLE
><P
>Convenience function that informs a canvas that the specified rectangle needs
to be repainted.  This function converts the rectangle to a microtile array
and feeds it to <A
HREF="gnomecanvas.html#GNOME-CANVAS-REQUEST-REDRAW-UTA"
>gnome_canvas_request_redraw_uta</A
>().  The rectangle includes
<TT
CLASS="PARAMETER"
><I
>x1</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>y1</I
></TT
>, but not <TT
CLASS="PARAMETER"
><I
>x2</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>y2</I
></TT
>.  To be used only by item implementations.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10810"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Leftmost coordinate of the rectangle to be redrawn.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Upper coordinate of the rectangle to be redrawn.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Rightmost coordinate of the rectangle to be redrawn, plus 1.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Lower coordinate of the rectangle to be redrawn, plus 1.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10835"
></A
><H3
><A
NAME="GNOME-CANVAS-W2C-AFFINE"
></A
>gnome_canvas_w2c_affine ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_w2c_affine         (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double affine[6]);</PRE
></TD
></TR
></TABLE
><P
>Gets the affine transform that converts from world coordinates to canvas
pixel coordinates.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10843"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>affine</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An affine transformation matrix (return value).</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10856"
></A
><H3
><A
NAME="GNOME-CANVAS-W2C"
></A
>gnome_canvas_w2c ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_w2c                (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double wx,
                                             double wy,
                                             int *cx,
                                             int *cy);</PRE
></TD
></TR
></TABLE
><P
>Converts world coordinates into canvas pixel coordinates.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10865"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>wx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> World X coordinate.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>wy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> World Y coordinate.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X pixel coordinate (return value).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y pixel coordinate (return value).</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10890"
></A
><H3
><A
NAME="GNOME-CANVAS-W2C-D"
></A
>gnome_canvas_w2c_d ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_w2c_d              (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double wx,
                                             double wy,
                                             double *cx,
                                             double *cy);</PRE
></TD
></TR
></TABLE
><P
>Converts world coordinates into canvas pixel coordinates.  This version</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10901"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>wx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> World X coordinate.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>wy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> World Y coordinate.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X pixel coordinate (return value).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y pixel coordinate (return value).</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10926"
></A
><H3
><A
NAME="GNOME-CANVAS-C2W"
></A
>gnome_canvas_c2w ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_c2w                (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             int cx,
                                             int cy,
                                             double *wx,
                                             double *wy);</PRE
></TD
></TR
></TABLE
><P
>Converts canvas pixel coordinates to world coordinates.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10935"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Canvas pixel X coordinate.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Canvas pixel Y coordinate.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>wx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X world coordinate (return value).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>wy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y world coordinate (return value).</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10960"
></A
><H3
><A
NAME="GNOME-CANVAS-WINDOW-TO-WORLD"
></A
>gnome_canvas_window_to_world ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_window_to_world    (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double winx,
                                             double winy,
                                             double *worldx,
                                             double *worldy);</PRE
></TD
></TR
></TABLE
><P
>Converts window-relative coordinates into world coordinates.  You can use
this when you need to convert mouse coordinates into world coordinates, for
example.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN10971"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>winx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Window-relative X coordinate.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>winy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Window-relative Y coordinate.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>worldx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X world coordinate (return value).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>worldy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y world coordinate (return value).</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN10996"
></A
><H3
><A
NAME="GNOME-CANVAS-WORLD-TO-WINDOW"
></A
>gnome_canvas_world_to_window ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_world_to_window    (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             double worldx,
                                             double worldy,
                                             double *winx,
                                             double *winy);</PRE
></TD
></TR
></TABLE
><P
>Converts world coordinates into window-relative coordinates.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11007"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>worldx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> World X coordinate.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>worldy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> World Y coordinate.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>winx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X window-relative coordinate.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>winy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y window-relative coordinate.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11032"
></A
><H3
><A
NAME="GNOME-CANVAS-GET-COLOR"
></A
>gnome_canvas_get_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_canvas_get_color          (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             const char *spec,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
>Allocates a color based on the specified X color specification.  As a
convenience to item implementations, it returns TRUE if the color was
allocated, or FALSE if the specification was NULL.  A NULL color
specification is considered as "transparent" by the canvas.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11040"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>spec</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X color specification, or NULL for "transparent".</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Returns the allocated color.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> TRUE if <TT
CLASS="PARAMETER"
><I
>spec</I
></TT
> is non-NULL and the color is allocated.  If <TT
CLASS="PARAMETER"
><I
>spec</I
></TT
>
is NULL, then returns FALSE.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11063"
></A
><H3
><A
NAME="GNOME-CANVAS-SET-STIPPLE-ORIGIN"
></A
>gnome_canvas_set_stipple_origin ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_set_stipple_origin (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             <A
HREF=../gdk/gdk-graphics-contexts.html#GDKGC
>GdkGC</A> *gc);</PRE
></TD
></TR
></TABLE
><P
>Sets the stipple origin of the specified GC as is appropriate for the canvas,
so that it will be aligned with other stipple patterns used by canvas items.
This is typically only needed by item implementations.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11071"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GC on which to set the stipple origin.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11084"
></A
><H3
><A
NAME="GNOME-CANVAS-SET-DITHER"
></A
>gnome_canvas_set_dither ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_set_dither         (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             <A
HREF=../gdk/gdk-gdkrgb.html#GDKRGBDITHER
>GdkRgbDither</A> dither);</PRE
></TD
></TR
></TABLE
><P
>Controls dithered rendering for antialiased canvases. The value of dither
should be; GDK_RGB_DITHER_NONE, GDK_RGB_DITHER_NORMAL, or
GDK_RGB_DITHER_MAX. The default canvas setting is GDK_RGB_DITHER_NORMAL.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11096"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dither</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Type of dither used to render an antialiased canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11113"
></A
><H3
><A
NAME="GNOME-CANVAS-GET-DITHER"
></A
>gnome_canvas_get_dither ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gdk/gdk-gdkrgb.html#GDKRGBDITHER
>GdkRgbDither</A> gnome_canvas_get_dither        (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas);</PRE
></TD
></TR
></TABLE
><P
>Returns the type of dithering used to render an antialiased canvas.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11121"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The dither setting.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN11134"
></A
><H2
>See Also</H2
><P
>    <A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>, <A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
>, GnomeCanvasRE,
    GnomeCanvasRectEllipse, <A
HREF="gnomecanvasimage.html"
>GnomeCanvasImage</A
>, <A
HREF="gnomecanvasline.html"
>GnomeCanvasLine</A
>,
    <A
HREF="gnomecanvaspolygon.html"
>GnomeCanvasPolygon</A
>, <A
HREF="gnomecanvastext.html"
>GnomeCanvasText</A
>, <A
HREF="gnomecanvaswidget.html"
>GnomeCanvasWidget</A
>
  </P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecalculator.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvasitem.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
>GnomeCalculator</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeCanvasItem</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeCanvasImage</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeCanvasText"
HREF="gnomecanvastext.html"><LINK
REL="NEXT"
TITLE="GnomeCanvasWidget"
HREF="gnomecanvaswidget.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvastext.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvaswidget.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMECANVASIMAGE"
>GnomeCanvasImage</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN12816"
></A
><H2
>Name</H2
>GnomeCanvasImage&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN12819"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomecanvasimage.html#GNOMECANVASIMAGE-STRUCT"
>GnomeCanvasImage</A
>;&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12823"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>
         +----GnomeCanvasImage</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12828"
></A
><H2
>Args</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  &quot;<A
HREF="gnomecanvasimage.html#GNOMECANVASIMAGE--PIXBUF"
>pixbuf</A
>&quot;               GtkBoxed             : Write
  &quot;<A
HREF="gnomecanvasimage.html#GNOMECANVASIMAGE--X"
>x</A
>&quot;                    <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvasimage.html#GNOMECANVASIMAGE--Y"
>y</A
>&quot;                    <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvasimage.html#GNOMECANVASIMAGE--WIDTH"
>width</A
>&quot;                <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvasimage.html#GNOMECANVASIMAGE--HEIGHT"
>height</A
>&quot;               <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvasimage.html#GNOMECANVASIMAGE--ANCHOR"
>anchor</A
>&quot;               <A
HREF=../gtk/gtkpacker.html#GTKANCHORTYPE
>GtkAnchorType</A>        : Read / Write</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12843"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12846"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN12848"
></A
><H3
><A
NAME="GNOMECANVASIMAGE-STRUCT"
></A
>struct GnomeCanvasImage</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeCanvasImage;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12853"
></A
><H2
>Args</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
NAME="GNOMECANVASIMAGE--PIXBUF"
></A
>&quot;<TT
CLASS="LITERAL"
>pixbuf</TT
>&quot; (GtkBoxed : Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASIMAGE--X"
></A
>&quot;<TT
CLASS="LITERAL"
>x</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASIMAGE--Y"
></A
>&quot;<TT
CLASS="LITERAL"
>y</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASIMAGE--WIDTH"
></A
>&quot;<TT
CLASS="LITERAL"
>width</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASIMAGE--HEIGHT"
></A
>&quot;<TT
CLASS="LITERAL"
>height</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASIMAGE--ANCHOR"
></A
>&quot;<TT
CLASS="LITERAL"
>anchor</TT
>&quot; (<A
HREF=../gtk/gtkpacker.html#GTKANCHORTYPE
>GtkAnchorType</A> : Read / Write)</DT
><DD
><P
></P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvastext.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvaswidget.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
>GnomeCanvasText</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeCanvasWidget</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeCanvasItem</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeCanvas"
HREF="gnomecanvas.html"><LINK
REL="NEXT"
TITLE="GnomeCanvasGroup"
HREF="gnomecanvasgroup.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvas.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvasgroup.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMECANVASITEM"
>GnomeCanvasItem</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN11150"
></A
><H2
>Name</H2
>GnomeCanvasItem&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN11153"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomecanvasitem.html#GNOMECANVASITEM-STRUCT"
>GnomeCanvasItem</A
>;
<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>* <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-NEW"
>gnome_canvas_item_new</A
>      (<A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
> *parent,
                                             <A
HREF=../gtk/gtk-types.html#GTKTYPE
>GtkType</A> type,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *first_arg_name,
                                             ...);
<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>* <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-NEWV"
>gnome_canvas_item_newv</A
>     (<A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
> *parent,
                                             <A
HREF=../gtk/gtk-types.html#GTKTYPE
>GtkType</A> type,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> nargs,
                                             <A
HREF=../gtk/gtk-types.html#GTKARG
>GtkArg</A> *args);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-CONSTRUCT"
>gnome_canvas_item_construct</A
>     (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             <A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
> *parent,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *first_arg_name,
                                             va_list args);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-CONSTRUCTV"
>gnome_canvas_item_constructv</A
>    (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             <A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
> *parent,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> nargs,
                                             <A
HREF=../gtk/gtk-types.html#GTKARG
>GtkArg</A> *args);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-SET"
>gnome_canvas_item_set</A
>           (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *first_arg_name,
                                             ...);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-SETV"
>gnome_canvas_item_setv</A
>          (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> nargs,
                                             <A
HREF=../gtk/gtk-types.html#GTKARG
>GtkArg</A> *args);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-SET-VALIST"
>gnome_canvas_item_set_valist</A
>    (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *first_arg_name,
                                             va_list args);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-MOVE"
>gnome_canvas_item_move</A
>          (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double dx,
                                             double dy);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-AFFINE-RELATIVE"
>gnome_canvas_item_affine_relative</A
>
                                            (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             const double affine[6]);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-AFFINE-ABSOLUTE"
>gnome_canvas_item_affine_absolute</A
>
                                            (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             const double affine[6]);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-SCALE"
>gnome_canvas_item_scale</A
>         (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double x,
                                             double y,
                                             double scale_x,
                                             double scale_y);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-ROTATE"
>gnome_canvas_item_rotate</A
>        (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double x,
                                             double y,
                                             double angle);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-RAISE"
>gnome_canvas_item_raise</A
>         (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             int positions);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-LOWER"
>gnome_canvas_item_lower</A
>         (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             int positions);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-RAISE-TO-TOP"
>gnome_canvas_item_raise_to_top</A
>  (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-LOWER-TO-BOTTOM"
>gnome_canvas_item_lower_to_bottom</A
>
                                            (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-SHOW"
>gnome_canvas_item_show</A
>          (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-HIDE"
>gnome_canvas_item_hide</A
>          (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);
int         <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-GRAB"
>gnome_canvas_item_grab</A
>          (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             unsigned int event_mask,
                                             <A
HREF=../gdk/gdk-cursors.html#GDKCURSOR
>GdkCursor</A> *cursor,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> etime);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-UNGRAB"
>gnome_canvas_item_ungrab</A
>        (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> etime);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-W2I"
>gnome_canvas_item_w2i</A
>           (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double *x,
                                             double *y);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-I2W"
>gnome_canvas_item_i2w</A
>           (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double *x,
                                             double *y);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-I2W-AFFINE"
>gnome_canvas_item_i2w_affine</A
>    (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double affine[6]);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-I2C-AFFINE"
>gnome_canvas_item_i2c_affine</A
>    (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double affine[6]);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-REPARENT"
>gnome_canvas_item_reparent</A
>      (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             <A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
> *new_group);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-GRAB-FOCUS"
>gnome_canvas_item_grab_focus</A
>    (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-GET-BOUNDS"
>gnome_canvas_item_get_bounds</A
>    (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double *x1,
                                             double *y1,
                                             double *x2,
                                             double *y2);
void        <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-REQUEST-UPDATE"
>gnome_canvas_item_request_update</A
>
                                            (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN11254"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----GnomeCanvasItem</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN11258"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomecanvasitem.html#GNOMECANVASITEM-EVENT"
>event</A
>&quot;     <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function      (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *canvasitem,
                                            <A
HREF=../gdk/gdk-event-structures.html#GDKEVENT
>GdkEvent</A> *event,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN11266"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN11269"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN11271"
></A
><H3
><A
NAME="GNOMECANVASITEM-STRUCT"
></A
>struct GnomeCanvasItem</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeCanvasItem;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11276"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-NEW"
></A
>gnome_canvas_item_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>* gnome_canvas_item_new      (<A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
> *parent,
                                             <A
HREF=../gtk/gtk-types.html#GTKTYPE
>GtkType</A> type,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *first_arg_name,
                                             ...);</PRE
></TD
></TR
></TABLE
><P
>Creates a new canvas item with <TT
CLASS="PARAMETER"
><I
>parent</I
></TT
> as its parent group.  The item is
created at the top of its parent's stack, and starts up as visible.  The item
is of the specified <TT
CLASS="PARAMETER"
><I
>type</I
></TT
>, for example, it can be
gnome_canvas_rect_get_type().  The list of object arguments/value pairs is
used to configure the item.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11289"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The parent group for the new item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The object type of the item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>first_arg_name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A list of object argument name/value pairs, NULL-terminated,
used to configure the item.  For example, "fill_color", "black",
"width_units", 5.0, NULL.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>...</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The newly-created item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11314"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-NEWV"
></A
>gnome_canvas_item_newv ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>* gnome_canvas_item_newv     (<A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
> *parent,
                                             <A
HREF=../gtk/gtk-types.html#GTKTYPE
>GtkType</A> type,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> nargs,
                                             <A
HREF=../gtk/gtk-types.html#GTKARG
>GtkArg</A> *args);</PRE
></TD
></TR
></TABLE
><P
>Creates a new canvas item with <TT
CLASS="PARAMETER"
><I
>parent</I
></TT
> as its parent group.  The item is
created at the top of its parent's stack, and starts up as visible.  The item
is of the specified <TT
CLASS="PARAMETER"
><I
>type</I
></TT
>, for example, it can be
gnome_canvas_rect_get_type().  The list of object arguments is used to
configure the item.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11328"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The parent group for the new item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The object type of the item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nargs</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The number of arguments used to configure the item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>args</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The list of arguments used to configure the item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The newly-created item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11353"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-CONSTRUCT"
></A
>gnome_canvas_item_construct ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_construct     (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             <A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
> *parent,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *first_arg_name,
                                             va_list args);</PRE
></TD
></TR
></TABLE
><P
>Constructs a canvas item; meant for use only by item implementations.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11362"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An unconstructed canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The parent group for the item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>first_arg_name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The name of the first argument for configuring the item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>args</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The list of arguments used to configure the item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11383"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-CONSTRUCTV"
></A
>gnome_canvas_item_constructv ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_constructv    (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             <A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
> *parent,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> nargs,
                                             <A
HREF=../gtk/gtk-types.html#GTKARG
>GtkArg</A> *args);</PRE
></TD
></TR
></TABLE
><P
>Constructs a canvas item; meant for use only by item implementations.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11393"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An unconstructed canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The parent group for the item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nargs</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The number of arguments used to configure the item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>args</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The list of arguments used to configure the item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11414"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-SET"
></A
>gnome_canvas_item_set ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_set           (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *first_arg_name,
                                             ...);</PRE
></TD
></TR
></TABLE
><P
>Configures a canvas item.  The arguments in the item are set to the specified
values, and the item is repainted as appropriate.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11422"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>first_arg_name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The list of object argument name/value pairs used to configure the item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>...</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11439"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-SETV"
></A
>gnome_canvas_item_setv ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_setv          (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> nargs,
                                             <A
HREF=../gtk/gtk-types.html#GTKARG
>GtkArg</A> *args);</PRE
></TD
></TR
></TABLE
><P
>Configures a canvas item.  The arguments in the item are set to the specified
values, and the item is repainted as appropriate.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11448"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nargs</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The number of arguments used to configure the item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>args</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The arguments used to configure the item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11465"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-SET-VALIST"
></A
>gnome_canvas_item_set_valist ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_set_valist    (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *first_arg_name,
                                             va_list args);</PRE
></TD
></TR
></TABLE
><P
>Configures a canvas item.  The arguments in the item are set to the specified
values, and the item is repainted as appropriate.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11473"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>first_arg_name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The name of the first argument used to configure the item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>var_args</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11490"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-MOVE"
></A
>gnome_canvas_item_move ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_move          (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double dx,
                                             double dy);</PRE
></TD
></TR
></TABLE
><P
>Moves a canvas item by creating an affine transformation matrix for
translation by using the specified values.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11499"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Horizontal offset.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Vertical offset.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11516"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-AFFINE-RELATIVE"
></A
>gnome_canvas_item_affine_relative ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_affine_relative
                                            (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             const double affine[6]);</PRE
></TD
></TR
></TABLE
><P
>Combines the specified affine transformation matrix with the item's current
transformation.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11524"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>affine</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An affine transformation matrix.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11537"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-AFFINE-ABSOLUTE"
></A
>gnome_canvas_item_affine_absolute ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_affine_absolute
                                            (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             const double affine[6]);</PRE
></TD
></TR
></TABLE
><P
>Makes the item's affine transformation matrix be equal to the specified
matrix.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11545"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>affine</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An affine transformation matrix.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11558"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-SCALE"
></A
>gnome_canvas_item_scale ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_scale         (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double x,
                                             double y,
                                             double scale_x,
                                             double scale_y);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11568"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>scale_x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>scale_y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11593"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-ROTATE"
></A
>gnome_canvas_item_rotate ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_rotate        (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double x,
                                             double y,
                                             double angle);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11602"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>angle</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11623"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-RAISE"
></A
>gnome_canvas_item_raise ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_raise         (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             int positions);</PRE
></TD
></TR
></TABLE
><P
>Raises the item in its parent's stack by the specified number of positions.
If the number of positions is greater than the distance to the top of the
stack, then the item is put at the top.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11630"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>positions</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of steps to raise the item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11643"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-LOWER"
></A
>gnome_canvas_item_lower ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_lower         (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             int positions);</PRE
></TD
></TR
></TABLE
><P
>Lowers the item in its parent's stack by the specified number of positions.
If the number of positions is greater than the distance to the bottom of the
stack, then the item is put at the bottom.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11650"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>positions</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of steps to lower the item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11663"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-RAISE-TO-TOP"
></A
>gnome_canvas_item_raise_to_top ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_raise_to_top  (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);</PRE
></TD
></TR
></TABLE
><P
>Raises an item to the top of its parent's stack.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11670"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11679"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-LOWER-TO-BOTTOM"
></A
>gnome_canvas_item_lower_to_bottom ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_lower_to_bottom
                                            (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);</PRE
></TD
></TR
></TABLE
><P
>Lowers an item to the bottom of its parent's stack.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11686"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11695"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-SHOW"
></A
>gnome_canvas_item_show ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_show          (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);</PRE
></TD
></TR
></TABLE
><P
>Shows a canvas item.  If the item was already shown, then no action is taken.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11702"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11711"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-HIDE"
></A
>gnome_canvas_item_hide ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_hide          (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);</PRE
></TD
></TR
></TABLE
><P
>Hides a canvas item.  If the item was already hidden, then no action is
taken.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11718"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11727"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-GRAB"
></A
>gnome_canvas_item_grab ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_canvas_item_grab          (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             unsigned int event_mask,
                                             <A
HREF=../gdk/gdk-cursors.html#GDKCURSOR
>GdkCursor</A> *cursor,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> etime);</PRE
></TD
></TR
></TABLE
><P
>Specifies that all events that match the specified event mask should be sent
to the specified item, and also grabs the mouse by calling
<A
HREF=../gdk/gdk-general.html#GDK-POINTER-GRAB
>gdk_pointer_grab</A>().  The event mask is also used when grabbing the pointer.
If <TT
CLASS="PARAMETER"
><I
>cursor</I
></TT
> is not NULL, then that cursor is used while the grab is active.
The <TT
CLASS="PARAMETER"
><I
>etime</I
></TT
> parameter is the timestamp required for grabbing the mouse.</P
><P
>Return value: If an item was already grabbed, it returns <TT
CLASS="LITERAL"
>AlreadyGrabbed</TT
>.  If
the specified item was hidden by calling <A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-HIDE"
>gnome_canvas_item_hide</A
>(), then it</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11742"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>event_mask</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Mask of events that will be sent to this item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cursor</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> If non-NULL, the cursor that will be used while the grab is active.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>etime</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The timestamp required for grabbing the mouse, or GDK_CURRENT_TIME.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>GrabNotViewable</TT
>.  Else, it returns the result of calling
<A
HREF=../gdk/gdk-general.html#GDK-POINTER-GRAB
>gdk_pointer_grab</A>().</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11769"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-UNGRAB"
></A
>gnome_canvas_item_ungrab ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_ungrab        (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> etime);</PRE
></TD
></TR
></TABLE
><P
>Ungrabs the item, which must have been grabbed in the canvas, and ungrabs the
mouse.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11777"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item that holds a grab.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>etime</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The timestamp for ungrabbing the mouse.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11790"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-W2I"
></A
>gnome_canvas_item_w2i ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_w2i           (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double *x,
                                             double *y);</PRE
></TD
></TR
></TABLE
><P
>Converts a coordinate pair from world coordinates to item-relative
coordinates.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11799"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate to convert (input/output value).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate to convert (input/output value).</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11816"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-I2W"
></A
>gnome_canvas_item_i2w ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_i2w           (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double *x,
                                             double *y);</PRE
></TD
></TR
></TABLE
><P
>Converts a coordinate pair from item-relative coordinates to world
coordinates.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11825"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate to convert (input/output value).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate to convert (input/output value).</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11842"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-I2W-AFFINE"
></A
>gnome_canvas_item_i2w_affine ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_i2w_affine    (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double affine[6]);</PRE
></TD
></TR
></TABLE
><P
>Gets the affine transform that converts from the item's coordinate system to
world coordinates.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11850"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>affine</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An affine transformation matrix (return value).</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11863"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-I2C-AFFINE"
></A
>gnome_canvas_item_i2c_affine ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_i2c_affine    (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double affine[6]);</PRE
></TD
></TR
></TABLE
><P
>Gets the affine transform that converts from item-relative coordinates to
canvas pixel coordinates.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11871"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>affine</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An affine transformation matrix (return value).</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11884"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-REPARENT"
></A
>gnome_canvas_item_reparent ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_reparent      (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             <A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
> *new_group);</PRE
></TD
></TR
></TABLE
><P
>Changes the parent of the specified item to be the new group.  The item keeps
its group-relative coordinates as for its old parent, so the item may change
its absolute position within the canvas.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11892"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_group</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas group.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11905"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-GRAB-FOCUS"
></A
>gnome_canvas_item_grab_focus ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_grab_focus    (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);</PRE
></TD
></TR
></TABLE
><P
>Makes the specified item take the keyboard focus, so all keyboard events will
be sent to it.  If the canvas widget itself did not have the focus, it grabs
it as well.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11912"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11921"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-GET-BOUNDS"
></A
>gnome_canvas_item_get_bounds ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_get_bounds    (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             double *x1,
                                             double *y1,
                                             double *x2,
                                             double *y2);</PRE
></TD
></TR
></TABLE
><P
>Queries the bounding box of a canvas item.  The bounds are returned in the
coordinate system of the item's parent.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11932"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Leftmost edge of the bounding box (return value).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Upper edge of the bounding box (return value).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Rightmost edge of the bounding box (return value).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Lower edge of the bounding box (return value).</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11957"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-REQUEST-UPDATE"
></A
>gnome_canvas_item_request_update ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_request_update
                                            (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);</PRE
></TD
></TR
></TABLE
><P
>To be used only by item implementations.  Requests that the canvas queue an
update for the specified item.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11964"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN11973"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN11975"
></A
><H3
><A
NAME="GNOMECANVASITEM-EVENT"
></A
>The &quot;event&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function                  (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *canvasitem,
                                            <A
HREF=../gdk/gdk-event-structures.html#GDKEVENT
>GdkEvent</A> *event,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN11984"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvasitem</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>event</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvas.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvasgroup.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
>GnomeCanvas</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeCanvasGroup</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeCanvasLine</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeCanvasGroup"
HREF="gnomecanvasgroup.html"><LINK
REL="NEXT"
TITLE="GnomeCanvasPolygon"
HREF="gnomecanvaspolygon.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvasgroup.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvaspolygon.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMECANVASLINE"
>GnomeCanvasLine</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN12085"
></A
><H2
>Name</H2
>GnomeCanvasLine&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN12088"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomecanvasline.html#GNOMECANVASLINE-STRUCT"
>GnomeCanvasLine</A
>;&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12092"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>
         +----GnomeCanvasLine</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12097"
></A
><H2
>Args</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--FILL-COLOR"
>fill-color</A
>&quot;           <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*               : Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--FILL-COLOR-GDK"
>fill-color-gdk</A
>&quot;       <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A>             : Read / Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--FILL-COLOR-RGBA"
>fill-color-rgba</A
>&quot;      <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>                : Read / Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--FILL-STIPPLE"
>fill-stipple</A
>&quot;         <A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A>            : Read / Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--WIDTH-PIXELS"
>width-pixels</A
>&quot;         <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>                : Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--WIDTH-UNITS"
>width-units</A
>&quot;          <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--CAP-STYLE"
>cap-style</A
>&quot;            <A
HREF=../gdk/gdk-graphics-contexts.html#GDKCAPSTYLE
>GdkCapStyle</A>          : Read / Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--JOIN-STYLE"
>join-style</A
>&quot;           <A
HREF=../gdk/gdk-graphics-contexts.html#GDKJOINSTYLE
>GdkJoinStyle</A>         : Read / Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--LINE-STYLE"
>line-style</A
>&quot;           <A
HREF=../gdk/gdk-graphics-contexts.html#GDKLINESTYLE
>GdkLineStyle</A>         : Read / Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--FIRST-ARROWHEAD"
>first-arrowhead</A
>&quot;      <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>             : Read / Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--LAST-ARROWHEAD"
>last-arrowhead</A
>&quot;       <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>             : Read / Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--SMOOTH"
>smooth</A
>&quot;               <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>             : Read / Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--SPLINE-STEPS"
>spline-steps</A
>&quot;         <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>                : Read / Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--ARROW-SHAPE-A"
>arrow-shape-a</A
>&quot;        <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--ARROW-SHAPE-B"
>arrow-shape-b</A
>&quot;        <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvasline.html#GNOMECANVASLINE--ARROW-SHAPE-C"
>arrow-shape-c</A
>&quot;        <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12132"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12135"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN12137"
></A
><H3
><A
NAME="GNOMECANVASLINE-STRUCT"
></A
>struct GnomeCanvasLine</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeCanvasLine;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12142"
></A
><H2
>Args</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
NAME="GNOMECANVASLINE--FILL-COLOR"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-color</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>* : Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--FILL-COLOR-GDK"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-color-gdk</TT
>&quot; (<A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--FILL-COLOR-RGBA"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-color-rgba</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--FILL-STIPPLE"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-stipple</TT
>&quot; (<A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--WIDTH-PIXELS"
></A
>&quot;<TT
CLASS="LITERAL"
>width-pixels</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> : Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--WIDTH-UNITS"
></A
>&quot;<TT
CLASS="LITERAL"
>width-units</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--CAP-STYLE"
></A
>&quot;<TT
CLASS="LITERAL"
>cap-style</TT
>&quot; (<A
HREF=../gdk/gdk-graphics-contexts.html#GDKCAPSTYLE
>GdkCapStyle</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--JOIN-STYLE"
></A
>&quot;<TT
CLASS="LITERAL"
>join-style</TT
>&quot; (<A
HREF=../gdk/gdk-graphics-contexts.html#GDKJOINSTYLE
>GdkJoinStyle</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--LINE-STYLE"
></A
>&quot;<TT
CLASS="LITERAL"
>line-style</TT
>&quot; (<A
HREF=../gdk/gdk-graphics-contexts.html#GDKLINESTYLE
>GdkLineStyle</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--FIRST-ARROWHEAD"
></A
>&quot;<TT
CLASS="LITERAL"
>first-arrowhead</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--LAST-ARROWHEAD"
></A
>&quot;<TT
CLASS="LITERAL"
>last-arrowhead</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--SMOOTH"
></A
>&quot;<TT
CLASS="LITERAL"
>smooth</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--SPLINE-STEPS"
></A
>&quot;<TT
CLASS="LITERAL"
>spline-steps</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--ARROW-SHAPE-A"
></A
>&quot;<TT
CLASS="LITERAL"
>arrow-shape-a</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--ARROW-SHAPE-B"
></A
>&quot;<TT
CLASS="LITERAL"
>arrow-shape-b</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASLINE--ARROW-SHAPE-C"
></A
>&quot;<TT
CLASS="LITERAL"
>arrow-shape-c</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvasgroup.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvaspolygon.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
>GnomeCanvasGroup</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeCanvasPolygon</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeCanvasPolygon</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeCanvasLine"
HREF="gnomecanvasline.html"><LINK
REL="NEXT"
TITLE="GnomeCanvasRE"
HREF="gnomecanvasre.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvasline.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvasre.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMECANVASPOLYGON"
>GnomeCanvasPolygon</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN12262"
></A
><H2
>Name</H2
>GnomeCanvasPolygon&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN12265"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomecanvaspolygon.html#GNOMECANVASPOLYGON-STRUCT"
>GnomeCanvasPolygon</A
>;&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12269"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>
         +----GnomeCanvasPolygon</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12274"
></A
><H2
>Args</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  &quot;<A
HREF="gnomecanvaspolygon.html#GNOMECANVASPOLYGON--FILL-COLOR"
>fill-color</A
>&quot;           <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*               : Write
  &quot;<A
HREF="gnomecanvaspolygon.html#GNOMECANVASPOLYGON--FILL-COLOR-GDK"
>fill-color-gdk</A
>&quot;       <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A>             : Read / Write
  &quot;<A
HREF="gnomecanvaspolygon.html#GNOMECANVASPOLYGON--FILL-COLOR-RGBA"
>fill-color-rgba</A
>&quot;      <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>                : Read / Write
  &quot;<A
HREF="gnomecanvaspolygon.html#GNOMECANVASPOLYGON--OUTLINE-COLOR"
>outline-color</A
>&quot;        <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*               : Write
  &quot;<A
HREF="gnomecanvaspolygon.html#GNOMECANVASPOLYGON--OUTLINE-COLOR-GDK"
>outline-color-gdk</A
>&quot;    <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A>             : Read / Write
  &quot;<A
HREF="gnomecanvaspolygon.html#GNOMECANVASPOLYGON--OUTLINE-COLOR-RGBA"
>outline-color-rgba</A
>&quot;   <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>                : Read / Write
  &quot;<A
HREF="gnomecanvaspolygon.html#GNOMECANVASPOLYGON--FILL-STIPPLE"
>fill-stipple</A
>&quot;         <A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A>            : Read / Write
  &quot;<A
HREF="gnomecanvaspolygon.html#GNOMECANVASPOLYGON--OUTLINE-STIPPLE"
>outline-stipple</A
>&quot;      <A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A>            : Read / Write
  &quot;<A
HREF="gnomecanvaspolygon.html#GNOMECANVASPOLYGON--WIDTH-PIXELS"
>width-pixels</A
>&quot;         <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>                : Write
  &quot;<A
HREF="gnomecanvaspolygon.html#GNOMECANVASPOLYGON--WIDTH-UNITS"
>width-units</A
>&quot;          <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Write</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12297"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12300"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN12302"
></A
><H3
><A
NAME="GNOMECANVASPOLYGON-STRUCT"
></A
>struct GnomeCanvasPolygon</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeCanvasPolygon;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12307"
></A
><H2
>Args</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
NAME="GNOMECANVASPOLYGON--FILL-COLOR"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-color</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>* : Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASPOLYGON--FILL-COLOR-GDK"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-color-gdk</TT
>&quot; (<A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASPOLYGON--FILL-COLOR-RGBA"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-color-rgba</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASPOLYGON--OUTLINE-COLOR"
></A
>&quot;<TT
CLASS="LITERAL"
>outline-color</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>* : Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASPOLYGON--OUTLINE-COLOR-GDK"
></A
>&quot;<TT
CLASS="LITERAL"
>outline-color-gdk</TT
>&quot; (<A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASPOLYGON--OUTLINE-COLOR-RGBA"
></A
>&quot;<TT
CLASS="LITERAL"
>outline-color-rgba</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASPOLYGON--FILL-STIPPLE"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-stipple</TT
>&quot; (<A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASPOLYGON--OUTLINE-STIPPLE"
></A
>&quot;<TT
CLASS="LITERAL"
>outline-stipple</TT
>&quot; (<A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASPOLYGON--WIDTH-PIXELS"
></A
>&quot;<TT
CLASS="LITERAL"
>width-pixels</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> : Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASPOLYGON--WIDTH-UNITS"
></A
>&quot;<TT
CLASS="LITERAL"
>width-units</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Write)</DT
><DD
><P
></P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvasline.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvasre.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
>GnomeCanvasLine</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeCanvasRE</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeCanvasRect</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeCanvasRE"
HREF="gnomecanvasre.html"><LINK
REL="NEXT"
TITLE="GnomeCanvasEllipse"
HREF="gnomecanvasellipse.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvasre.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvasellipse.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMECANVASRECT"
>GnomeCanvasRect</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN12544"
></A
><H2
>Name</H2
>GnomeCanvasRect&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN12547"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomecanvasrect.html#GNOMECANVASRECT-STRUCT"
>GnomeCanvasRect</A
>;&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12551"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>
         +----<A
HREF="gnomecanvasre.html"
>GnomeCanvasRE</A
>
               +----GnomeCanvasRect</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12557"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12560"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN12562"
></A
><H3
><A
NAME="GNOMECANVASRECT-STRUCT"
></A
>struct GnomeCanvasRect</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeCanvasRect;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvasre.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvasellipse.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
>GnomeCanvasRE</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeCanvasEllipse</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeCanvasRE</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeCanvasPolygon"
HREF="gnomecanvaspolygon.html"><LINK
REL="NEXT"
TITLE="GnomeCanvasRect"
HREF="gnomecanvasrect.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvaspolygon.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvasrect.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMECANVASRE"
>GnomeCanvasRE</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN12385"
></A
><H2
>Name</H2
>GnomeCanvasRE&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN12388"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomecanvasre.html#GNOMECANVASRE-STRUCT"
>GnomeCanvasRE</A
>;&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12392"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>
         +----GnomeCanvasRE</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12397"
></A
><H2
>Args</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  &quot;<A
HREF="gnomecanvasre.html#GNOMECANVASRE--X1"
>x1</A
>&quot;                   <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvasre.html#GNOMECANVASRE--Y1"
>y1</A
>&quot;                   <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvasre.html#GNOMECANVASRE--X2"
>x2</A
>&quot;                   <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvasre.html#GNOMECANVASRE--Y2"
>y2</A
>&quot;                   <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvasre.html#GNOMECANVASRE--FILL-COLOR"
>fill-color</A
>&quot;           <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*               : Write
  &quot;<A
HREF="gnomecanvasre.html#GNOMECANVASRE--FILL-COLOR-GDK"
>fill-color-gdk</A
>&quot;       <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A>             : Read / Write
  &quot;<A
HREF="gnomecanvasre.html#GNOMECANVASRE--FILL-COLOR-RGBA"
>fill-color-rgba</A
>&quot;      <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>                : Read / Write
  &quot;<A
HREF="gnomecanvasre.html#GNOMECANVASRE--OUTLINE-COLOR"
>outline-color</A
>&quot;        <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*               : Write
  &quot;<A
HREF="gnomecanvasre.html#GNOMECANVASRE--OUTLINE-COLOR-GDK"
>outline-color-gdk</A
>&quot;    <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A>             : Read / Write
  &quot;<A
HREF="gnomecanvasre.html#GNOMECANVASRE--OUTLINE-COLOR-RGBA"
>outline-color-rgba</A
>&quot;   <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>                : Read / Write
  &quot;<A
HREF="gnomecanvasre.html#GNOMECANVASRE--FILL-STIPPLE"
>fill-stipple</A
>&quot;         <A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A>            : Read / Write
  &quot;<A
HREF="gnomecanvasre.html#GNOMECANVASRE--OUTLINE-STIPPLE"
>outline-stipple</A
>&quot;      <A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A>            : Read / Write
  &quot;<A
HREF="gnomecanvasre.html#GNOMECANVASRE--WIDTH-PIXELS"
>width-pixels</A
>&quot;         <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>                : Write
  &quot;<A
HREF="gnomecanvasre.html#GNOMECANVASRE--WIDTH-UNITS"
>width-units</A
>&quot;          <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Write</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12428"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12431"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN12433"
></A
><H3
><A
NAME="GNOMECANVASRE-STRUCT"
></A
>struct GnomeCanvasRE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeCanvasRE;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12438"
></A
><H2
>Args</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
NAME="GNOMECANVASRE--X1"
></A
>&quot;<TT
CLASS="LITERAL"
>x1</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASRE--Y1"
></A
>&quot;<TT
CLASS="LITERAL"
>y1</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASRE--X2"
></A
>&quot;<TT
CLASS="LITERAL"
>x2</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASRE--Y2"
></A
>&quot;<TT
CLASS="LITERAL"
>y2</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASRE--FILL-COLOR"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-color</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>* : Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASRE--FILL-COLOR-GDK"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-color-gdk</TT
>&quot; (<A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASRE--FILL-COLOR-RGBA"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-color-rgba</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASRE--OUTLINE-COLOR"
></A
>&quot;<TT
CLASS="LITERAL"
>outline-color</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>* : Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASRE--OUTLINE-COLOR-GDK"
></A
>&quot;<TT
CLASS="LITERAL"
>outline-color-gdk</TT
>&quot; (<A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASRE--OUTLINE-COLOR-RGBA"
></A
>&quot;<TT
CLASS="LITERAL"
>outline-color-rgba</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASRE--FILL-STIPPLE"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-stipple</TT
>&quot; (<A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASRE--OUTLINE-STIPPLE"
></A
>&quot;<TT
CLASS="LITERAL"
>outline-stipple</TT
>&quot; (<A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASRE--WIDTH-PIXELS"
></A
>&quot;<TT
CLASS="LITERAL"
>width-pixels</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> : Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASRE--WIDTH-UNITS"
></A
>&quot;<TT
CLASS="LITERAL"
>width-units</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Write)</DT
><DD
><P
></P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvaspolygon.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvasrect.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
>GnomeCanvasPolygon</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeCanvasRect</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeCanvasText</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeCanvasEllipse"
HREF="gnomecanvasellipse.html"><LINK
REL="NEXT"
TITLE="GnomeCanvasImage"
HREF="gnomecanvasimage.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvasellipse.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvasimage.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMECANVASTEXT"
>GnomeCanvasText</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN12600"
></A
><H2
>Name</H2
>GnomeCanvasText&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN12603"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomecanvastext.html#GNOMECANVASTEXT-STRUCT"
>GnomeCanvasText</A
>;
struct      <A
HREF="gnomecanvastext.html#GNOMECANVASTEXTSUCKCHAR"
>GnomeCanvasTextSuckChar</A
>;
struct      <A
HREF="gnomecanvastext.html#GNOMECANVASTEXTSUCKFONT"
>GnomeCanvasTextSuckFont</A
>;&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12609"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>
         +----GnomeCanvasText</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12614"
></A
><H2
>Args</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--TEXT"
>text</A
>&quot;                 <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*               : Read / Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--X"
>x</A
>&quot;                    <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--Y"
>y</A
>&quot;                    <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--FONT"
>font</A
>&quot;                 <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*               : Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--FONTSET"
>fontset</A
>&quot;              <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*               : Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--FONT-GDK"
>font-gdk</A
>&quot;             <A
HREF=../gdk/gdk-fonts.html#GDKFONT
>GdkFont</A>              : Read / Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--ANCHOR"
>anchor</A
>&quot;               <A
HREF=../gtk/gtkpacker.html#GTKANCHORTYPE
>GtkAnchorType</A>        : Read / Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--JUSTIFICATION"
>justification</A
>&quot;        <A
HREF=../gtk/gtk-standard-enumerations.html#GTKJUSTIFICATION
>GtkJustification</A>     : Read / Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--CLIP-WIDTH"
>clip-width</A
>&quot;           <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--CLIP-HEIGHT"
>clip-height</A
>&quot;          <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--CLIP"
>clip</A
>&quot;                 <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>             : Read / Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--X-OFFSET"
>x-offset</A
>&quot;             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--Y-OFFSET"
>y-offset</A
>&quot;             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--FILL-COLOR"
>fill-color</A
>&quot;           <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*               : Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--FILL-COLOR-GDK"
>fill-color-gdk</A
>&quot;       <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A>             : Read / Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--FILL-COLOR-RGBA"
>fill-color-rgba</A
>&quot;      <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>                : Read / Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--FILL-STIPPLE"
>fill-stipple</A
>&quot;         <A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A>            : Read / Write
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--TEXT-WIDTH"
>text-width</A
>&quot;           <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read
  &quot;<A
HREF="gnomecanvastext.html#GNOMECANVASTEXT--TEXT-HEIGHT"
>text-height</A
>&quot;          <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12655"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12658"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN12660"
></A
><H3
><A
NAME="GNOMECANVASTEXT-STRUCT"
></A
>struct GnomeCanvasText</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeCanvasText;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN12665"
></A
><H3
><A
NAME="GNOMECANVASTEXTSUCKCHAR"
></A
>struct GnomeCanvasTextSuckChar</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeCanvasTextSuckChar {
	int     left_sb;
	int     right_sb;
	int     width;
	int     ascent;
	int     descent;
	int     bitmap_offset; /* in pixels */
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN12670"
></A
><H3
><A
NAME="GNOMECANVASTEXTSUCKFONT"
></A
>struct GnomeCanvasTextSuckFont</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeCanvasTextSuckFont {
	guchar *bitmap;
	gint    bitmap_width;
	gint    bitmap_height;
	gint    ascent;
	GnomeCanvasTextSuckChar chars[256];
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12675"
></A
><H2
>Args</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
NAME="GNOMECANVASTEXT--TEXT"
></A
>&quot;<TT
CLASS="LITERAL"
>text</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>* : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--X"
></A
>&quot;<TT
CLASS="LITERAL"
>x</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--Y"
></A
>&quot;<TT
CLASS="LITERAL"
>y</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--FONT"
></A
>&quot;<TT
CLASS="LITERAL"
>font</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>* : Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--FONTSET"
></A
>&quot;<TT
CLASS="LITERAL"
>fontset</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>* : Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--FONT-GDK"
></A
>&quot;<TT
CLASS="LITERAL"
>font-gdk</TT
>&quot; (<A
HREF=../gdk/gdk-fonts.html#GDKFONT
>GdkFont</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--ANCHOR"
></A
>&quot;<TT
CLASS="LITERAL"
>anchor</TT
>&quot; (<A
HREF=../gtk/gtkpacker.html#GTKANCHORTYPE
>GtkAnchorType</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--JUSTIFICATION"
></A
>&quot;<TT
CLASS="LITERAL"
>justification</TT
>&quot; (<A
HREF=../gtk/gtk-standard-enumerations.html#GTKJUSTIFICATION
>GtkJustification</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--CLIP-WIDTH"
></A
>&quot;<TT
CLASS="LITERAL"
>clip-width</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--CLIP-HEIGHT"
></A
>&quot;<TT
CLASS="LITERAL"
>clip-height</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--CLIP"
></A
>&quot;<TT
CLASS="LITERAL"
>clip</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--X-OFFSET"
></A
>&quot;<TT
CLASS="LITERAL"
>x-offset</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--Y-OFFSET"
></A
>&quot;<TT
CLASS="LITERAL"
>y-offset</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--FILL-COLOR"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-color</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>* : Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--FILL-COLOR-GDK"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-color-gdk</TT
>&quot; (<A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--FILL-COLOR-RGBA"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-color-rgba</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--FILL-STIPPLE"
></A
>&quot;<TT
CLASS="LITERAL"
>fill-stipple</TT
>&quot; (<A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--TEXT-WIDTH"
></A
>&quot;<TT
CLASS="LITERAL"
>text-width</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASTEXT--TEXT-HEIGHT"
></A
>&quot;<TT
CLASS="LITERAL"
>text-height</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read)</DT
><DD
><P
></P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvasellipse.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecanvasimage.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
>GnomeCanvasEllipse</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeCanvasImage</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeCanvasWidget</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeCanvasImage"
HREF="gnomecanvasimage.html"><LINK
REL="NEXT"
TITLE="GnomeClient"
HREF="gnomeclient.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvasimage.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeclient.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMECANVASWIDGET"
>GnomeCanvasWidget</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN12903"
></A
><H2
>Name</H2
>GnomeCanvasWidget&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN12906"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomecanvaswidget.html#GNOMECANVASWIDGET-STRUCT"
>GnomeCanvasWidget</A
>;&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12910"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>
         +----GnomeCanvasWidget</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12915"
></A
><H2
>Args</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  &quot;<A
HREF="gnomecanvaswidget.html#GNOMECANVASWIDGET--WIDGET"
>widget</A
>&quot;               <A
HREF=../gtk/gtkobject.html
>GtkObject</A>            : Read / Write
  &quot;<A
HREF="gnomecanvaswidget.html#GNOMECANVASWIDGET--X"
>x</A
>&quot;                    <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvaswidget.html#GNOMECANVASWIDGET--Y"
>y</A
>&quot;                    <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvaswidget.html#GNOMECANVASWIDGET--WIDTH"
>width</A
>&quot;                <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvaswidget.html#GNOMECANVASWIDGET--HEIGHT"
>height</A
>&quot;               <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>              : Read / Write
  &quot;<A
HREF="gnomecanvaswidget.html#GNOMECANVASWIDGET--ANCHOR"
>anchor</A
>&quot;               <A
HREF=../gtk/gtkpacker.html#GTKANCHORTYPE
>GtkAnchorType</A>        : Read / Write
  &quot;<A
HREF="gnomecanvaswidget.html#GNOMECANVASWIDGET--SIZE-PIXELS"
>size-pixels</A
>&quot;          <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>             : Read / Write</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12932"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12935"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN12937"
></A
><H3
><A
NAME="GNOMECANVASWIDGET-STRUCT"
></A
>struct GnomeCanvasWidget</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeCanvasWidget;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN12942"
></A
><H2
>Args</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
NAME="GNOMECANVASWIDGET--WIDGET"
></A
>&quot;<TT
CLASS="LITERAL"
>widget</TT
>&quot; (<A
HREF=../gtk/gtkobject.html
>GtkObject</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASWIDGET--X"
></A
>&quot;<TT
CLASS="LITERAL"
>x</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASWIDGET--Y"
></A
>&quot;<TT
CLASS="LITERAL"
>y</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASWIDGET--WIDTH"
></A
>&quot;<TT
CLASS="LITERAL"
>width</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASWIDGET--HEIGHT"
></A
>&quot;<TT
CLASS="LITERAL"
>height</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASWIDGET--ANCHOR"
></A
>&quot;<TT
CLASS="LITERAL"
>anchor</TT
>&quot; (<A
HREF=../gtk/gtkpacker.html#GTKANCHORTYPE
>GtkAnchorType</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMECANVASWIDGET--SIZE-PIXELS"
></A
>&quot;<TT
CLASS="LITERAL"
>size-pixels</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> : Read / Write)</DT
><DD
><P
></P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvasimage.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeclient.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
>GnomeCanvasImage</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeClient</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeClient</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeCanvasWidget"
HREF="gnomecanvaswidget.html"><LINK
REL="NEXT"
TITLE="GnomeColorPicker"
HREF="gnomecolorpicker.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvaswidget.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecolorpicker.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMECLIENT"
>GnomeClient</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN12999"
></A
><H2
>Name</H2
>GnomeClient&nbsp;--&nbsp;Routines to provide session management support in your application</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN13002"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeclient.html#GNOMECLIENT-STRUCT"
>GnomeClient</A
>;
enum        <A
HREF="gnomeclient.html#GNOMECLIENTFLAGS"
>GnomeClientFlags</A
>;
#define     <A
HREF="gnomeclient.html#GNOME-CLIENT-CONNECTED-CAPS"
>GNOME_CLIENT_CONNECTED</A
>          (obj)
enum        <A
HREF="gnomeclient.html#GNOMEINTERACTSTYLE"
>GnomeInteractStyle</A
>;
enum        <A
HREF="gnomeclient.html#GNOMEDIALOGTYPE"
>GnomeDialogType</A
>;
enum        <A
HREF="gnomeclient.html#GNOMESAVESTYLE"
>GnomeSaveStyle</A
>;
enum        <A
HREF="gnomeclient.html#GNOMERESTARTSTYLE"
>GnomeRestartStyle</A
>;
enum        <A
HREF="gnomeclient.html#GNOMECLIENTSTATE"
>GnomeClientState</A
>;
void        (<A
HREF="gnomeclient.html#GNOMEINTERACTFUNCTION"
>*GnomeInteractFunction</A
>)        (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> key,
                                             <A
HREF="gnomeclient.html#GNOMEDIALOGTYPE"
>GnomeDialogType</A
> dialog_type,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-DISABLE-MASTER-CONNECTION"
>gnome_client_disable_master_connection</A
>
                                            (void);
<A
HREF="gnomeclient.html"
>GnomeClient</A
>* <A
HREF="gnomeclient.html#GNOME-MASTER-CLIENT"
>gnome_master_client</A
>            (void);
<A
HREF="gnomeclient.html"
>GnomeClient</A
>* <A
HREF="gnomeclient.html#GNOME-CLONED-CLIENT"
>gnome_cloned_client</A
>            (void);
<A
HREF="gnomeclient.html"
>GnomeClient</A
>* <A
HREF="gnomeclient.html#GNOME-CLIENT-NEW"
>gnome_client_new</A
>               (void);
<A
HREF="gnomeclient.html"
>GnomeClient</A
>* <A
HREF="gnomeclient.html#GNOME-CLIENT-NEW-WITHOUT-CONNECTION"
>gnome_client_new_without_connection</A
>
                                            (void);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-CONNECT"
>gnome_client_connect</A
>            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-DISCONNECT"
>gnome_client_disconnect</A
>         (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SET-ID"
>gnome_client_set_id</A
>             (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *client_id);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomeclient.html#GNOME-CLIENT-GET-ID"
>gnome_client_get_id</A
>             (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomeclient.html#GNOME-CLIENT-GET-PREVIOUS-ID"
>gnome_client_get_previous_id</A
>    (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomeclient.html#GNOME-CLIENT-GET-CONFIG-PREFIX"
>gnome_client_get_config_prefix</A
>  (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomeclient.html#GNOME-CLIENT-GET-GLOBAL-CONFIG-PREFIX"
>gnome_client_get_global_config_prefix</A
>
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SET-GLOBAL-CONFIG-PREFIX"
>gnome_client_set_global_config_prefix</A
>
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prefix);
<A
HREF="gnomeclient.html#GNOMECLIENTFLAGS"
>GnomeClientFlags</A
> <A
HREF="gnomeclient.html#GNOME-CLIENT-GET-FLAGS"
>gnome_client_get_flags</A
>     (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SET-RESTART-STYLE"
>gnome_client_set_restart_style</A
>  (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF="gnomeclient.html#GNOMERESTARTSTYLE"
>GnomeRestartStyle</A
> style);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SET-RESTART-COMMAND"
>gnome_client_set_restart_command</A
>
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> argc,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *argv[]);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-ADD-STATIC-ARG"
>gnome_client_add_static_arg</A
>     (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             ...);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SET-DISCARD-COMMAND"
>gnome_client_set_discard_command</A
>
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> argc,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *argv[]);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SET-RESIGN-COMMAND"
>gnome_client_set_resign_command</A
> (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> argc,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *argv[]);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SET-SHUTDOWN-COMMAND"
>gnome_client_set_shutdown_command</A
>
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> argc,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *argv[]);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SET-CURRENT-DIRECTORY"
>gnome_client_set_current_directory</A
>
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *dir);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SET-ENVIRONMENT"
>gnome_client_set_environment</A
>    (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *value);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SET-CLONE-COMMAND"
>gnome_client_set_clone_command</A
>  (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> argc,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *argv[]);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SET-PROCESS-ID"
>gnome_client_set_process_id</A
>     (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF=../glib/glib-windows-compatability-functions.html#PID-T
>pid_t</A> pid);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SET-PROGRAM"
>gnome_client_set_program</A
>        (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *program);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SET-USER-ID"
>gnome_client_set_user_id</A
>        (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *user_id);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-REQUEST-PHASE-2"
>gnome_client_request_phase_2</A
>    (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SAVE-ANY-DIALOG"
>gnome_client_save_any_dialog</A
>    (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-SAVE-ERROR-DIALOG"
>gnome_client_save_error_dialog</A
>  (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-REQUEST-INTERACTION"
>gnome_client_request_interaction</A
>
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF="gnomeclient.html#GNOMEDIALOGTYPE"
>GnomeDialogType</A
> dialog,
                                             <A
HREF="gnomeclient.html#GNOMEINTERACTFUNCTION"
>GnomeInteractFunction</A
> func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> client_data);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-REQUEST-INTERACTION-INTERP"
>gnome_client_request_interaction_interp</A
>
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF="gnomeclient.html#GNOMEDIALOGTYPE"
>GnomeDialogType</A
> dialog,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> destroy);
void        <A
HREF="gnomeclient.html#GNOME-INTERACTION-KEY-RETURN"
>gnome_interaction_key_return</A
>    (<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> key,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> cancel_shutdown);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-REQUEST-SAVE"
>gnome_client_request_save</A
>       (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF="gnomeclient.html#GNOMESAVESTYLE"
>GnomeSaveStyle</A
> save_style,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> shutdown,
                                             <A
HREF="gnomeclient.html#GNOMEINTERACTSTYLE"
>GnomeInteractStyle</A
> interact_style,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> fast,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> global);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-FLUSH"
>gnome_client_flush</A
>              (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);
void        <A
HREF="gnomeclient.html#GNOME-CLIENT-INIT"
>gnome_client_init</A
>               (void);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN13125"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----GnomeClient</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN13129"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomeclient.html#GNOMECLIENT-SAVE-YOURSELF"
>save-yourself</A
>&quot;
            <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function      (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg2,
                                            <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> arg3,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg4,
                                            <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> arg5,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomeclient.html#GNOMECLIENT-DIE"
>die</A
>&quot;       void        user_function      (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomeclient.html#GNOMECLIENT-SAVE-COMPLETE"
>save-complete</A
>&quot;
            void        user_function      (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomeclient.html#GNOMECLIENT-SHUTDOWN-CANCELLED"
>shutdown-cancelled</A
>&quot;
            void        user_function      (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomeclient.html#GNOMECLIENT-CONNECT"
>connect</A
>&quot;   void        user_function      (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                            <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomeclient.html#GNOMECLIENT-DISCONNECT"
>disconnect</A
>&quot;
            void        user_function      (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN13157"
></A
><H2
>Description</H2
><P
>The GNOME project uses a special object - the GnomeClient object
- to implement session management.  This object handles the connection
to a session manager, the setting and removing of properties and the
handling of messages sent by a session manager.</P
><P
>There are two functions in the GNOME libraries, that create a
new GnomeClient object: <A
HREF="gnomeclient.html#GNOME-CLIENT-NEW"
>gnome_client_new</A
>() and
<A
HREF="gnomeclient.html#GNOME-CLIENT-NEW-WITHOUT-CONNECTION"
>gnome_client_new_without_connection</A
>().  As one may guess from the
functions names: The first function tries to connect to a session
manager automatically, while the second one does not.  However, you
probably don't need to create your own client;
<TT
CLASS="FUNCTION"
><A
HREF="gnomeui-gnome-init.html#GNOME-INIT"
>gnome_init</A
>()</TT
> automatically creates a client for
you. To obtain this client, call
<TT
CLASS="FUNCTION"
><A
HREF="gnomeclient.html#GNOME-MASTER-CLIENT"
>gnome_master_client</A
>().</TT
>
 </P
><P
>Two useful sources of information on session management are the
gnome-client header file and the SMlib.PS.Z document that comes with
X.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN13168"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN13170"
></A
><H3
><A
NAME="GNOMECLIENT-STRUCT"
></A
>struct GnomeClient</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeClient;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13175"
></A
><H3
><A
NAME="GNOMECLIENTFLAGS"
></A
>enum GnomeClientFlags</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  GNOME_CLIENT_IS_CONNECTED= 1 &lt;&lt; 0,
  GNOME_CLIENT_RESTARTED   = 1 &lt;&lt; 1,
  GNOME_CLIENT_RESTORED    = 1 &lt;&lt; 2
} GnomeClientFlags;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13180"
></A
><H3
><A
NAME="GNOME-CLIENT-CONNECTED-CAPS"
></A
>GNOME_CLIENT_CONNECTED()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_CLIENT_CONNECTED(obj) (GNOME_CLIENT (obj)-&gt;smc_conn)</PRE
></TD
></TR
></TABLE
><P
>Returns TRUE if the client is connected to the session manager.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13185"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>obj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Client to check.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13194"
></A
><H3
><A
NAME="GNOMEINTERACTSTYLE"
></A
>enum GnomeInteractStyle</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  GNOME_INTERACT_NONE,
  GNOME_INTERACT_ERRORS,
  GNOME_INTERACT_ANY
} GnomeInteractStyle;</PRE
></TD
></TR
></TABLE
><P
>Controls permitted user interaction during session save.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13199"
></A
><H3
><A
NAME="GNOMEDIALOGTYPE"
></A
>enum GnomeDialogType</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  GNOME_DIALOG_ERROR,
  GNOME_DIALOG_NORMAL
} GnomeDialogType;</PRE
></TD
></TR
></TABLE
><P
>Controls type of dialog generated for user interaction.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13204"
></A
><H3
><A
NAME="GNOMESAVESTYLE"
></A
>enum GnomeSaveStyle</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  GNOME_SAVE_GLOBAL,
  GNOME_SAVE_LOCAL,
  GNOME_SAVE_BOTH
} GnomeSaveStyle;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13209"
></A
><H3
><A
NAME="GNOMERESTARTSTYLE"
></A
>enum GnomeRestartStyle</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  GNOME_RESTART_IF_RUNNING,
  GNOME_RESTART_ANYWAY,
  GNOME_RESTART_IMMEDIATELY,
  GNOME_RESTART_NEVER
} GnomeRestartStyle;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13214"
></A
><H3
><A
NAME="GNOMECLIENTSTATE"
></A
>enum GnomeClientState</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  GNOME_CLIENT_IDLE,
  GNOME_CLIENT_SAVING_PHASE_1,
  GNOME_CLIENT_WAITING_FOR_PHASE_2,
  GNOME_CLIENT_SAVING_PHASE_2,
  GNOME_CLIENT_FROZEN,
  GNOME_CLIENT_DISCONNECTED,
  GNOME_CLIENT_REGISTERING
} GnomeClientState;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13219"
></A
><H3
><A
NAME="GNOMEINTERACTFUNCTION"
></A
>GnomeInteractFunction ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        (*GnomeInteractFunction)        (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> key,
                                             <A
HREF="gnomeclient.html#GNOMEDIALOGTYPE"
>GnomeDialogType</A
> dialog_type,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Callback invoked to perform user interaction.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13228"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Client.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>key</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Key to be returned when interaction ends.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Type of dialog being shown.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Callback data.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13249"
></A
><H3
><A
NAME="GNOME-CLIENT-DISABLE-MASTER-CONNECTION"
></A
>gnome_client_disable_master_connection ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_disable_master_connection
                                            (void);</PRE
></TD
></TR
></TABLE
><P
>Don't connect the master client to the session manager. Usually 
invoked by users when they pass the --sm-disable argument to a Gnome application.</P
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13255"
></A
><H3
><A
NAME="GNOME-MASTER-CLIENT"
></A
>gnome_master_client ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeclient.html"
>GnomeClient</A
>* gnome_master_client            (void);</PRE
></TD
></TR
></TABLE
><P
>Get the master session management client.  This master client gets
   a client id, that may be specified by the '--sm-client-id' command
   line option.  A master client will be generated by 'gnome-init'.
   If possible the master client will contact the session manager
   after command-line parsing is finished (unless
   'gnome_client_disable_master_connection' was called).  The master
   client will also set the SM_CLIENT_ID property on the client leader
   window of your application.  </P
><P
>   Additionally, the master client gets some static arguments set
   automatically (see 'gnome_client_add_static_arg' for static
   arguments): 'gnome_init' passes all the command line options which 
   are recognised by gtk as static arguments to the master client.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13263"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to the master client</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13272"
></A
><H3
><A
NAME="GNOME-CLONED-CLIENT"
></A
>gnome_cloned_client ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeclient.html"
>GnomeClient</A
>* gnome_cloned_client            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13279"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13288"
></A
><H3
><A
NAME="GNOME-CLIENT-NEW"
></A
>gnome_client_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeclient.html"
>GnomeClient</A
>* gnome_client_new               (void);</PRE
></TD
></TR
></TABLE
><P
>Allocates memory for a new GNOME session management
client object.  After allocating, the client tries to connect to a
session manager. You probably want to use
&lt;function&gt;<A
HREF="gnomeclient.html#GNOME-MASTER-CLIENT"
>gnome_master_client</A
>()&lt;/function&gt; instead.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13296"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to a newly allocated GNOME session management
client object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13305"
></A
><H3
><A
NAME="GNOME-CLIENT-NEW-WITHOUT-CONNECTION"
></A
>gnome_client_new_without_connection ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeclient.html"
>GnomeClient</A
>* gnome_client_new_without_connection
                                            (void);</PRE
></TD
></TR
></TABLE
><P
>Allocates memory for a new GNOME session management
client object. You probably want to use
&lt;function&gt;<A
HREF="gnomeclient.html#GNOME-MASTER-CLIENT"
>gnome_master_client</A
>()&lt;/function&gt; instead.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13313"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to a newly allocated GNOME session management
client object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13322"
></A
><H3
><A
NAME="GNOME-CLIENT-CONNECT"
></A
>gnome_client_connect ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_connect            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);</PRE
></TD
></TR
></TABLE
><P
>Causes the client to connect to the session manager.
Usually happens automatically; no need to call this function.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13329"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13338"
></A
><H3
><A
NAME="GNOME-CLIENT-DISCONNECT"
></A
>gnome_client_disconnect ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_disconnect         (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);</PRE
></TD
></TR
></TABLE
><P
>Disconnect the client from the session manager.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13345"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13354"
></A
><H3
><A
NAME="GNOME-CLIENT-SET-ID"
></A
>gnome_client_set_id ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_set_id             (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *client_id);</PRE
></TD
></TR
></TABLE
><P
>Set the client's session management ID; must be done
before connecting to the session manager. Frankly I have no idea
why you'd do this.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13362"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13375"
></A
><H3
><A
NAME="GNOME-CLIENT-GET-ID"
></A
>gnome_client_get_id ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_client_get_id             (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);</PRE
></TD
></TR
></TABLE
><P
>Returns session management ID</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13383"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Session management ID for this client; NULL if not connected to a session manager.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13396"
></A
><H3
><A
NAME="GNOME-CLIENT-GET-PREVIOUS-ID"
></A
>gnome_client_get_previous_id ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_client_get_previous_id    (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);</PRE
></TD
></TR
></TABLE
><P
>Get the previous session management ID (from previous session)</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13404"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to the session management ID the client had in the last
session, or NULL if it wasn't in a previous session.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13417"
></A
><H3
><A
NAME="GNOME-CLIENT-GET-CONFIG-PREFIX"
></A
>gnome_client_get_config_prefix ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_client_get_config_prefix  (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);</PRE
></TD
></TR
></TABLE
><P
>Get the config prefix for a client. This config prefix
provides a suitable place to store any details about the state of
the client which can not be described using the app's command line
arguments (as set in the restart command). You may push the
returned value using 'gnome_config_push_prefix' and read or write
any values you require.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13425"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Config prefix.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13438"
></A
><H3
><A
NAME="GNOME-CLIENT-GET-GLOBAL-CONFIG-PREFIX"
></A
>gnome_client_get_global_config_prefix ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_client_get_global_config_prefix
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);</PRE
></TD
></TR
></TABLE
><P
>Get the config prefix that will be returned by
#<A
HREF="gnomeclient.html#GNOME-CLIENT-GET-CONFIG-PREFIX"
>gnome_client_get_config_prefix</A
>() for clients
which have NOT been restarted or cloned (i.e. for clients started
by the user without `--sm-' options). This config prefix may be
used to write the user's preferred config for these "new" clients.</P
><P
>You could also use this prefix as a place to store and retrieve
config details that you wish to apply to ALL instances of the
app. However, this practice limits the users freedom to configure
each instance in a different way so it should be used with caution.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13448"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  The config prefix as a newly allocated string</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13461"
></A
><H3
><A
NAME="GNOME-CLIENT-SET-GLOBAL-CONFIG-PREFIX"
></A
>gnome_client_set_global_config_prefix ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_set_global_config_prefix
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prefix);</PRE
></TD
></TR
></TABLE
><P
>Set the value used for the global config prefix. The config prefixes 
   returned by gnome_client_get_config_prefix are formed by extending
   this prefix with an unique identifier.
   
   The global config prefix defaults to a name based on the name of
   the executable. This function allows you to set it to a different
   value. It should be called BEFORE retrieving the config prefix for
   the first time. Later calls will be ignored.</P
><P
>   For example, setting a global config prefix of "/app.d/session/"
   would ensure that all your session save files or directories would
   be gathered together into the app.d directory.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13470"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>prefix</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Prefix for saving the global configuration</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13483"
></A
><H3
><A
NAME="GNOME-CLIENT-GET-FLAGS"
></A
>gnome_client_get_flags ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeclient.html#GNOMECLIENTFLAGS"
>GnomeClientFlags</A
> gnome_client_get_flags     (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13491"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>some flags, that give additional information about this
client.  Right now, the following flags are supported:

- GNOME_CLIENT_IS_CONNECTED: The client is connected to a session
manager (It's the same information like using *
GNOME_CLIENT_CONNECTED).

- GNOME_CLIENT_RESTARTED: The client has been restarted, i. e. it
has been running with the same client id before.

- GNOME_CLIENT_RESTORED: This flag is only used for the master
client.  It indicates, that there may be a configuraion file from
which the clients state should be restored (using the
gnome_client_get_config_prefix call).</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13504"
></A
><H3
><A
NAME="GNOME-CLIENT-SET-RESTART-STYLE"
></A
>gnome_client_set_restart_style ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_set_restart_style  (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF="gnomeclient.html#GNOMERESTARTSTYLE"
>GnomeRestartStyle</A
> style);</PRE
></TD
></TR
></TABLE
><P
>GNOME_RESTART_IF_RUNNING causes the client to be
restarted in the next session if it was running when the previous
session exited. Restart is done via the restart command you
set. GNOME_RESTART_ANYWAY means the client will be restarted even
if the user exits the client before logging
out. GNOME_RESTART_IMMEDIATELY restarts the client immediately
anytime it crashes or is exited.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13512"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>style</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> When to restart the client</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13525"
></A
><H3
><A
NAME="GNOME-CLIENT-SET-RESTART-COMMAND"
></A
>gnome_client_set_restart_command ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_set_restart_command
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> argc,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *argv[]);</PRE
></TD
></TR
></TABLE
><P
>When clients crash or the user logs out and back in,
   they are restarted.  * This command should perform the restart.  *
   Executing the restart command on the local host should reproduce
   the state of the client at the time of the session save as closely
   as possible. Saving config info under the
   gnome_client_get_config_prefix is generally useful.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13534"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> number of strings in argv</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argv</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> argument vector to &lt;function&gt;execv()&lt;/function&gt; to restart the client</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13552"
></A
><H3
><A
NAME="GNOME-CLIENT-ADD-STATIC-ARG"
></A
>gnome_client_add_static_arg ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_add_static_arg     (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             ...);</PRE
></TD
></TR
></TABLE
><P
>You can add arguments to your restart command argv
   with this function. This function provides an alternative way of
   adding new arguments to the restart command. The arguments are
   placed before the arguments specified by
   'gnome_client_set_restart_command' and after the arguments
   recognised by gtk specified by the user on the original command
   line.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13559"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>...</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> NULL-terminated list of arguments to add to the restart command</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13572"
></A
><H3
><A
NAME="GNOME-CLIENT-SET-DISCARD-COMMAND"
></A
>gnome_client_set_discard_command ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_set_discard_command
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> argc,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *argv[]);</PRE
></TD
></TR
></TABLE
><P
>Provides a command to run when a client is removed
from the session. It might delete session-specific config files for
example.  Executing the discard command on the local host should
delete the information saved as part of the session save that was
in progress when the discard command was set. For example:</P
><P
>&lt;example&gt;
     gchar *prefix = gnome_client_get_config_prefix (client);
     gchar *argv[] = { "rm", "-r", NULL };
     argv[2] = gnome_config_get_real_path (prefix);
     gnome_client_set_discard_command (client, 3, argv);
&lt;/example&gt;</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13582"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of strings in argv</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argv</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13599"
></A
><H3
><A
NAME="GNOME-CLIENT-SET-RESIGN-COMMAND"
></A
>gnome_client_set_resign_command ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_set_resign_command (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> argc,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *argv[]);</PRE
></TD
></TR
></TABLE
><P
>Some clients can be "undone," removing their effects and deleting any 
saved state. For example, xmodmap could register a resign command to undo the keymap 
changes it saved.</P
><P
>Used by clients that use the GNOME_RESTART_ANYWAY restart style to
to undo their effects (these clients usually perform initialisation
functions and leave effects behind after they die).  The resign
command combines the effects of a shutdown command and a discard
command. It is executed when the user decides that the client
should cease to be restarted.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13609"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> number of strings in argv</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argv</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13626"
></A
><H3
><A
NAME="GNOME-CLIENT-SET-SHUTDOWN-COMMAND"
></A
>gnome_client_set_shutdown_command ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_set_shutdown_command
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> argc,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *argv[]);</PRE
></TD
></TR
></TABLE
><P
>GNOME_RESTART_ANYWAY clients can set this command to run 
when the user logs out but the client is no longer running.</P
><P
>Used by clients that use the GNOME_RESTART_ANYWAY restart style to
to undo their effects (these clients usually perform initialisation
functions and leave effects behind after they die).  The shutdown
command simply undoes the effects of the client. It is executed
during a normal logout.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13636"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> number of strings in argv</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argv</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13653"
></A
><H3
><A
NAME="GNOME-CLIENT-SET-CURRENT-DIRECTORY"
></A
>gnome_client_set_current_directory ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_set_current_directory
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *dir);</PRE
></TD
></TR
></TABLE
><P
>Set the directory to be in when running shutdown, discard, restart, etc. commands.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13661"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dir</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Directory path</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13674"
></A
><H3
><A
NAME="GNOME-CLIENT-SET-ENVIRONMENT"
></A
>gnome_client_set_environment ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_set_environment    (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *value);</PRE
></TD
></TR
></TABLE
><P
>Set an environment variable to be placed in the
client's environment prior to running restart, shutdown, discard, etc. commands.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13683"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of the environment variable</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>value</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Value of the environment variable</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13700"
></A
><H3
><A
NAME="GNOME-CLIENT-SET-CLONE-COMMAND"
></A
>gnome_client_set_clone_command ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_set_clone_command  (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> argc,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *argv[]);</PRE
></TD
></TR
></TABLE
><P
>Set a command the session manager can use to create a new instance of the application.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13709"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> number of strings in the argv vector</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argv</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13726"
></A
><H3
><A
NAME="GNOME-CLIENT-SET-PROCESS-ID"
></A
>gnome_client_set_process_id ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_set_process_id     (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF=../glib/glib-windows-compatability-functions.html#PID-T
>pid_t</A> pid);</PRE
></TD
></TR
></TABLE
><P
>The client should tell the session manager the result
of &lt;function&gt;<A
HREF=../glib/glib-windows-compatability-functions.html#GETPID
>getpid</A>()&lt;/function&gt;. However, Gnome does this
automatically; so you don't need this function.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13735"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pid</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> PID to set as the client's PID</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13748"
></A
><H3
><A
NAME="GNOME-CLIENT-SET-PROGRAM"
></A
>gnome_client_set_program ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_set_program        (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *program);</PRE
></TD
></TR
></TABLE
><P
>Used to tell the session manager the name of your program. Set automatically;
this function isn't needed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13756"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>program</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> name of the program</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13769"
></A
><H3
><A
NAME="GNOME-CLIENT-SET-USER-ID"
></A
>gnome_client_set_user_id ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_set_user_id        (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *user_id);</PRE
></TD
></TR
></TABLE
><P
>Tell the session manager the user's login name. Gnome
does this automatically; no need to call the function.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13777"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13790"
></A
><H3
><A
NAME="GNOME-CLIENT-REQUEST-PHASE-2"
></A
>gnome_client_request_phase_2 ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_request_phase_2    (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);</PRE
></TD
></TR
></TABLE
><P
>Request the session managaer to emit the "save_yourself" signal for 
   a second time after all the clients in the session have ceased 
   interacting with the user and entered an idle state. This might be 
   useful if your app manages other apps and requires that they are in 
   an idle state before saving its final data.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13797"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13806"
></A
><H3
><A
NAME="GNOME-CLIENT-SAVE-ANY-DIALOG"
></A
>gnome_client_save_any_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_save_any_dialog    (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog);</PRE
></TD
></TR
></TABLE
><P
>May be called during a "save_youself" handler to request that a 
(modal) dialog is presented to the user. The session manager decides 
when the dialog is shown but it will not be shown it unless the 
interact_style == GNOME_INTERACT_ANY. A "Cancel Logout" button 
will be added during a shutdown.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13814"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME dialog widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13827"
></A
><H3
><A
NAME="GNOME-CLIENT-SAVE-ERROR-DIALOG"
></A
>gnome_client_save_error_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_save_error_dialog  (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog);</PRE
></TD
></TR
></TABLE
><P
>May be called during a "save_youself" handler when an error has occured 
during the save. The session manager decides when the dialog is shown 
but it will not be shown when the interact_style == GNOME_INTERACT_NONE.
A "Cancel Logout" button will be added during a shutdown.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13835"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME dialog widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13848"
></A
><H3
><A
NAME="GNOME-CLIENT-REQUEST-INTERACTION"
></A
>gnome_client_request_interaction ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_request_interaction
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF="gnomeclient.html#GNOMEDIALOGTYPE"
>GnomeDialogType</A
> dialog,
                                             <A
HREF="gnomeclient.html#GNOMEINTERACTFUNCTION"
>GnomeInteractFunction</A
> func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> client_data);</PRE
></TD
></TR
></TABLE
><P
>Use the following functions, if you want to interact
with the user during a "save_yourself" handler without being
restricted to using the dialog based commands
gnome_client_save_[any/error]_dialog.  If and when the session
manager decides that it's the app's turn to interact then 'func'
will be called with the specified arguments and a unique
'GnomeInteractionKey'. The session manager will block other clients
from interacting until this key is returned with
'gnome_interaction_key_return'.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13858"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13879"
></A
><H3
><A
NAME="GNOME-CLIENT-REQUEST-INTERACTION-INTERP"
></A
>gnome_client_request_interaction_interp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_request_interaction_interp
                                            (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF="gnomeclient.html#GNOMEDIALOGTYPE"
>GnomeDialogType</A
> dialog,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> destroy);</PRE
></TD
></TR
></TABLE
><P
>Used when you need to destroy the callback data after the interaction.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13890"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> callback data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>destroy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> function to destroy callback data</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13915"
></A
><H3
><A
NAME="GNOME-INTERACTION-KEY-RETURN"
></A
>gnome_interaction_key_return ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_interaction_key_return    (<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> key,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> cancel_shutdown);</PRE
></TD
></TR
></TABLE
><P
>Used in interaction callback to tell the session manager
you're done interacting</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13923"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>key</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Key passed to interaction callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cancel_shutdown</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> if TRUE then cancel the shutdown</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13936"
></A
><H3
><A
NAME="GNOME-CLIENT-REQUEST-SAVE"
></A
>gnome_client_request_save ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_request_save       (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                             <A
HREF="gnomeclient.html#GNOMESAVESTYLE"
>GnomeSaveStyle</A
> save_style,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> shutdown,
                                             <A
HREF="gnomeclient.html#GNOMEINTERACTSTYLE"
>GnomeInteractStyle</A
> interact_style,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> fast,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> global);</PRE
></TD
></TR
></TABLE
><P
>Request the session manager to save the session in
some way. The arguments correspond with the arguments passed to the
"save_yourself" signal handler.</P
><P
>The save_style indicates whether the save should affect data
accessible to other users (GNOME_SAVE_GLOBAL) or only the state
visible to the current user (GNOME_SAVE_LOCAL) or both. Setting
shutdown to TRUE will initiate a logout. The interact_style
specifies which kinds of interaction will be available. Setting
fast to TRUE will limit the save to setting the session manager
properties plus any essential data.  Setting the value of global to
TRUE will request that all the other apps in the session do a save
as well. A global save is mandatory when doing a shutdown.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13949"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>save_style</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Save style to request</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>shutdown</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Whether to log out of the session</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interact_style</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> whether to allow user interaction</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fast</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> minimize activity to save ASAP</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>global</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> request that all other apps in the session also save</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13978"
></A
><H3
><A
NAME="GNOME-CLIENT-FLUSH"
></A
>gnome_client_flush ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_flush              (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client);</PRE
></TD
></TR
></TABLE
><P
>This will force the underlying connection to the session manager to
be flushed.  This is useful if you have some pending changes that
you want to make sure get committed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN13985"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME session client object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13994"
></A
><H3
><A
NAME="GNOME-CLIENT-INIT"
></A
>gnome_client_init ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_client_init               (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14000"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN14002"
></A
><H3
><A
NAME="GNOMECLIENT-SAVE-YOURSELF"
></A
>The &quot;save-yourself&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function                  (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg2,
                                            <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> arg3,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg4,
                                            <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> arg5,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is probably the most important one, because it causes the
clients to save the programs state.  Clients should connect to this
signal and save their state.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14015"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg3</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg4</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg5</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14052"
></A
><H3
><A
NAME="GNOMECLIENT-DIE"
></A
>The &quot;die&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>Emitted when the client should exit.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14059"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14072"
></A
><H3
><A
NAME="GNOMECLIENT-SAVE-COMPLETE"
></A
>The &quot;save-complete&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>Emitted when everything is saved.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14079"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14092"
></A
><H3
><A
NAME="GNOMECLIENT-SHUTDOWN-CANCELLED"
></A
>The &quot;shutdown-cancelled&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>Emitted if the user or a client cancels the logout.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14099"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14112"
></A
><H3
><A
NAME="GNOMECLIENT-CONNECT"
></A
>The &quot;connect&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                            <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>Emitted on connection to the session manager.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14120"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14137"
></A
><H3
><A
NAME="GNOMECLIENT-DISCONNECT"
></A
>The &quot;disconnect&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeclient.html"
>GnomeClient</A
> *client,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>Emitted on disconnection from the session manager.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14144"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>client</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecanvaswidget.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomecolorpicker.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
>GnomeCanvasWidget</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeColorPicker</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeColorPicker</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeClient"
HREF="gnomeclient.html"><LINK
REL="NEXT"
TITLE="GnomeDateEdit"
HREF="gnomedateedit.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeclient.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedateedit.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMECOLORPICKER"
>GnomeColorPicker</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN14162"
></A
><H2
>Name</H2
>GnomeColorPicker&nbsp;--&nbsp;Widget for selecting colors.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN14165"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomecolorpicker.html#GNOMECOLORPICKER-STRUCT"
>GnomeColorPicker</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomecolorpicker.html#GNOME-COLOR-PICKER-NEW"
>gnome_color_picker_new</A
>          (void);
void        <A
HREF="gnomecolorpicker.html#GNOME-COLOR-PICKER-SET-D"
>gnome_color_picker_set_d</A
>        (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> r,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> g,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> b,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> a);
void        <A
HREF="gnomecolorpicker.html#GNOME-COLOR-PICKER-GET-D"
>gnome_color_picker_get_d</A
>        (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> *r,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> *g,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> *b,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> *a);
void        <A
HREF="gnomecolorpicker.html#GNOME-COLOR-PICKER-SET-I8"
>gnome_color_picker_set_i8</A
>       (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> r,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> g,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> b,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> a);
void        <A
HREF="gnomecolorpicker.html#GNOME-COLOR-PICKER-GET-I8"
>gnome_color_picker_get_i8</A
>       (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> *r,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> *g,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> *b,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> *a);
void        <A
HREF="gnomecolorpicker.html#GNOME-COLOR-PICKER-SET-I16"
>gnome_color_picker_set_i16</A
>      (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> r,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> g,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> b,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> a);
void        <A
HREF="gnomecolorpicker.html#GNOME-COLOR-PICKER-GET-I16"
>gnome_color_picker_get_i16</A
>      (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> *r,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> *g,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> *b,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> *a);
void        <A
HREF="gnomecolorpicker.html#GNOME-COLOR-PICKER-SET-DITHER"
>gnome_color_picker_set_dither</A
>   (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> dither);
void        <A
HREF="gnomecolorpicker.html#GNOME-COLOR-PICKER-SET-USE-ALPHA"
>gnome_color_picker_set_use_alpha</A
>
                                            (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> use_alpha);
void        <A
HREF="gnomecolorpicker.html#GNOME-COLOR-PICKER-SET-TITLE"
>gnome_color_picker_set_title</A
>    (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14216"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----<A
HREF=../gtk/gtkbutton.html
>GtkButton</A>
                           +----GnomeColorPicker</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14224"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomecolorpicker.html#GNOMECOLORPICKER-COLOR-SET"
>color-set</A
>&quot; void        user_function      (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *colorpicker,
                                            <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> arg2,
                                            <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> arg3,
                                            <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> arg4,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14234"
></A
><H2
>Description</H2
><P
>This widget provides color selection facilities to your application.
The widget appears as a button which contains a "color swatch" of the
currently selected color. When the button is pressed, the widget
presents the user with a color selection dialog where the color can be
selected. </P
><P
>You can select the color to be displayed in a number of ways:
floating point values for the red, green and blue channels,
integers in the range 0 to 65,535, or integers in the range 0 to 255,
depending on your needs.</P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN14238"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void color_picked_callback(GtkWidget *w, guint r, guint g, guint b, guint a, gpointer data)
{
	g_print("User selected color (rgba): <TT
CLASS="LITERAL"
>d</TT
> <TT
CLASS="LITERAL"
>d</TT
> <TT
CLASS="LITERAL"
>d</TT
> <TT
CLASS="LITERAL"
>d</TT
>\n", r, g, b, a);
	/* save colors to configuration file, or use them some other way */
}
...
GtkWidget *cp;

/* create a color picker, set a default color */
cp = <A
HREF="gnomecolorpicker.html#GNOME-COLOR-PICKER-NEW"
>gnome_color_picker_new</A
>();
<A
HREF="gnomecolorpicker.html#GNOME-COLOR-PICKER-SET-I8"
>gnome_color_picker_set_i8</A
>(GNOME_COLOR_PICKER(cp),
			  255, 0, 0, 0);

/* connect a function to our widget */
gtk_signal_connect(GTK_OBJECT(cp), "color_set",
		   GTK_SIGNAL_FUNC(color_picked_callback), NULL);
...
/* retrieve color from our widget, someplace else in code */
gdouble r, g, b, a;
<A
HREF="gnomecolorpicker.html#GNOME-COLOR-PICKER-GET-D"
>gnome_color_picker_get_d</A
>(GNOME_COLOR_PICKER(cp),
			 &amp;r, &amp;g, &amp;b, &amp;a);
g_print("Color (rgba): %<TT
CLASS="LITERAL"
>g</TT
> %<TT
CLASS="LITERAL"
>g</TT
> %<TT
CLASS="LITERAL"
>g</TT
> %<TT
CLASS="LITERAL"
>g</TT
>\n", r, g, b, a);
  </PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14251"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN14253"
></A
><H3
><A
NAME="GNOMECOLORPICKER-STRUCT"
></A
>struct GnomeColorPicker</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeColorPicker;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14258"
></A
><H3
><A
NAME="GNOME-COLOR-PICKER-NEW"
></A
>gnome_color_picker_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_color_picker_new          (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a new GNOME color picker widget. This returns a widget in the form of a small button
containing a swatch representing the current selected color. When the button is clicked,
a color-selection dialog will open, allowing the user to select a color. The swatch will be
updated to reflect the new color when the user finishes.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14265"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to new GNOME color picker widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14274"
></A
><H3
><A
NAME="GNOME-COLOR-PICKER-SET-D"
></A
>gnome_color_picker_set_d ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_color_picker_set_d        (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> r,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> g,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> b,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> a);</PRE
></TD
></TR
></TABLE
><P
>Set color shown in the color picker widget using floating point values.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14285"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME color picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>r</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Red color component, values are in [0.0, 1.0]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>g</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Green color component, values are in [0.0, 1.0]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Blue color component, values are in [0.0, 1.0]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>a</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Alpha component, values are in [0.0, 1.0]</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14310"
></A
><H3
><A
NAME="GNOME-COLOR-PICKER-GET-D"
></A
>gnome_color_picker_get_d ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_color_picker_get_d        (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> *r,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> *g,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> *b,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> *a);</PRE
></TD
></TR
></TABLE
><P
>Retrieve color currently selected in the color picker widget in the form of floating point values.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14321"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME color picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>r</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Output location of red color component, values are in [0.0, 1.0]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>g</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Output location of green color component, values are in [0.0, 1.0]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Output location of blue color component, values are in [0.0, 1.0]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>a</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Output location of alpha color component, values are in [0.0, 1.0]</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14346"
></A
><H3
><A
NAME="GNOME-COLOR-PICKER-SET-I8"
></A
>gnome_color_picker_set_i8 ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_color_picker_set_i8       (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> r,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> g,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> b,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> a);</PRE
></TD
></TR
></TABLE
><P
>Set color shown in the color picker widget using 8-bit integer values.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14357"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME color picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>r</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Red color component, values are in [0, 255]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>g</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Green color component, values are in [0, 255]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Blue color component, values are in [0, 255]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>a</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Alpha component, values are in [0, 255]</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14382"
></A
><H3
><A
NAME="GNOME-COLOR-PICKER-GET-I8"
></A
>gnome_color_picker_get_i8 ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_color_picker_get_i8       (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> *r,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> *g,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> *b,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> *a);</PRE
></TD
></TR
></TABLE
><P
>Retrieve color currently selected in the color picker widget in the form of 8-bit integer values.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14393"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME color picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>r</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Output location of red color component, values are in [0, 255]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>g</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Output location of green color component, values are in [0, 255]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Output location of blue color component, values are in [0, 255]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>a</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Output location of alpha color component, values are in [0, 255]</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14418"
></A
><H3
><A
NAME="GNOME-COLOR-PICKER-SET-I16"
></A
>gnome_color_picker_set_i16 ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_color_picker_set_i16      (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> r,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> g,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> b,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> a);</PRE
></TD
></TR
></TABLE
><P
>Set color shown in the color picker widget using 16-bit integer values.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14429"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME color picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>r</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Red color component, values are in [0, 65535]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>g</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Green color component, values are in [0, 65535]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Blue color component, values are in [0, 65535]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>a</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Alpha component, values are in [0, 65535]</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14454"
></A
><H3
><A
NAME="GNOME-COLOR-PICKER-GET-I16"
></A
>gnome_color_picker_get_i16 ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_color_picker_get_i16      (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> *r,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> *g,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> *b,
                                             <A
HREF=../glib/glib-basic-types.html#GUSHORT
>gushort</A> *a);</PRE
></TD
></TR
></TABLE
><P
>Retrieve color currently selected in the color picker widget in the form of 16-bit integer values.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14465"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME color picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>r</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Output location of red color component, values are in [0, 65535]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>g</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Output location of green color component, values are in [0, 65535]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Output location of blue color component, values are in [0, 65535]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>a</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Output location of alpha color component, values are in [0, 65535]</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14490"
></A
><H3
><A
NAME="GNOME-COLOR-PICKER-SET-DITHER"
></A
>gnome_color_picker_set_dither ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_color_picker_set_dither   (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> dither);</PRE
></TD
></TR
></TABLE
><P
>Sets whether the picker should dither the color sample or just paint
a solid rectangle.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14498"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME color picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dither</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if color sample should be dithered, <TT
CLASS="LITERAL"
>FALSE</TT
> if not.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14513"
></A
><H3
><A
NAME="GNOME-COLOR-PICKER-SET-USE-ALPHA"
></A
>gnome_color_picker_set_use_alpha ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_color_picker_set_use_alpha
                                            (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> use_alpha);</PRE
></TD
></TR
></TABLE
><P
>Sets whether or not the picker should use the alpha channel.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14521"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME color picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>use_alpha</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if color sample should use alpha channel, <TT
CLASS="LITERAL"
>FALSE</TT
> if not.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14536"
></A
><H3
><A
NAME="GNOME-COLOR-PICKER-SET-TITLE"
></A
>gnome_color_picker_set_title ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_color_picker_set_title    (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *cp,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);</PRE
></TD
></TR
></TABLE
><P
>Sets the title for the color selection dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14544"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME color picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> String containing new window title.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14557"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN14559"
></A
><H3
><A
NAME="GNOMECOLORPICKER-COLOR-SET"
></A
>The &quot;color-set&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> *colorpicker,
                                            <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> arg2,
                                            <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> arg3,
                                            <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> arg4,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is emitted when the user changes the color on the color
selector.  The values passed to this signal are the red, green, blue
and alpha channels selected in integer form in the range 0 to 65535.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14570"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>colorpicker</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Red color component, values are in [0, 65535]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Green color component, values are in [0, 65535]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg3</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Blue color component, values are in [0, 65535]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg4</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Alpha component, values are in [0, 65535]</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>User data set when the signal handler was connected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeclient.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedateedit.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
>GnomeClient</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeDateEdit</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeDateEdit</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeColorPicker"
HREF="gnomecolorpicker.html"><LINK
REL="NEXT"
TITLE="GnomeDEntryEdit"
HREF="gnomedentryedit.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecolorpicker.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedentryedit.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEDATEEDIT"
>GnomeDateEdit</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN14612"
></A
><H2
>Name</H2
>GnomeDateEdit&nbsp;--&nbsp;Date and time entry widget.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN14615"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


typedef     <A
HREF="gnomedateedit.html"
>GnomeDateEdit</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedateedit.html#GNOME-DATE-EDIT-NEW"
>gnome_date_edit_new</A
>             (time_t the_time,
                                             int show_time,
                                             int use_24_format);
void        <A
HREF="gnomedateedit.html#GNOME-DATE-EDIT-SET-TIME"
>gnome_date_edit_set_time</A
>        (<A
HREF="gnomedateedit.html"
>GnomeDateEdit</A
> *gde,
                                             time_t the_time);
void        <A
HREF="gnomedateedit.html#GNOME-DATE-EDIT-SET-POPUP-RANGE"
>gnome_date_edit_set_popup_range</A
> (<A
HREF="gnomedateedit.html"
>GnomeDateEdit</A
> *gde,
                                             int low_hour,
                                             int up_hour);
time_t      <A
HREF="gnomedateedit.html#GNOME-DATE-EDIT-GET-DATE"
>gnome_date_edit_get_date</A
>        (<A
HREF="gnomedateedit.html"
>GnomeDateEdit</A
> *gde);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14630"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbox.html
>GtkBox</A>
                     +----<A
HREF=../gtk/gtkhbox.html
>GtkHBox</A>
                           +----GnomeDateEdit</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14638"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomedateedit.html#GNOMEDATEEDIT-DATE-CHANGED"
>date-changed</A
>&quot;
            void        user_function      (<A
HREF="gnomedateedit.html"
>GnomeDateEdit</A
> *dateedit,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomedateedit.html#GNOMEDATEEDIT-TIME-CHANGED"
>time-changed</A
>&quot;
            void        user_function      (<A
HREF="gnomedateedit.html"
>GnomeDateEdit</A
> *dateedit,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14647"
></A
><H2
>Description</H2
><P
>The <SPAN
CLASS="TYPE"
>GnomeDateEdit</SPAN
> widget provides a way to enter dates and
times with a helper calendar to let the user select the date.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14651"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN14653"
></A
><H3
><A
NAME="GNOMEDATEEDIT"
></A
>GnomeDateEdit</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct {
	GtkHBox hbox;

	GtkWidget *date_entry;
	GtkWidget *date_button;
	
	GtkWidget *time_entry;
	GtkWidget *time_popup;

	GtkWidget *cal_label;
	GtkWidget *cal_popup;
	GtkWidget *calendar;

	int       lower_hour;
	int       upper_hour;
	
	time_t    initial_time;
	int       flags;
} GnomeDateEdit;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14658"
></A
><H3
><A
NAME="GNOME-DATE-EDIT-NEW"
></A
>gnome_date_edit_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_date_edit_new             (time_t the_time,
                                             int show_time,
                                             int use_24_format);</PRE
></TD
></TR
></TABLE
><P
>Creates a new GnomeDateEdit widget which can be used to provide
an easy to use way for entering dates and times.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14666"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>the_time</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> date and time to be displayed on the widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>show_time</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> whether time should be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>use_24_format</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> whether 24-hour format is desired for the time display.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a GnomeDateEdit widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14687"
></A
><H3
><A
NAME="GNOME-DATE-EDIT-SET-TIME"
></A
>gnome_date_edit_set_time ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_date_edit_set_time        (<A
HREF="gnomedateedit.html"
>GnomeDateEdit</A
> *gde,
                                             time_t the_time);</PRE
></TD
></TR
></TABLE
><P
>Changes the displayed date and time in the GnomeDateEdit widget
to be the one represented by <TT
CLASS="PARAMETER"
><I
>the_time</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14696"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gde</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the GnomeDateEdit widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>the_time</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The time and date that should be set on the widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14709"
></A
><H3
><A
NAME="GNOME-DATE-EDIT-SET-POPUP-RANGE"
></A
>gnome_date_edit_set_popup_range ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_date_edit_set_popup_range (<A
HREF="gnomedateedit.html"
>GnomeDateEdit</A
> *gde,
                                             int low_hour,
                                             int up_hour);</PRE
></TD
></TR
></TABLE
><P
>Sets the range of times that will be provide by the time popup
selectors.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14716"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gde</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeDateEdit widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>low_hour</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> low boundary for the time-range display popup.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>up_hour</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  upper boundary for the time-range display popup.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14733"
></A
><H3
><A
NAME="GNOME-DATE-EDIT-GET-DATE"
></A
>gnome_date_edit_get_date ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>time_t      gnome_date_edit_get_date        (<A
HREF="gnomedateedit.html"
>GnomeDateEdit</A
> *gde);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14741"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gde</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeDateEdit widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the time entered in the GnomeDateEdit widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14754"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN14756"
></A
><H3
><A
NAME="GNOMEDATEEDIT-DATE-CHANGED"
></A
>The &quot;date-changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomedateedit.html"
>GnomeDateEdit</A
> *dateedit,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14763"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dateedit</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14776"
></A
><H3
><A
NAME="GNOMEDATEEDIT-TIME-CHANGED"
></A
>The &quot;time-changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomedateedit.html"
>GnomeDateEdit</A
> *dateedit,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14783"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dateedit</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomecolorpicker.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedentryedit.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
>GnomeColorPicker</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeDEntryEdit</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeDEntryEdit</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeDateEdit"
HREF="gnomedateedit.html"><LINK
REL="NEXT"
TITLE="GnomeDialog"
HREF="gnomedialog.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedateedit.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedialog.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEDENTRYEDIT"
>GnomeDEntryEdit</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN14801"
></A
><H2
>Name</H2
>GnomeDEntryEdit&nbsp;--&nbsp;Editing object for dentries (.desktop files)</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN14804"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomedentryedit.html#GNOMEDENTRYEDIT-STRUCT"
>GnomeDEntryEdit</A
>;
<A
HREF=../gtk/gtkobject.html
>GtkObject</A>*  <A
HREF="gnomedentryedit.html#GNOME-DENTRY-EDIT-NEW"
>gnome_dentry_edit_new</A
>           (void);
#define     <A
HREF="gnomedentryedit.html#GNOME-DENTRY-EDIT-CHILD1"
>gnome_dentry_edit_child1</A
>        (d)
#define     <A
HREF="gnomedentryedit.html#GNOME-DENTRY-EDIT-CHILD2"
>gnome_dentry_edit_child2</A
>        (d)
<A
HREF=../gtk/gtkobject.html
>GtkObject</A>*  <A
HREF="gnomedentryedit.html#GNOME-DENTRY-EDIT-NEW-NOTEBOOK"
>gnome_dentry_edit_new_notebook</A
>  (<A
HREF=../gtk/gtknotebook.html
>GtkNotebook</A> *notebook);
void        <A
HREF="gnomedentryedit.html#GNOME-DENTRY-EDIT-CLEAR"
>gnome_dentry_edit_clear</A
>         (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dee);
void        <A
HREF="gnomedentryedit.html#GNOME-DENTRY-EDIT-LOAD-FILE"
>gnome_dentry_edit_load_file</A
>     (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dee,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path);
void        <A
HREF="gnomedentryedit.html#GNOME-DENTRY-EDIT-SET-DENTRY"
>gnome_dentry_edit_set_dentry</A
>    (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dee,
                                             <A
HREF=../gnome/gnome-gnome-dentry.html#GNOMEDESKTOPENTRY
>GnomeDesktopEntry</A> *dentry);
<A
HREF=../gnome/gnome-gnome-dentry.html#GNOMEDESKTOPENTRY
>GnomeDesktopEntry</A>* <A
HREF="gnomedentryedit.html#GNOME-DENTRY-GET-DENTRY"
>gnome_dentry_get_dentry</A
>  (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dee);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomedentryedit.html#GNOME-DENTRY-EDIT-GET-ICON"
>gnome_dentry_edit_get_icon</A
>      (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dee);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomedentryedit.html#GNOME-DENTRY-EDIT-GET-NAME"
>gnome_dentry_edit_get_name</A
>      (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dee);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14832"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----GnomeDEntryEdit</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14836"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomedentryedit.html#GNOMEDENTRYEDIT-CHANGED"
>changed</A
>&quot;   void        user_function      (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dentryedit,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomedentryedit.html#GNOMEDENTRYEDIT-ICON-CHANGED"
>icon-changed</A
>&quot;
            void        user_function      (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dentryedit,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomedentryedit.html#GNOMEDENTRYEDIT-NAME-CHANGED"
>name-changed</A
>&quot;
            void        user_function      (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dentryedit,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14848"
></A
><H2
>Description</H2
><P
>  GnomeDEntryEdit is a simpleobject, not a widget.  It is used for adding
  pages to a property notebook for editing a .desktop entry (such
  as in the menu editor).  Since it is not a widget you don't add it to the
  notebook, but you use the <A
HREF="gnomedentryedit.html#GNOME-DENTRY-EDIT-NEW-NOTEBOOK"
>gnome_dentry_edit_new_notebook</A
> method to make
  a new object and automatically add it as the last page to a notebook.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN14852"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN14854"
></A
><H3
><A
NAME="GNOMEDENTRYEDIT-STRUCT"
></A
>struct GnomeDEntryEdit</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeDEntryEdit;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14859"
></A
><H3
><A
NAME="GNOME-DENTRY-EDIT-NEW"
></A
>gnome_dentry_edit_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkobject.html
>GtkObject</A>*  gnome_dentry_edit_new           (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a new <A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> object. The object is not
a widget, but just an object which creates some widgets which you have
to add to a notebook. Use the <A
HREF="gnomedentryedit.html#GNOME-DENTRY-EDIT-NEW-NOTEBOOK"
>gnome_dentry_edit_new_notebook</A
> to add
pages to the notebook.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14868"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Newly-created <A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14878"
></A
><H3
><A
NAME="GNOME-DENTRY-EDIT-CHILD1"
></A
>gnome_dentry_edit_child1()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_dentry_edit_child1(d)</PRE
></TD
></TR
></TABLE
><P
>  Get the first child widget pointer (page 1, basic), if you want to
  add it to a notebook yourself.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14883"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>d</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the GnomeDEntryEdit object to work with
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14892"
></A
><H3
><A
NAME="GNOME-DENTRY-EDIT-CHILD2"
></A
>gnome_dentry_edit_child2()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_dentry_edit_child2(d)</PRE
></TD
></TR
></TABLE
><P
>  Get the first child widget pointer (page 2, advanced), if you want to
  add it to a notebook yourself.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14897"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>d</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the GnomeDEntryEdit object to work with
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14906"
></A
><H3
><A
NAME="GNOME-DENTRY-EDIT-NEW-NOTEBOOK"
></A
>gnome_dentry_edit_new_notebook ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkobject.html
>GtkObject</A>*  gnome_dentry_edit_new_notebook  (<A
HREF=../gtk/gtknotebook.html
>GtkNotebook</A> *notebook);</PRE
></TD
></TR
></TABLE
><P
>Creates a new <A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> object and adds it's pages
to the <TT
CLASS="PARAMETER"
><I
>notebook</I
></TT
> specified in the parameter.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14916"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>notebook</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> notebook to add the pages to</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Newly-created <A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14930"
></A
><H3
><A
NAME="GNOME-DENTRY-EDIT-CLEAR"
></A
>gnome_dentry_edit_clear ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dentry_edit_clear         (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dee);</PRE
></TD
></TR
></TABLE
><P
>Clear the editting areas.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14937"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dee</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> object to work with</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14947"
></A
><H3
><A
NAME="GNOME-DENTRY-EDIT-LOAD-FILE"
></A
>gnome_dentry_edit_load_file ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dentry_edit_load_file     (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dee,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path);</PRE
></TD
></TR
></TABLE
><P
>Load a .desktop file and update the editting areas
of the object accordingly.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14955"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dee</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> object to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> file to load into the editting areas</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14969"
></A
><H3
><A
NAME="GNOME-DENTRY-EDIT-SET-DENTRY"
></A
>gnome_dentry_edit_set_dentry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dentry_edit_set_dentry    (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dee,
                                             <A
HREF=../gnome/gnome-gnome-dentry.html#GNOMEDESKTOPENTRY
>GnomeDesktopEntry</A> *dentry);</PRE
></TD
></TR
></TABLE
><P
>Destroy existing dentry and replace
it with this one, updating the <A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> to reflect it.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN14978"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dee</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> object to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF=../gnome/gnome-gnome-dentry.html#GNOMEDESKTOPENTRY
>GnomeDesktopEntry</A> to use</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN14993"
></A
><H3
><A
NAME="GNOME-DENTRY-GET-DENTRY"
></A
>gnome_dentry_get_dentry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gnome/gnome-gnome-dentry.html#GNOMEDESKTOPENTRY
>GnomeDesktopEntry</A>* gnome_dentry_get_dentry  (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dee);</PRE
></TD
></TR
></TABLE
><P
>This call is actually the gnome_dentry_edit_get_dentry,
it should not be used, it is left ONLY for compatibility reasons.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15002"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dee</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> object to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a newly allocated <A
HREF=../gnome/gnome-gnome-dentry.html#GNOMEDESKTOPENTRY
>GnomeDesktopEntry</A> structure.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15017"
></A
><H3
><A
NAME="GNOME-DENTRY-EDIT-GET-ICON"
></A
>gnome_dentry_edit_get_icon ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_dentry_edit_get_icon      (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dee);</PRE
></TD
></TR
></TABLE
><P
>Get the icon filename. The icon is entered into a
<A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
>, so the semantics of this call are the same as
for <A
HREF="gnomeiconentry.html#GNOME-ICON-ENTRY-GET-FILENAME"
>gnome_icon_entry_get_filename</A
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15027"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dee</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> object to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a newly allocated string with the filename of the icon</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15041"
></A
><H3
><A
NAME="GNOME-DENTRY-EDIT-GET-NAME"
></A
>gnome_dentry_edit_get_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_dentry_edit_get_name      (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dee);</PRE
></TD
></TR
></TABLE
><P
>Get the Name field from the dentry.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15049"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dee</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> object to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a newly allocated string with the name of the dentry</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15063"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN15065"
></A
><H3
><A
NAME="GNOMEDENTRYEDIT-CHANGED"
></A
>The &quot;changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dentryedit,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>  Something has changed in the editing areas.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15072"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dentryedit</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15085"
></A
><H3
><A
NAME="GNOMEDENTRYEDIT-ICON-CHANGED"
></A
>The &quot;icon-changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dentryedit,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>  The icon entry has changed.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15092"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dentryedit</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15105"
></A
><H3
><A
NAME="GNOMEDENTRYEDIT-NAME-CHANGED"
></A
>The &quot;name-changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> *dentryedit,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>  The name entry has changed.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15112"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dentryedit</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedateedit.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedialog.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
>GnomeDateEdit</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeDialog</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeDialog</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeDEntryEdit"
HREF="gnomedentryedit.html"><LINK
REL="NEXT"
TITLE="GnomeDockBand"
HREF="gnomedockband.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedentryedit.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedockband.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEDIALOG"
>GnomeDialog</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN15130"
></A
><H2
>Name</H2
>GnomeDialog&nbsp;--&nbsp;Transient ("popup") dialogs.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN15133"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomedialog.html#GNOMEDIALOG-STRUCT"
>GnomeDialog</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedialog.html#GNOME-DIALOG-NEW"
>gnome_dialog_new</A
>                (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             ...);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedialog.html#GNOME-DIALOG-NEWV"
>gnome_dialog_newv</A
>               (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **buttons);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-SET-PARENT"
>gnome_dialog_set_parent</A
>         (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-BUTTON-CONNECT"
>gnome_dialog_button_connect</A
>     (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> button,
                                             <A
HREF=../gtk/gtk-types.html#GTKSIGNALFUNC
>GtkSignalFunc</A> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-BUTTON-CONNECT-OBJECT"
>gnome_dialog_button_connect_object</A
>
                                            (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> button,
                                             <A
HREF=../gtk/gtk-types.html#GTKSIGNALFUNC
>GtkSignalFunc</A> callback,
                                             <A
HREF=../gtk/gtkobject.html
>GtkObject</A> *obj);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomedialog.html#GNOME-DIALOG-RUN"
>gnome_dialog_run</A
>                (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomedialog.html#GNOME-DIALOG-RUN-AND-CLOSE"
>gnome_dialog_run_and_close</A
>      (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-SET-DEFAULT"
>gnome_dialog_set_default</A
>        (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> button);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-SET-SENSITIVE"
>gnome_dialog_set_sensitive</A
>      (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> button,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> setting);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-SET-ACCELERATOR"
>gnome_dialog_set_accelerator</A
>    (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> button,
                                             const <A
HREF=../glib/glib-basic-types.html#GUCHAR
>guchar</A> accelerator_key,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> accelerator_mods);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-CLOSE"
>gnome_dialog_close</A
>              (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-CLOSE-HIDES"
>gnome_dialog_close_hides</A
>        (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> just_hide);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-SET-CLOSE"
>gnome_dialog_set_close</A
>          (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> click_closes);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-EDITABLE-ENTERS"
>gnome_dialog_editable_enters</A
>    (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../gtk/gtkeditable.html
>GtkEditable</A> *editable);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-APPEND-BUTTONS"
>gnome_dialog_append_buttons</A
>     (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *first,
                                             ...);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-APPEND-BUTTON"
>gnome_dialog_append_button</A
>      (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-APPEND-BUTTONSV"
>gnome_dialog_append_buttonsv</A
>    (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **buttons);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-APPEND-BUTTON-WITH-PIXMAP"
>gnome_dialog_append_button_with_pixmap</A
>
                                            (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *pixmap);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-APPEND-BUTTONS-WITH-PIXMAPS"
>gnome_dialog_append_buttons_with_pixmaps</A
>
                                            (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **names,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **pixmaps);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-CONSTRUCT"
>gnome_dialog_construct</A
>          (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             va_list ap);
void        <A
HREF="gnomedialog.html#GNOME-DIALOG-CONSTRUCTV"
>gnome_dialog_constructv</A
>         (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **buttons);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15210"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----<A
HREF=../gtk/gtkwindow.html
>GtkWindow</A>
                           +----GnomeDialog</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15218"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomedialog.html#GNOMEDIALOG-CLICKED"
>clicked</A
>&quot;   void        user_function      (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomedialog.html#GNOMEDIALOG-CLOSE"
>close</A
>&quot;     <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        user_function      (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15229"
></A
><H2
>Description</H2
><P
>GnomeDialog gives dialogs a consistent look and feel, while making
them more convenient to program. GnomeDialog makes it easy to use
stock buttons, makes it easier to handle delete_event, and adds some
cosmetic touches (such as a separator above the buttons, and a bevel
around the edge of the window). </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15232"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN15234"
></A
><H3
><A
NAME="GNOMEDIALOG-STRUCT"
></A
>struct GnomeDialog</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeDialog {
  GtkWidget * vbox;
};</PRE
></TD
></TR
></TABLE
><P
>struct _GnomeDialog
{
    	GtkWindow window;
    	GtkWidget * vbox;
      
    	GtkWidget * action_area; /* A button box, not an hbox */
      
    	GList *buttons;
    	GtkAccelGroup * accelerators;
      
    	unsigned int click_closes : 1;
    	unsigned int just_hide : 1;
      
    	gpointer padding;
};</P
><P
>Only <TT
CLASS="STRUCTFIELD"
><I
>vbox</I
></TT
> should be accessed directly.</P
><DIV
CLASS="EXAMPLE"
><A
NAME="AEN15241"
></A
><P
><B
>Example 1. Using GnomeDialog to implement yes/no/cancel</B
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>include <FONT
COLOR="RED"
>&#13;/*
 * This function demostrates how to use the GnomeDialog in
 * modal mode to request a yes/no from the user.
 *
 * It sets the title to title and inserts the message in message.
 *
 * If main_window is not NULL, it also binds the dialog to that
 * window (so if you minimize the main window, this dialog also
 * gets minimized).
 */
int
yes_no (GtkWindow *main_window, char *title, char *message)
{
	GtkWidget *dialog, *label;
	int button;

	dialog = gnome_dialog_new (
		title,
		GNOME_STOCK_BUTTON_YES,
		GNOME_STOCK_BUTTON_NO,
		NULL);
        if (main_window)
	        gnome_dialog_set_parent (GNOME_DIALOG (dialog), main_window);

	label = gtk_label_new (message);
        gtk_box_pack_start (GTK_BOX (GNOME_DIALOG (dialog)-&#62;vbox), label, TRUE, TRUE, 0);

	/*
	 * Run the dialog and wait for the user to select yes or no.
	 * If the user closes the window with the window manager, we
	 * will get a -1 return value
	 */
	button = gnome_dialog_run_and_close (GNOME_DIALOG (dialog));

	return button;
}

int
main (int argc, char **argv)
{
       int button;
       
       gnome_init ("SampleProgram", "1.0", argc, argv);

       button = yes_no ("Question?", "Do you like the Bonobos?");

       switch (button){
              case 0:
	              printf ("User selected yes\n");
		      break;
	      case 1:
	              printf ("User selected no\n");
		      break;
	      case -1:
	              printf ("User closed the window with the window manager\n");
		      break;
       }
       return 0;
}&#13;</FONT
></PRE
></TD
></TR
></TABLE
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15246"
></A
><H3
><A
NAME="GNOME-DIALOG-NEW"
></A
>gnome_dialog_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_dialog_new                (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             ...);</PRE
></TD
></TR
></TABLE
><P
>Creates a new <A
HREF="gnomedialog.html"
>GnomeDialog</A
>, with the given title, and any button names 
in the arg list. Buttons can be simple names, such as _("My Button"),
or gnome-stock defines such as <TT
CLASS="LITERAL"
>GNOME_STOCK_BUTTON_OK</TT
>, etc. The last
argument should be NULL to terminate the list.  </P
><P
>Buttons passed to this function are numbered from left to right,
starting with 0. So the first button in the arglist is button 0,
then button 1, etc.  These numbers are used throughout the
<A
HREF="gnomedialog.html"
>GnomeDialog</A
> API.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15258"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The title of the dialog; appears in window titlebar.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>...</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> NULL-terminated varargs list of button names or GNOME_STOCK_BUTTON_* defines.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The new <A
HREF="gnomedialog.html"
>GnomeDialog</A
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15276"
></A
><H3
><A
NAME="GNOME-DIALOG-NEWV"
></A
>gnome_dialog_newv ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_dialog_newv               (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **buttons);</PRE
></TD
></TR
></TABLE
><P
>See <A
HREF="gnomedialog.html#GNOME-DIALOG-NEW"
>gnome_dialog_new</A
>(), this function is identical but does not use
varargs.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15286"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Title of the dialog.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>buttons</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> NULL-terminated vector of buttons names.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The new <A
HREF="gnomedialog.html"
>GnomeDialog</A
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15304"
></A
><H3
><A
NAME="GNOME-DIALOG-SET-PARENT"
></A
>gnome_dialog_set_parent ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_set_parent         (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);</PRE
></TD
></TR
></TABLE
><P
>Dialogs have "parents," usually the main application window which spawned 
them. This function will let the window manager know about the parent-child
relationship. Usually this means the dialog must stay on top of the parent,
and will be minimized when the parent is. Gnome also allows users to 
request dialog placement above the parent window (vs. at the mouse position,
or at a default window manger location).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15312"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to set the parent of.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15327"
></A
><H3
><A
NAME="GNOME-DIALOG-BUTTON-CONNECT"
></A
>gnome_dialog_button_connect ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_button_connect     (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> button,
                                             <A
HREF=../gtk/gtk-types.html#GTKSIGNALFUNC
>GtkSignalFunc</A> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Simply <A
HREF=../gtk/gtk-signals.html#GTK-SIGNAL-CONNECT
>gtk_signal_connect</A>() to the "clicked" signal of the specified button.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15338"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to affect.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>button</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Button number.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A standard Gtk callback.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback data.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15360"
></A
><H3
><A
NAME="GNOME-DIALOG-BUTTON-CONNECT-OBJECT"
></A
>gnome_dialog_button_connect_object ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_button_connect_object
                                            (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> button,
                                             <A
HREF=../gtk/gtk-types.html#GTKSIGNALFUNC
>GtkSignalFunc</A> callback,
                                             <A
HREF=../gtk/gtkobject.html
>GtkObject</A> *obj);</PRE
></TD
></TR
></TABLE
><P
><A
HREF=../gtk/gtk-signals.html#GTK-SIGNAL-CONNECT-OBJECT
>gtk_signal_connect_object</A>() to the "clicked" signal of the given button.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15371"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to affect.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>button</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Button to connect to.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>obj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> As for <A
HREF=../gtk/gtk-signals.html#GTK-SIGNAL-CONNECT-OBJECT
>gtk_signal_connect_object</A>().</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15394"
></A
><H3
><A
NAME="GNOME-DIALOG-RUN"
></A
>gnome_dialog_run ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_dialog_run                (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog);</PRE
></TD
></TR
></TABLE
><P
>Blocks until the user clicks a button, or closes the dialog with the 
window manager's close decoration (or by pressing Escape).</P
><P
>You need to set up the dialog to do the right thing when a button
is clicked or delete_event is received; you must consider both of
those possibilities so that you know the status of the dialog when
<A
HREF="gnomedialog.html#GNOME-DIALOG-RUN"
>gnome_dialog_run</A
>() returns. A common mistake is to forget about
Escape and the window manager close decoration; by default, these
call <A
HREF="gnomedialog.html#GNOME-DIALOG-CLOSE"
>gnome_dialog_close</A
>(), which by default destroys the dialog. If
your button clicks do not destroy the dialog, you don't know
whether the dialog is destroyed when <A
HREF="gnomedialog.html#GNOME-DIALOG-RUN"
>gnome_dialog_run</A
>()
returns. This is bad.</P
><P
>So you should either close the dialog on button clicks as well, or
change the <A
HREF="gnomedialog.html#GNOME-DIALOG-CLOSE"
>gnome_dialog_close</A
>() behavior to hide instead of
destroy. You can do this with <A
HREF="gnomedialog.html#GNOME-DIALOG-CLOSE-HIDES"
>gnome_dialog_close_hides</A
>().</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15409"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to use.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  If a button was pressed, the button number is returned. If not, -1 is returned.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15423"
></A
><H3
><A
NAME="GNOME-DIALOG-RUN-AND-CLOSE"
></A
>gnome_dialog_run_and_close ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_dialog_run_and_close      (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog);</PRE
></TD
></TR
></TABLE
><P
>See <A
HREF="gnomedialog.html#GNOME-DIALOG-RUN"
>gnome_dialog_run</A
>(). The only difference is that this function calls 
<A
HREF="gnomedialog.html#GNOME-DIALOG-CLOSE"
>gnome_dialog_close</A
>() before returning, if the dialog was not already closed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15433"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to use.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> If a button was pressed, the button number. Otherwise -1.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15447"
></A
><H3
><A
NAME="GNOME-DIALOG-SET-DEFAULT"
></A
>gnome_dialog_set_default ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_set_default        (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> button);</PRE
></TD
></TR
></TABLE
><P
>The default button will be activated if the user just presses return.
Usually you should make the least-destructive button the default.
Otherwise, the most commonly-used button.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15455"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to affect.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>button</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of the default button.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15469"
></A
><H3
><A
NAME="GNOME-DIALOG-SET-SENSITIVE"
></A
>gnome_dialog_set_sensitive ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_set_sensitive      (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> button,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> setting);</PRE
></TD
></TR
></TABLE
><P
>Calls <A
HREF=../gtk/gtkwidget.html#GTK-WIDGET-SET-SENSITIVE
>gtk_widget_set_sensitive</A>() on the specified button number.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15479"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to affect.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>button</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Which button to affect.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>setting</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> TRUE means it's sensitive.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15497"
></A
><H3
><A
NAME="GNOME-DIALOG-SET-ACCELERATOR"
></A
>gnome_dialog_set_accelerator ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_set_accelerator    (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> button,
                                             const <A
HREF=../glib/glib-basic-types.html#GUCHAR
>guchar</A> accelerator_key,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> accelerator_mods);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15507"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to affect.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>button</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Button number.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>accelerator_key</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Key for the accelerator.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>accelerator_mods</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Modifier.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15529"
></A
><H3
><A
NAME="GNOME-DIALOG-CLOSE"
></A
>gnome_dialog_close ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_close              (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog);</PRE
></TD
></TR
></TABLE
><P
>See also <A
HREF="gnomedialog.html#GNOME-DIALOG-CLOSE-HIDES"
>gnome_dialog_close_hides</A
>(). This function emits the
"close" signal, which either hides or destroys the dialog (destroy
by default). If you connect to the "close" signal, and your
callback returns TRUE, the hide or destroy will be blocked. You can
do this to avoid closing the dialog if the user gives invalid
input, for example.</P
><P
>Using <A
HREF="gnomedialog.html#GNOME-DIALOG-CLOSE"
>gnome_dialog_close</A
>() in place of <A
HREF=../gtk/gtkwidget.html#GTK-WIDGET-HIDE
>gtk_widget_hide</A>() or
<A
HREF=../gtk/gtkwidget.html#GTK-WIDGET-DESTROY
>gtk_widget_destroy</A>() allows you to easily catch all sources of
dialog closure, including delete_event and button clicks, and
handle them in a central location.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15541"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to close.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15551"
></A
><H3
><A
NAME="GNOME-DIALOG-CLOSE-HIDES"
></A
>gnome_dialog_close_hides ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_close_hides        (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> just_hide);</PRE
></TD
></TR
></TABLE
><P
>Some dialogs are expensive to create, so you want to keep them around and just 
<A
HREF=../gtk/gtkwidget.html#GTK-WIDGET-SHOW
>gtk_widget_show</A>() them when they are opened, and <A
HREF=../gtk/gtkwidget.html#GTK-WIDGET-HIDE
>gtk_widget_hide</A>() them when 
they're closed. Other dialogs are expensive to keep around, so you want to 
<A
HREF=../gtk/gtkwidget.html#GTK-WIDGET-DESTROY
>gtk_widget_destroy</A>() them when they're closed. It's a judgment call you 
will need to make for each dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15562"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to affect.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>just_hide</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> If TRUE, <A
HREF="gnomedialog.html#GNOME-DIALOG-CLOSE"
>gnome_dialog_close</A
>() calls <A
HREF=../gtk/gtkwidget.html#GTK-WIDGET-HIDE
>gtk_widget_hide</A>() instead of <A
HREF=../gtk/gtkwidget.html#GTK-WIDGET-DESTROY
>gtk_widget_destroy</A>().</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15579"
></A
><H3
><A
NAME="GNOME-DIALOG-SET-CLOSE"
></A
>gnome_dialog_set_close ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_set_close          (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> click_closes);</PRE
></TD
></TR
></TABLE
><P
>This is a convenience function so you don't have to connect callbacks
to each button just to close the dialog. By default, <A
HREF="gnomedialog.html"
>GnomeDialog</A
> 
has this parameter set the FALSE and it will not close on any click.
(This was a design error.) However, almost all the <A
HREF="gnomedialog.html"
>GnomeDialog</A
> subclasses,
such as <A
HREF="gnomemessagebox.html"
>GnomeMessageBox</A
> and <A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
>, have this parameter set to
TRUE by default.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15591"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to affect.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>click_closes</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> TRUE if clicking any button should call <A
HREF="gnomedialog.html#GNOME-DIALOG-CLOSE"
>gnome_dialog_close</A
>().</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15606"
></A
><H3
><A
NAME="GNOME-DIALOG-EDITABLE-ENTERS"
></A
>gnome_dialog_editable_enters ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_editable_enters    (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             <A
HREF=../gtk/gtkeditable.html
>GtkEditable</A> *editable);</PRE
></TD
></TR
></TABLE
><P
>Normally if there's an editable widget (such as <A
HREF=../gtk/gtkentry.html
>GtkEntry</A>) in your
dialog, pressing Enter will activate the editable rather than the
default dialog button. However, in most cases, the user expects to
type something in and then press enter to close the dialog. This 
function enables that behavior.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15615"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to affect.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>editable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Editable to affect.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15629"
></A
><H3
><A
NAME="GNOME-DIALOG-APPEND-BUTTONS"
></A
>gnome_dialog_append_buttons ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_append_buttons     (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *first,
                                             ...);</PRE
></TD
></TR
></TABLE
><P
>This function is mostly for internal library use. You should use
<A
HREF="gnomedialog.html#GNOME-DIALOG-NEW"
>gnome_dialog_new</A
>() instead. See that function for a description of
the button arguments.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15638"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to add buttons to.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>first</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> First button to add.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>...</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> varargs list of additional buttons, NULL-terminated.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15656"
></A
><H3
><A
NAME="GNOME-DIALOG-APPEND-BUTTON"
></A
>gnome_dialog_append_button ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_append_button      (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);</PRE
></TD
></TR
></TABLE
><P
>This function is mostly for internal library use. You should use
<A
HREF="gnomedialog.html#GNOME-DIALOG-NEW"
>gnome_dialog_new</A
>() instead. See that function for a description of
the button argument.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15665"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to add button to.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15679"
></A
><H3
><A
NAME="GNOME-DIALOG-APPEND-BUTTONSV"
></A
>gnome_dialog_append_buttonsv ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_append_buttonsv    (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **buttons);</PRE
></TD
></TR
></TABLE
><P
>For internal use, language bindings, etc. Use <A
HREF="gnomedialog.html#GNOME-DIALOG-NEW"
>gnome_dialog_new</A
>() instead.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15688"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to append to.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>buttons</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> NULL-terminated vector of buttons to append.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15702"
></A
><H3
><A
NAME="GNOME-DIALOG-APPEND-BUTTON-WITH-PIXMAP"
></A
>gnome_dialog_append_button_with_pixmap ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_append_button_with_pixmap
                                            (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *pixmap);</PRE
></TD
></TR
></TABLE
><P
><A
HREF="gnomedialog.html#GNOME-DIALOG-NEW"
>gnome_dialog_new</A
>() does not permit custom buttons with pixmaps, so if you 
want one of those you need to use this function.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15712"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to add the button to.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15730"
></A
><H3
><A
NAME="GNOME-DIALOG-APPEND-BUTTONS-WITH-PIXMAPS"
></A
>gnome_dialog_append_buttons_with_pixmaps ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_append_buttons_with_pixmaps
                                            (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **names,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **pixmaps);</PRE
></TD
></TR
></TABLE
><P
>Simply calls <A
HREF="gnomedialog.html#GNOME-DIALOG-APPEND-BUTTON-WITH-PIXMAP"
>gnome_dialog_append_button_with_pixmap</A
>() repeatedly.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15740"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <A
HREF="gnomedialog.html"
>GnomeDialog</A
> to append to.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>names</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> NULL-terminated vector of button names.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixmaps</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> NULL-terminated vector of pixmap names.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15758"
></A
><H3
><A
NAME="GNOME-DIALOG-CONSTRUCT"
></A
>gnome_dialog_construct ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_construct          (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             va_list ap);</PRE
></TD
></TR
></TABLE
><P
>See <A
HREF="gnomedialog.html#GNOME-DIALOG-NEW"
>gnome_dialog_new</A
>().</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15767"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Dialog to construct.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Title of the dialog.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> va_list of buttons, NULL-terminated.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15784"
></A
><H3
><A
NAME="GNOME-DIALOG-CONSTRUCTV"
></A
>gnome_dialog_constructv ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dialog_constructv         (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **buttons);</PRE
></TD
></TR
></TABLE
><P
>See <A
HREF="gnomedialog.html#GNOME-DIALOG-NEW"
>gnome_dialog_new</A
>().</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15794"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Dialog to construct.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Title of the dialog.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>buttons</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> NULL-terminated array of buttons.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15811"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN15813"
></A
><H3
><A
NAME="GNOMEDIALOG-CLICKED"
></A
>The &quot;clicked&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15821"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15838"
></A
><H3
><A
NAME="GNOMEDIALOG-CLOSE"
></A
>The &quot;close&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        user_function                  (<A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15846"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15863"
></A
><H2
>See Also</H2
><P
><A
HREF="gnomeabout.html"
>GnomeAbout</A
> <A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> <A
HREF="gnomemessagebox.html"
>GnomeMessageBox</A
> <A
HREF="gnomescores.html"
>GnomeScores</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedentryedit.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedockband.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
>GnomeDEntryEdit</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeDockBand</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeDockBand</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeDialog"
HREF="gnomedialog.html"><LINK
REL="NEXT"
TITLE="GnomeDockItem"
HREF="gnomedockitem.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedialog.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedockitem.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEDOCKBAND"
>GnomeDockBand</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN15875"
></A
><H2
>Name</H2
>GnomeDockBand&nbsp;--&nbsp;A widget implementing dock bands.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN15878"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomedockband.html#GNOMEDOCKBAND-STRUCT"
>GnomeDockBand</A
>;
struct      <A
HREF="gnomedockband.html#GNOMEDOCKBANDCHILD"
>GnomeDockBandChild</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-NEW"
>gnome_dock_band_new</A
>             (void);
void        <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-SET-ORIENTATION"
>gnome_dock_band_set_orientation</A
> (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKORIENTATION
>GtkOrientation</A> orientation);
<A
HREF=../gtk/gtk-standard-enumerations.html#GTKORIENTATION
>GtkOrientation</A> <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-GET-ORIENTATION"
>gnome_dock_band_get_orientation</A
>
                                            (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-INSERT"
>gnome_dock_band_insert</A
>          (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *child,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> position);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-PREPEND"
>gnome_dock_band_prepend</A
>         (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *child,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> offset);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-APPEND"
>gnome_dock_band_append</A
>          (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *child,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> offset);
void        <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-SET-CHILD-OFFSET"
>gnome_dock_band_set_child_offset</A
>
                                            (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *child,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> offset);
<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>       <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-GET-CHILD-OFFSET"
>gnome_dock_band_get_child_offset</A
>
                                            (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *child);
void        <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-MOVE-CHILD"
>gnome_dock_band_move_child</A
>      (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF=../glib/glib-doubly-linked-lists.html#GLIST
>GList</A> *old_child,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> new_num);
<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>       <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-GET-NUM-CHILDREN"
>gnome_dock_band_get_num_children</A
>
                                            (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band);
void        <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-DRAG-BEGIN"
>gnome_dock_band_drag_begin</A
>      (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-DRAG-TO"
>gnome_dock_band_drag_to</A
>         (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y);
void        <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-DRAG-END"
>gnome_dock_band_drag_end</A
>        (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item);
<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
>* <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-GET-ITEM-BY-NAME"
>gnome_dock_band_get_item_by_name</A
>
                                            (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             const char *name,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> *position_return,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> *offset_return);
void        <A
HREF="gnomedockband.html#GNOME-DOCK-BAND-LAYOUT-ADD"
>gnome_dock_band_layout_add</A
>      (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> band_num);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15944"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----GnomeDockBand</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15950"
></A
><H2
>Description</H2
><P
><SPAN
CLASS="TYPE"
>GnomeDockBand</SPAN
> is a widget implementing a "dock band", i.e. a
horizontal or vertical stripe containing dockable widgets.</P
><P
>The application programmer does not normally need to use
<SPAN
CLASS="TYPE"
>GnomeDockBand</SPAN
>s directly; they are mostly used by the
<SPAN
CLASS="TYPE"
>GnomeDock</SPAN
> widget to implement its functionality.  For an
explanation of the way dock bands are used within a dock, check out
the documentation for the <SPAN
CLASS="TYPE"
>GnomeDock</SPAN
> widget.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN15958"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN15960"
></A
><H3
><A
NAME="GNOMEDOCKBAND-STRUCT"
></A
>struct GnomeDockBand</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeDockBand;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15965"
></A
><H3
><A
NAME="GNOMEDOCKBANDCHILD"
></A
>struct GnomeDockBandChild</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeDockBandChild
{
  GtkWidget *widget;

  /* Maximum (requested) offset from the previous child.  */
  guint offset;

  /* Actual offset.  */
  guint real_offset;

  guint drag_offset;

  GtkAllocation drag_allocation;

  guint prev_space, foll_space;
  guint drag_prev_space, drag_foll_space;

  guint max_space_requisition;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15970"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-NEW"
></A
>gnome_dock_band_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_dock_band_new             (void);</PRE
></TD
></TR
></TABLE
><P
>Create a new GnomeDockBand widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15977"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The new GnomeDockBand widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN15986"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-SET-ORIENTATION"
></A
>gnome_dock_band_set_orientation ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_band_set_orientation (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKORIENTATION
>GtkOrientation</A> orientation);</PRE
></TD
></TR
></TABLE
><P
>Set the orientation for <TT
CLASS="PARAMETER"
><I
>band</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN15995"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeDockBand widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>orientation</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New orientation for <TT
CLASS="PARAMETER"
><I
>band</I
></TT
></TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16009"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-GET-ORIENTATION"
></A
>gnome_dock_band_get_orientation ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtk-standard-enumerations.html#GTKORIENTATION
>GtkOrientation</A> gnome_dock_band_get_orientation
                                            (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the orientation of the specified <TT
CLASS="PARAMETER"
><I
>band</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16018"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeDockBand widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The orientation of <TT
CLASS="PARAMETER"
><I
>band</I
></TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16032"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-INSERT"
></A
>gnome_dock_band_insert ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_dock_band_insert          (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *child,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> offset,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> position);</PRE
></TD
></TR
></TABLE
><P
>Add <TT
CLASS="PARAMETER"
><I
>child</I
></TT
> to <TT
CLASS="PARAMETER"
><I
>band</I
></TT
> at the specified <TT
CLASS="PARAMETER"
><I
>position</I
></TT
>, with
the specified <TT
CLASS="PARAMETER"
><I
>offset</I
></TT
> from the previous item (or from the beginning
of the band, if this is the first item).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16047"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeDockBand widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The widget to be added to <TT
CLASS="PARAMETER"
><I
>band</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Offset from the previous item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>position</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Position within the <TT
CLASS="PARAMETER"
><I
>band</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if the operation fails.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16076"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-PREPEND"
></A
>gnome_dock_band_prepend ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_dock_band_prepend         (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *child,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> offset);</PRE
></TD
></TR
></TABLE
><P
>Add <TT
CLASS="PARAMETER"
><I
>child</I
></TT
> to <TT
CLASS="PARAMETER"
><I
>band</I
></TT
> with the specified <TT
CLASS="PARAMETER"
><I
>offset</I
></TT
> as the
first element.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16089"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeDockBand widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A widget to be added to <TT
CLASS="PARAMETER"
><I
>band</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Offset (in pixels) from the beginning of the band</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if the operation fails.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16113"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-APPEND"
></A
>gnome_dock_band_append ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_dock_band_append          (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *child,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> offset);</PRE
></TD
></TR
></TABLE
><P
>Add <TT
CLASS="PARAMETER"
><I
>child</I
></TT
> to <TT
CLASS="PARAMETER"
><I
>band</I
></TT
> with the specified <TT
CLASS="PARAMETER"
><I
>offset</I
></TT
> as the
last element.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16126"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeDockBand widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A widget to be added to <TT
CLASS="PARAMETER"
><I
>band</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Offset (in pixels) from the last item of the band</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if the operation fails.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16150"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-SET-CHILD-OFFSET"
></A
>gnome_dock_band_set_child_offset ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_band_set_child_offset
                                            (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *child,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> offset);</PRE
></TD
></TR
></TABLE
><P
>Set the offset for the specified <TT
CLASS="PARAMETER"
><I
>child</I
></TT
> of <TT
CLASS="PARAMETER"
><I
>band</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16161"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeDockBand widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Child of <TT
CLASS="PARAMETER"
><I
>band</I
></TT
> whose offset must be changed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New offset value for <TT
CLASS="PARAMETER"
><I
>child</I
></TT
></TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16180"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-GET-CHILD-OFFSET"
></A
>gnome_dock_band_get_child_offset ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>       gnome_dock_band_get_child_offset
                                            (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *child);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the offset of <TT
CLASS="PARAMETER"
><I
>child</I
></TT
> in <TT
CLASS="PARAMETER"
><I
>band</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16191"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeDockBand widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Child of <TT
CLASS="PARAMETER"
><I
>band</I
></TT
> whose offset must be retrieved</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The offset of <TT
CLASS="PARAMETER"
><I
>child</I
></TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16210"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-MOVE-CHILD"
></A
>gnome_dock_band_move_child ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_band_move_child      (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF=../glib/glib-doubly-linked-lists.html#GLIST
>GList</A> *old_child,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> new_num);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16218"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>old_child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16235"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-GET-NUM-CHILDREN"
></A
>gnome_dock_band_get_num_children ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>       gnome_dock_band_get_num_children
                                            (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the number of children in <TT
CLASS="PARAMETER"
><I
>band</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16244"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeDockBand widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The number of children in <TT
CLASS="PARAMETER"
><I
>band</I
></TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16258"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-DRAG-BEGIN"
></A
>gnome_dock_band_drag_begin ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_band_drag_begin      (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16265"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16278"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-DRAG-TO"
></A
>gnome_dock_band_drag_to ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_dock_band_drag_to         (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16288"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16313"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-DRAG-END"
></A
>gnome_dock_band_drag_end ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_band_drag_end        (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16320"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16333"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-GET-ITEM-BY-NAME"
></A
>gnome_dock_band_get_item_by_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomedockitem.html"
>GnomeDockItem</A
>* gnome_dock_band_get_item_by_name
                                            (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             const char *name,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> *position_return,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> *offset_return);</PRE
></TD
></TR
></TABLE
><P
>Retrieve a named item from <TT
CLASS="PARAMETER"
><I
>band</I
></TT
>, and return its
position and offset in *<TT
CLASS="PARAMETER"
><I
>position_return</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>offset_return</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16346"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeDockBand widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of the child to be retrieved</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>position_return</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to a variable holding the position of
the named child</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset_return</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to a variable holding the offset of the
named child</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The child whose name is <TT
CLASS="PARAMETER"
><I
>name</I
></TT
>, or <TT
CLASS="LITERAL"
>NULL</TT
> if no child
of <TT
CLASS="PARAMETER"
><I
>band</I
></TT
> has such name.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16374"
></A
><H3
><A
NAME="GNOME-DOCK-BAND-LAYOUT-ADD"
></A
>gnome_dock_band_layout_add ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_band_layout_add      (<A
HREF="gnomedockband.html"
>GnomeDockBand</A
> *band,
                                             <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> band_num);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16383"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>placement</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN16404"
></A
><H2
>See Also</H2
><P
><A
HREF="gnomedock.html"
>GnomeDock</A
>
<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
>
<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedialog.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedockitem.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
>GnomeDialog</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeDockItem</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeDock</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeDockItem"
HREF="gnomedockitem.html"><LINK
REL="NEXT"
TITLE="GnomeDruid"
HREF="gnomedruid.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedockitem.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedruid.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEDOCK"
>GnomeDock</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN17024"
></A
><H2
>Name</H2
>GnomeDock&nbsp;--&nbsp;A widget supporting movable and detachable widgets.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN17027"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomedock.html#GNOMEDOCK-STRUCT"
>GnomeDock</A
>;
enum        <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedock.html#GNOME-DOCK-NEW"
>gnome_dock_new</A
>                  (void);
void        <A
HREF="gnomedock.html#GNOME-DOCK-ALLOW-FLOATING-ITEMS"
>gnome_dock_allow_floating_items</A
> (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> enable);
void        <A
HREF="gnomedock.html#GNOME-DOCK-ADD-ITEM"
>gnome_dock_add_item</A
>             (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> band_num,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> position,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> offset,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> in_new_band);
void        <A
HREF="gnomedock.html#GNOME-DOCK-ADD-FLOATING-ITEM"
>gnome_dock_add_floating_item</A
>    (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *widget,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKORIENTATION
>GtkOrientation</A> orientation);
void        <A
HREF="gnomedock.html#GNOME-DOCK-SET-CLIENT-AREA"
>gnome_dock_set_client_area</A
>      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedock.html#GNOME-DOCK-GET-CLIENT-AREA"
>gnome_dock_get_client_area</A
>      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock);
<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
>* <A
HREF="gnomedock.html#GNOME-DOCK-GET-ITEM-BY-NAME"
>gnome_dock_get_item_by_name</A
>  (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> *placement_return,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> *num_band_return,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> *band_position_return,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> *offset_return);
<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
>* <A
HREF="gnomedock.html#GNOME-DOCK-GET-LAYOUT"
>gnome_dock_get_layout</A
>      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedock.html#GNOME-DOCK-ADD-FROM-LAYOUT"
>gnome_dock_add_from_layout</A
>      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17072"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----GnomeDock</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17078"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomedock.html#GNOMEDOCK-LAYOUT-CHANGED"
>layout-changed</A
>&quot;
            void        user_function      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17084"
></A
><H2
>Description</H2
><P
><SPAN
CLASS="TYPE"
>GnomeDock</SPAN
> is a container widget designed to let users
move around widgets such as toolbars, menubars and so on.</P
><P
>Every <SPAN
CLASS="TYPE"
>GnomeDock</SPAN
> contains a widget called the "client
area".  On the four sides of the client area, there are four "dock
areas", which can contain an arbitrary number of dockable widgets.
All the dockable widgets should be <SPAN
CLASS="TYPE"
>GnomeDockItem</SPAN
>
widgets; the <SPAN
CLASS="TYPE"
>GnomeDockItem</SPAN
> widget can in turn contain
any kind of widget, and implements the dragging functionality: every
<SPAN
CLASS="TYPE"
>GnomeDockItem</SPAN
> has a handle that users can use to move
them within the dock, or even move them outside it, so that they
become "floating items".</P
><P
>Every "dock area" is implemented by means of zero or more "dock
bands": a dock band is a horizontal or vertical stripe containing one
or more dock items, and is implemented by the
<SPAN
CLASS="TYPE"
>GnomeDockBand</SPAN
> widget.  Items are ordered from top to
bottom in vertical bands, and from left to right in horizontal bands.
Every dock item in a band is given an offset value that defines the
distance, in pixels, from the previous item in the same band; if the
item is first in the band, the offset defines the distance from the
start of the band.</P
><P
>As a consequence, the position of an item in the dock can be specified
by means of the following values: a "placement" specifying what area
is being used (top, bottom, left, right), a "band number" specifying
the number of the band within the specified area, a "position" within
the band and a "offset" from the previous item in the same band.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17096"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN17098"
></A
><H3
><A
NAME="GNOMEDOCK-STRUCT"
></A
>struct GnomeDock</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeDock;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17103"
></A
><H3
><A
NAME="GNOMEDOCKPLACEMENT"
></A
>enum GnomeDockPlacement</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  GNOME_DOCK_TOP,
  GNOME_DOCK_RIGHT,
  GNOME_DOCK_BOTTOM,
  GNOME_DOCK_LEFT,
  GNOME_DOCK_FLOATING
} GnomeDockPlacement;</PRE
></TD
></TR
></TABLE
><P
>This enumeration is used to specify the position of a dock item in the
dock widget.</P
><P
><P
></P
><UL
><LI
><P
>GNOME_DOCK_TOP - The horizontal area at the top of the dock widget </P
></LI
><LI
><P
>GNOME_DOCK_RIGHT - The vertical area on the right side of the dock widget </P
></LI
><LI
><P
>GNOME_DOCK_BOTTOM - The horizontal area at the bottom of the dock widget </P
></LI
><LI
><P
>GNOME_DOCK_RIGHT - The vertical area on the right side of the dock widget </P
></LI
><LI
><P
>GNOME_DOCK_FLOATING - Used for floating (detached) items</P
></LI
></UL
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17120"
></A
><H3
><A
NAME="GNOME-DOCK-NEW"
></A
>gnome_dock_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_dock_new                  (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a new <A
HREF="gnomedock.html"
>GnomeDock</A
> widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17128"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The new widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17137"
></A
><H3
><A
NAME="GNOME-DOCK-ALLOW-FLOATING-ITEMS"
></A
>gnome_dock_allow_floating_items ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_allow_floating_items (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> enable);</PRE
></TD
></TR
></TABLE
><P
>Enable or disable floating items on <TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>, according
to <TT
CLASS="PARAMETER"
><I
>enable</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17147"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a <A
HREF="gnomedock.html"
>GnomeDock</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>enable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Specifies whether floating items are allowed in this dock</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17161"
></A
><H3
><A
NAME="GNOME-DOCK-ADD-ITEM"
></A
>gnome_dock_add_item ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_add_item             (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> band_num,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> position,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> offset,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> in_new_band);</PRE
></TD
></TR
></TABLE
><P
>Add <TT
CLASS="PARAMETER"
><I
>item</I
></TT
> to <TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>.  <TT
CLASS="PARAMETER"
><I
>placement</I
></TT
> can be either
<TT
CLASS="LITERAL"
>GNOME_DOCK_TOP</TT
>, <TT
CLASS="LITERAL"
>GNOME_DOCK_RIGHT</TT
>, <TT
CLASS="LITERAL"
>GNOME_DOCK_BOTTOM</TT
> or
<TT
CLASS="LITERAL"
>GNOME_DOCK_LEFT</TT
>, and specifies what area of the dock should
contain the item.  If <TT
CLASS="PARAMETER"
><I
>in_new_band</I
></TT
> is <TT
CLASS="LITERAL"
>TRUE</TT
>, a new dock band is
created at the position specified by <TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
>; otherwise, the item
is added to the <TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
>'th band.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17185"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a <A
HREF="gnomedock.html"
>GnomeDock</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The item to add</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>placement</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Placement for the new item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of the band the new item must be added to</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>position</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Position of the item in the specified band</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Offset (in pixels) from the previous item in the same band</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>in_new_band</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Specifies whether a new band must be created for this item</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17219"
></A
><H3
><A
NAME="GNOME-DOCK-ADD-FLOATING-ITEM"
></A
>gnome_dock_add_floating_item ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_add_floating_item    (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *widget,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKORIENTATION
>GtkOrientation</A> orientation);</PRE
></TD
></TR
></TABLE
><P
>Add <TT
CLASS="PARAMETER"
><I
>item</I
></TT
> to <TT
CLASS="PARAMETER"
><I
>dock</I
></TT
> and make it floating at the
specified (<TT
CLASS="PARAMETER"
><I
>x</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>y</I
></TT
>) coordinates (relative to the root window of the
screen).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17234"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedock.html"
>GnomeDock</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X-coordinate for the floating item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y-coordinate for the floating item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>orientation</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Orientation for the new item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17260"
></A
><H3
><A
NAME="GNOME-DOCK-SET-CLIENT-AREA"
></A
>gnome_dock_set_client_area ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_set_client_area      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget);</PRE
></TD
></TR
></TABLE
><P
>Specify a widget for the dock's client area.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17268"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedock.html"
>GnomeDock</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The widget to be used for the client area.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17282"
></A
><H3
><A
NAME="GNOME-DOCK-GET-CLIENT-AREA"
></A
>gnome_dock_get_client_area ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_dock_get_client_area      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the widget being used as the client area in
<TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17291"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedock.html"
>GnomeDock</A
> widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The client area widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17305"
></A
><H3
><A
NAME="GNOME-DOCK-GET-ITEM-BY-NAME"
></A
>gnome_dock_get_item_by_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomedockitem.html"
>GnomeDockItem</A
>* gnome_dock_get_item_by_name  (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> *placement_return,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> *num_band_return,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> *band_position_return,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> *offset_return);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the dock item named <TT
CLASS="PARAMETER"
><I
>name</I
></TT
>; information about
its position in the dock is returned via <TT
CLASS="PARAMETER"
><I
>placement_return</I
></TT
>,
<TT
CLASS="PARAMETER"
><I
>num_band_return</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>band_position_return</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>offset_return</I
></TT
>.  If
the placement is <TT
CLASS="LITERAL"
>GNOME_DOCK_FLOATING</TT
> *<TT
CLASS="PARAMETER"
><I
>num_band_return</I
></TT
>,
*<TT
CLASS="PARAMETER"
><I
>band_position_return</I
></TT
> and *<TT
CLASS="PARAMETER"
><I
>offset_return</I
></TT
> are not set.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17327"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedock.html"
>GnomeDock</A
> widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The name of the dock item to retrieve</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>placement_return</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a variable holding the item's placement</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>num_band_return</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a variable holding the band number</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_position_return</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a variable holding the position
of the item within the band</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset_return</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a variable holding the offset of the item
from the previous item in the same band</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The named <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> widget, or <TT
CLASS="LITERAL"
>NULL</TT
> if no item with
such name exists.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17363"
></A
><H3
><A
NAME="GNOME-DOCK-GET-LAYOUT"
></A
>gnome_dock_get_layout ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
>* gnome_dock_get_layout      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the layout of <TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17372"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedock.html"
>GnomeDock</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>'s layout as a <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17388"
></A
><H3
><A
NAME="GNOME-DOCK-ADD-FROM-LAYOUT"
></A
>gnome_dock_add_from_layout ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_dock_add_from_layout      (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                             <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout);</PRE
></TD
></TR
></TABLE
><P
>Add all the items in <TT
CLASS="PARAMETER"
><I
>layout</I
></TT
> to the specified <TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17399"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The <A
HREF="gnomedock.html"
>GnomeDock</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if the operation succeeds, <TT
CLASS="LITERAL"
>FALSE</TT
> if it fails.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17420"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN17422"
></A
><H3
><A
NAME="GNOMEDOCK-LAYOUT-CHANGED"
></A
>The &quot;layout-changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomedock.html"
>GnomeDock</A
> *dock,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is emitted after any of the dock items has been
dragged, thus changing the dock configuration.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17429"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17442"
></A
><H2
>See Also</H2
><P
><A
HREF="gnomedockitem.html"
>GnomeDockItem</A
>
<A
HREF="gnomedockband.html"
>GnomeDockBand</A
>
<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedockitem.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedruid.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
>GnomeDockItem</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeDruid</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeDockItem</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeDockBand"
HREF="gnomedockband.html"><LINK
REL="NEXT"
TITLE="GnomeDock"
HREF="gnomedock.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedockband.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedock.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEDOCKITEM"
>GnomeDockItem</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN16415"
></A
><H2
>Name</H2
>GnomeDockItem&nbsp;--&nbsp;A dockable widget.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN16418"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomedockitem.html#GNOMEDOCKITEM-STRUCT"
>GnomeDockItem</A
>;
enum        <A
HREF="gnomedockitem.html#GNOMEDOCKITEMBEHAVIOR"
>GnomeDockItemBehavior</A
>;
#define     <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-NOT-LOCKED-CAPS"
>GNOME_DOCK_ITEM_NOT_LOCKED</A
>      (x)
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-NEW"
>gnome_dock_item_new</A
>             (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gnomedockitem.html#GNOMEDOCKITEMBEHAVIOR"
>GnomeDockItemBehavior</A
> behavior);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-GET-CHILD"
>gnome_dock_item_get_child</A
>       (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dock_item);
char*       <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-GET-NAME"
>gnome_dock_item_get_name</A
>        (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dock_item);
void        <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-SET-SHADOW-TYPE"
>gnome_dock_item_set_shadow_type</A
> (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dock_item,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKSHADOWTYPE
>GtkShadowType</A> type);
<A
HREF=../gtk/gtk-standard-enumerations.html#GTKSHADOWTYPE
>GtkShadowType</A> <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-GET-SHADOW-TYPE"
>gnome_dock_item_get_shadow_type</A
>
                                            (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dock_item);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-SET-ORIENTATION"
>gnome_dock_item_set_orientation</A
> (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dock_item,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKORIENTATION
>GtkOrientation</A> orientation);
<A
HREF=../gtk/gtk-standard-enumerations.html#GTKORIENTATION
>GtkOrientation</A> <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-GET-ORIENTATION"
>gnome_dock_item_get_orientation</A
>
                                            (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dock_item);
<A
HREF="gnomedockitem.html#GNOMEDOCKITEMBEHAVIOR"
>GnomeDockItemBehavior</A
> <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-GET-BEHAVIOR"
>gnome_dock_item_get_behavior</A
>
                                            (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dock_item);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-DETACH"
>gnome_dock_item_detach</A
>          (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y);
void        <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-ATTACH"
>gnome_dock_item_attach</A
>          (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *parent,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y);
void        <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-GRAB-POINTER"
>gnome_dock_item_grab_pointer</A
>    (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item);
void        <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-DRAG-FLOATING"
>gnome_dock_item_drag_floating</A
>   (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y);
void        <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-HANDLE-SIZE-REQUEST"
>gnome_dock_item_handle_size_request</A
>
                                            (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF=../gtk/gtkwidget.html#GTKREQUISITION
>GtkRequisition</A> *requisition);
void        <A
HREF="gnomedockitem.html#GNOME-DOCK-ITEM-GET-FLOATING-POSITION"
>gnome_dock_item_get_floating_position</A
>
                                            (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *y);
&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN16472"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----GnomeDockItem</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN16479"
></A
><H2
>Args</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  &quot;<A
HREF="gnomedockitem.html#GNOMEDOCKITEM--SHADOW"
>shadow</A
>&quot;               <A
HREF=../gtk/gtk-standard-enumerations.html#GTKSHADOWTYPE
>GtkShadowType</A>        : Read / Write
  &quot;<A
HREF="gnomedockitem.html#GNOMEDOCKITEM--ORIENTATION"
>orientation</A
>&quot;          <A
HREF=../gtk/gtk-standard-enumerations.html#GTKORIENTATION
>GtkOrientation</A>       : Read / Write
  &quot;<A
HREF="gnomedockitem.html#GNOMEDOCKITEM--PREFERRED-WIDTH"
>preferred-width</A
>&quot;      <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>                : Read
  &quot;<A
HREF="gnomedockitem.html#GNOMEDOCKITEM--PREFERRED-HEIGHT"
>preferred-height</A
>&quot;     <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>                : Read</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN16490"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomedockitem.html#GNOMEDOCKITEM-DOCK-DRAG-BEGIN"
>dock-drag-begin</A
>&quot;
            void        user_function      (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dockitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomedockitem.html#GNOMEDOCKITEM-DOCK-DRAG-END"
>dock-drag-end</A
>&quot;
            void        user_function      (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dockitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomedockitem.html#GNOMEDOCKITEM-DOCK-DRAG-MOTION"
>dock-drag-motion</A
>&quot;
            void        user_function      (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dockitem,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg2,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomedockitem.html#GNOMEDOCKITEM-DOCK-DETACH"
>dock-detach</A
>&quot;
            void        user_function      (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dockitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN16507"
></A
><H2
>Description</H2
><P
><SPAN
CLASS="TYPE"
>GnomeDockItem</SPAN
> is a container widget that can be used to
make widgets dockable.  "Making a widget dockable" means that the
widget gets a handle through which users can drag it around the dock
widget or detach it so that it gets displayed into its own window
(thus becoming a "floating" item).</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN16511"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN16513"
></A
><H3
><A
NAME="GNOMEDOCKITEM-STRUCT"
></A
>struct GnomeDockItem</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeDockItem;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16518"
></A
><H3
><A
NAME="GNOMEDOCKITEMBEHAVIOR"
></A
>enum GnomeDockItemBehavior</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  GNOME_DOCK_ITEM_BEH_NORMAL = 0,
  GNOME_DOCK_ITEM_BEH_EXCLUSIVE = 1 &lt;&lt; 0,
  GNOME_DOCK_ITEM_BEH_NEVER_FLOATING = 1 &lt;&lt; 1,
  GNOME_DOCK_ITEM_BEH_NEVER_VERTICAL = 1 &lt;&lt; 2,
  GNOME_DOCK_ITEM_BEH_NEVER_HORIZONTAL = 1 &lt;&lt; 3,
  GNOME_DOCK_ITEM_BEH_LOCKED = 1 &lt;&lt; 4
} GnomeDockItemBehavior;</PRE
></TD
></TR
></TABLE
><P
>This enumeration can be used to customize the behavior of a dock item.
Every value represents a property bit, so that the properties can be
combined together by using the OR (`|') operator.</P
><P
>The special value GNOME_DOCK_ITEM_BEH_NORMAL specifies the ``normal''
(default) behavior, and means to have all the properties disabled (and
thus the corresponding bits set to zero).</P
><P
></P
><UL
><LI
><P
>GNOME_DOCK_ITEM_BEH_EXCLUSIVE specifies that the dock
item is always the only one in its band. </P
></LI
><LI
><P
>GNOME_DOCK_ITEM_BEH_NEVER_FLOATING specifies that
users cannot detach the dock item from the dock. </P
></LI
><LI
><P
>GNOME_DOCK_ITEM_BEH_NEVER_VERTICAL specifies that the
dock item must be kept horizontal, and users cannot move it to a
vertical band.</P
></LI
><LI
><P
>GNOME_DOCK_ITEM_BEH_NEVER_HORIZONTAL specifies that
the dock item must be kept horizontal, and users cannot move it to a
vertical band.</P
></LI
><LI
><P
>GNOME_DOCK_ITEM_BEH_LOCKED specifies that users cannot
drag the item around.</P
></LI
></UL
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16535"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-NOT-LOCKED-CAPS"
></A
>GNOME_DOCK_ITEM_NOT_LOCKED()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOME_DOCK_ITEM_NOT_LOCKED(x)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16540"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16549"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-NEW"
></A
>gnome_dock_item_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_dock_item_new             (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF="gnomedockitem.html#GNOMEDOCKITEMBEHAVIOR"
>GnomeDockItemBehavior</A
> behavior);</PRE
></TD
></TR
></TABLE
><P
>Create a new GnomeDockItem named <TT
CLASS="PARAMETER"
><I
>name</I
></TT
>, with the
specified <TT
CLASS="PARAMETER"
><I
>behavior</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16560"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name for the new item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>behavior</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Behavior for the new item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A new GnomeDockItem widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16577"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-GET-CHILD"
></A
>gnome_dock_item_get_child ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_dock_item_get_child       (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dock_item);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the child of <TT
CLASS="PARAMETER"
><I
>item</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16586"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The child of <TT
CLASS="PARAMETER"
><I
>item</I
></TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16600"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-GET-NAME"
></A
>gnome_dock_item_get_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>char*       gnome_dock_item_get_name        (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dock_item);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the name of <TT
CLASS="PARAMETER"
><I
>item</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16608"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The name of <TT
CLASS="PARAMETER"
><I
>item</I
></TT
> as a malloc()ed zero-terminated
string.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16623"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-SET-SHADOW-TYPE"
></A
>gnome_dock_item_set_shadow_type ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_item_set_shadow_type (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dock_item,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKSHADOWTYPE
>GtkShadowType</A> type);</PRE
></TD
></TR
></TABLE
><P
>Set the shadow type for <TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16632"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeDockItem widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The shadow type for <TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
></TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16646"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-GET-SHADOW-TYPE"
></A
>gnome_dock_item_get_shadow_type ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtk-standard-enumerations.html#GTKSHADOWTYPE
>GtkShadowType</A> gnome_dock_item_get_shadow_type
                                            (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dock_item);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the shadow type of <TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16655"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeDockItem widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>'s shadow type.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16669"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-SET-ORIENTATION"
></A
>gnome_dock_item_set_orientation ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_dock_item_set_orientation (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dock_item,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKORIENTATION
>GtkOrientation</A> orientation);</PRE
></TD
></TR
></TABLE
><P
>Set the orientation for <TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16679"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeDockItem widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>orientation</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New orientation for <TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if the operation succeeds, <TT
CLASS="LITERAL"
>FALSE</TT
> if it fails.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16699"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-GET-ORIENTATION"
></A
>gnome_dock_item_get_orientation ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtk-standard-enumerations.html#GTKORIENTATION
>GtkOrientation</A> gnome_dock_item_get_orientation
                                            (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dock_item);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the orientation of <TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16708"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeDockItem widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The current orientation of <TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16722"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-GET-BEHAVIOR"
></A
>gnome_dock_item_get_behavior ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomedockitem.html#GNOMEDOCKITEMBEHAVIOR"
>GnomeDockItemBehavior</A
> gnome_dock_item_get_behavior
                                            (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dock_item);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the behavior of <TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16731"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeDockItem widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The behavior of <TT
CLASS="PARAMETER"
><I
>dock_item</I
></TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16745"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-DETACH"
></A
>gnome_dock_item_detach ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_dock_item_detach          (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16754"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16775"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-ATTACH"
></A
>gnome_dock_item_attach ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_item_attach          (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *parent,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16784"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16805"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-GRAB-POINTER"
></A
>gnome_dock_item_grab_pointer ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_item_grab_pointer    (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16811"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16820"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-DRAG-FLOATING"
></A
>gnome_dock_item_drag_floating ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_item_drag_floating   (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16828"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16845"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-HANDLE-SIZE-REQUEST"
></A
>gnome_dock_item_handle_size_request ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_item_handle_size_request
                                            (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF=../gtk/gtkwidget.html#GTKREQUISITION
>GtkRequisition</A> *requisition);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16852"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>requisition</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16865"
></A
><H3
><A
NAME="GNOME-DOCK-ITEM-GET-FLOATING-POSITION"
></A
>gnome_dock_item_get_floating_position ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dock_item_get_floating_position
                                            (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *y);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16873"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN16890"
></A
><H2
>Args</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
NAME="GNOMEDOCKITEM--SHADOW"
></A
>&quot;<TT
CLASS="LITERAL"
>shadow</TT
>&quot; (<A
HREF=../gtk/gtk-standard-enumerations.html#GTKSHADOWTYPE
>GtkShadowType</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMEDOCKITEM--ORIENTATION"
></A
>&quot;<TT
CLASS="LITERAL"
>orientation</TT
>&quot; (<A
HREF=../gtk/gtk-standard-enumerations.html#GTKORIENTATION
>GtkOrientation</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMEDOCKITEM--PREFERRED-WIDTH"
></A
>&quot;<TT
CLASS="LITERAL"
>preferred-width</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> : Read)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GNOMEDOCKITEM--PREFERRED-HEIGHT"
></A
>&quot;<TT
CLASS="LITERAL"
>preferred-height</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> : Read)</DT
><DD
><P
></P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN16921"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN16923"
></A
><H3
><A
NAME="GNOMEDOCKITEM-DOCK-DRAG-BEGIN"
></A
>The &quot;dock-drag-begin&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dockitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is emitted as soon as the user starts dragging the dock item.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16930"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dockitem</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16943"
></A
><H3
><A
NAME="GNOMEDOCKITEM-DOCK-DRAG-END"
></A
>The &quot;dock-drag-end&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dockitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is emitted at the end of a dock item drag.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16950"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dockitem</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16963"
></A
><H3
><A
NAME="GNOMEDOCKITEM-DOCK-DRAG-MOTION"
></A
>The &quot;dock-drag-motion&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dockitem,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg2,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is emitted while the item is being dragged and reports
that the pointer position has changed.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN16972"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dockitem</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the new X coordinate of the upper left corner of the item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the new Y coordinate of the upper left corner of the item.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN16993"
></A
><H3
><A
NAME="GNOMEDOCKITEM-DOCK-DETACH"
></A
>The &quot;dock-detach&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *dockitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is emitted when an item is detached from its parent dock
band and thus becomes a floating item.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17000"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dockitem</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17013"
></A
><H2
>See Also</H2
><P
><A
HREF="gnomedock.html"
>GnomeDock</A
>
<A
HREF="gnomedockband.html"
>GnomeDockBand</A
>
<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedockband.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedock.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
>GnomeDockBand</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeDock</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeDockLayout</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeSpell"
HREF="gnomespell.html"><LINK
REL="NEXT"
TITLE="GnomeProcBar"
HREF="gnomeprocbar.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomespell.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeprocbar.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEDOCKLAYOUT"
>GnomeDockLayout</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN28602"
></A
><H2
>Name</H2
>GnomeDockLayout&nbsp;--&nbsp;A widget for saving and retrieving the layout of a
<SPAN
CLASS="TYPE"
>GnomeDock</SPAN
> widget.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN28606"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomedocklayout.html#GNOMEDOCKLAYOUT-STRUCT"
>GnomeDockLayout</A
>;
struct      <A
HREF="gnomedocklayout.html#GNOMEDOCKLAYOUTITEM"
>GnomeDockLayoutItem</A
>;
<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
>* <A
HREF="gnomedocklayout.html#GNOME-DOCK-LAYOUT-NEW"
>gnome_dock_layout_new</A
>      (void);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedocklayout.html#GNOME-DOCK-LAYOUT-ADD-ITEM"
>gnome_dock_layout_add_item</A
>      (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_num,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_position,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> offset);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedocklayout.html#GNOME-DOCK-LAYOUT-ADD-FLOATING-ITEM"
>gnome_dock_layout_add_floating_item</A
>
                                            (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKORIENTATION
>GtkOrientation</A> orientation);
<A
HREF="gnomedocklayout.html#GNOMEDOCKLAYOUTITEM"
>GnomeDockLayoutItem</A
>* <A
HREF="gnomedocklayout.html#GNOME-DOCK-LAYOUT-GET-ITEM"
>gnome_dock_layout_get_item</A
>
                                            (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item);
<A
HREF="gnomedocklayout.html#GNOMEDOCKLAYOUTITEM"
>GnomeDockLayoutItem</A
>* <A
HREF="gnomedocklayout.html#GNOME-DOCK-LAYOUT-GET-ITEM-BY-NAME"
>gnome_dock_layout_get_item_by_name</A
>
                                            (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedocklayout.html#GNOME-DOCK-LAYOUT-REMOVE-ITEM"
>gnome_dock_layout_remove_item</A
>   (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedocklayout.html#GNOME-DOCK-LAYOUT-REMOVE-ITEM-BY-NAME"
>gnome_dock_layout_remove_item_by_name</A
>
                                            (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomedocklayout.html#GNOME-DOCK-LAYOUT-CREATE-STRING"
>gnome_dock_layout_create_string</A
> (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedocklayout.html#GNOME-DOCK-LAYOUT-PARSE-STRING"
>gnome_dock_layout_parse_string</A
>  (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *string);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedocklayout.html#GNOME-DOCK-LAYOUT-ADD-TO-DOCK"
>gnome_dock_layout_add_to_dock</A
>   (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             <A
HREF="gnomedock.html"
>GnomeDock</A
> *dock);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28655"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----GnomeDockLayout</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28659"
></A
><H2
>Description</H2
><P
>The <SPAN
CLASS="TYPE"
>GnomeDockLayout</SPAN
> widget is meant to make it simple for
programmers to handle the layout of a <SPAN
CLASS="TYPE"
>GnomeDock</SPAN
> widget.</P
><P
><SPAN
CLASS="TYPE"
>GnomeDockLayout</SPAN
> can contain an arbitrary number of
<SPAN
CLASS="TYPE"
>GnomeDockItem</SPAN
> widgets, each of them with its own
placement information.  It is possible to "extract" a layout from an
existing <SPAN
CLASS="TYPE"
>GnomeDock</SPAN
> widget, as well as adding the items
present in a <SPAN
CLASS="TYPE"
>GnomeDockLayout</SPAN
> to it.  Moreover,
<SPAN
CLASS="TYPE"
>GnomeDockLayout</SPAN
> is able to create a layout configuration
string that can be later used to re-construct the layout on a brand
new <SPAN
CLASS="TYPE"
>GnomeDockLayout</SPAN
> widget.</P
><P
>As a consequence, <SPAN
CLASS="TYPE"
>GnomeDockLayout</SPAN
> is very useful to save
and retrieve <SPAN
CLASS="TYPE"
>GnomeDock</SPAN
> configurations into files.  For
example, <SPAN
CLASS="TYPE"
>GnomeApp</SPAN
> uses <SPAN
CLASS="TYPE"
>GnomeDockLayout</SPAN
> to
create a default layout configuration, override it with the
user-specific configuration file, and finally apply it to it
<SPAN
CLASS="TYPE"
>GnomeDock</SPAN
>.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28677"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN28679"
></A
><H3
><A
NAME="GNOMEDOCKLAYOUT-STRUCT"
></A
>struct GnomeDockLayout</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeDockLayout;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28684"
></A
><H3
><A
NAME="GNOMEDOCKLAYOUTITEM"
></A
>struct GnomeDockLayoutItem</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeDockLayoutItem
{
  GnomeDockItem *item;

  GnomeDockPlacement placement;

  union
  {
    struct
    {
      gint x;
      gint y;
      GtkOrientation orientation;
    } floating;

    struct
    {
      gint band_num;
      gint band_position;
      gint offset;
    } docked;

  } position;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28689"
></A
><H3
><A
NAME="GNOME-DOCK-LAYOUT-NEW"
></A
>gnome_dock_layout_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
>* gnome_dock_layout_new      (void);</PRE
></TD
></TR
></TABLE
><P
>Create a new <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28697"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The new <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28707"
></A
><H3
><A
NAME="GNOME-DOCK-LAYOUT-ADD-ITEM"
></A
>gnome_dock_layout_add_item ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_dock_layout_add_item      (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF="gnomedock.html#GNOMEDOCKPLACEMENT"
>GnomeDockPlacement</A
> placement,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_num,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> band_position,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> offset);</PRE
></TD
></TR
></TABLE
><P
>Add <TT
CLASS="PARAMETER"
><I
>item</I
></TT
> to <TT
CLASS="PARAMETER"
><I
>layout</I
></TT
> with the specified parameters.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28722"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The dock item to be added to <TT
CLASS="PARAMETER"
><I
>layout</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>placement</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Placement of <TT
CLASS="PARAMETER"
><I
>item</I
></TT
> in <TT
CLASS="PARAMETER"
><I
>layout</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Band number</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>band_position</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Position within the band</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Distance from the previous element in the band</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if the operation succeeds, <TT
CLASS="LITERAL"
>FALSE</TT
> if it fails.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28761"
></A
><H3
><A
NAME="GNOME-DOCK-LAYOUT-ADD-FLOATING-ITEM"
></A
>gnome_dock_layout_add_floating_item ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_dock_layout_add_floating_item
                                            (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKORIENTATION
>GtkOrientation</A> orientation);</PRE
></TD
></TR
></TABLE
><P
>Add <TT
CLASS="PARAMETER"
><I
>item</I
></TT
> to <TT
CLASS="PARAMETER"
><I
>layout</I
></TT
> as a floating item with the
specified (<TT
CLASS="PARAMETER"
><I
>x</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>y</I
></TT
>) position and <TT
CLASS="PARAMETER"
><I
>orientation</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28778"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The dock item to be added to <TT
CLASS="PARAMETER"
><I
>layout</I
></TT
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X-coordinate for the floating item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y-coordinate for the floating item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>orientation</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Orientation for the floating item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if the operation succeeds, <TT
CLASS="LITERAL"
>FALSE</TT
> if it fails.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28811"
></A
><H3
><A
NAME="GNOME-DOCK-LAYOUT-GET-ITEM"
></A
>gnome_dock_layout_get_item ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomedocklayout.html#GNOMEDOCKLAYOUTITEM"
>GnomeDockLayoutItem</A
>* gnome_dock_layout_get_item
                                            (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item);</PRE
></TD
></TR
></TABLE
><P
>Retrieve a layout item.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28820"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> to be retrieved</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The retrieved <A
HREF="gnomedocklayout.html#GNOMEDOCKLAYOUTITEM"
>GnomeDockLayoutItem</A
> widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28840"
></A
><H3
><A
NAME="GNOME-DOCK-LAYOUT-GET-ITEM-BY-NAME"
></A
>gnome_dock_layout_get_item_by_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomedocklayout.html#GNOMEDOCKLAYOUTITEM"
>GnomeDockLayoutItem</A
>* gnome_dock_layout_get_item_by_name
                                            (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);</PRE
></TD
></TR
></TABLE
><P
>Retrieve the dock item named <TT
CLASS="PARAMETER"
><I
>name</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28850"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of the item to be retrieved</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The named <A
HREF="gnomedocklayout.html#GNOMEDOCKLAYOUTITEM"
>GnomeDockLayoutItem</A
> widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28869"
></A
><H3
><A
NAME="GNOME-DOCK-LAYOUT-REMOVE-ITEM"
></A
>gnome_dock_layout_remove_item ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_dock_layout_remove_item   (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> *item);</PRE
></TD
></TR
></TABLE
><P
>Remove the specified <TT
CLASS="PARAMETER"
><I
>item</I
></TT
> from <TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28880"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> to be removed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if the operation succeeds, <TT
CLASS="LITERAL"
>FALSE</TT
> if it fails.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28901"
></A
><H3
><A
NAME="GNOME-DOCK-LAYOUT-REMOVE-ITEM-BY-NAME"
></A
>gnome_dock_layout_remove_item_by_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_dock_layout_remove_item_by_name
                                            (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);</PRE
></TD
></TR
></TABLE
><P
>Remove the item named <TT
CLASS="PARAMETER"
><I
>name</I
></TT
> from <TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28912"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of the <A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> to be removed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if the operation succeeds, <TT
CLASS="LITERAL"
>FALSE</TT
> if it fails.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28933"
></A
><H3
><A
NAME="GNOME-DOCK-LAYOUT-CREATE-STRING"
></A
>gnome_dock_layout_create_string ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_dock_layout_create_string (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout);</PRE
></TD
></TR
></TABLE
><P
>Generate a string describing the layout in <TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28942"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The (malloced) layout string for <TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28957"
></A
><H3
><A
NAME="GNOME-DOCK-LAYOUT-PARSE-STRING"
></A
>gnome_dock_layout_parse_string ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_dock_layout_parse_string  (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *string);</PRE
></TD
></TR
></TABLE
><P
>Parse the layout string <TT
CLASS="PARAMETER"
><I
>string</I
></TT
>, and move around the
items in <TT
CLASS="PARAMETER"
><I
>layout</I
></TT
> accordingly.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28968"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>string</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A layout string to be parsed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if the operation succeeds, <TT
CLASS="LITERAL"
>FALSE</TT
> if it fails.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28988"
></A
><H3
><A
NAME="GNOME-DOCK-LAYOUT-ADD-TO-DOCK"
></A
>gnome_dock_layout_add_to_dock ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_dock_layout_add_to_dock   (<A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> *layout,
                                             <A
HREF="gnomedock.html"
>GnomeDock</A
> *dock);</PRE
></TD
></TR
></TABLE
><P
>Add all the items in <TT
CLASS="PARAMETER"
><I
>layout</I
></TT
> to the specified <TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28999"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The <A
HREF="gnomedock.html"
>GnomeDock</A
> widget the layout items must be added to</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if the operation succeeds, <TT
CLASS="LITERAL"
>FALSE</TT
> if it fails.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN29020"
></A
><H2
>See Also</H2
><P
><A
HREF="gnomedock.html"
>GnomeDock</A
>
<A
HREF="gnomedockitem.html"
>GnomeDockItem</A
>
<A
HREF="gnomedockband.html"
>GnomeDockBand</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomespell.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeprocbar.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
>GnomeSpell</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeProcBar</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeDruid</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeDock"
HREF="gnomedock.html"><LINK
REL="NEXT"
TITLE="GnomeDruidPage"
HREF="gnomedruidpage.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedock.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedruidpage.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEDRUID"
>GnomeDruid</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN17453"
></A
><H2
>Name</H2
>GnomeDruid&nbsp;--&nbsp;  The main widget of the GNOME druid system.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN17456"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedruid.html#GNOME-DRUID-NEW"
>gnome_druid_new</A
>                 (void);
void        <A
HREF="gnomedruid.html#GNOME-DRUID-SET-BUTTONS-SENSITIVE"
>gnome_druid_set_buttons_sensitive</A
>
                                            (<A
HREF="gnomedruid.html"
>GnomeDruid</A
> *druid,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> back_sensitive,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> next_sensitive,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> cancel_sensitive);
void        <A
HREF="gnomedruid.html#GNOME-DRUID-SET-SHOW-FINISH"
>gnome_druid_set_show_finish</A
>     (<A
HREF="gnomedruid.html"
>GnomeDruid</A
> *druid,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> show_finish);
void        <A
HREF="gnomedruid.html#GNOME-DRUID-PREPEND-PAGE"
>gnome_druid_prepend_page</A
>        (<A
HREF="gnomedruid.html"
>GnomeDruid</A
> *druid,
                                             <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *page);
void        <A
HREF="gnomedruid.html#GNOME-DRUID-INSERT-PAGE"
>gnome_druid_insert_page</A
>         (<A
HREF="gnomedruid.html"
>GnomeDruid</A
> *druid,
                                             <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *back_page,
                                             <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *page);
void        <A
HREF="gnomedruid.html#GNOME-DRUID-APPEND-PAGE"
>gnome_druid_append_page</A
>         (<A
HREF="gnomedruid.html"
>GnomeDruid</A
> *druid,
                                             <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *page);
void        <A
HREF="gnomedruid.html#GNOME-DRUID-SET-PAGE"
>gnome_druid_set_page</A
>            (<A
HREF="gnomedruid.html"
>GnomeDruid</A
> *druid,
                                             <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *page);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17482"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----GnomeDruid</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17488"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomedruid.html#GNOMEDRUID-CANCEL"
>cancel</A
>&quot;    void        user_function      (<A
HREF="gnomedruid.html"
>GnomeDruid</A
> *druid,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17494"
></A
><H2
>Description</H2
><P
>    The GNOME druid is a system for assisting the user with installing a
    service.  It is roughly equivalent in functionality to the
    "Wizards" available in Windows.
  </P
><P
>    There are two major parts of the druid, the <A
HREF="gnomedruid.html"
>GnomeDruid</A
> widget, and
    the set of <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> widgets.  The <A
HREF="gnomedruid.html"
>GnomeDruid</A
> widget is the
    main widget that interacts with the user.  It has a Next, a
    Prev, and a Cancel button, and acts as a container for the pages.
    It is not a top-level window, so it needs to be put in a
    <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> in almost all cases.  The <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> is a virtual
    widget, from which all of the actual content of the page inherits
    from.  There are currently three of these available within
    gnome-libs.
  </P
><DIV
CLASS="REFSECT2"
><A
NAME="AEN17503"
></A
><H3
>Creating a druid</H3
><P
>      GNOME druids are fairly simple to program with.  You start by
      creating a <A
HREF="gnomedruid.html"
>GnomeDruid</A
> into which you put all of your pages.
      This widget will handle the presentation of the <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
>
      widgets.
    </P
><P
>      You then create all appropriate <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> widgets.  There
      are three implementations of these in libgnomeui, although there
      is no reason why more couldn't be written.  They are the
      <A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
>, the <A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
>, and the
      <A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
>.  The <A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
> acts as a
      <A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>, and is probably the most commonly used druid page.
      The other ones, as their names might suggest, are used at the
      endpoints of the druid.  More information on the specific
      properties of these widgets can be found on their respective
      pages.
    </P
><P
>      You will need to add the pages to the druid in order for them to
      appear.  The druid itself keeps an internal list of all pages, and
      using the <A
HREF="gnomedruid.html#GNOME-DRUID-PREPEND-PAGE"
>gnome_druid_prepend_page</A
>(), <A
HREF="gnomedruid.html#GNOME-DRUID-APPEND-PAGE"
>gnome_druid_append_page</A
>(),
      and <A
HREF="gnomedruid.html#GNOME-DRUID-INSERT-PAGE"
>gnome_druid_insert_page</A
>() will place them into it.
    </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17519"
></A
><H3
>Managing the control-flow in a druid</H3
><P
>      The control-flow in a druid is managed at the <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
>
      level, and is a little complex.  The signals available are "back",
      "next", "finish", "cancel" and "prepare", and all but the last are
      triggered when their respective buttons are pressed.  In the
      absence of anything connected to these signals, the druid will
      cycle through the pages in the order of the internal list, so for
      a simple druid, just adding the pages in order is sufficient.
    </P
><P
>      If the druid has some branching code, then it will be handled at
      the point of the branch.  The current page will emit the
      appropriate "next" or "back" signal in this case.  It is up to the
      druid author to trap this signal when necessary and call
      <A
HREF="gnomedruid.html#GNOME-DRUID-SET-PAGE"
>gnome_druid_set_page</A
>() in the handler to go to the correct page.
      In addition, they will want to return TRUE to let the druid know
      that it has handled the page change, and to prevent the druid from
      following its list.
    </P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17525"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN17527"
></A
><H3
><A
NAME="GNOME-DRUID-NEW"
></A
>gnome_druid_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_druid_new                 (void);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17533"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17542"
></A
><H3
><A
NAME="GNOME-DRUID-SET-BUTTONS-SENSITIVE"
></A
>gnome_druid_set_buttons_sensitive ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_set_buttons_sensitive
                                            (<A
HREF="gnomedruid.html"
>GnomeDruid</A
> *druid,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> back_sensitive,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> next_sensitive,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> cancel_sensitive);</PRE
></TD
></TR
></TABLE
><P
>Sets the sensitivity of the <TT
CLASS="PARAMETER"
><I
>druid</I
></TT
>'s control-buttons.  If the
variables are TRUE, then they will be clickable.  This function is used
primarily by the actual GnomeDruidPage widgets.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17553"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A Druid.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>back_sensitive</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The sensitivity of the back button.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>next_sensitive</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The sensitivity of the next button.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cancel_sensitive</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The sensitivity of the cancel button.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17574"
></A
><H3
><A
NAME="GNOME-DRUID-SET-SHOW-FINISH"
></A
>gnome_druid_set_show_finish ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_set_show_finish     (<A
HREF="gnomedruid.html"
>GnomeDruid</A
> *druid,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> show_finish);</PRE
></TD
></TR
></TABLE
><P
>Sets the text on the last button on the <TT
CLASS="PARAMETER"
><I
>druid</I
></TT
>.  If <TT
CLASS="PARAMETER"
><I
>show_finish</I
></TT
>
is TRUE, then the text becomes "Finish".  If <TT
CLASS="PARAMETER"
><I
>show_finish</I
></TT
> is FALSE, then the
text becomes "Cancel".</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17585"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A Druid widget.
 # <TT
CLASS="PARAMETER"
><I
>show_finish</I
></TT
>: If TRUE, then the "Cancel" button is changed to be "Finish"</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>show_finish</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17599"
></A
><H3
><A
NAME="GNOME-DRUID-PREPEND-PAGE"
></A
>gnome_druid_prepend_page ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_prepend_page        (<A
HREF="gnomedruid.html"
>GnomeDruid</A
> *druid,
                                             <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *page);</PRE
></TD
></TR
></TABLE
><P
>This will prepend a GnomeDruidPage into the internal list of
pages that the <TT
CLASS="PARAMETER"
><I
>druid</I
></TT
> has.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17608"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A Druid widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>page</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The page to be inserted.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17621"
></A
><H3
><A
NAME="GNOME-DRUID-INSERT-PAGE"
></A
>gnome_druid_insert_page ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_insert_page         (<A
HREF="gnomedruid.html"
>GnomeDruid</A
> *druid,
                                             <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *back_page,
                                             <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *page);</PRE
></TD
></TR
></TABLE
><P
>This will insert <TT
CLASS="PARAMETER"
><I
>page</I
></TT
> after <TT
CLASS="PARAMETER"
><I
>back_page</I
></TT
> into the list of
internal pages that the <TT
CLASS="PARAMETER"
><I
>druid</I
></TT
> has.  If <TT
CLASS="PARAMETER"
><I
>back_page</I
></TT
> is not present in the list
or NULL, <TT
CLASS="PARAMETER"
><I
>page</I
></TT
> will be prepended to the list.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17635"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A Druid widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>back_page</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The page prior to the page to be inserted.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>page</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The page to insert.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17652"
></A
><H3
><A
NAME="GNOME-DRUID-APPEND-PAGE"
></A
>gnome_druid_append_page ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_append_page         (<A
HREF="gnomedruid.html"
>GnomeDruid</A
> *druid,
                                             <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *page);</PRE
></TD
></TR
></TABLE
><P
>This will append <TT
CLASS="PARAMETER"
><I
>page</I
></TT
> onto the end of the internal list.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17661"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A Druid widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>page</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The page to be appended.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17674"
></A
><H3
><A
NAME="GNOME-DRUID-SET-PAGE"
></A
>gnome_druid_set_page ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_set_page            (<A
HREF="gnomedruid.html"
>GnomeDruid</A
> *druid,
                                             <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *page);</PRE
></TD
></TR
></TABLE
><P
>This will make <TT
CLASS="PARAMETER"
><I
>page</I
></TT
> the currently showing page in the druid.
<TT
CLASS="PARAMETER"
><I
>page</I
></TT
> must already be in the druid.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17684"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A Druid widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>page</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The page to be brought to the foreground.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17697"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN17699"
></A
><H3
><A
NAME="GNOMEDRUID-CANCEL"
></A
>The &quot;cancel&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomedruid.html"
>GnomeDruid</A
> *druid,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>  This signal is emitted when the "cancel" button has been pressed.  
  Note that the current druid page has the option to trap the signal 
  and use it, if need be, preventing this signal from being emitted.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17706"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17719"
></A
><H2
>See Also</H2
><P
>    <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
>, <A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
>, <A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
>, <A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
>
  </P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedock.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedruidpage.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
>GnomeDock</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeDruidPage</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeDruidPageFinish</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeDruidPageStandard"
HREF="gnomedruidpagestandard.html"><LINK
REL="NEXT"
TITLE="GnomeEntry"
HREF="gnomeentry.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedruidpagestandard.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeentry.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEDRUIDPAGEFINISH"
>GnomeDruidPageFinish</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN18527"
></A
><H2
>Name</H2
>GnomeDruidPageFinish&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN18530"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedruidpagefinish.html#GNOME-DRUID-PAGE-FINISH-NEW"
>gnome_druid_page_finish_new</A
>     (void);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedruidpagefinish.html#GNOME-DRUID-PAGE-FINISH-NEW-WITH-VALS"
>gnome_druid_page_finish_new_with_vals</A
>
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text,
                                             GdkImlibImage *logo,
                                             GdkImlibImage *watermark);
void        <A
HREF="gnomedruidpagefinish.html#GNOME-DRUID-PAGE-FINISH-SET-BG-COLOR"
>gnome_druid_page_finish_set_bg_color</A
>
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomedruidpagefinish.html#GNOME-DRUID-PAGE-FINISH-SET-TEXTBOX-COLOR"
>gnome_druid_page_finish_set_textbox_color</A
>
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomedruidpagefinish.html#GNOME-DRUID-PAGE-FINISH-SET-LOGO-BG-COLOR"
>gnome_druid_page_finish_set_logo_bg_color</A
>
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomedruidpagefinish.html#GNOME-DRUID-PAGE-FINISH-SET-TITLE-COLOR"
>gnome_druid_page_finish_set_title_color</A
>
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomedruidpagefinish.html#GNOME-DRUID-PAGE-FINISH-SET-TEXT-COLOR"
>gnome_druid_page_finish_set_text_color</A
>
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomedruidpagefinish.html#GNOME-DRUID-PAGE-FINISH-SET-TEXT"
>gnome_druid_page_finish_set_text</A
>
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text);
void        <A
HREF="gnomedruidpagefinish.html#GNOME-DRUID-PAGE-FINISH-SET-TITLE"
>gnome_druid_page_finish_set_title</A
>
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);
void        <A
HREF="gnomedruidpagefinish.html#GNOME-DRUID-PAGE-FINISH-SET-LOGO"
>gnome_druid_page_finish_set_logo</A
>
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             GdkImlibImage *logo_image);
void        <A
HREF="gnomedruidpagefinish.html#GNOME-DRUID-PAGE-FINISH-SET-WATERMARK"
>gnome_druid_page_finish_set_watermark</A
>
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             GdkImlibImage *watermark);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18568"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
>
                           +----GnomeDruidPageFinish</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18576"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18579"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN18581"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-FINISH-NEW"
></A
>gnome_druid_page_finish_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_druid_page_finish_new     (void);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18587"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18596"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-FINISH-NEW-WITH-VALS"
></A
>gnome_druid_page_finish_new_with_vals ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_druid_page_finish_new_with_vals
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text,
                                             GdkImlibImage *logo,
                                             GdkImlibImage *watermark);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18606"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>logo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>watermark</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18631"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-FINISH-SET-BG-COLOR"
></A
>gnome_druid_page_finish_set_bg_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_finish_set_bg_color
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18638"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_finish</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18651"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-FINISH-SET-TEXTBOX-COLOR"
></A
>gnome_druid_page_finish_set_textbox_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_finish_set_textbox_color
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18658"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_finish</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18671"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-FINISH-SET-LOGO-BG-COLOR"
></A
>gnome_druid_page_finish_set_logo_bg_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_finish_set_logo_bg_color
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18678"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_finish</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18691"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-FINISH-SET-TITLE-COLOR"
></A
>gnome_druid_page_finish_set_title_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_finish_set_title_color
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18698"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_finish</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18711"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-FINISH-SET-TEXT-COLOR"
></A
>gnome_druid_page_finish_set_text_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_finish_set_text_color
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18718"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_finish</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18731"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-FINISH-SET-TEXT"
></A
>gnome_druid_page_finish_set_text ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_finish_set_text
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18738"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_finish</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18751"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-FINISH-SET-TITLE"
></A
>gnome_druid_page_finish_set_title ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_finish_set_title
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18758"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_finish</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18771"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-FINISH-SET-LOGO"
></A
>gnome_druid_page_finish_set_logo ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_finish_set_logo
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             GdkImlibImage *logo_image);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18778"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_finish</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>logo_image</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18791"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-FINISH-SET-WATERMARK"
></A
>gnome_druid_page_finish_set_watermark ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_finish_set_watermark
                                            (<A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> *druid_page_finish,
                                             GdkImlibImage *watermark);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18798"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_finish</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>watermark</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedruidpagestandard.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeentry.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
>GnomeDruidPageStandard</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeEntry</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeDruidPage</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeDruid"
HREF="gnomedruid.html"><LINK
REL="NEXT"
TITLE="GnomeDruidPageStart"
HREF="gnomedruidpagestart.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedruid.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedruidpagestart.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEDRUIDPAGE"
>GnomeDruidPage</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN17731"
></A
><H2
>Name</H2
>GnomeDruidPage&nbsp;--&nbsp;A virtual widget defining the druid page.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN17734"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedruidpage.html#GNOME-DRUID-PAGE-NEXT"
>gnome_druid_page_next</A
>           (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druid_page);
void        <A
HREF="gnomedruidpage.html#GNOME-DRUID-PAGE-PREPARE"
>gnome_druid_page_prepare</A
>        (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druid_page);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedruidpage.html#GNOME-DRUID-PAGE-BACK"
>gnome_druid_page_back</A
>           (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druid_page);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomedruidpage.html#GNOME-DRUID-PAGE-CANCEL"
>gnome_druid_page_cancel</A
>         (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druid_page);
void        <A
HREF="gnomedruidpage.html#GNOME-DRUID-PAGE-FINISH"
>gnome_druid_page_finish</A
>         (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druid_page);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17750"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----GnomeDruidPage</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17757"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomedruidpage.html#GNOMEDRUIDPAGE-NEXT"
>next</A
>&quot;      <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function      (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druidpage,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomedruidpage.html#GNOMEDRUIDPAGE-PREPARE"
>prepare</A
>&quot;   void        user_function      (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druidpage,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomedruidpage.html#GNOMEDRUIDPAGE-BACK"
>back</A
>&quot;      <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function      (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druidpage,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomedruidpage.html#GNOMEDRUIDPAGE-FINISH"
>finish</A
>&quot;    void        user_function      (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druidpage,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomedruidpage.html#GNOMEDRUIDPAGE-CANCEL"
>cancel</A
>&quot;    <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function      (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druidpage,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17783"
></A
><H2
>Description</H2
><P
>This widget is a virtual widget to define the interface to a druid
page.  It's descendants are placed in <A
HREF="gnomedruid.html"
>GnomeDruid</A
>, and comprise of the
actual material in the widget.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17787"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN17789"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-NEXT"
></A
>gnome_druid_page_next ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_druid_page_next           (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druid_page);</PRE
></TD
></TR
></TABLE
><P
>This will emit the "next" signal for that particular page.  It
is called by gnome-druid exclusively.  It is expected that non-linear Druid's
will override this signal and return TRUE if it handles changing pages.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17797"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A DruidPage widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> This function will return FALSE by default.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17810"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-PREPARE"
></A
>gnome_druid_page_prepare ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_prepare        (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druid_page);</PRE
></TD
></TR
></TABLE
><P
>This emits the "prepare" signal for the page.  It is called by
gnome-druid exclusively.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17817"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A DruidPage widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17826"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-BACK"
></A
>gnome_druid_page_back ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_druid_page_back           (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druid_page);</PRE
></TD
></TR
></TABLE
><P
>This will emit the "back" signal for that particular page.  It
is called by gnome-druid exclusively.  It is expected that non-linear Druid's
will override this signal and return TRUE if it handles changing pages.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17834"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A DruidPage widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> This function will return FALSE by default.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17847"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-CANCEL"
></A
>gnome_druid_page_cancel ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_druid_page_cancel         (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druid_page);</PRE
></TD
></TR
></TABLE
><P
>This will emit the "cancel" signal for that particular page.  It
is called by gnome-druid exclusively.  It is expected that a Druid will
override this signal and return TRUE if it does not want to exit.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17855"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A DruidPage widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> This function will return FALSE by default.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17868"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-FINISH"
></A
>gnome_druid_page_finish ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_finish         (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druid_page);</PRE
></TD
></TR
></TABLE
><P
>This emits the "finish" signal for the page.  It is called by
gnome-druid exclusively.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17875"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A DruidPage widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN17884"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN17886"
></A
><H3
><A
NAME="GNOMEDRUIDPAGE-NEXT"
></A
>The &quot;next&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function                  (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druidpage,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is emitted by the druid when the "next" button is pressed.  It
is overridden by the application when it wants to go to a different
page.  If the signal returns TRUE, then it has handled the control-flow,
and the druid will not change the page.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17895"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druidpage</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the druid that emitted the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>TRUE or FALSE.&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17916"
></A
><H3
><A
NAME="GNOMEDRUIDPAGE-PREPARE"
></A
>The &quot;prepare&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druidpage,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is sent to all pages just before they are shown.  It gives
them an opportunity to prepare the page before it is realized.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17924"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druidpage</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the druid that emitted the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17941"
></A
><H3
><A
NAME="GNOMEDRUIDPAGE-BACK"
></A
>The &quot;back&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function                  (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druidpage,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is emitted by the druid when the "back" button is pressed.  It
is overridden by the application when it wants to go to a different
page.  If the signal returns TRUE, then it has handled the control-flow,
and the druid will not change the page.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17950"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druidpage</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the druid that emitted the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>TRUE or FALSE.&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17971"
></A
><H3
><A
NAME="GNOMEDRUIDPAGE-FINISH"
></A
>The &quot;finish&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druidpage,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is sent when the "finish" button is pressed on the druid.
It should finish setting up whatever the druid is doing, and quit.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN17979"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druidpage</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the druid that emitted the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN17996"
></A
><H3
><A
NAME="GNOMEDRUIDPAGE-CANCEL"
></A
>The &quot;cancel&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function                  (<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> *druidpage,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is sent when the "cancel" button is pressed on the druid.
It should put up a dialog, if needed, to confirm the users' exit.  If it
does intend to quit, it should return FALSE, which will cause <TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>
to emit it's "cancel" signal.  If it returns TRUE, it is assumed that
the DRUID does not want to quit, and it will keep running.  This return
value should be used with some caution.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18006"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druidpage</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the druid that emitted the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>TRUE or FALSE.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18027"
></A
><H2
>See Also</H2
><P
><A
HREF="gnomedruid.html"
>GnomeDruid</A
>, <A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
>, <A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
>, <A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedruid.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedruidpagestart.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
>GnomeDruid</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeDruidPageStart</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeDruidPageStandard</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeDruidPageStart"
HREF="gnomedruidpagestart.html"><LINK
REL="NEXT"
TITLE="GnomeDruidPageFinish"
HREF="gnomedruidpagefinish.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedruidpagestart.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedruidpagefinish.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEDRUIDPAGESTANDARD"
>GnomeDruidPageStandard</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN18342"
></A
><H2
>Name</H2
>GnomeDruidPageStandard&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN18345"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedruidpagestandard.html#GNOME-DRUID-PAGE-STANDARD-NEW"
>gnome_druid_page_standard_new</A
>   (void);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedruidpagestandard.html#GNOME-DRUID-PAGE-STANDARD-NEW-WITH-VALS"
>gnome_druid_page_standard_new_with_vals</A
>
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             GdkImlibImage *logo);
void        <A
HREF="gnomedruidpagestandard.html#GNOME-DRUID-PAGE-STANDARD-SET-BG-COLOR"
>gnome_druid_page_standard_set_bg_color</A
>
                                            (<A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
> *druid_page_standard,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomedruidpagestandard.html#GNOME-DRUID-PAGE-STANDARD-SET-LOGO-BG-COLOR"
>gnome_druid_page_standard_set_logo_bg_color</A
>
                                            (<A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
> *druid_page_standard,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomedruidpagestandard.html#GNOME-DRUID-PAGE-STANDARD-SET-TITLE-COLOR"
>gnome_druid_page_standard_set_title_color</A
>
                                            (<A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
> *druid_page_standard,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomedruidpagestandard.html#GNOME-DRUID-PAGE-STANDARD-SET-TITLE"
>gnome_druid_page_standard_set_title</A
>
                                            (<A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
> *druid_page_standard,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);
void        <A
HREF="gnomedruidpagestandard.html#GNOME-DRUID-PAGE-STANDARD-SET-LOGO"
>gnome_druid_page_standard_set_logo</A
>
                                            (<A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
> *druid_page_standard,
                                             GdkImlibImage *logo_image);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18369"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
>
                           +----GnomeDruidPageStandard</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18377"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18380"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN18382"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-STANDARD-NEW"
></A
>gnome_druid_page_standard_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_druid_page_standard_new   (void);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18388"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18397"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-STANDARD-NEW-WITH-VALS"
></A
>gnome_druid_page_standard_new_with_vals ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_druid_page_standard_new_with_vals
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             GdkImlibImage *logo);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18405"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>logo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18422"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-STANDARD-SET-BG-COLOR"
></A
>gnome_druid_page_standard_set_bg_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_standard_set_bg_color
                                            (<A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
> *druid_page_standard,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18429"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_standard</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18442"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-STANDARD-SET-LOGO-BG-COLOR"
></A
>gnome_druid_page_standard_set_logo_bg_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_standard_set_logo_bg_color
                                            (<A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
> *druid_page_standard,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18449"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_standard</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18462"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-STANDARD-SET-TITLE-COLOR"
></A
>gnome_druid_page_standard_set_title_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_standard_set_title_color
                                            (<A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
> *druid_page_standard,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18469"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_standard</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18482"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-STANDARD-SET-TITLE"
></A
>gnome_druid_page_standard_set_title ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_standard_set_title
                                            (<A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
> *druid_page_standard,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18489"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_standard</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18502"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-STANDARD-SET-LOGO"
></A
>gnome_druid_page_standard_set_logo ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_standard_set_logo
                                            (<A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
> *druid_page_standard,
                                             GdkImlibImage *logo_image);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18509"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_standard</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>logo_image</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedruidpagestart.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedruidpagefinish.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
>GnomeDruidPageStart</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeDruidPageFinish</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeDruidPageStart</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeDruidPage"
HREF="gnomedruidpage.html"><LINK
REL="NEXT"
TITLE="GnomeDruidPageStandard"
HREF="gnomedruidpagestandard.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedruidpage.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedruidpagestandard.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEDRUIDPAGESTART"
>GnomeDruidPageStart</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN18039"
></A
><H2
>Name</H2
>GnomeDruidPageStart&nbsp;--&nbsp;A GnomeDruidPage for the beginning of a DRUID.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN18042"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedruidpagestart.html#GNOME-DRUID-PAGE-START-NEW"
>gnome_druid_page_start_new</A
>      (void);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomedruidpagestart.html#GNOME-DRUID-PAGE-START-NEW-WITH-VALS"
>gnome_druid_page_start_new_with_vals</A
>
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text,
                                             GdkImlibImage *logo,
                                             GdkImlibImage *watermark);
void        <A
HREF="gnomedruidpagestart.html#GNOME-DRUID-PAGE-START-SET-BG-COLOR"
>gnome_druid_page_start_set_bg_color</A
>
                                            (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomedruidpagestart.html#GNOME-DRUID-PAGE-START-SET-TEXTBOX-COLOR"
>gnome_druid_page_start_set_textbox_color</A
>
                                            (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomedruidpagestart.html#GNOME-DRUID-PAGE-START-SET-LOGO-BG-COLOR"
>gnome_druid_page_start_set_logo_bg_color</A
>
                                            (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomedruidpagestart.html#GNOME-DRUID-PAGE-START-SET-TITLE-COLOR"
>gnome_druid_page_start_set_title_color</A
>
                                            (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomedruidpagestart.html#GNOME-DRUID-PAGE-START-SET-TEXT-COLOR"
>gnome_druid_page_start_set_text_color</A
>
                                            (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomedruidpagestart.html#GNOME-DRUID-PAGE-START-SET-TEXT"
>gnome_druid_page_start_set_text</A
> (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text);
void        <A
HREF="gnomedruidpagestart.html#GNOME-DRUID-PAGE-START-SET-TITLE"
>gnome_druid_page_start_set_title</A
>
                                            (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);
void        <A
HREF="gnomedruidpagestart.html#GNOME-DRUID-PAGE-START-SET-LOGO"
>gnome_druid_page_start_set_logo</A
> (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             GdkImlibImage *logo_image);
void        <A
HREF="gnomedruidpagestart.html#GNOME-DRUID-PAGE-START-SET-WATERMARK"
>gnome_druid_page_start_set_watermark</A
>
                                            (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             GdkImlibImage *watermark);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18080"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----<A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
>
                           +----GnomeDruidPageStart</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18088"
></A
><H2
>Description</H2
><P
>This is a <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
>.  It is meant to be used to introduce the user
to what is being installed in a consistent manner.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18092"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN18094"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-START-NEW"
></A
>gnome_druid_page_start_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_druid_page_start_new      (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a new GnomeDruidPageStart widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18101"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to new GnomeDruidPageStart</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18110"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-START-NEW-WITH-VALS"
></A
>gnome_druid_page_start_new_with_vals ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_druid_page_start_new_with_vals
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text,
                                             GdkImlibImage *logo,
                                             GdkImlibImage *watermark);</PRE
></TD
></TR
></TABLE
><P
>This will create a new GNOME Druid start page, with the values
given.  It is acceptable for any of them to be <TT
CLASS="LITERAL"
>NULL</TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18122"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The title.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The introduction text.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>logo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The logo in the upper right corner.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>watermark</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The watermark on the left.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GtkWidget pointer to new GnomeDruidPageStart.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18147"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-START-SET-BG-COLOR"
></A
>gnome_druid_page_start_set_bg_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_start_set_bg_color
                                            (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
>This will set the background color to be the <TT
CLASS="PARAMETER"
><I
>color</I
></TT
>.  You do not
need to allocate the color, as the <TT
CLASS="PARAMETER"
><I
>druid_page_start</I
></TT
> will do it for
you.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18157"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_start</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A DruidPageStart.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The new background color.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18170"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-START-SET-TEXTBOX-COLOR"
></A
>gnome_druid_page_start_set_textbox_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_start_set_textbox_color
                                            (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18177"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_start</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18190"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-START-SET-LOGO-BG-COLOR"
></A
>gnome_druid_page_start_set_logo_bg_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_start_set_logo_bg_color
                                            (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18197"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_start</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18210"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-START-SET-TITLE-COLOR"
></A
>gnome_druid_page_start_set_title_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_start_set_title_color
                                            (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18217"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_start</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18230"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-START-SET-TEXT-COLOR"
></A
>gnome_druid_page_start_set_text_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_start_set_text_color
                                            (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18237"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_start</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18250"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-START-SET-TEXT"
></A
>gnome_druid_page_start_set_text ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_start_set_text (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18257"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_start</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18270"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-START-SET-TITLE"
></A
>gnome_druid_page_start_set_title ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_start_set_title
                                            (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18277"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_start</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18290"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-START-SET-LOGO"
></A
>gnome_druid_page_start_set_logo ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_start_set_logo (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             GdkImlibImage *logo_image);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18297"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_start</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>logo_image</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18310"
></A
><H3
><A
NAME="GNOME-DRUID-PAGE-START-SET-WATERMARK"
></A
>gnome_druid_page_start_set_watermark ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_druid_page_start_set_watermark
                                            (<A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> *druid_page_start,
                                             GdkImlibImage *watermark);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18317"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>druid_page_start</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>watermark</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18330"
></A
><H2
>See Also</H2
><P
><A
HREF="gnomedruid.html"
>GnomeDruid</A
>, <A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
>, <A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
>, <A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedruidpage.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedruidpagestandard.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
>GnomeDruidPage</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeDruidPageStandard</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeEntry</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeDruidPageFinish"
HREF="gnomedruidpagefinish.html"><LINK
REL="NEXT"
TITLE="GnomeFileEntry"
HREF="gnomefileentry.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedruidpagefinish.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomefileentry.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEENTRY"
>GnomeEntry</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN18816"
></A
><H2
>Name</H2
>GnomeEntry&nbsp;--&nbsp;Entry widget with history tracking.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN18819"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeentry.html#GNOMEENTRY-STRUCT"
>GnomeEntry</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeentry.html#GNOME-ENTRY-NEW"
>gnome_entry_new</A
>                 (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *history_id);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeentry.html#GNOME-ENTRY-GTK-ENTRY"
>gnome_entry_gtk_entry</A
>           (<A
HREF="gnomeentry.html"
>GnomeEntry</A
> *gentry);
void        <A
HREF="gnomeentry.html#GNOME-ENTRY-SET-HISTORY-ID"
>gnome_entry_set_history_id</A
>      (<A
HREF="gnomeentry.html"
>GnomeEntry</A
> *gentry,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *history_id);
void        <A
HREF="gnomeentry.html#GNOME-ENTRY-PREPEND-HISTORY"
>gnome_entry_prepend_history</A
>     (<A
HREF="gnomeentry.html"
>GnomeEntry</A
> *gentry,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> save,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text);
void        <A
HREF="gnomeentry.html#GNOME-ENTRY-APPEND-HISTORY"
>gnome_entry_append_history</A
>      (<A
HREF="gnomeentry.html"
>GnomeEntry</A
> *gentry,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> save,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text);
void        <A
HREF="gnomeentry.html#GNOME-ENTRY-LOAD-HISTORY"
>gnome_entry_load_history</A
>        (<A
HREF="gnomeentry.html"
>GnomeEntry</A
> *gentry);
void        <A
HREF="gnomeentry.html#GNOME-ENTRY-SAVE-HISTORY"
>gnome_entry_save_history</A
>        (<A
HREF="gnomeentry.html"
>GnomeEntry</A
> *gentry);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18844"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbox.html
>GtkBox</A>
                     +----<A
HREF=../gtk/gtkhbox.html
>GtkHBox</A>
                           +----<A
HREF=../gtk/gtkcombo.html
>GtkCombo</A>
                                 +----GnomeEntry</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18853"
></A
><H2
>Description</H2
><P
>  This widget is a wrapper around the <A
HREF=../gtk/gtkentry.html
>GtkEntry</A> widget, but it provides
  a history mechanism for all the input entered into the widget.  The
  way this works is that a special identifier is provided when
  creating the <SPAN
CLASS="TYPE"
>GnomeEntry</SPAN
> widget, and this identifier
  is used to load and save the history of the text.</P
><P
>  Here is an example of how to use the widget

  <DIV
CLASS="EXAMPLE"
><A
NAME="AEN18859"
></A
><P
><B
>Example 1. Sample usage of the GnomeEntry widget</B
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>GtkWidget *gnomeentry, *gtkentry;
char *text;

...

/* create a gnome entry */
gnomeentry = gnome_entry_new("some_history_id");

/* get the GtkEntry widget */
gtkentry = gnome_entry_gtk_entry (GNOME_ENTRY (gnomeentry));

/* set the text to "BLAH" */
gtk_entry_set_text(GTK_ENTRY(gtkentry), "BLAH");

...

/*somewhere else we wish to retrieve the contents*/
text = gtk_entry_get_text(GTK_ENTRY(gtkentry));
     </PRE
></TD
></TR
></TABLE
></DIV
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18862"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN18864"
></A
><H3
><A
NAME="GNOMEENTRY-STRUCT"
></A
>struct GnomeEntry</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeEntry;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18869"
></A
><H3
><A
NAME="GNOME-ENTRY-NEW"
></A
>gnome_entry_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_entry_new                 (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *history_id);</PRE
></TD
></TR
></TABLE
><P
>Creates a new GnomeEntry widget.  If  <TT
CLASS="PARAMETER"
><I
>history_id</I
></TT
> is
not <TT
CLASS="LITERAL"
>NULL</TT
>, then the history list will be saved and restored between
uses under the given id.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18879"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>history_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> If not <TT
CLASS="LITERAL"
>NULL</TT
>, the text id under which history data is stored</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Newly-created GnomeEntry widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18893"
></A
><H3
><A
NAME="GNOME-ENTRY-GTK-ENTRY"
></A
>gnome_entry_gtk_entry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_entry_gtk_entry           (<A
HREF="gnomeentry.html"
>GnomeEntry</A
> *gentry);</PRE
></TD
></TR
></TABLE
><P
>Obtain pointer to GnomeEntry's internal text entry</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18901"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeEntry object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GtkEntry widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18914"
></A
><H3
><A
NAME="GNOME-ENTRY-SET-HISTORY-ID"
></A
>gnome_entry_set_history_id ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_entry_set_history_id      (<A
HREF="gnomeentry.html"
>GnomeEntry</A
> *gentry,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *history_id);</PRE
></TD
></TR
></TABLE
><P
>Set or clear the history id of the GnomeEntry widget.  If
<TT
CLASS="PARAMETER"
><I
>history_id</I
></TT
> is <TT
CLASS="LITERAL"
>NULL</TT
>, the widget's history id is cleared.  Otherwise,
the given id replaces the previous widget history id.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18924"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeEntry object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>history_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> If not <TT
CLASS="LITERAL"
>NULL</TT
>, the text id under which history data is stored</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18938"
></A
><H3
><A
NAME="GNOME-ENTRY-PREPEND-HISTORY"
></A
>gnome_entry_prepend_history ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_entry_prepend_history     (<A
HREF="gnomeentry.html"
>GnomeEntry</A
> *gentry,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> save,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text);</PRE
></TD
></TR
></TABLE
><P
>Adds a history item of the given <TT
CLASS="PARAMETER"
><I
>text</I
></TT
> to the head of
the history list inside <TT
CLASS="PARAMETER"
><I
>gentry</I
></TT
>.  If <TT
CLASS="PARAMETER"
><I
>save</I
></TT
> is <TT
CLASS="LITERAL"
>TRUE</TT
>, the history
item will be saved in the config file (assuming that <TT
CLASS="PARAMETER"
><I
>gentry</I
></TT
>'s
history id is not <TT
CLASS="LITERAL"
>NULL</TT
>).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18953"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeEntry object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>save</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> If <TT
CLASS="LITERAL"
>TRUE</TT
>, history entry will be saved to config file</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text to add</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18971"
></A
><H3
><A
NAME="GNOME-ENTRY-APPEND-HISTORY"
></A
>gnome_entry_append_history ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_entry_append_history      (<A
HREF="gnomeentry.html"
>GnomeEntry</A
> *gentry,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> save,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text);</PRE
></TD
></TR
></TABLE
><P
>Adds a history item of the given <TT
CLASS="PARAMETER"
><I
>text</I
></TT
> to the tail
of the history list inside <TT
CLASS="PARAMETER"
><I
>gentry</I
></TT
>.  If <TT
CLASS="PARAMETER"
><I
>save</I
></TT
> is <TT
CLASS="LITERAL"
>TRUE</TT
>, the
history item will be saved in the config file (assuming that
<TT
CLASS="PARAMETER"
><I
>gentry</I
></TT
>'s history id is not <TT
CLASS="LITERAL"
>NULL</TT
>).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN18986"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeEntry object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>save</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> If <TT
CLASS="LITERAL"
>TRUE</TT
>, history entry will be saved to config file</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text to add</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19004"
></A
><H3
><A
NAME="GNOME-ENTRY-LOAD-HISTORY"
></A
>gnome_entry_load_history ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_entry_load_history        (<A
HREF="gnomeentry.html"
>GnomeEntry</A
> *gentry);</PRE
></TD
></TR
></TABLE
><P
>Loads a stored history list from the GNOME config file,
if one is available.  If the history id of <TT
CLASS="PARAMETER"
><I
>gentry</I
></TT
> is <TT
CLASS="LITERAL"
>NULL</TT
>,
nothing occurs.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19013"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeEntry object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19022"
></A
><H3
><A
NAME="GNOME-ENTRY-SAVE-HISTORY"
></A
>gnome_entry_save_history ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_entry_save_history        (<A
HREF="gnomeentry.html"
>GnomeEntry</A
> *gentry);</PRE
></TD
></TR
></TABLE
><P
>Force the history items of the widget to be stored
in a configuration file.  If the history id of <TT
CLASS="PARAMETER"
><I
>gentry</I
></TT
> is <TT
CLASS="LITERAL"
>NULL</TT
>,
nothing occurs.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19031"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeEntry object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19040"
></A
><H2
>See Also</H2
><P
>  <A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
>, <A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
>, <A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
>, <A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedruidpagefinish.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomefileentry.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
>GnomeDruidPageFinish</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeFileEntry</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeFileEntry</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeEntry"
HREF="gnomeentry.html"><LINK
REL="NEXT"
TITLE="GnomeFontPicker"
HREF="gnomefontpicker.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeentry.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomefontpicker.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEFILEENTRY"
>GnomeFileEntry</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN19052"
></A
><H2
>Name</H2
>GnomeFileEntry&nbsp;--&nbsp;An entry widget for file names.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN19055"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomefileentry.html#GNOMEFILEENTRY-STRUCT"
>GnomeFileEntry</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-NEW"
>gnome_file_entry_new</A
>            (const char *history_id,
                                             const char *browse_dialog_title);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-GNOME-ENTRY"
>gnome_file_entry_gnome_entry</A
>    (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-GTK-ENTRY"
>gnome_file_entry_gtk_entry</A
>      (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry);
void        <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-SET-TITLE"
>gnome_file_entry_set_title</A
>      (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
                                             const char *browse_dialog_title);
void        <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-SET-DEFAULT-PATH"
>gnome_file_entry_set_default_path</A
>
                                            (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
                                             const char *path);
void        <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-SET-DIRECTORY"
>gnome_file_entry_set_directory</A
>  (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> directory_entry);
char*       <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-GET-FULL-PATH"
>gnome_file_entry_get_full_path</A
>  (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> file_must_exist);
void        <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-SET-MODAL"
>gnome_file_entry_set_modal</A
>      (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> is_modal);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19080"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbox.html
>GtkBox</A>
                     +----<A
HREF=../gtk/gtkhbox.html
>GtkHBox</A>
                           +----GnomeFileEntry</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19088"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomefileentry.html#GNOMEFILEENTRY-BROWSE-CLICKED"
>browse-clicked</A
>&quot;
            void        user_function      (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fileentry,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19094"
></A
><H2
>Description</H2
><P
>  This widget provides an entry box with history (a <A
HREF="gnomeentry.html"
>GnomeEntry</A
>) and a
  button which can pop up a file selector dialog box
  (GtkFileSelection). It also accepts DND drops from the filemanager
  and other sources.</P
><P
>The following is an example of its use. It is a collection of excerpts
from the sound section of the GNOME control center.</P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN19099"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>static SoundProps *
sound_properties_create(void)
{
   char *path;
   GtkWidget *btn_filename;
   SoundProps *retval;

...
   /* Create the gnome_file_entry widget, with a given title */

   btn_filename = gnome_file_entry_new(NULL, _("Select sound file"));

   /* sets the default path */
   path = gnome_datadir_file ("sounds/");
   gnome_file_entry_set_default_path(GNOME_FILE_ENTRY (retval-&#62;btn_filename), path);

   /* Connect the function sound_properties_event_change_file to the
   event "changed" of the entry widget of gnome_file_entry. The
   function will be called with a pointer to the entry widget in the
   gnome_file_entry and the "retval" value. Look at
   sound_properties_event_change_file below. */

   gtk_signal_connect(GTK_OBJECT(gnome_file_entry_gtk_entry(GNOME_FILE_ENTRY(btn_filename))),
                       "changed",
                       GTK_SIGNAL_FUNC(sound_properties_event_change_file),
                       retval);
...

}
...

/* This is the callback function for the "changed" event of the
gnome_file_entry.  */

static void
sound_properties_event_change_file(GtkEditable *entry, SoundProps *props)
{
    char *tmp, *sounddir, *tmp2;
    
...
    /* Get the current value of the gnome_file_entry */
    tmp = gtk_entry_get_text(GTK_ENTRY(entry));

...

}

...

static void
sound_properties_event_play(GtkWidget *widget, SoundProps *props)
{
    GtkWidget *entry;

    /* This code shows how to read the current value of the widget,
       you first have to get a pointer to the entry widget of the
       gnome_file_entry*/

    entry = gnome_file_entry_gtk_entry(GNOME_FILE_ENTRY(props-&#62;btn_filename));

    gnome_sound_play(gtk_entry_get_text(GTK_ENTRY(entry)));
}

...

/* This is the way that you set the value of the widget */

GtkWidget *btn_filename;

gtk_entry_set_text(GTK_ENTRY(gnome_file_entry_gtk_entry(GNOME_FILE_ENTRY(btn_filename))),
ctmp);


  </PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19101"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN19103"
></A
><H3
><A
NAME="GNOMEFILEENTRY-STRUCT"
></A
>struct GnomeFileEntry</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeFileEntry;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19108"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-NEW"
></A
>gnome_file_entry_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_file_entry_new            (const char *history_id,
                                             const char *browse_dialog_title);</PRE
></TD
></TR
></TABLE
><P
>Creates a new <A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19116"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>history_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the id given to <A
HREF="gnomeentry.html#GNOME-ENTRY-NEW"
>gnome_entry_new</A
> (see <A
HREF="gnomeentry.html"
>GnomeEntry</A
>).</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>browse_dialog_title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Title for the file dialog window.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to the widget, NULL if it cannot be created.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19135"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-GNOME-ENTRY"
></A
>gnome_file_entry_gnome_entry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_file_entry_gnome_entry    (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry);</PRE
></TD
></TR
></TABLE
><P
>It returns a pointer to the gnome entry widget of the
widget (see<A
HREF="gnomeentry.html"
>GnomeEntry</A
>).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19144"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeFileEntry widget to work with.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to the component <A
HREF="gnomeentry.html"
>GnomeEntry</A
> widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19158"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-GTK-ENTRY"
></A
>gnome_file_entry_gtk_entry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_file_entry_gtk_entry      (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry);</PRE
></TD
></TR
></TABLE
><P
>Similar to <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-GNOME-ENTRY"
>gnome_file_entry_gnome_entry</A
> but
returns the gtk entry instead of the Gnome entry widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19167"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeFileEntry widget to work with.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Returns the GtkEntry widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19180"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-SET-TITLE"
></A
>gnome_file_entry_set_title ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_file_entry_set_title      (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
                                             const char *browse_dialog_title);</PRE
></TD
></TR
></TABLE
><P
>Set the title of the browse dialog to <TT
CLASS="PARAMETER"
><I
>browse_dialog_title</I
></TT
>.
The new title will go into effect the next time the browse button is pressed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19188"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeFileEntry widget to work with.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>browse_dialog_title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The new title for the file browse dialog window.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19201"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-SET-DEFAULT-PATH"
></A
>gnome_file_entry_set_default_path ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_file_entry_set_default_path
                                            (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
                                             const char *path);</PRE
></TD
></TR
></TABLE
><P
>Set the default path of browse dialog to <TT
CLASS="PARAMETER"
><I
>path</I
></TT
>. The
default path is only used if the entry is empty or if the current path
of the entry is not an absolute path, in which case the default
path is prepended to it before the dialog is started.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19209"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeFileEntry widget to work with.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A path string.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19222"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-SET-DIRECTORY"
></A
>gnome_file_entry_set_directory ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_file_entry_set_directory  (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> directory_entry);</PRE
></TD
></TR
></TABLE
><P
>Sets whether this is a directory only entry.  If
<TT
CLASS="PARAMETER"
><I
>directory_entry</I
></TT
> is true, then <A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-GET-FULL-PATH"
>gnome_file_entry_get_full_path</A
> will
check for the file being a directory, and the browse dialog will have
the file list disabled.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19232"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeFileEntry widget to work with.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>directory_entry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> boolean</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19245"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-GET-FULL-PATH"
></A
>gnome_file_entry_get_full_path ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>char*       gnome_file_entry_get_full_path  (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> file_must_exist);</PRE
></TD
></TR
></TABLE
><P
>Gets the full absolute path of the file from the entry.
If <TT
CLASS="PARAMETER"
><I
>file_must_exist</I
></TT
> is false, nothing is tested and the path is returned.
If <TT
CLASS="PARAMETER"
><I
>file_must_exist</I
></TT
> is true, then the path is only returned if the path
actually exists. In case the entry is a directory entry (see
<A
HREF="gnomefileentry.html#GNOME-FILE-ENTRY-SET-DIRECTORY"
>gnome_file_entry_set_directory</A
>), then if the path exists and is a
directory then it's returned; if not, it is assumed it was a file so
we try to strip it, and try again. It allocates memory for the returned string.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19256"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeFileEntry widget to work with.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>file_must_exist</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> boolean</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a newly allocated string with the path or NULL if something went
wrong</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19273"
></A
><H3
><A
NAME="GNOME-FILE-ENTRY-SET-MODAL"
></A
>gnome_file_entry_set_modal ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_file_entry_set_modal      (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fentry,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> is_modal);</PRE
></TD
></TR
></TABLE
><P
>Sets the modality of the browse dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19281"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeFileEntry widget to work with.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>is_modal</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> true if the window is to be modal, false otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19294"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN19296"
></A
><H3
><A
NAME="GNOMEFILEENTRY-BROWSE-CLICKED"
></A
>The &quot;browse-clicked&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> *fileentry,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>  Signal emitted when the "browse" button is clicked. This is so that you
  can add stuff to the file selector or to override this method.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19303"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fileentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19316"
></A
><H2
>See Also</H2
><P
>  <A
HREF="gnomeentry.html"
>GnomeEntry</A
>, <A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
>, <A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
>, <A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeentry.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomefontpicker.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
>GnomeEntry</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeFontPicker</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeFontPicker</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeFileEntry"
HREF="gnomefileentry.html"><LINK
REL="NEXT"
TITLE="GnomeFontSelector"
HREF="gnomefontselector.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomefileentry.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomefontselector.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEFONTPICKER"
>GnomeFontPicker</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN19328"
></A
><H2
>Name</H2
>GnomeFontPicker&nbsp;--&nbsp;Button that displays current font; click to select new font.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN19331"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomefontpicker.html#GNOMEFONTPICKER-STRUCT"
>GnomeFontPicker</A
>;
enum        <A
HREF="gnomefontpicker.html#GNOMEFONTPICKERMODE"
>GnomeFontPickerMode</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomefontpicker.html#GNOME-FONT-PICKER-NEW"
>gnome_font_picker_new</A
>           (void);
void        <A
HREF="gnomefontpicker.html#GNOME-FONT-PICKER-SET-TITLE"
>gnome_font_picker_set_title</A
>     (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);
<A
HREF="gnomefontpicker.html#GNOMEFONTPICKERMODE"
>GnomeFontPickerMode</A
> <A
HREF="gnomefontpicker.html#GNOME-FONT-PICKER-GET-MODE"
>gnome_font_picker_get_mode</A
>
                                            (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp);
void        <A
HREF="gnomefontpicker.html#GNOME-FONT-PICKER-SET-MODE"
>gnome_font_picker_set_mode</A
>      (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp,
                                             <A
HREF="gnomefontpicker.html#GNOMEFONTPICKERMODE"
>GnomeFontPickerMode</A
> mode);
void        <A
HREF="gnomefontpicker.html#GNOME-FONT-PICKER-FI-SET-USE-FONT-IN-LABEL"
>gnome_font_picker_fi_set_use_font_in_label</A
>
                                            (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> use_font_in_label,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> size);
void        <A
HREF="gnomefontpicker.html#GNOME-FONT-PICKER-FI-SET-SHOW-SIZE"
>gnome_font_picker_fi_set_show_size</A
>
                                            (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> show_size);
void        <A
HREF="gnomefontpicker.html#GNOME-FONT-PICKER-UW-SET-WIDGET"
>gnome_font_picker_uw_set_widget</A
> (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomefontpicker.html#GNOME-FONT-PICKER-GET-FONT-NAME"
>gnome_font_picker_get_font_name</A
> (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp);
<A
HREF=../gdk/gdk-fonts.html#GDKFONT
>GdkFont</A>*    <A
HREF="gnomefontpicker.html#GNOME-FONT-PICKER-GET-FONT"
>gnome_font_picker_get_font</A
>      (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomefontpicker.html#GNOME-FONT-PICKER-SET-FONT-NAME"
>gnome_font_picker_set_font_name</A
> (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *fontname);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomefontpicker.html#GNOME-FONT-PICKER-GET-PREVIEW-TEXT"
>gnome_font_picker_get_preview_text</A
>
                                            (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp);
void        <A
HREF="gnomefontpicker.html#GNOME-FONT-PICKER-SET-PREVIEW-TEXT"
>gnome_font_picker_set_preview_text</A
>
                                            (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19373"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----<A
HREF=../gtk/gtkbutton.html
>GtkButton</A>
                           +----GnomeFontPicker</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19381"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomefontpicker.html#GNOMEFONTPICKER-FONT-SET"
>font-set</A
>&quot;  void        user_function      (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *fontpicker,
                                            <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19388"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19391"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN19393"
></A
><H3
><A
NAME="GNOMEFONTPICKER-STRUCT"
></A
>struct GnomeFontPicker</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeFontPicker;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19398"
></A
><H3
><A
NAME="GNOMEFONTPICKERMODE"
></A
>enum GnomeFontPickerMode</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum {
    GNOME_FONT_PICKER_MODE_PIXMAP,
    GNOME_FONT_PICKER_MODE_FONT_INFO,
    GNOME_FONT_PICKER_MODE_USER_WIDGET,
    GNOME_FONT_PICKER_MODE_UNKNOWN
} GnomeFontPickerMode;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19403"
></A
><H3
><A
NAME="GNOME-FONT-PICKER-NEW"
></A
>gnome_font_picker_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_font_picker_new           (void);</PRE
></TD
></TR
></TABLE
><P
>Create new font picker widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19410"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to new font picker widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19419"
></A
><H3
><A
NAME="GNOME-FONT-PICKER-SET-TITLE"
></A
>gnome_font_picker_set_title ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_font_picker_set_title     (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);</PRE
></TD
></TR
></TABLE
><P
>Sets the title for the font selection dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19427"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gfp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME font picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> String containing font selection dialog title.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19440"
></A
><H3
><A
NAME="GNOME-FONT-PICKER-GET-MODE"
></A
>gnome_font_picker_get_mode ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomefontpicker.html#GNOMEFONTPICKERMODE"
>GnomeFontPickerMode</A
> gnome_font_picker_get_mode
                                            (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp);</PRE
></TD
></TR
></TABLE
><P
>Returns current font picker button mode (or what to show).  Possible
values include <TT
CLASS="LITERAL"
>GNOME_FONT_PICKER_MODE_PIXMAP</TT
>,
<TT
CLASS="LITERAL"
>GNOME_FONT_PICKER_MODE_FONT_INFO</TT
>, and 
<TT
CLASS="LITERAL"
>GNOME_FONT_PICKER_MODE_USER_WIDGET</TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19451"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gfp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME font picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Button mode currently set in font picker widget, or 
<TT
CLASS="LITERAL"
>GNOME_FONT_PICKER_MODE_UNKNOWN</TT
> on error.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19465"
></A
><H3
><A
NAME="GNOME-FONT-PICKER-SET-MODE"
></A
>gnome_font_picker_set_mode ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_font_picker_set_mode      (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp,
                                             <A
HREF="gnomefontpicker.html#GNOMEFONTPICKERMODE"
>GnomeFontPickerMode</A
> mode);</PRE
></TD
></TR
></TABLE
><P
>Set value of subsequent font picker button mode (or what to show).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19473"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gfp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME font picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mode</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Value of subsequent font picker button mode (or what to show)</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19486"
></A
><H3
><A
NAME="GNOME-FONT-PICKER-FI-SET-USE-FONT-IN-LABEL"
></A
>gnome_font_picker_fi_set_use_font_in_label ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_font_picker_fi_set_use_font_in_label
                                            (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> use_font_in_label,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> size);</PRE
></TD
></TR
></TABLE
><P
>If <TT
CLASS="PARAMETER"
><I
>use_font_in_label</I
></TT
> is <TT
CLASS="LITERAL"
>TRUE</TT
>, font name will be written using font chosen
by user and using <TT
CLASS="PARAMETER"
><I
>size</I
></TT
> passed to this function.  This only applies if
current button mode is <TT
CLASS="LITERAL"
>GNOME_FONT_PICKER_MODE_FONT_INFO</TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19499"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gfp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME font picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>use_font_in_label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> If <TT
CLASS="LITERAL"
>TRUE</TT
>, font name will be written using font chosen.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>size</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Display font using this point size.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19517"
></A
><H3
><A
NAME="GNOME-FONT-PICKER-FI-SET-SHOW-SIZE"
></A
>gnome_font_picker_fi_set_show_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_font_picker_fi_set_show_size
                                            (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> show_size);</PRE
></TD
></TR
></TABLE
><P
>If <TT
CLASS="PARAMETER"
><I
>show_size</I
></TT
> is <TT
CLASS="LITERAL"
>TRUE</TT
>, font size will be displayed along with font chosen
by user.  This only applies if current button mode is
<TT
CLASS="LITERAL"
>GNOME_FONT_PICKER_MODE_FONT_INFO</TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19528"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gfp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME font picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>show_size</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if font size should be displayed in dialog.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19542"
></A
><H3
><A
NAME="GNOME-FONT-PICKER-UW-SET-WIDGET"
></A
>gnome_font_picker_uw_set_widget ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_font_picker_uw_set_widget (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget);</PRE
></TD
></TR
></TABLE
><P
>Set the user-supplied <TT
CLASS="PARAMETER"
><I
>widget</I
></TT
> as the inside of the font picker.
This only applies with GNOME_FONT_PICKER_MODE_USER_WIDGET.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19551"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gfp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME font picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> User widget to display for inside of font picker.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19564"
></A
><H3
><A
NAME="GNOME-FONT-PICKER-GET-FONT-NAME"
></A
>gnome_font_picker_get_font_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_font_picker_get_font_name (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp);</PRE
></TD
></TR
></TABLE
><P
>Retrieve name of font from font selection dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19572"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gfp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME font picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to an internal copy of the font name.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19585"
></A
><H3
><A
NAME="GNOME-FONT-PICKER-GET-FONT"
></A
>gnome_font_picker_get_font ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gdk/gdk-fonts.html#GDKFONT
>GdkFont</A>*    gnome_font_picker_get_font      (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp);</PRE
></TD
></TR
></TABLE
><P
>Retrieve font info from font selection dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19593"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gfp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME font picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Return value of gtk_font_selection_dialog_get_font, or <TT
CLASS="LITERAL"
>NULL</TT
> if
font dialog is not being displayed.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19607"
></A
><H3
><A
NAME="GNOME-FONT-PICKER-SET-FONT-NAME"
></A
>gnome_font_picker_set_font_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_font_picker_set_font_name (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *fontname);</PRE
></TD
></TR
></TABLE
><P
>Set or update currently-displayed font in font picker dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19616"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gfp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME font picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fontname</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of font to display in font selection dialog</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Return value of gtk_font_selection_dialog_set_font_name if the
font selection dialog exists, otherwise <TT
CLASS="LITERAL"
>FALSE</TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19634"
></A
><H3
><A
NAME="GNOME-FONT-PICKER-GET-PREVIEW-TEXT"
></A
>gnome_font_picker_get_preview_text ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_font_picker_get_preview_text
                                            (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp);</PRE
></TD
></TR
></TABLE
><P
>Retrieve preview text from font selection dialog if available.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19642"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gfp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME font picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Reference to internal copy of preview text string, or <TT
CLASS="LITERAL"
>NULL</TT
> if no
font dialog is being displayed.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19656"
></A
><H3
><A
NAME="GNOME-FONT-PICKER-SET-PREVIEW-TEXT"
></A
>gnome_font_picker_set_preview_text ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_font_picker_set_preview_text
                                            (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *gfp,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text);</PRE
></TD
></TR
></TABLE
><P
>Set preview text in font picker, and in font selection dialog if one
is being displayed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19664"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gfp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME font picker widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New preview text</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19677"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN19679"
></A
><H3
><A
NAME="GNOMEFONTPICKER-FONT-SET"
></A
>The &quot;font-set&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> *fontpicker,
                                            <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19687"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fontpicker</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomefileentry.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomefontselector.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
>GnomeFileEntry</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeFontSelector</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeFontSelector</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeFontPicker"
HREF="gnomefontpicker.html"><LINK
REL="NEXT"
TITLE="GnomeHRef"
HREF="gnomehref.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomefontpicker.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomehref.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEFONTSELECTOR"
>GnomeFontSelector</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN19709"
></A
><H2
>Name</H2
>GnomeFontSelector&nbsp;--&nbsp;Deprecated, use GtkFontSelection in a GnomeDialog or GnomeFontPicker</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN19712"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomefontselector.html#GNOMEFONTSELECTOR-STRUCT"
>GnomeFontSelector</A
>;
struct      <A
HREF="gnomefontselector.html#FONTINFO"
>FontInfo</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomefontselector.html#GNOME-FONT-SELECTOR-NEW"
>gnome_font_selector_new</A
>         (void);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomefontselector.html#GNOME-FONT-SELECTOR-GET-SELECTED"
>gnome_font_selector_get_selected</A
>
                                            (<A
HREF="gnomefontselector.html"
>GnomeFontSelector</A
> *text_tool);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomefontselector.html#GNOME-FONT-SELECT"
>gnome_font_select</A
>               (void);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomefontselector.html#GNOME-FONT-SELECT-WITH-DEFAULT"
>gnome_font_select_with_default</A
>  (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19727"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----<A
HREF=../gtk/gtkwindow.html
>GtkWindow</A>
                           +----<A
HREF=../gtk/gtkdialog.html
>GtkDialog</A>
                                 +----GnomeFontSelector</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19736"
></A
><H2
>Description</H2
><P
>Deprecated, use GtkFontSelection in a GnomeDialog or GnomeFontPicker</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19739"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN19741"
></A
><H3
><A
NAME="GNOMEFONTSELECTOR-STRUCT"
></A
>struct GnomeFontSelector</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeFontSelector;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19746"
></A
><H3
><A
NAME="FONTINFO"
></A
>struct FontInfo</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct FontInfo;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19751"
></A
><H3
><A
NAME="GNOME-FONT-SELECTOR-NEW"
></A
>gnome_font_selector_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_font_selector_new         (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19758"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a newly created font selector widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19767"
></A
><H3
><A
NAME="GNOME-FONT-SELECTOR-GET-SELECTED"
></A
>gnome_font_selector_get_selected ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_font_selector_get_selected
                                            (<A
HREF="gnomefontselector.html"
>GnomeFontSelector</A
> *text_tool);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19775"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text_tool</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a font selector</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the name of the font currently selected.  The value returned
is allocated with g_malloc.  The font name is in the format expected
by Gdk.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19788"
></A
><H3
><A
NAME="GNOME-FONT-SELECT"
></A
>gnome_font_select ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_font_select               (void);</PRE
></TD
></TR
></TABLE
><P
>Pops up a font selector and lets the user choose the font.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19795"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF=../glib/glib-memory-allocation.html#G-MALLOC
>g_malloc</A>()ed string with the X font name that was selected</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19805"
></A
><H3
><A
NAME="GNOME-FONT-SELECT-WITH-DEFAULT"
></A
>gnome_font_select_with_default ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_font_select_with_default  (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19812"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>Param1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomefontpicker.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomehref.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
>GnomeFontPicker</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeHRef</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeHRef</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeFontSelector"
HREF="gnomefontselector.html"><LINK
REL="NEXT"
TITLE="GnomeIconEntry"
HREF="gnomeiconentry.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomefontselector.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeiconentry.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEHREF"
>GnomeHRef</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN19830"
></A
><H2
>Name</H2
>GnomeHRef&nbsp;--&nbsp;A clickable URL button.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN19833"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomehref.html#GNOMEHREF-STRUCT"
>GnomeHRef</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomehref.html#GNOME-HREF-NEW"
>gnome_href_new</A
>                  (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *url,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *label);
void        <A
HREF="gnomehref.html#GNOME-HREF-SET-URL"
>gnome_href_set_url</A
>              (<A
HREF="gnomehref.html"
>GnomeHRef</A
> *href,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *url);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomehref.html#GNOME-HREF-GET-URL"
>gnome_href_get_url</A
>              (<A
HREF="gnomehref.html"
>GnomeHRef</A
> *href);
void        <A
HREF="gnomehref.html#GNOME-HREF-SET-LABEL"
>gnome_href_set_label</A
>            (<A
HREF="gnomehref.html"
>GnomeHRef</A
> *href,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *label);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomehref.html#GNOME-HREF-GET-LABEL"
>gnome_href_get_label</A
>            (<A
HREF="gnomehref.html"
>GnomeHRef</A
> *href);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19853"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----<A
HREF=../gtk/gtkbutton.html
>GtkButton</A>
                           +----GnomeHRef</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19861"
></A
><H2
>Description</H2
><P
>   This widget is a <A
HREF=../gtk/gtkbutton.html
>GtkButton</A> button that contains a URL.  When
   clicked it invokes the configured browser for the URL you provided.&#13;</P
><P
>   This sample program creates a button whose label is "GNOME Web
   site" and when clicked launches a browser to view the site at
   <TT
CLASS="FILENAME"
>http://www.gnome.org</TT
>.

<TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>   GtkWidget *button;

   button = gnome_href_new ("http://www.gnome.org", "GNOME Web site");</PRE
></TD
></TR
></TABLE
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19868"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN19870"
></A
><H3
><A
NAME="GNOMEHREF-STRUCT"
></A
>struct GnomeHRef</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeHRef;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19875"
></A
><H3
><A
NAME="GNOME-HREF-NEW"
></A
>gnome_href_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_href_new                  (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *url,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *label);</PRE
></TD
></TR
></TABLE
><P
>Created a GNOME href object, a label widget with a clickable action
and an associated URL.  If <TT
CLASS="PARAMETER"
><I
>label</I
></TT
> is set to <TT
CLASS="LITERAL"
>NULL</TT
>, <TT
CLASS="PARAMETER"
><I
>url</I
></TT
> is used as
the label.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19887"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>url</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> URL assigned to this object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text associated with the URL.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME href widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19904"
></A
><H3
><A
NAME="GNOME-HREF-SET-URL"
></A
>gnome_href_set_url ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_href_set_url              (<A
HREF="gnomehref.html"
>GnomeHRef</A
> *href,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *url);</PRE
></TD
></TR
></TABLE
><P
>Sets the internal URL value within <TT
CLASS="PARAMETER"
><I
>self</I
></TT
> to the value of <TT
CLASS="PARAMETER"
><I
>url</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19914"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>self</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeHRef widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>url</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> String containing the URL to be stored within <TT
CLASS="PARAMETER"
><I
>self</I
></TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19928"
></A
><H3
><A
NAME="GNOME-HREF-GET-URL"
></A
>gnome_href_get_url ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_href_get_url              (<A
HREF="gnomehref.html"
>GnomeHRef</A
> *href);</PRE
></TD
></TR
></TABLE
><P
>Returns the pointer to the URL associated with the <TT
CLASS="PARAMETER"
><I
>self</I
></TT
> href object.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19937"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>self</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeHRef widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to URL string, or <TT
CLASS="LITERAL"
>NULL</TT
> if failure.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19951"
></A
><H3
><A
NAME="GNOME-HREF-SET-LABEL"
></A
>gnome_href_set_label ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_href_set_label            (<A
HREF="gnomehref.html"
>GnomeHRef</A
> *href,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *label);</PRE
></TD
></TR
></TABLE
><P
>Sets the internal label widget text (used to display a URL's link
text) to the value given in <TT
CLASS="PARAMETER"
><I
>label</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19960"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>self</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeHRef widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New link text for the href object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19973"
></A
><H3
><A
NAME="GNOME-HREF-GET-LABEL"
></A
>gnome_href_get_label ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_href_get_label            (<A
HREF="gnomehref.html"
>GnomeHRef</A
> *href);</PRE
></TD
></TR
></TABLE
><P
>Returns the contents of the label widget used to display the link
text.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN19981"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>self</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeHRef widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to text contained in the label widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19994"
></A
><H2
>See Also</H2
><P
><A
HREF=../gnome/gnome-gnome-url.html#GNOME-URL-SHOW
>gnome_url_show</A>(), <A
HREF=../gtk/gtkbutton.html
>GtkButton</A>,</P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomefontselector.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeiconentry.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
>GnomeFontSelector</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeIconEntry</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeIconEntry</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeHRef"
HREF="gnomehref.html"><LINK
REL="NEXT"
TITLE="GnomeIconTextItem"
HREF="gnomeicontextitem.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomehref.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeicontextitem.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEICONENTRY"
>GnomeIconEntry</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN20004"
></A
><H2
>Name</H2
>GnomeIconEntry&nbsp;--&nbsp;A widget to select an icon.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN20007"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeiconentry.html#GNOMEICONENTRY-STRUCT"
>GnomeIconEntry</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeiconentry.html#GNOME-ICON-ENTRY-NEW"
>gnome_icon_entry_new</A
>            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *history_id,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *browse_dialog_title);
void        <A
HREF="gnomeiconentry.html#GNOME-ICON-ENTRY-SET-PIXMAP-SUBDIR"
>gnome_icon_entry_set_pixmap_subdir</A
>
                                            (<A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
> *ientry,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *subdir);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeiconentry.html#GNOME-ICON-ENTRY-GNOME-FILE-ENTRY"
>gnome_icon_entry_gnome_file_entry</A
>
                                            (<A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
> *ientry);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeiconentry.html#GNOME-ICON-ENTRY-GNOME-ENTRY"
>gnome_icon_entry_gnome_entry</A
>    (<A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
> *ientry);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeiconentry.html#GNOME-ICON-ENTRY-GTK-ENTRY"
>gnome_icon_entry_gtk_entry</A
>      (<A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
> *ientry);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomeiconentry.html#GNOME-ICON-ENTRY-GET-FILENAME"
>gnome_icon_entry_get_filename</A
>   (<A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
> *ientry);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20030"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbox.html
>GtkBox</A>
                     +----<A
HREF=../gtk/gtkvbox.html
>GtkVBox</A>
                           +----GnomeIconEntry</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20038"
></A
><H2
>Description</H2
><P
>   This widget provides the facilities to select an icon.  An icon is
   displayed inside a button, when the button is pressed, an Icon
   selector (a dialog with a GnomeIconSel widget) pops up to let the
   user choose an icon.  It also allows one to Drag and Drop the images
   to and from the preview button.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20042"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN20044"
></A
><H3
><A
NAME="GNOMEICONENTRY-STRUCT"
></A
>struct GnomeIconEntry</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeIconEntry;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20049"
></A
><H3
><A
NAME="GNOME-ICON-ENTRY-NEW"
></A
>gnome_icon_entry_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_icon_entry_new            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *history_id,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *browse_dialog_title);</PRE
></TD
></TR
></TABLE
><P
>Creates a new icon entry widget</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20058"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>history_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the id given to <A
HREF="gnomeentry.html#GNOME-ENTRY-NEW"
>gnome_entry_new</A
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>browse_dialog_title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> title of the browse dialog and icon selection dialog</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Returns the new object</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20076"
></A
><H3
><A
NAME="GNOME-ICON-ENTRY-SET-PIXMAP-SUBDIR"
></A
>gnome_icon_entry_set_pixmap_subdir ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_entry_set_pixmap_subdir
                                            (<A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
> *ientry,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *subdir);</PRE
></TD
></TR
></TABLE
><P
>Sets the subdirectory below gnome's default
pixmap directory to use as the default path for the file
entry.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20084"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ientry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the GnomeIconEntry to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>subdir</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> subdirectory</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20097"
></A
><H3
><A
NAME="GNOME-ICON-ENTRY-GNOME-FILE-ENTRY"
></A
>gnome_icon_entry_gnome_file_entry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_icon_entry_gnome_file_entry
                                            (<A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
> *ientry);</PRE
></TD
></TR
></TABLE
><P
>Get the GnomeFileEntry widget that's part of the entry</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20105"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ientry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the GnomeIconEntry to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Returns GnomeFileEntry widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20118"
></A
><H3
><A
NAME="GNOME-ICON-ENTRY-GNOME-ENTRY"
></A
>gnome_icon_entry_gnome_entry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_icon_entry_gnome_entry    (<A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
> *ientry);</PRE
></TD
></TR
></TABLE
><P
>Get the GnomeEntry widget that's part of the entry</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20126"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ientry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the GnomeIconEntry to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Returns GnomeEntry widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20139"
></A
><H3
><A
NAME="GNOME-ICON-ENTRY-GTK-ENTRY"
></A
>gnome_icon_entry_gtk_entry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_icon_entry_gtk_entry      (<A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
> *ientry);</PRE
></TD
></TR
></TABLE
><P
>Get the GtkEntry widget that's part of the entry</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20147"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ientry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the GnomeIconEntry to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Returns GtkEntry widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20160"
></A
><H3
><A
NAME="GNOME-ICON-ENTRY-GET-FILENAME"
></A
>gnome_icon_entry_get_filename ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_icon_entry_get_filename   (<A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
> *ientry);</PRE
></TD
></TR
></TABLE
><P
>Gets the file name of the image if it was possible
to load it into the preview. That is, it will only return a filename
if the image exists and it was possible to load it as an image.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20168"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ientry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the GnomeIconEntry to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a newly allocated string with the path or <TT
CLASS="LITERAL"
>NULL</TT
> if it
couldn't load the file</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20182"
></A
><H2
>See Also</H2
><P
>  <A
HREF="gnomeentry.html"
>GnomeEntry</A
>, <A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
>, <A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
>, <A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomehref.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeicontextitem.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
>GnomeHRef</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeIconTextItem</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeIconList</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeIconTextItem"
HREF="gnomeicontextitem.html"><LINK
REL="NEXT"
TITLE="GnomeIconSelection"
HREF="gnomeiconselection.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeicontextitem.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeiconselection.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEICONLIST"
>GnomeIconList</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN20586"
></A
><H2
>Name</H2
>GnomeIconList&nbsp;--&nbsp;A list of icons with captions, with optional caption editing.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN20589"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


typedef     <A
HREF="gnomeiconlist.html"
>GnomeIconList</A
>;
#define     <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-IS-EDITABLE-CAPS"
>GNOME_ICON_LIST_IS_EDITABLE</A
>
#define     <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-STATIC-TEXT-CAPS"
>GNOME_ICON_LIST_STATIC_TEXT</A
>
enum        <A
HREF="gnomeiconlist.html#GNOMEICONLISTMODE"
>GnomeIconListMode</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-NEW"
>gnome_icon_list_new</A
>             (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> icon_width,
                                             <A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> *adj,
                                             int flags);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-NEW-FLAGS"
>gnome_icon_list_new_flags</A
>       (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> icon_width,
                                             <A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> *adj,
                                             int flags);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-CONSTRUCT"
>gnome_icon_list_construct</A
>       (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> icon_width,
                                             <A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> *adj,
                                             int flags);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-HADJUSTMENT"
>gnome_icon_list_set_hadjustment</A
> (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> *hadj);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-VADJUSTMENT"
>gnome_icon_list_set_vadjustment</A
> (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> *vadj);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-FREEZE"
>gnome_icon_list_freeze</A
>          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-THAW"
>gnome_icon_list_thaw</A
>            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-INSERT"
>gnome_icon_list_insert</A
>          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             const char *icon_filename,
                                             const char *text);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-INSERT-IMLIB"
>gnome_icon_list_insert_imlib</A
>    (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             GdkImlibImage *im,
                                             const char *text);
int         <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-APPEND"
>gnome_icon_list_append</A
>          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             const char *icon_filename,
                                             const char *text);
int         <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-APPEND-IMLIB"
>gnome_icon_list_append_imlib</A
>    (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             GdkImlibImage *im,
                                             const char *text);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-CLEAR"
>gnome_icon_list_clear</A
>           (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-REMOVE"
>gnome_icon_list_remove</A
>          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-SELECTION-MODE"
>gnome_icon_list_set_selection_mode</A
>
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKSELECTIONMODE
>GtkSelectionMode</A> mode);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SELECT-ICON"
>gnome_icon_list_select_icon</A
>     (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int idx);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-UNSELECT-ICON"
>gnome_icon_list_unselect_icon</A
>   (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);
int         <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-UNSELECT-ALL"
>gnome_icon_list_unselect_all</A
>    (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <A
HREF=../gdk/gdk-event-structures.html#GDKEVENT
>GdkEvent</A> *event,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> keep);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-ICON-WIDTH"
>gnome_icon_list_set_icon_width</A
>  (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int w);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-ROW-SPACING"
>gnome_icon_list_set_row_spacing</A
> (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-COL-SPACING"
>gnome_icon_list_set_col_spacing</A
> (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-TEXT-SPACING"
>gnome_icon_list_set_text_spacing</A
>
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-ICON-BORDER"
>gnome_icon_list_set_icon_border</A
> (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-SEPARATORS"
>gnome_icon_list_set_separators</A
>  (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             const char *sep);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-ICON-DATA"
>gnome_icon_list_set_icon_data</A
>   (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-ICON-DATA-FULL"
>gnome_icon_list_set_icon_data_full</A
>
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> destroy);
int         <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-FIND-ICON-FROM-DATA"
>gnome_icon_list_find_icon_from_data</A
>
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
<A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A>    <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-GET-ICON-DATA"
>gnome_icon_list_get_icon_data</A
>   (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);
void        <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-MOVETO"
>gnome_icon_list_moveto</A
>          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             double yalign);
<A
HREF=../gtk/gtk-standard-enumerations.html#GTKVISIBILITY
>GtkVisibility</A> <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-ICON-IS-VISIBLE"
>gnome_icon_list_icon_is_visible</A
>
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);
int         <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-GET-ICON-AT"
>gnome_icon_list_get_icon_at</A
>     (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int x,
                                             int y);
int         <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-GET-ITEMS-PER-LINE"
>gnome_icon_list_get_items_per_line</A
>
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);
&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20678"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtklayout.html
>GtkLayout</A>
                     +----<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
>
                           +----GnomeIconList</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20686"
></A
><H2
>Args</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  &quot;<A
HREF="gnomeiconlist.html#GNOMEICONLIST--HADJUSTMENT"
>hadjustment</A
>&quot;          <A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A>        : Read / Write
  &quot;<A
HREF="gnomeiconlist.html#GNOMEICONLIST--VADJUSTMENT"
>vadjustment</A
>&quot;          <A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A>        : Read / Write</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20693"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomeiconlist.html#GNOMEICONLIST-SELECT-ICON"
>select-icon</A
>&quot;
            void        user_function      (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *iconlist,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../gdk/gdk-event-structures.html#GDKEVENT
>GdkEvent</A> *event,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomeiconlist.html#GNOMEICONLIST-UNSELECT-ICON"
>unselect-icon</A
>&quot;
            void        user_function      (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *iconlist,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../gdk/gdk-event-structures.html#GDKEVENT
>GdkEvent</A> *event,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomeiconlist.html#GNOMEICONLIST-TEXT-CHANGED"
>text-changed</A
>&quot;
            <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function      (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *iconlist,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg2,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20712"
></A
><H2
>Description</H2
><P
>    The GNOME icon list widget can hold a number of icons with
    captions.  The icons on the list can be selected (various
    selection methods are supported).  The programmer can enable
    caption-editing for the icons.  This parameters is configured when
    you create the icon list widget.
  </P
><P
>    You can control the type of selection mode you desire by using the
    <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-SET-SELECTION-MODE"
>gnome_icon_list_set_selection_mode</A
>() function.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20717"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN20719"
></A
><H3
><A
NAME="GNOMEICONLIST"
></A
>GnomeIconList</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct {
	GnomeCanvas canvas;

	/* Scroll adjustments */
	GtkAdjustment *adj;
	GtkAdjustment *hadj;

	/* Number of icons in the list */
	int icons;

	/* Private data */
	gpointer priv; /* was GList *icon_list */

	int pad3; /* was int frozen */
	int pad4; /* was int dirty */
	int pad5; /* was int row_spacing */
	int pad6; /* was int col_spacing */
	int pad7; /* was int text_spacing */
	int pad8; /* was int icon_border */
	gpointer pad9; /* was char *separators */
	GnomeIconListMode pad10; /* was GnomeIconListMode mode */
	GtkSelectionMode pad11; /* was GtkSelectionMode selection_mode */

	/* A list of integers with the indices of the currently selected icons */
	GList *selection;

	gpointer pad12; /* was GList *preserve_selection */
	int pad13; /* was int icon_width */
	unsigned int pad14 : 1; /* was unsigned int is_editable : 1 */
	unsigned int pad15 : 1; /* was unsigned int static_text : 1 */
	int pad16; /* was int last_selected */
	gpointer pad17; /* was void *last_clicked */
	int pad18; /* was int timer_tag */
	int pad19; /* was int value_diff */
	gdouble pad20; /* was gdouble event_last_x */
	gdouble pad21; /* was gdouble event_last_y */
	gpointer pad22; /* was GList *lines */
	int pad23; /* was int total_height */
	double pad24; /* was double sel_start_x */
	double pad25; /* was double sel_start_y */
	gpointer pad26; /* was GnomeCanvasItem *sel_rect */
} GnomeIconList;</PRE
></TD
></TR
></TABLE
><P
>    All fields in the <SPAN
CLASS="STRUCTNAME"
>GnomeIconList</SPAN
> structure
    are private, except for the <TT
CLASS="STRUCTFIELD"
><I
>selection</I
></TT
>
    field which you must query to get information about which icons
    are currently selected in the icon list.
  </P
><P
>    The <TT
CLASS="STRUCTFIELD"
><I
>selection</I
></TT
> field of the
    <SPAN
CLASS="STRUCTNAME"
>GnomeIconList</SPAN
> structure is a linked list
    that holds the indices of the icons that are selected at any one
    time.  The <TT
CLASS="STRUCTFIELD"
><I
>data</I
></TT
> pointer in each link of
    the list can be casted to an integer, preferably using the
    <TT
CLASS="FUNCTION"
><A
HREF=../glib/glib-type-conversion-macros.html#GPOINTER-TO-INT-CAPS
>GPOINTER_TO_INT</A>()</TT
> macro, to get the index of
    the icon represented by that link:

    <TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>static void
print_selected_icons (GnomeIconList *gil)
{
	GList *l;
	int i;

	for (l = gil-&gt;selection; l; l = l-&gt;next) {
		i = GPOINTER_TO_INT (l-&#62;data)
		printf ("Icon number &percnt;d is selected\n", i);
	}
}
    </PRE
></TD
></TR
></TABLE
>
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20733"
></A
><H3
><A
NAME="GNOME-ICON-LIST-IS-EDITABLE-CAPS"
></A
>GNOME_ICON_LIST_IS_EDITABLE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_ICON_LIST_IS_EDITABLE 1</PRE
></TD
></TR
></TABLE
><P
>    This macro is a flag passed to the constructor functions.  It is
    used to specify that the icon list should have editable text
    captions.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20738"
></A
><H3
><A
NAME="GNOME-ICON-LIST-STATIC-TEXT-CAPS"
></A
>GNOME_ICON_LIST_STATIC_TEXT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_ICON_LIST_STATIC_TEXT 2</PRE
></TD
></TR
></TABLE
><P
>    This macro is a flag passed to the constructor functions.  It is
    used to specify whether an icon list makes copies of the text in
    the icon captions or whether it just keeps pointers to the text
    strings supplied by the application.  If this flag is specified,
    then the icon list will just store pointers to the original text
    strings specified by the application, which must then guarantee
    that they will not be freed or changed until the icon list no
    longer needs them.  If it is not specified, then the icon list
    will make copies of the text strings specified by the application.
  </P
><P
>    Applications with very big icon lists can save memory by
    specifying this flag and being careful about when to free the text
    strings that are used for the icon captions.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20744"
></A
><H3
><A
NAME="GNOMEICONLISTMODE"
></A
>enum GnomeIconListMode</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum {
	GNOME_ICON_LIST_ICONS,
	GNOME_ICON_LIST_TEXT_BELOW,
	GNOME_ICON_LIST_TEXT_RIGHT
} GnomeIconListMode;</PRE
></TD
></TR
></TABLE
><P
>    The use of this enumeration is currently not implemented.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20749"
></A
><H3
><A
NAME="GNOME-ICON-LIST-NEW"
></A
>gnome_icon_list_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_icon_list_new             (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> icon_width,
                                             <A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> *adj,
                                             int flags);</PRE
></TD
></TR
></TABLE
><P
>This function is kept for binary compatibility with old applications.  It is
similar in purpose to <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-NEW-FLAGS"
>gnome_icon_list_new_flags</A
>(), but it will always turn on
the <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_IS_EDITABLE</TT
> flag.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20760"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Width for the icon columns.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>adj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Adjustment to be used for vertical scrolling.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>flags</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A combination of <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_IS_EDITABLE</TT
> and <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_STATIC_TEXT</TT
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a newly-created icon list widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20783"
></A
><H3
><A
NAME="GNOME-ICON-LIST-NEW-FLAGS"
></A
>gnome_icon_list_new_flags ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_icon_list_new_flags       (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> icon_width,
                                             <A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> *adj,
                                             int flags);</PRE
></TD
></TR
></TABLE
><P
>Creates a new icon list widget.  The icon columns are allocated a width of
<TT
CLASS="PARAMETER"
><I
>icon_width</I
></TT
> pixels.  Icon captions will be word-wrapped to this width as
well.</P
><P
>The adjustment is used to pass an existing adjustment to be used to control
the icon list's vertical scrolling.  Normally NULL can be passed here; if the
icon list is inserted into a &amp;GtkScrolledWindow, it will handle scrolling
automatically.</P
><P
>If <TT
CLASS="PARAMETER"
><I
>flags</I
></TT
> has the <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_IS_EDITABLE</TT
> flag set, then the user will be
able to edit the text in the icon captions, and the "text_changed" signal
will be emitted when an icon's text is changed.</P
><P
>If <TT
CLASS="PARAMETER"
><I
>flags</I
></TT
> has the <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_STATIC_TEXT</TT
> flags set, then the text
for the icon captions will not be copied inside the icon list; it will only
store the pointers to the original text strings specified by the application.
This is intended to save memory.  If this flag is not set, then the text
strings will be copied and managed internally.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20800"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Width for the icon columns.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>adj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>        Adjustment to be used for vertical scrolling.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>flags</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>      A combination of <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_IS_EDITABLE</TT
> and <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_STATIC_TEXT</TT
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a newly-created icon list widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20823"
></A
><H3
><A
NAME="GNOME-ICON-LIST-CONSTRUCT"
></A
>gnome_icon_list_construct ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_construct       (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> icon_width,
                                             <A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> *adj,
                                             int flags);</PRE
></TD
></TR
></TABLE
><P
>Constructor for the icon list, to be used by derived classes.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20832"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Width for the icon columns.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>adj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Adjustment to be used for vertical scrolling.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>flags</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A combination of <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_IS_EDITABLE</TT
> and <TT
CLASS="LITERAL"
>GNOME_ICON_LIST_STATIC_TEXT</TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20855"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-HADJUSTMENT"
></A
>gnome_icon_list_set_hadjustment ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_hadjustment (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> *hadj);</PRE
></TD
></TR
></TABLE
><P
>Sets the adjustment to be used for horizontal scrolling.  This is normally
not required, as the icon list can be simply inserted in a &amp;GtkScrolledWindow
and scrolling will be handled automatically.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20863"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>hadj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Adjustment to be used for horizontal scrolling.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20876"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-VADJUSTMENT"
></A
>gnome_icon_list_set_vadjustment ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_vadjustment (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> *vadj);</PRE
></TD
></TR
></TABLE
><P
>Sets the adjustment to be used for vertical scrolling.  This is normally not
required, as the icon list can be simply inserted in a &amp;GtkScrolledWindow and
scrolling will be handled automatically.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20884"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>vadj</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20897"
></A
><H3
><A
NAME="GNOME-ICON-LIST-FREEZE"
></A
>gnome_icon_list_freeze ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_freeze          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);</PRE
></TD
></TR
></TABLE
><P
>Freezes an icon list so that any changes made to it will not be
reflected on the screen until it is thawed with <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-THAW"
>gnome_icon_list_thaw</A
>().
It is recommended to freeze the icon list before inserting or deleting
many icons, for example, so that the layout process will only be executed
once, when the icon list is finally thawed.</P
><P
>You can call this function multiple times, but it must be balanced with the
same number of calls to <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-THAW"
>gnome_icon_list_thaw</A
>() before the changes will take
effect.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20907"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  An icon list.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20916"
></A
><H3
><A
NAME="GNOME-ICON-LIST-THAW"
></A
>gnome_icon_list_thaw ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_thaw            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);</PRE
></TD
></TR
></TABLE
><P
>Thaws the icon list and performs any pending layout operations.  This
is to be used in conjunction with <A
HREF="gnomeiconlist.html#GNOME-ICON-LIST-FREEZE"
>gnome_icon_list_freeze</A
>().</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20924"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  An icon list.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20933"
></A
><H3
><A
NAME="GNOME-ICON-LIST-INSERT"
></A
>gnome_icon_list_insert ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_insert          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             const char *icon_filename,
                                             const char *text);</PRE
></TD
></TR
></TABLE
><P
>Inserts an icon in the specified icon list.  The icon's image is loaded
from the specified file, and it is inserted at the <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
> index.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20941"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>           An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>           Position at which the new icon should be inserted.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon_filename</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of the file that holds the icon's image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>          Text to be used for the icon's caption.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20962"
></A
><H3
><A
NAME="GNOME-ICON-LIST-INSERT-IMLIB"
></A
>gnome_icon_list_insert_imlib ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_insert_imlib    (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             GdkImlibImage *im,
                                             const char *text);</PRE
></TD
></TR
></TABLE
><P
>Inserts an icon in the specified icon list.  The icon is created from the
specified Imlib image, and it is inserted at the <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
> index.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20971"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Position at which the new icon should be inserted.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>im</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   Imlib image with the icon image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text to be used for the icon's caption.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20992"
></A
><H3
><A
NAME="GNOME-ICON-LIST-APPEND"
></A
>gnome_icon_list_append ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_icon_list_append          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             const char *icon_filename,
                                             const char *text);</PRE
></TD
></TR
></TABLE
><P
>Appends an icon to the specified icon list.  The icon's image is loaded from
the specified file, and it is inserted at the <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
> index.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21000"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>           An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon_filename</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of the file that holds the icon's image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>          Text to be used for the icon's caption.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21021"
></A
><H3
><A
NAME="GNOME-ICON-LIST-APPEND-IMLIB"
></A
>gnome_icon_list_append_imlib ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_icon_list_append_imlib    (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             GdkImlibImage *im,
                                             const char *text);</PRE
></TD
></TR
></TABLE
><P
>Appends an icon to the specified icon list.  The icon is created from
the specified Imlib image.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21029"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>im</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   Imlib image with the icon image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text to be used for the icon's caption.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21050"
></A
><H3
><A
NAME="GNOME-ICON-LIST-CLEAR"
></A
>gnome_icon_list_clear ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_clear           (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);</PRE
></TD
></TR
></TABLE
><P
>Clears the contents for the icon list by removing all the icons.  If destroy
handlers were specified for any of the icons, they will be called with the
appropriate data.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21057"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21066"
></A
><H3
><A
NAME="GNOME-ICON-LIST-REMOVE"
></A
>gnome_icon_list_remove ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_remove          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);</PRE
></TD
></TR
></TABLE
><P
>Removes the icon at index position <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>.  If a destroy handler was specified
for that icon, it will be called with the appropriate data.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21074"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Index of the icon that should be removed.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21087"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-SELECTION-MODE"
></A
>gnome_icon_list_set_selection_mode ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_selection_mode
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKSELECTIONMODE
>GtkSelectionMode</A> mode);</PRE
></TD
></TR
></TABLE
><P
>Sets the selection mode for an icon list.  The <TT
CLASS="LITERAL"
>GTK_SELECTION_MULTIPLE</TT
> and
<TT
CLASS="LITERAL"
>GTK_SELECTION_EXTENDED</TT
> modes are considered equivalent.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21097"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mode</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New selection mode.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21110"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SELECT-ICON"
></A
>gnome_icon_list_select_icon ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_select_icon     (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int idx);</PRE
></TD
></TR
></TABLE
><P
>Selects the icon at the index specified by <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21118"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>idx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21131"
></A
><H3
><A
NAME="GNOME-ICON-LIST-UNSELECT-ICON"
></A
>gnome_icon_list_unselect_icon ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_unselect_icon   (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);</PRE
></TD
></TR
></TABLE
><P
>Unselects the icon at the index specified by <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21139"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Index of the icon to be unselected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21152"
></A
><H3
><A
NAME="GNOME-ICON-LIST-UNSELECT-ALL"
></A
>gnome_icon_list_unselect_all ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_icon_list_unselect_all    (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <A
HREF=../gdk/gdk-event-structures.html#GDKEVENT
>GdkEvent</A> *event,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> keep);</PRE
></TD
></TR
></TABLE
><P
>Unselects all the icons in the icon list.  The <TT
CLASS="PARAMETER"
><I
>event</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>keep</I
></TT
> parameters
must be NULL, since they are used only internally.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21163"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>event</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Unused, must be NULL.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>keep</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  For internal use only; must be NULL.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the number of icons in the icon list</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21184"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-ICON-WIDTH"
></A
>gnome_icon_list_set_icon_width ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_icon_width  (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int w);</PRE
></TD
></TR
></TABLE
><P
>Sets the amount of horizontal space allocated to the icons, i.e. the column
width of the icon list.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21191"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>w</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   New width for the icon columns.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21204"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-ROW-SPACING"
></A
>gnome_icon_list_set_row_spacing ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_row_spacing (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);</PRE
></TD
></TR
></TABLE
><P
>Sets the spacing to be used between rows of icons.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21211"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixels</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of pixels for inter-row spacing.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21224"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-COL-SPACING"
></A
>gnome_icon_list_set_col_spacing ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_col_spacing (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);</PRE
></TD
></TR
></TABLE
><P
>Sets the spacing to be used between columns of icons.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21231"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixels</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of pixels for inter-column spacing.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21244"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-TEXT-SPACING"
></A
>gnome_icon_list_set_text_spacing ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_text_spacing
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);</PRE
></TD
></TR
></TABLE
><P
>Sets the spacing to be used between an icon's image and its text caption.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21251"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixels</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of pixels between an icon's image and its caption.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21264"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-ICON-BORDER"
></A
>gnome_icon_list_set_icon_border ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_icon_border (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pixels);</PRE
></TD
></TR
></TABLE
><P
>Sets the width of the border to be displayed around an icon's image.  This is
currently not implemented.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21271"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixels</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of border pixels to be used around an icon's image.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21284"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-SEPARATORS"
></A
>gnome_icon_list_set_separators ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_separators  (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             const char *sep);</PRE
></TD
></TR
></TABLE
><P
>Sets the characters that can be used as word separators when doing
word-wrapping in the icon text captions.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21291"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>sep</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> String with characters to be used as word separators.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21304"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-ICON-DATA"
></A
>gnome_icon_list_set_icon_data ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_icon_data   (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21311"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21328"
></A
><H3
><A
NAME="GNOME-ICON-LIST-SET-ICON-DATA-FULL"
></A
>gnome_icon_list_set_icon_data_full ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_set_icon_data_full
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> destroy);</PRE
></TD
></TR
></TABLE
><P
>Associates the <TT
CLASS="PARAMETER"
><I
>data</I
></TT
> pointer to the icon at the index specified by <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>.  The
<TT
CLASS="PARAMETER"
><I
>destroy</I
></TT
> argument points to a function that will be called when the icon is
destroyed, or NULL if no function is to be called when this happens.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21340"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>     An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>     Index of an icon.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    User data to set on the icon.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>destroy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Destroy notification handler for the icon.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21361"
></A
><H3
><A
NAME="GNOME-ICON-LIST-FIND-ICON-FROM-DATA"
></A
>gnome_icon_list_find_icon_from_data ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_icon_list_find_icon_from_data
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21369"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   Data pointer associated to an icon.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the index of the icon whose user data has been set to <TT
CLASS="PARAMETER"
><I
>data</I
></TT
>,
or -1 if no icon has this data associated to it.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21387"
></A
><H3
><A
NAME="GNOME-ICON-LIST-GET-ICON-DATA"
></A
>gnome_icon_list_get_icon_data ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A>    gnome_icon_list_get_icon_data   (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21395"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Index of an icon.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the user data pointer associated to the icon at the index specified
by <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21413"
></A
><H3
><A
NAME="GNOME-ICON-LIST-MOVETO"
></A
>gnome_icon_list_moveto ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_list_moveto          (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos,
                                             double yalign);</PRE
></TD
></TR
></TABLE
><P
>Makes the icon whose index is <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
> be visible on the screen.  The icon list
gets scrolled so that the icon is visible.  An alignment of 0.0 represents
the top of the visible part of the icon list, and 1.0 represents the bottom.
An icon can be centered on the icon list.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21422"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    Index of an icon.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>yalign</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Vertical alignment of the icon.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21439"
></A
><H3
><A
NAME="GNOME-ICON-LIST-ICON-IS-VISIBLE"
></A
>gnome_icon_list_icon_is_visible ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtk-standard-enumerations.html#GTKVISIBILITY
>GtkVisibility</A> gnome_icon_list_icon_is_visible
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int pos);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21446"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21463"
></A
><H3
><A
NAME="GNOME-ICON-LIST-GET-ICON-AT"
></A
>gnome_icon_list_get_icon_at ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_icon_list_get_icon_at     (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil,
                                             int x,
                                             int y);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21470"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   X position in the icon list window.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>   Y position in the icon list window.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the index of the icon that is under the specified coordinates, which
are relative to the icon list's window.  If there is no icon in that
position, -1 is returned.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21491"
></A
><H3
><A
NAME="GNOME-ICON-LIST-GET-ITEMS-PER-LINE"
></A
>gnome_icon_list_get_items_per_line ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_icon_list_get_items_per_line
                                            (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *gil);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21498"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gil</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon list.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the number of icons that fit in a line or row.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN21511"
></A
><H2
>Args</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
NAME="GNOMEICONLIST--HADJUSTMENT"
></A
>&quot;<TT
CLASS="LITERAL"
>hadjustment</TT
>&quot; (<A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> : Read / Write)</DT
><DD
><P
>    This is a <SPAN
CLASS="STRUCTNAME"
>GtkHAdjustment</SPAN
> that is used
    internally to support the
    <SPAN
CLASS="STRUCTNAME"
>GtkScrolledWindow</SPAN
> scrolling interface.
  </P
></DD
><DT
><A
NAME="GNOMEICONLIST--VADJUSTMENT"
></A
>&quot;<TT
CLASS="LITERAL"
>vadjustment</TT
>&quot; (<A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> : Read / Write)</DT
><DD
><P
>    This is a <SPAN
CLASS="STRUCTNAME"
>GtkVAdjustment</SPAN
> that is used
    internally to support the
    <SPAN
CLASS="STRUCTNAME"
>GtkScrolledWindow</SPAN
> scrolling interface.
  </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN21532"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN21534"
></A
><H3
><A
NAME="GNOMEICONLIST-SELECT-ICON"
></A
>The &quot;select-icon&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *iconlist,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../gdk/gdk-event-structures.html#GDKEVENT
>GdkEvent</A> *event,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>    This signal is emitted when an icon becomes selected.  If the
    <SPAN
CLASS="SYMBOL"
>event</SPAN
> argument is NULL, then it means the icon
    became selected due to a range or rubberband selection.  If it is
    non-NULL, it means the icon became selected due to an
    user-initiated event such as a mouse button press.  The event can
    be examined to get this information.
  </P
><DIV
CLASS="IMPORTANT"
><BLOCKQUOTE
CLASS="IMPORTANT"
><P
><B
>Important: </B
>      You should not insert or delete icons, or otherwise change the
      selection in the icon list, from within a callback to this
      signal.
    </P
></BLOCKQUOTE
></DIV
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21546"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>iconlist</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Icon list which emitted the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Index of the icon that became selected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>event</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Event that triggered the selection, or NULL if none.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21567"
></A
><H3
><A
NAME="GNOMEICONLIST-UNSELECT-ICON"
></A
>The &quot;unselect-icon&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *iconlist,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../gdk/gdk-event-structures.html#GDKEVENT
>GdkEvent</A> *event,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>    This signal is emitted when an icon becomes unselected.  The
    meaning of the <SPAN
CLASS="SYMBOL"
>event</SPAN
> argument is the same as for
    the select-icon signal.
  </P
><DIV
CLASS="IMPORTANT"
><BLOCKQUOTE
CLASS="IMPORTANT"
><P
><B
>Important: </B
>      You should not insert or delete icons, or otherwise change the
      selection in the icon list, from within a callback to this
      signal.
    </P
></BLOCKQUOTE
></DIV
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21579"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>iconlist</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Icon list which emitted the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Index of the icon that became unselected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>event</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Event that triggered the unselection, or NULL if none.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21600"
></A
><H3
><A
NAME="GNOMEICONLIST-TEXT-CHANGED"
></A
>The &quot;text-changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function                  (<A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> *iconlist,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg2,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>    This signal is emitted when the user has finished editing the text
    of an icon's caption.  Typically this happens when the user
    presses <B
CLASS="KEYCAP"
>Enter</B
>.  The application must then decide
    whether the text is valid or not.
  </P
><P
>    The return value of this signal indicates whether the proposed
    text is accepted by the application.  For example, an application
    may need to check whether the user can rename a file to the
    proposed name or not.  If the proposed text is valid, then a
    signal handler should return <SPAN
CLASS="SYMBOL"
>TRUE</SPAN
>, otherwise it
    should return <SPAN
CLASS="SYMBOL"
>FALSE</SPAN
>.  If the change is not
    accepted, the text is automatically reset to its original state.
  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21614"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>iconlist</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Icon list which emitted the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Index of the icon whose text was edited.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Text entered by the user, which must be validated.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Whether the change is accepted by the application or not.&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeicontextitem.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeiconselection.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
>GnomeIconTextItem</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeIconSelection</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeIconSelection</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeIconList"
HREF="gnomeiconlist.html"><LINK
REL="NEXT"
TITLE="GnomeLess"
HREF="gnomeless.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeiconlist.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeless.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEICONSELECTION"
>GnomeIconSelection</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN21644"
></A
><H2
>Name</H2
>GnomeIconSelection&nbsp;--&nbsp;An icon listing/chooser display.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN21647"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeiconselection.html#GNOMEICONSELECTION-STRUCT"
>GnomeIconSelection</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-NEW"
>gnome_icon_selection_new</A
>        (void);
void        <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-ADD-DEFAULTS"
>gnome_icon_selection_add_defaults</A
>
                                            (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis);
void        <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-ADD-DIRECTORY"
>gnome_icon_selection_add_directory</A
>
                                            (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *dir);
void        <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-SHOW-ICONS"
>gnome_icon_selection_show_icons</A
> (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis);
void        <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-CLEAR"
>gnome_icon_selection_clear</A
>      (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> not_shown);
const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>* <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-GET-ICON"
>gnome_icon_selection_get_icon</A
>  (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> full_path);
void        <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-SELECT-ICON"
>gnome_icon_selection_select_icon</A
>
                                            (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *filename);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN21670"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbox.html
>GtkBox</A>
                     +----<A
HREF=../gtk/gtkvbox.html
>GtkVBox</A>
                           +----GnomeIconSelection</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN21678"
></A
><H2
>Description</H2
><P
>   This provides an icon chooser display.  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN21681"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN21683"
></A
><H3
><A
NAME="GNOMEICONSELECTION-STRUCT"
></A
>struct GnomeIconSelection</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeIconSelection;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21688"
></A
><H3
><A
NAME="GNOME-ICON-SELECTION-NEW"
></A
>gnome_icon_selection_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_icon_selection_new        (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a new icon selection widget, it uses GnomeIconList
for the listing of icons</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21695"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Returns the new object</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21704"
></A
><H3
><A
NAME="GNOME-ICON-SELECTION-ADD-DEFAULTS"
></A
>gnome_icon_selection_add_defaults ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_selection_add_defaults
                                            (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis);</PRE
></TD
></TR
></TABLE
><P
>Adds the default pixmap directory into the selection
widget. It doesn't show the icons in the selection until you
do <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-SHOW-ICONS"
>gnome_icon_selection_show_icons</A
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21712"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gis</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeIconSelection to work with</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21721"
></A
><H3
><A
NAME="GNOME-ICON-SELECTION-ADD-DIRECTORY"
></A
>gnome_icon_selection_add_directory ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_selection_add_directory
                                            (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *dir);</PRE
></TD
></TR
></TABLE
><P
>Adds the icons from the directory <TT
CLASS="PARAMETER"
><I
>dir</I
></TT
> to the
selection widget. It doesn't show the icons in the selection
until you do <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-SHOW-ICONS"
>gnome_icon_selection_show_icons</A
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21731"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gis</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeIconSelection to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dir</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> directory with pixmaps</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21744"
></A
><H3
><A
NAME="GNOME-ICON-SELECTION-SHOW-ICONS"
></A
>gnome_icon_selection_show_icons ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_selection_show_icons (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis);</PRE
></TD
></TR
></TABLE
><P
>Shows the icons inside the widget that
were added with <A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-ADD-DEFAULTS"
>gnome_icon_selection_add_defaults</A
> and
<A
HREF="gnomeiconselection.html#GNOME-ICON-SELECTION-ADD-DIRECTORY"
>gnome_icon_selection_add_directory</A
>. Before this function
is called the icons aren't actually added to the listing 
and can't be picked by the user.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21753"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gis</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeIconSelection to work with</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21762"
></A
><H3
><A
NAME="GNOME-ICON-SELECTION-CLEAR"
></A
>gnome_icon_selection_clear ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_selection_clear      (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> not_shown);</PRE
></TD
></TR
></TABLE
><P
>Clear the currently shown icons, the ones
that weren't shown yet are not cleared unless the not_shown
parameter is given, in which case even those are cleared.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21770"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gis</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeIconSelection to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>not_shown</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> boolean</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21783"
></A
><H3
><A
NAME="GNOME-ICON-SELECTION-GET-ICON"
></A
>gnome_icon_selection_get_icon ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>* gnome_icon_selection_get_icon  (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> full_path);</PRE
></TD
></TR
></TABLE
><P
>Gets the currently selected icon name, if
full_path is true, it returns the full path to the icon,
if none is selected it returns NULL</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21792"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gis</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeIconSelection to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>full_path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> boolean</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> internal string, it must not be changed or freed
or NULL</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21809"
></A
><H3
><A
NAME="GNOME-ICON-SELECTION-SELECT-ICON"
></A
>gnome_icon_selection_select_icon ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_selection_select_icon
                                            (<A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> *gis,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *filename);</PRE
></TD
></TR
></TABLE
><P
>Selects the icon <TT
CLASS="PARAMETER"
><I
>filename</I
></TT
>. This icon must have
already been added and shown * (see <TT
CLASS="PARAMETER"
><I
>gnome_icon_selection_show_icons</I
></TT
>)</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21819"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gis</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeIconSelection to work with</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>filename</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> icon filename</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN21832"
></A
><H2
>See Also</H2
><P
><A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
> widget; </P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeiconlist.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeless.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
>GnomeIconList</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeLess</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeIconTextItem</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeIconEntry"
HREF="gnomeiconentry.html"><LINK
REL="NEXT"
TITLE="GnomeIconList"
HREF="gnomeiconlist.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeiconentry.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeiconlist.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEICONTEXTITEM"
>GnomeIconTextItem</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN20194"
></A
><H2
>Name</H2
>GnomeIconTextItem&nbsp;--&nbsp;Canvas item for editable text captions in icon lists.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN20197"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


typedef     <A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
>;
void        <A
HREF="gnomeicontextitem.html#GNOME-ICON-TEXT-ITEM-CONFIGURE"
>gnome_icon_text_item_configure</A
>  (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *iti,
                                             int x,
                                             int y,
                                             int width,
                                             const char *fontname,
                                             const char *text,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> is_editable,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> is_static);
void        <A
HREF="gnomeicontextitem.html#GNOME-ICON-TEXT-ITEM-SETXY"
>gnome_icon_text_item_setxy</A
>      (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *iti,
                                             int x,
                                             int y);
void        <A
HREF="gnomeicontextitem.html#GNOME-ICON-TEXT-ITEM-SELECT"
>gnome_icon_text_item_select</A
>     (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *iti,
                                             int sel);
char*       <A
HREF="gnomeicontextitem.html#GNOME-ICON-TEXT-ITEM-GET-TEXT"
>gnome_icon_text_item_get_text</A
>   (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *iti);
void        <A
HREF="gnomeicontextitem.html#GNOME-ICON-TEXT-ITEM-STOP-EDITING"
>gnome_icon_text_item_stop_editing</A
>
                                            (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *iti,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> accept);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20214"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
>
         +----GnomeIconTextItem</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20219"
></A
><H2
>Args</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  &quot;<A
HREF="gnomeicontextitem.html#GNOMEICONTEXTITEM--USE-BROKEN-EVENT-HANDLING"
>use-broken-event-handling</A
>&quot; <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>             : Write</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20224"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomeicontextitem.html#GNOMEICONTEXTITEM-TEXT-CHANGED"
>text-changed</A
>&quot;
            <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function      (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *icontextitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomeicontextitem.html#GNOMEICONTEXTITEM-HEIGHT-CHANGED"
>height-changed</A
>&quot;
            void        user_function      (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *icontextitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomeicontextitem.html#GNOMEICONTEXTITEM-WIDTH-CHANGED"
>width-changed</A
>&quot;
            void        user_function      (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *icontextitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomeicontextitem.html#GNOMEICONTEXTITEM-EDITING-STARTED"
>editing-started</A
>&quot;
            void        user_function      (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *icontextitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomeicontextitem.html#GNOMEICONTEXTITEM-EDITING-STOPPED"
>editing-stopped</A
>&quot;
            void        user_function      (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *icontextitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomeicontextitem.html#GNOMEICONTEXTITEM-SELECTION-STARTED"
>selection-started</A
>&quot;
            void        user_function      (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *icontextitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomeicontextitem.html#GNOMEICONTEXTITEM-SELECTION-STOPPED"
>selection-stopped</A
>&quot;
            void        user_function      (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *icontextitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20249"
></A
><H2
>Description</H2
><P
>    The <SPAN
CLASS="STRUCTNAME"
>GnomeIconTextItem</SPAN
> canvas item
    provides a specialized, editable text item to be used for the text
    captions of icons.  This item is used by the
    <SPAN
CLASS="STRUCTNAME"
>GnomeIconList</SPAN
> widget and by the GNOME
    file manager.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20254"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN20256"
></A
><H3
><A
NAME="GNOMEICONTEXTITEM"
></A
>GnomeIconTextItem</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct {
	GnomeCanvasItem canvas_item;

	/* Size and maximum allowed width */
	int x, y;
	int width;

	/* Font name */
	char *fontname;

	/* Private data */
	gpointer priv; /* was GtkEntry *entry */
	gpointer pad1; /* was GtkWidget *entry_top */
	gpointer pad2; /* was GdkFont *font */

	/* Actual text */
	char *text;

	/* Text layout information */
	GnomeIconTextInfo *ti;

	/* Whether the text is being edited */
	unsigned int editing : 1;

	/* Whether the text item is selected */
	unsigned int selected : 1;

	unsigned int pad3; /* was unsigned int unselected_click : 1 */

	/* Whether the user is select-dragging a block of text */
	unsigned int selecting : 1;

	/* Whether the text is editable */
	unsigned int is_editable : 1;

	/* Whether the text is allocated by us (FALSE if allocated by the client) */
	unsigned int is_text_allocated : 1;
} GnomeIconTextItem;</PRE
></TD
></TR
></TABLE
><P
>    All the fields in the <SPAN
CLASS="STRUCTNAME"
>GnomeIconTextItem</SPAN
>
    structure should be considered private.  When the application
    needs to know the size and bounds of an icon text item, it should
    use the <TT
CLASS="FUNCTION"
><A
HREF="gnomecanvasitem.html#GNOME-CANVAS-ITEM-GET-BOUNDS"
>gnome_canvas_item_get_bounds</A
>()</TT
>
    function.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20264"
></A
><H3
><A
NAME="GNOME-ICON-TEXT-ITEM-CONFIGURE"
></A
>gnome_icon_text_item_configure ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_text_item_configure  (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *iti,
                                             int x,
                                             int y,
                                             int width,
                                             const char *fontname,
                                             const char *text,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> is_editable,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> is_static);</PRE
></TD
></TR
></TABLE
><P
>This routine is used to configure a &amp;GnomeIconTextItem.</P
><P
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>y</I
></TT
> specify the cordinates where the item is placed inside the canvas.
The <TT
CLASS="PARAMETER"
><I
>x</I
></TT
> coordinate should be the leftmost position that the icon text item can
assume at any one time, that is, the left margin of the column in which the
icon is to be placed.  The <TT
CLASS="PARAMETER"
><I
>y</I
></TT
> coordinate specifies the top of the icon text
item.</P
><P
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
> is the maximum width allowed for this icon text item.  The coordinates
define the upper-left corner of an icon text item with maximum width; this may
actually be outside the bounding box of the item if the text is narrower than
the maximum width.</P
><P
>If <TT
CLASS="PARAMETER"
><I
>is_static</I
></TT
> is true, it means that there is no need for the item to
allocate memory for the string (it is a guarantee that the text is allocated
by the caller and it will not be deallocated during the lifetime of this
item).  This is an optimization to reduce memory usage for large icon sets.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20282"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>iti</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon text item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X position in which to place the item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y position in which to place the item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Maximum width allowed for this item, to be used for word wrapping.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fontname</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of the fontset that should be used to display the text.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text that is going to be displayed.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>is_editable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Deprecated.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>is_static</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Whether <TT
CLASS="PARAMETER"
><I
>text</I
></TT
> points to a static string or not.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20320"
></A
><H3
><A
NAME="GNOME-ICON-TEXT-ITEM-SETXY"
></A
>gnome_icon_text_item_setxy ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_text_item_setxy      (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *iti,
                                             int x,
                                             int y);</PRE
></TD
></TR
></TABLE
><P
>Sets the coordinates at which the icon text item should be placed.</P
><P
>See also: <A
HREF="gnomeicontextitem.html#GNOME-ICON-TEXT-ITEM-CONFIGURE"
>gnome_icon_text_item_configure</A
>().</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20329"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>iti</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  An icon text item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X position.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y position.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20346"
></A
><H3
><A
NAME="GNOME-ICON-TEXT-ITEM-SELECT"
></A
>gnome_icon_text_item_select ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_text_item_select     (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *iti,
                                             int sel);</PRE
></TD
></TR
></TABLE
><P
>This function is used to control whether an icon text item is displayed as
selected or not.  Mouse events are ignored by the item when it is unselected;
when the user clicks on a selected icon text item, it will start the text
editing process.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20353"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>iti</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon text item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>sel</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Whether the icon text item should be displayed as selected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20366"
></A
><H3
><A
NAME="GNOME-ICON-TEXT-ITEM-GET-TEXT"
></A
>gnome_icon_text_item_get_text ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>char*       gnome_icon_text_item_get_text   (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *iti);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20373"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>iti</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon text item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the current text string in an icon text item.  The client should not
free this string, as it is internal to the icon text item.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20386"
></A
><H3
><A
NAME="GNOME-ICON-TEXT-ITEM-STOP-EDITING"
></A
>gnome_icon_text_item_stop_editing ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_text_item_stop_editing
                                            (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *iti,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> accept);</PRE
></TD
></TR
></TABLE
><P
>Terminates the editing state of an icon text item.  The <TT
CLASS="PARAMETER"
><I
>accept</I
></TT
> argument
controls whether the item's current text should be accepted or discarded.  If
it is discarded, then the icon's original text will be restored.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20395"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>iti</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon text item.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>accept</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Whether to accept the current text or to discard it.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20408"
></A
><H2
>Args</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
NAME="GNOMEICONTEXTITEM--USE-BROKEN-EVENT-HANDLING"
></A
>&quot;<TT
CLASS="LITERAL"
>use-broken-event-handling</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> : Write)</DT
><DD
><P
></P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20418"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN20420"
></A
><H3
><A
NAME="GNOMEICONTEXTITEM-TEXT-CHANGED"
></A
>The &quot;text-changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function                  (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *icontextitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>    This signal is emitted when the user has finished editing the text
    in an icon text item.  Typically this happens when the user
    presses <B
CLASS="KEYCAP"
>Enter</B
>.  The application has to decide
    whether the entered text is valid or not; for example, a file
    manager may want to test whether it is legal to rename a file to
    the proposed name or not.
  </P
><P
>    Upon receiving this signal, the application should use
    <TT
CLASS="FUNCTION"
><A
HREF="gnomeicontextitem.html#GNOME-ICON-TEXT-ITEM-GET-TEXT"
>gnome_icon_text_item_get_text</A
>()</TT
> to get the
    text for validation.  The return value of this signal indicates
    whether the proposed text is accepted by the application.  If the
    proposed text is valid, then a signal handler should return
    <SPAN
CLASS="SYMBOL"
>TRUE</SPAN
>, otherwise it should return
    <SPAN
CLASS="SYMBOL"
>FALSE</SPAN
>.  If the change is not accepted, the text
    is automatically reset to its original state.
  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20434"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icontextitem</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Icon text item which emitted the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if the change is accepted, <TT
CLASS="LITERAL"
>FALSE</TT
> otherwise.&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20453"
></A
><H3
><A
NAME="GNOMEICONTEXTITEM-HEIGHT-CHANGED"
></A
>The &quot;height-changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *icontextitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>    This signal is emitted when the height of an icon text item
    changes, usually due to the user changing the text or the
    application selecting a different font.  Applications can change
    their layout accordingly.
  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20460"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icontextitem</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Icon text item which emitted the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20473"
></A
><H3
><A
NAME="GNOMEICONTEXTITEM-WIDTH-CHANGED"
></A
>The &quot;width-changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *icontextitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>    This signal is emitted when the width of an icon text item
    changes, usually due to the user changing the text or the
    application selecting a different font.  Applications can change
    their layout accordingly.
  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20480"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icontextitem</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Icon text item which emitted the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20493"
></A
><H3
><A
NAME="GNOMEICONTEXTITEM-EDITING-STARTED"
></A
>The &quot;editing-started&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *icontextitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>    This signal is emitted when the user begins editing the text in an
    icon text item, usually by clicking on it while it is selected.
    Applications can use this information to disable drag and drop
    signals and update their state accordingly.
  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20500"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icontextitem</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Icon text item which emitted the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20513"
></A
><H3
><A
NAME="GNOMEICONTEXTITEM-EDITING-STOPPED"
></A
>The &quot;editing-stopped&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *icontextitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>    This signal is emitted when the user terminates editing the text
    in an icon text item, usually by pressing <B
CLASS="KEYCAP"
>Enter</B
>
    or <B
CLASS="KEYCAP"
>Esc</B
>.  Applications can use this information to
    enable drag and drop signals and update their state accordingly.
  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20522"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icontextitem</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Icon text item which emitted the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20535"
></A
><H3
><A
NAME="GNOMEICONTEXTITEM-SELECTION-STARTED"
></A
>The &quot;selection-started&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *icontextitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>    This signal is emitted when the user begins a rubberband selection
    of text with the mouse in an icon text item.  Applications can use
    this information to disable drag and drop signals and update their
    state accordingly.
  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20542"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icontextitem</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Icon text item which emitted the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20555"
></A
><H3
><A
NAME="GNOMEICONTEXTITEM-SELECTION-STOPPED"
></A
>The &quot;selection-stopped&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> *icontextitem,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>    This signal is emitted when the user terminates a rubberband
    selection of text with the mouse in an icon text item.
    Applications can use this information to disable drag and drop
    signals and update their state accordingly.
  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN20562"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icontextitem</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Icon text item which emitted the signal.
&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20575"
></A
><H2
>See Also</H2
><P
>    <A
HREF="gnomeiconlist.html"
>GnomeIconList</A
>, <A
HREF="gnomecanvas.html"
>GnomeCanvas</A
>. <A
HREF="gnomeui-gnome-icon-text.html#GNOMEICONTEXTINFO"
>GnomeIconTextInfo</A
>.
  </P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeiconentry.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeiconlist.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
>GnomeIconEntry</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeIconList</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeLess</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeIconSelection"
HREF="gnomeiconselection.html"><LINK
REL="NEXT"
TITLE="GnomeMDIChild"
HREF="gnomemdichild.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeiconselection.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomemdichild.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMELESS"
>GnomeLess</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN21841"
></A
><H2
>Name</H2
>GnomeLess&nbsp;--&nbsp;Simple file content browser widget.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN21844"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeless.html#GNOMELESS-STRUCT"
>GnomeLess</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeless.html#GNOME-LESS-NEW"
>gnome_less_new</A
>                  (void);
void        <A
HREF="gnomeless.html#GNOME-LESS-CLEAR"
>gnome_less_clear</A
>                (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeless.html#GNOME-LESS-SHOW-FILE"
>gnome_less_show_file</A
>            (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeless.html#GNOME-LESS-SHOW-COMMAND"
>gnome_less_show_command</A
>         (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *command_line);
void        <A
HREF="gnomeless.html#GNOME-LESS-SHOW-STRING"
>gnome_less_show_string</A
>          (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *s);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeless.html#GNOME-LESS-SHOW-FILESTREAM"
>gnome_less_show_filestream</A
>      (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             FILE *f);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeless.html#GNOME-LESS-SHOW-FD"
>gnome_less_show_fd</A
>              (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             int file_descriptor);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeless.html#GNOME-LESS-WRITE-FILE"
>gnome_less_write_file</A
>           (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeless.html#GNOME-LESS-WRITE-FD"
>gnome_less_write_fd</A
>             (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             int fd);
void        <A
HREF="gnomeless.html#GNOME-LESS-SET-FONT"
>gnome_less_set_font</A
>             (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             <A
HREF=../gdk/gdk-fonts.html#GDKFONT
>GdkFont</A> *font);
void        <A
HREF="gnomeless.html#GNOME-LESS-SET-FIXED-FONT"
>gnome_less_set_fixed_font</A
>       (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> fixed);
void        <A
HREF="gnomeless.html#GNOME-LESS-RESHOW"
>gnome_less_reshow</A
>               (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl);
void        <A
HREF="gnomeless.html#GNOME-LESS-FIXED-FONT"
>gnome_less_fixed_font</A
>           (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN21887"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbox.html
>GtkBox</A>
                     +----<A
HREF=../gtk/gtkvbox.html
>GtkVBox</A>
                           +----GnomeLess</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN21895"
></A
><H2
>Description</H2
><P
>    This widget implements a graphical "more" command.  It allows the
    user to view a text file.  There are various possible ways to
    specify the contents to display: loading the data from a file (by
    providing a filename) or by loading it from an open C FILE data
    stream or from the output of a Unix command or from a Unix file
    descriptor. 
  </P
><P
>    The following is a simple example of its use. The code creates a
    GnomeLess widget, sets a custom font, and fills the widget with
    the contents of a file.
  </P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN21899"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>GtkWidget *gl;
GdkFont *font;

/* create a new widget */
gl = <A
HREF="gnomeless.html#GNOME-LESS-NEW"
>gnome_less_new</A
>();

/* set our custom font */
font = gdk_font_load("-adobe-helvetica-bold-o-normal-*-*-140-*-*-p-*-iso8859-1");
<A
HREF="gnomeless.html#GNOME-LESS-SET-FONT"
>gnome_less_set_font</A
>(GNOME_LESS(gl), font);

/* display some text */
<A
HREF="gnomeless.html#GNOME-LESS-SHOW-FILE"
>gnome_less_show_file</A
>(GNOME_LESS(gl), "/home/user/file.txt");
  </PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN21904"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN21906"
></A
><H3
><A
NAME="GNOMELESS-STRUCT"
></A
>struct GnomeLess</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeLess;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21911"
></A
><H3
><A
NAME="GNOME-LESS-NEW"
></A
>gnome_less_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_less_new                  (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a new GnomeLess widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21918"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&amp;GtkWidget pointer to a new GNOME less widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21927"
></A
><H3
><A
NAME="GNOME-LESS-CLEAR"
></A
>gnome_less_clear ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_less_clear                (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl);</PRE
></TD
></TR
></TABLE
><P
>Clears all text from GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21935"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21944"
></A
><H3
><A
NAME="GNOME-LESS-SHOW-FILE"
></A
>gnome_less_show_file ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_less_show_file            (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path);</PRE
></TD
></TR
></TABLE
><P
>Displays a file in a GnomeLess widget. Replaces any text already being displayed
in the widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21953"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pathname of file to be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if not. Error stored in <TT
CLASS="LITERAL"
>errno</TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN21973"
></A
><H3
><A
NAME="GNOME-LESS-SHOW-COMMAND"
></A
>gnome_less_show_command ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_less_show_command         (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *command_line);</PRE
></TD
></TR
></TABLE
><P
>Runs the shell command specified in <TT
CLASS="PARAMETER"
><I
>command_line</I
></TT
>, and places the output of that command
in the GnomeLess widget specified by <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>. Replaces any text already being displayed in the
widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN21984"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>command_line</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Command to be executed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if not. Error stored in <TT
CLASS="LITERAL"
>errno</TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22004"
></A
><H3
><A
NAME="GNOME-LESS-SHOW-STRING"
></A
>gnome_less_show_string ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_less_show_string          (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *s);</PRE
></TD
></TR
></TABLE
><P
>Displays a string in the GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>. Replaces any text
already being displayed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22013"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>s</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> String to be displayed</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22026"
></A
><H3
><A
NAME="GNOME-LESS-SHOW-FILESTREAM"
></A
>gnome_less_show_filestream ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_less_show_filestream      (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             FILE *f);</PRE
></TD
></TR
></TABLE
><P
>Reads all of the text from filestream <TT
CLASS="PARAMETER"
><I
>f</I
></TT
>, and places it in the GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>. Replaces any text
already being displayed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22037"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>f</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Filestream to be displayed in the widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if not. Error stored in <TT
CLASS="LITERAL"
>errno</TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22057"
></A
><H3
><A
NAME="GNOME-LESS-SHOW-FD"
></A
>gnome_less_show_fd ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_less_show_fd              (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             int file_descriptor);</PRE
></TD
></TR
></TABLE
><P
>Reads all of the text from file descriptor <TT
CLASS="PARAMETER"
><I
>file_descriptor</I
></TT
>, and places it in the GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>.
Replaces any text already being displayed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22067"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>file_descriptor</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Filestream to be displayed in the widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if not. Error stored in <TT
CLASS="LITERAL"
>errno</TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22087"
></A
><H3
><A
NAME="GNOME-LESS-WRITE-FILE"
></A
>gnome_less_write_file ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_less_write_file           (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path);</PRE
></TD
></TR
></TABLE
><P
>Writes the text displayed in the GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
> to the file specified by <TT
CLASS="PARAMETER"
><I
>path</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22098"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Path of file to be written</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if not. Error stored in <TT
CLASS="LITERAL"
>errno</TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22118"
></A
><H3
><A
NAME="GNOME-LESS-WRITE-FD"
></A
>gnome_less_write_fd ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_less_write_fd             (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             int fd);</PRE
></TD
></TR
></TABLE
><P
>Writes the text displayed in the GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
> to file descriptor <TT
CLASS="PARAMETER"
><I
>fd</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22128"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fd</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> File descriptor</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if not. Error stored in <TT
CLASS="LITERAL"
>errno</TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22148"
></A
><H3
><A
NAME="GNOME-LESS-SET-FONT"
></A
>gnome_less_set_font ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_less_set_font             (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             <A
HREF=../gdk/gdk-fonts.html#GDKFONT
>GdkFont</A> *font);</PRE
></TD
></TR
></TABLE
><P
>Sets the font of the text to be displayed in the GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
> to <TT
CLASS="PARAMETER"
><I
>font</I
></TT
>.</P
><P
>Note: This will not affect text already being displayed.
If you use this function after adding text to the widget, you must show it again
by using <A
HREF="gnomeless.html#GNOME-LESS-RESHOW"
>gnome_less_reshow</A
> or one of the gnome_less_show commands.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22160"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>font</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GdkFont</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22173"
></A
><H3
><A
NAME="GNOME-LESS-SET-FIXED-FONT"
></A
>gnome_less_set_fixed_font ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_less_set_fixed_font       (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> fixed);</PRE
></TD
></TR
></TABLE
><P
>Specifies whether or not new text should be displayed using a fixed font. Pass TRUE
in <TT
CLASS="PARAMETER"
><I
>fixed</I
></TT
> to use a fixed font, or FALSE to revert to the default GtkText font.</P
><P
>Note: This will not affect text already being displayed.
If you use this function after adding text to the widget, you must show it again
by using <A
HREF="gnomeless.html#GNOME-LESS-RESHOW"
>gnome_less_reshow</A
> or one of the gnome_less_show commands.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22184"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME Less widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fixed</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Whether or not to use a fixed font</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22197"
></A
><H3
><A
NAME="GNOME-LESS-RESHOW"
></A
>gnome_less_reshow ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_less_reshow               (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl);</PRE
></TD
></TR
></TABLE
><P
>Re-displays all of the text in the GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>. If the font has changed since
the last show/reshow of text, it will update the current text to the new font.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22205"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22214"
></A
><H3
><A
NAME="GNOME-LESS-FIXED-FONT"
></A
>gnome_less_fixed_font ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_less_fixed_font           (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl);</PRE
></TD
></TR
></TABLE
><P
>This function is obsolete. Please use <A
HREF="gnomeless.html#GNOME-LESS-SET-FIXED-FONT"
>gnome_less_set_fixed_font</A
> instead.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22222"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeiconselection.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomemdichild.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
>GnomeIconSelection</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeMDIChild</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeMDIChild</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeLess"
HREF="gnomeless.html"><LINK
REL="NEXT"
TITLE="GnomeMDIGenericChild"
HREF="gnomemdigenericchild.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeless.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomemdigenericchild.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEMDICHILD"
>GnomeMDIChild</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN22236"
></A
><H2
>Name</H2
>GnomeMDIChild&nbsp;--&nbsp;An abstract MDI child class</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN22239"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomemdichild.html#GNOMEMDICHILD-STRUCT"
>GnomeMDIChild</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  (<A
HREF="gnomemdichild.html#GNOMEMDICHILDVIEWCREATOR"
>*GnomeMDIChildViewCreator</A
>)     (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>*,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A>);
<A
HREF=../glib/glib-doubly-linked-lists.html#GLIST
>GList</A>*      (<A
HREF="gnomemdichild.html#GNOMEMDICHILDMENUCREATOR"
>*GnomeMDIChildMenuCreator</A
>)     (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>*,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A>);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      (<A
HREF="gnomemdichild.html#GNOMEMDICHILDCONFIGFUNC"
>*GnomeMDIChildConfigFunc</A
>)      (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>*,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A>);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  (<A
HREF="gnomemdichild.html#GNOMEMDICHILDLABELFUNC"
>*GnomeMDIChildLabelFunc</A
>)       (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>*,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A>);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomemdichild.html#GNOME-MDI-CHILD-ADD-VIEW"
>gnome_mdi_child_add_view</A
>        (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *mdi_child);
void        <A
HREF="gnomemdichild.html#GNOME-MDI-CHILD-REMOVE-VIEW"
>gnome_mdi_child_remove_view</A
>     (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *mdi_child,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *view);
void        <A
HREF="gnomemdichild.html#GNOME-MDI-CHILD-SET-NAME"
>gnome_mdi_child_set_name</A
>        (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *mdi_child,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);
void        <A
HREF="gnomemdichild.html#GNOME-MDI-CHILD-SET-MENU-TEMPLATE"
>gnome_mdi_child_set_menu_template</A
>
                                            (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *mdi_child,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *menu_tmpl);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN22273"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----GnomeMDIChild</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN22277"
></A
><H2
>Description</H2
><P
>    <SPAN
CLASS="TYPE"
>GnomeMDIChild</SPAN
> is an abstract class for <SPAN
CLASS="TYPE"
>GnomeMDI</SPAN
>
    children. In order to use it, you have to either derive a new class from it
    and define the proper virtual functions in its parent
    <SPAN
CLASS="TYPE"
>GnomeMDIChildClass</SPAN
> structure or use the
    <SPAN
CLASS="TYPE"
>GnomeMDIGenericChild</SPAN
> class that allows to specify the relevant
    functions on a per-instance rather than on per-class basis.
  </P
><P
>    Each instance of GnomeMDIChild class defines a name for the child and possibly
    a menu template for document-specific menus that will be merged with the global
    MDI menus. The menu template is set using the <A
HREF="gnomemdichild.html#GNOME-MDI-CHILD-SET-MENU-TEMPLATE"
>gnome_mdi_child_set_menu_template</A
>()
    function.
  </P
><P
>    The <SPAN
CLASS="TYPE"
>GnomeMDIChild</SPAN
> class has four virtual functions that are used by
    the MDI:
    <P
></P
><UL
><LI
><P
>	  create_view must be defined for each subclass and must return a pointer to a
	  GtkWidget representing a new view of the document.
	</P
></LI
><LI
><P
>	  create_menus must return a GList of menu items and can be used instead of the
	  child's menu template. If both template and this function are defined, only the
	  template (which can be defined on a per-instance basis) is used.
	</P
></LI
><LI
><P
>	  get_config_string must return a string that represents the state of the child
	  and will be used to save and restore state of the MDI children bewtween sessions.
	</P
></LI
><LI
><P
>	  set_label must return a pointer to a GtkWidget that will be used as notebook and
	  menu item label for this child.
	</P
></LI
></UL
>
    create_view function must be defined for each subclass and the <SPAN
CLASS="TYPE"
>GnomeMDIChild</SPAN
>
    class provides a simple default implementation of set_label; create_menus and get_config_string
    may be undefined.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN22298"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN22300"
></A
><H3
><A
NAME="GNOMEMDICHILD-STRUCT"
></A
>struct GnomeMDIChild</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeMDIChild;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22305"
></A
><H3
><A
NAME="GNOMEMDICHILDVIEWCREATOR"
></A
>GnomeMDIChildViewCreator ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  (*GnomeMDIChildViewCreator)     (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>*,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A>);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22313"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>Param1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>Param2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22330"
></A
><H3
><A
NAME="GNOMEMDICHILDMENUCREATOR"
></A
>GnomeMDIChildMenuCreator ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-doubly-linked-lists.html#GLIST
>GList</A>*      (*GnomeMDIChildMenuCreator)     (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>*,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A>);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22339"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>Param1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>Param2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>Param3</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22360"
></A
><H3
><A
NAME="GNOMEMDICHILDCONFIGFUNC"
></A
>GnomeMDIChildConfigFunc ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      (*GnomeMDIChildConfigFunc)      (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>*,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A>);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22368"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>Param1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>Param2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22385"
></A
><H3
><A
NAME="GNOMEMDICHILDLABELFUNC"
></A
>GnomeMDIChildLabelFunc ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  (*GnomeMDIChildLabelFunc)       (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>*,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A>);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22394"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>Param1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>Param2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>Param3</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22415"
></A
><H3
><A
NAME="GNOME-MDI-CHILD-ADD-VIEW"
></A
>gnome_mdi_child_add_view ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_mdi_child_add_view        (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *mdi_child);</PRE
></TD
></TR
></TABLE
><P
>Creates a new view of a child (a GtkWidget) adds it to the list
of the views and returns a pointer to it. Virtual function
that has to be specified for classes derived from GnomeMDIChild
is used to create the new view.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22423"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi_child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDIChild object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to the new view.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22436"
></A
><H3
><A
NAME="GNOME-MDI-CHILD-REMOVE-VIEW"
></A
>gnome_mdi_child_remove_view ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_child_remove_view     (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *mdi_child,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *view);</PRE
></TD
></TR
></TABLE
><P
>Removes view <TT
CLASS="PARAMETER"
><I
>view</I
></TT
> from the list of <TT
CLASS="PARAMETER"
><I
>mdi_child</I
></TT
>'s views and
unrefs it.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22446"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi_child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDIChild object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>view</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> View to be removed.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22459"
></A
><H3
><A
NAME="GNOME-MDI-CHILD-SET-NAME"
></A
>gnome_mdi_child_set_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_child_set_name        (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *mdi_child,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);</PRE
></TD
></TR
></TABLE
><P
>Changes name of <TT
CLASS="PARAMETER"
><I
>mdi_child</I
></TT
> to <TT
CLASS="PARAMETER"
><I
>name</I
></TT
>. <TT
CLASS="PARAMETER"
><I
>name</I
></TT
> is duplicated and stored
in <TT
CLASS="PARAMETER"
><I
>mdi_child</I
></TT
>. If <TT
CLASS="PARAMETER"
><I
>mdi_child</I
></TT
> has already been added to GnomeMDI,
it also takes care of updating it.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22472"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi_child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDIChild object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> String containing the new name for the child.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22485"
></A
><H3
><A
NAME="GNOME-MDI-CHILD-SET-MENU-TEMPLATE"
></A
>gnome_mdi_child_set_menu_template ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_child_set_menu_template
                                            (<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *mdi_child,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *menu_tmpl);</PRE
></TD
></TR
></TABLE
><P
>Sets the template for menus that are added and removed when differrent
children get activated. This way, each child can modify the MDI menubar
to suit its needs. If no template is set, the create_menus virtual
function will be used for creating these menus (it has to return a
GList of menu items). If no such function is specified, the menubar will
be unchanged by MDI children.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22493"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi_child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDIChild object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>menu_tmpl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeUIInfo array describing the child specific menus.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeless.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomemdigenericchild.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
>GnomeLess</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeMDIGenericChild</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeMDIGenericChild</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeMDIChild"
HREF="gnomemdichild.html"><LINK
REL="NEXT"
TITLE="GnomeMDI"
HREF="gnomemdi.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomemdichild.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomemdi.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEMDIGENERICCHILD"
>GnomeMDIGenericChild</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN22511"
></A
><H2
>Name</H2
>GnomeMDIGenericChild&nbsp;--&nbsp;A generic <SPAN
CLASS="TYPE"
>GnomeMDI</SPAN
> child</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN22515"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomemdigenericchild.html#GNOMEMDIGENERICCHILD-STRUCT"
>GnomeMDIGenericChild</A
>;
<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
>* <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-NEW"
>gnome_mdi_generic_child_new</A
>
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-VIEW-CREATOR"
>gnome_mdi_generic_child_set_view_creator</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDVIEWCREATOR"
>GnomeMDIChildViewCreator</A
> func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-VIEW-CREATOR-FULL"
>gnome_mdi_generic_child_set_view_creator_full</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDVIEWCREATOR"
>GnomeMDIChildViewCreator</A
> func,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> marshal,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> notify);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-MENU-CREATOR"
>gnome_mdi_generic_child_set_menu_creator</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDMENUCREATOR"
>GnomeMDIChildMenuCreator</A
> func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-MENU-CREATOR-FULL"
>gnome_mdi_generic_child_set_menu_creator_full</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDMENUCREATOR"
>GnomeMDIChildMenuCreator</A
> func,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> marshal,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> notify);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-CONFIG-FUNC"
>gnome_mdi_generic_child_set_config_func</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDCONFIGFUNC"
>GnomeMDIChildConfigFunc</A
> func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-CONFIG-FUNC-FULL"
>gnome_mdi_generic_child_set_config_func_full</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDCONFIGFUNC"
>GnomeMDIChildConfigFunc</A
> func,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> marshal,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> notify);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-LABEL-FUNC"
>gnome_mdi_generic_child_set_label_func</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDLABELFUNC"
>GnomeMDIChildLabelFunc</A
> func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-LABEL-FUNC-FULL"
>gnome_mdi_generic_child_set_label_func_full</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDLABELFUNC"
>GnomeMDIChildLabelFunc</A
> func,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> marshal,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> notify);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN22562"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>
         +----GnomeMDIGenericChild</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN22567"
></A
><H2
>Description</H2
><P
>    <SPAN
CLASS="TYPE"
>GnomeMDIGenericChild</SPAN
> is a subclass of <SPAN
CLASS="TYPE"
>GnomeMDIChild</SPAN
>
    that allows for defining of GnomeMDIChild's virtual functions on a per-instance
    rather than on per-class basis. Thus the programmer does not have to subclass
    <SPAN
CLASS="TYPE"
>GnomeMDIChild</SPAN
> but can use <SPAN
CLASS="TYPE"
>GnomeMDIGenericChild</SPAN
> class
    directly.
  </P
><P
>    Only the view creating function is mandatory. It has to be set with
    <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-VIEW-CREATOR"
>gnome_mdi_generic_child_set_view_creator</A
>() or
    <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-VIEW-CREATOR-FULL"
>gnome_mdi_generic_child_set_view_creator_full</A
>(). A simple default implementation
    of notebook label creation is provided by <SPAN
CLASS="TYPE"
>GnomeMDIChild</SPAN
> class. The
    other two functions are optional.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN22578"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN22580"
></A
><H3
><A
NAME="GNOMEMDIGENERICCHILD-STRUCT"
></A
>struct GnomeMDIGenericChild</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeMDIGenericChild;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22585"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-NEW"
></A
>gnome_mdi_generic_child_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
>* gnome_mdi_generic_child_new
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);</PRE
></TD
></TR
></TABLE
><P
>Creates a new mdi child, which has the ability to set view creators, etc
on an instance basis (rather than on a class basis like &amp;GnomeMDIChild).</P
><P
>After creation, you will need to set, at a minimum, the view creator
function.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22594"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the name of this MDI child.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A newly created &amp;GnomeMDIGenericChild object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22607"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-VIEW-CREATOR"
></A
>gnome_mdi_generic_child_set_view_creator ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_view_creator
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDVIEWCREATOR"
>GnomeMDIChildViewCreator</A
> func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>This function sets the function that is used to create new views for this
particular mdi child object.  The function should return a newly created
widget (the view).</P
><P
>A &amp;GnomeMDIGenericChild must have a view creator.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22617"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function used to create views</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22634"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-VIEW-CREATOR-FULL"
></A
>gnome_mdi_generic_child_set_view_creator_full ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_view_creator_full
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDVIEWCREATOR"
>GnomeMDIChildViewCreator</A
> func,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> marshal,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> notify);</PRE
></TD
></TR
></TABLE
><P
>Similar to <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-VIEW-CREATOR"
>gnome_mdi_generic_child_set_view_creator</A
>(), except that it gives
more control to the programmer.  If <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> is not <TT
CLASS="LITERAL"
>NULL</TT
>, then it will
be called instead of <TT
CLASS="PARAMETER"
><I
>func</I
></TT
>.</P
><P
>The &amp;GtkArg array passed to <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> will be of length 2.  The first
element will be <TT
CLASS="PARAMETER"
><I
>child</I
></TT
>, and the second is the return value (a pointer to
a &amp;GtkWidget).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22652"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function to create views (not used if <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> != <TT
CLASS="LITERAL"
>NULL</TT
>)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a callback marshaller</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>notify</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function used to free the user data.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22679"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-MENU-CREATOR"
></A
>gnome_mdi_generic_child_set_menu_creator ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_menu_creator
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDMENUCREATOR"
>GnomeMDIChildMenuCreator</A
> func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Sets the function used to create child specific menus.  The function
should return a &amp;GList of the menus created.</P
><P
>A &amp;GnomeMDIGenericChild doesn't require a menu creator.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22689"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function to create a list of child specific menus</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22706"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-MENU-CREATOR-FULL"
></A
>gnome_mdi_generic_child_set_menu_creator_full ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_menu_creator_full
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDMENUCREATOR"
>GnomeMDIChildMenuCreator</A
> func,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> marshal,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> notify);</PRE
></TD
></TR
></TABLE
><P
>This function is similar to <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-MENU-CREATOR"
>gnome_mdi_generic_child_set_menu_creator</A
>(),
but gives extra flexibility to the programmer, in the form of a a
destroy notify for the user data, and a callback marshaller.</P
><P
>The &amp;GtkArg array passed to <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> is of length 3.  The first element
will be <TT
CLASS="PARAMETER"
><I
>child</I
></TT
>, the second will be a view of <TT
CLASS="PARAMETER"
><I
>child</I
></TT
>, and the third is the
return value (a pointer to the returned GList).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22722"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a menu creator function (not used if <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> != <TT
CLASS="LITERAL"
>NULL</TT
>)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a callback marshaller</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>notify</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a destroy notify for the data</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22749"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-CONFIG-FUNC"
></A
>gnome_mdi_generic_child_set_config_func ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_config_func
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDCONFIGFUNC"
>GnomeMDIChildConfigFunc</A
> func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Sets the function used to get the config key used for session saves.</P
><P
>A &amp;GnomeMDIGenericChild doesn't require a config func.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22759"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function to set the config key for session saves</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22776"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-CONFIG-FUNC-FULL"
></A
>gnome_mdi_generic_child_set_config_func_full ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_config_func_full
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDCONFIGFUNC"
>GnomeMDIChildConfigFunc</A
> func,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> marshal,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> notify);</PRE
></TD
></TR
></TABLE
><P
>A function similar to <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-CONFIG-FUNC"
>gnome_mdi_generic_child_set_config_func</A
>(), except
it gives more control to the programmer.</P
><P
>The &amp;GtkArg array passed to <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> is of length 2.  The first element is
<TT
CLASS="PARAMETER"
><I
>child</I
></TT
>, and the second is the return value (a pointer to a string).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22791"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function (not used if <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> != <TT
CLASS="LITERAL"
>NULL</TT
>)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a callback marshaller</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>notify</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a destroy notify for the user data</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22818"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-LABEL-FUNC"
></A
>gnome_mdi_generic_child_set_label_func ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_label_func
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDLABELFUNC"
>GnomeMDIChildLabelFunc</A
> func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Sets the function used to set (or modify) the label for <TT
CLASS="PARAMETER"
><I
>child</I
></TT
>.  The
first argument to <TT
CLASS="PARAMETER"
><I
>func</I
></TT
> is <TT
CLASS="PARAMETER"
><I
>child</I
></TT
>.  If a label exists, it will be passed
to <TT
CLASS="PARAMETER"
><I
>func</I
></TT
> as the second argument, otherwise, <TT
CLASS="LITERAL"
>NULL</TT
> is passed.  The
function should return the modified label.</P
><P
>A &amp;GnomeMDIGenericChild doesn't require a label function.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22833"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN22850"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-LABEL-FUNC-FULL"
></A
>gnome_mdi_generic_child_set_label_func_full ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_label_func_full
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDLABELFUNC"
>GnomeMDIChildLabelFunc</A
> func,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> marshal,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> notify);</PRE
></TD
></TR
></TABLE
><P
>Similar to <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-LABEL-FUNC"
>gnome_mdi_generic_child_set_label_func</A
>(), except it gives more
flexibility to the programmer.</P
><P
>The &amp;GtkArg array passed to <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> is of length 3.  The first argument
is <TT
CLASS="PARAMETER"
><I
>child</I
></TT
>, the second is the old widget (or <TT
CLASS="LITERAL"
>NULL</TT
>), and the third is the
return value (a pointer to a &amp;GtkWidget).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN22866"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function (not used if <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> != <TT
CLASS="LITERAL"
>NULL</TT
>)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a callback marshaller</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>notify</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a destroy notify for the data</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomemdichild.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomemdi.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
>GnomeMDIChild</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeMDI</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeMDI</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeMDIGenericChild"
HREF="gnomemdigenericchild.html"><LINK
REL="NEXT"
TITLE="GnomeMessageBox"
HREF="gnomemessagebox.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomemdigenericchild.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomemessagebox.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEMDI"
>GnomeMDI</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN22898"
></A
><H2
>Name</H2
>GnomeMDI&nbsp;--&nbsp;GNOME Multiple Document Interface</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN22901"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomemdi.html#GNOMEMDI-STRUCT"
>GnomeMDI</A
>;
enum        <A
HREF="gnomemdi.html#GNOMEMDIMODE"
>GnomeMDIMode</A
>;
<A
HREF=../gtk/gtkobject.html
>GtkObject</A>*  <A
HREF="gnomemdi.html#GNOME-MDI-NEW"
>gnome_mdi_new</A
>                   (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *appname,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);
void        <A
HREF="gnomemdi.html#GNOME-MDI-SET-MODE"
>gnome_mdi_set_mode</A
>              (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomemdi.html#GNOMEMDIMODE"
>GnomeMDIMode</A
> mode);
void        <A
HREF="gnomemdi.html#GNOME-MDI-SET-MENUBAR-TEMPLATE"
>gnome_mdi_set_menubar_template</A
>  (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *menu_tmpl);
void        <A
HREF="gnomemdi.html#GNOME-MDI-SET-TOOLBAR-TEMPLATE"
>gnome_mdi_set_toolbar_template</A
>  (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *tbar_tmpl);
void        <A
HREF="gnomemdi.html#GNOME-MDI-SET-CHILD-MENU-PATH"
>gnome_mdi_set_child_menu_path</A
>   (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path);
void        <A
HREF="gnomemdi.html#GNOME-MDI-SET-CHILD-LIST-PATH"
>gnome_mdi_set_child_list_path</A
>   (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomemdi.html#GNOME-MDI-ADD-VIEW"
>gnome_mdi_add_view</A
>              (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *child);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomemdi.html#GNOME-MDI-ADD-TOPLEVEL-VIEW"
>gnome_mdi_add_toplevel_view</A
>     (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *child);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomemdi.html#GNOME-MDI-REMOVE-VIEW"
>gnome_mdi_remove_view</A
>           (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *view,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> force);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomemdi.html#GNOME-MDI-GET-ACTIVE-VIEW"
>gnome_mdi_get_active_view</A
>       (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi);
void        <A
HREF="gnomemdi.html#GNOME-MDI-SET-ACTIVE-VIEW"
>gnome_mdi_set_active_view</A
>       (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *view);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomemdi.html#GNOME-MDI-ADD-CHILD"
>gnome_mdi_add_child</A
>             (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *child);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomemdi.html#GNOME-MDI-REMOVE-CHILD"
>gnome_mdi_remove_child</A
>          (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *child,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> force);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomemdi.html#GNOME-MDI-REMOVE-ALL"
>gnome_mdi_remove_all</A
>            (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> force);
void        <A
HREF="gnomemdi.html#GNOME-MDI-OPEN-TOPLEVEL"
>gnome_mdi_open_toplevel</A
>         (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi);
void        <A
HREF="gnomemdi.html#GNOME-MDI-UPDATE-CHILD"
>gnome_mdi_update_child</A
>          (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *child);
<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>* <A
HREF="gnomemdi.html#GNOME-MDI-GET-ACTIVE-CHILD"
>gnome_mdi_get_active_child</A
>   (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi);
<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>* <A
HREF="gnomemdi.html#GNOME-MDI-FIND-CHILD"
>gnome_mdi_find_child</A
>         (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);
<A
HREF="gnomeapp.html"
>GnomeApp</A
>*   <A
HREF="gnomemdi.html#GNOME-MDI-GET-ACTIVE-WINDOW"
>gnome_mdi_get_active_window</A
>     (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi);
void        <A
HREF="gnomemdi.html#GNOME-MDI-REGISTER"
>gnome_mdi_register</A
>              (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF=../gtk/gtkobject.html
>GtkObject</A> *object);
void        <A
HREF="gnomemdi.html#GNOME-MDI-UNREGISTER"
>gnome_mdi_unregister</A
>            (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF=../gtk/gtkobject.html
>GtkObject</A> *object);
<A
HREF="gnomeapp.html"
>GnomeApp</A
>*   <A
HREF="gnomemdi.html#GNOME-MDI-GET-APP-FROM-VIEW"
>gnome_mdi_get_app_from_view</A
>     (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *view);
<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>* <A
HREF="gnomemdi.html#GNOME-MDI-GET-CHILD-FROM-VIEW"
>gnome_mdi_get_child_from_view</A
>
                                            (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *view);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomemdi.html#GNOME-MDI-GET-VIEW-FROM-WINDOW"
>gnome_mdi_get_view_from_window</A
>  (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomeapp.html"
>GnomeApp</A
> *app);
<A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
>* <A
HREF="gnomemdi.html#GNOME-MDI-GET-MENUBAR-INFO"
>gnome_mdi_get_menubar_info</A
>     (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app);
<A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
>* <A
HREF="gnomemdi.html#GNOME-MDI-GET-TOOLBAR-INFO"
>gnome_mdi_get_toolbar_info</A
>     (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app);
<A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
>* <A
HREF="gnomemdi.html#GNOME-MDI-GET-CHILD-MENU-INFO"
>gnome_mdi_get_child_menu_info</A
>  (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN22997"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----GnomeMDI</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN23001"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomemdi.html#GNOMEMDI-ADD-CHILD"
>add-child</A
>&quot; <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function      (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                            <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomemdi.html#GNOMEMDI-REMOVE-CHILD"
>remove-child</A
>&quot;
            <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function      (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                            <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomemdi.html#GNOMEMDI-ADD-VIEW"
>add-view</A
>&quot;  <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function      (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                            <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomemdi.html#GNOMEMDI-REMOVE-VIEW"
>remove-view</A
>&quot;
            <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function      (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                            <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomemdi.html#GNOMEMDI-CHILD-CHANGED"
>child-changed</A
>&quot;
            void        user_function      (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                            <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomemdi.html#GNOMEMDI-VIEW-CHANGED"
>view-changed</A
>&quot;
            void        user_function      (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                            <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomemdi.html#GNOMEMDI-APP-CREATED"
>app-created</A
>&quot;
            void        user_function      (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                            <A
HREF="gnomeapp.html"
>GnomeApp</A
> *arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN23036"
></A
><H2
>Description</H2
><P
>    The <SPAN
CLASS="TYPE"
>GnomeMDI</SPAN
> object lets the application manage a
    number of documents and displays their views in a configurable
    fashion.
  </P
><P
>    Once an instance of <SPAN
CLASS="TYPE"
>GnomeMDI</SPAN
> has been created, you
    can add documents to it using <A
HREF="gnomemdi.html#GNOME-MDI-ADD-CHILD"
>gnome_mdi_add_child</A
>() and add views
    of these documents with <A
HREF="gnomemdi.html#GNOME-MDI-ADD-VIEW"
>gnome_mdi_add_view</A
>() routine. GnomeMDI
    also provides means to create global menus and toolbar that apply
    for each document and for merging document-specific menus with the
    global ones. MDI automatically creates a menu containing a list of
    all open documents. The global menus and toolbar can be created
    using a template GnomeUIInfo structure or with a handler for
    app_created signal which allows for customization of all
    <SPAN
CLASS="TYPE"
>GnomeApp</SPAN
> widgets that <SPAN
CLASS="TYPE"
>GnomeMDI</SPAN
> creates.
  </P
><P
>    The views are displayed in one of three modes that can be set using
    <A
HREF="gnomemdi.html#GNOME-MDI-SET-MODE"
>gnome_mdi_set_mode</A
>() function:
    <P
></P
><UL
><LI
><P
>	  <TT
CLASS="LITERAL"
>GNOME_MDI_NOTEBOOK</TT
> mode displays each view in a notebook page. The user can create
	  any number of notebooks, each within its toplevel <SPAN
CLASS="TYPE"
>GnomeApp</SPAN
> and drag
	  pages from one to another, thus distributing the views between them in any
	  desired manner.
	</P
></LI
><LI
><P
>	  <TT
CLASS="LITERAL"
>GNOME_MDI_TOPLEVEL</TT
> mode displays each view in its own toplevel window.
	</P
></LI
><LI
><P
>	  <TT
CLASS="LITERAL"
>GNOME_MDI_MODAL</TT
> mode displays only a single view of a document.
	</P
></LI
><LI
><P
>	  <TT
CLASS="LITERAL"
>GNOME_MDI_DEFAULT</TT
> uses the mode that can be configured on a per-user
	  basis via the GNOME control center.
	</P
></LI
></UL
>
  </P
><P
>    <SPAN
CLASS="TYPE"
>GnomeMDI</SPAN
> can automatically save and restore its state and the state
    of its children and layout, which is particularly useful to simplify implementation
    of session managment.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN23064"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN23066"
></A
><H3
><A
NAME="GNOMEMDI-STRUCT"
></A
>struct GnomeMDI</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeMDI;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23071"
></A
><H3
><A
NAME="GNOMEMDIMODE"
></A
>enum GnomeMDIMode</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum {
	GNOME_MDI_NOTEBOOK,
	GNOME_MDI_TOPLEVEL,
	GNOME_MDI_MODAL,
	GNOME_MDI_DEFAULT_MODE = 42
} GnomeMDIMode;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23076"
></A
><H3
><A
NAME="GNOME-MDI-NEW"
></A
>gnome_mdi_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkobject.html
>GtkObject</A>*  gnome_mdi_new                   (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *appname,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title);</PRE
></TD
></TR
></TABLE
><P
>Creates a new MDI object. <TT
CLASS="PARAMETER"
><I
>appname</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>title</I
></TT
> are used for
MDI's calling <A
HREF="gnomeapp.html#GNOME-APP-NEW"
>gnome_app_new</A
>().</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23088"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appname</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Application name as used in filenames and paths.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Title of the application windows.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a new GnomeMDI object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23105"
></A
><H3
><A
NAME="GNOME-MDI-SET-MODE"
></A
>gnome_mdi_set_mode ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_set_mode              (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomemdi.html#GNOMEMDIMODE"
>GnomeMDIMode</A
> mode);</PRE
></TD
></TR
></TABLE
><P
>Sets the MDI mode to mode. Possible values are <TT
CLASS="LITERAL"
>GNOME_MDI_TOPLEVEL</TT
>,
<TT
CLASS="LITERAL"
>GNOME_MDI_NOTEBOOK</TT
>, <TT
CLASS="LITERAL"
>GNOME_MDI_MODAL</TT
> and <TT
CLASS="LITERAL"
>GNOME_MDI_DEFAULT</TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23117"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mode</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New mode.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23130"
></A
><H3
><A
NAME="GNOME-MDI-SET-MENUBAR-TEMPLATE"
></A
>gnome_mdi_set_menubar_template ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_set_menubar_template  (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *menu_tmpl);</PRE
></TD
></TR
></TABLE
><P
>This function sets the template for menus that appear in each toplevel
window to menu_template. For each new toplevel window created by the MDI,
this structure is copied, the menus are created with
<A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-CREATE-MENUS-WITH-DATA"
>gnome_app_create_menus_with_data</A
>() function with mdi as the callback
user data. Finally, the pointer to the copy is assigned to the new
toplevel window (a GnomeApp widget) and can be obtained by calling
&amp;gnome_mdi_get_menubar_info.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23139"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>menu_tmpl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeUIInfo array describing the menu.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23152"
></A
><H3
><A
NAME="GNOME-MDI-SET-TOOLBAR-TEMPLATE"
></A
>gnome_mdi_set_toolbar_template ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_set_toolbar_template  (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *tbar_tmpl);</PRE
></TD
></TR
></TABLE
><P
>This function sets the template for toolbar that appears in each toplevel
window to toolbar_template. For each new toplevel window created by the MDI,
this structure is copied, the toolbar is created with
<A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-CREATE-TOOLBAR-WITH-DATA"
>gnome_app_create_toolbar_with_data</A
>() function with mdi as the callback
user data. Finally, the pointer to the copy is assigned to the new toplevel
window (a GnomeApp widget) and can be retrieved with a call to
&amp;gnome_mdi_get_toolbar_info.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23161"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tbar_tmpl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeUIInfo array describing the toolbar.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23174"
></A
><H3
><A
NAME="GNOME-MDI-SET-CHILD-MENU-PATH"
></A
>gnome_mdi_set_child_menu_path ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_set_child_menu_path   (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path);</PRE
></TD
></TR
></TABLE
><P
>Sets the desired position of child-specific menus (which are added to and
removed from the main menus as views of different children are activated).
See gnome_app_find_menu_pos for details on menu paths.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23182"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object. </TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A menu path where the child menus should be inserted.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23195"
></A
><H3
><A
NAME="GNOME-MDI-SET-CHILD-LIST-PATH"
></A
>gnome_mdi_set_child_list_path ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_set_child_list_path   (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path);</PRE
></TD
></TR
></TABLE
><P
>Sets the position for insertion of menu items used to activate the MDI
children that were added to the MDI. See gnome_app_find_menu_pos for
details on menu paths. If the path is not set or set to <TT
CLASS="LITERAL"
>NULL</TT
>, these menu
items aren't going to be inserted in the MDI menu structure. Note that if
you want all menu items to be inserted in their own submenu, you have to
create that submenu (and leave it empty, of course).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23204"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A menu path where the child list menu should be inserted</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23217"
></A
><H3
><A
NAME="GNOME-MDI-ADD-VIEW"
></A
>gnome_mdi_add_view ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_mdi_add_view              (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *child);</PRE
></TD
></TR
></TABLE
><P
>Creates a new view of the child and adds it to the MDI. GnomeMDIChild
<TT
CLASS="PARAMETER"
><I
>child</I
></TT
> has to be added to the MDI with a call to gnome_mdi_add_child
before its views are added to the MDI. 
An "add_view" signal is emitted to the MDI after the view has been
created, but before it is shown and added to the MDI, with a pointer to
the created view as its parameter. The view is added to the MDI only if
the signal handler (if it exists) returns <TT
CLASS="LITERAL"
>TRUE</TT
>. If the handler returns
<TT
CLASS="LITERAL"
>FALSE</TT
>, the created view is destroyed and not added to the MDI.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23229"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a child.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if adding the view succeeded and <TT
CLASS="LITERAL"
>FALSE</TT
> otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23248"
></A
><H3
><A
NAME="GNOME-MDI-ADD-TOPLEVEL-VIEW"
></A
>gnome_mdi_add_toplevel_view ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_mdi_add_toplevel_view     (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *child);</PRE
></TD
></TR
></TABLE
><P
>Creates a new view of the child and adds it to the MDI; it behaves the
same way as gnome_mdi_add_view in <TT
CLASS="LITERAL"
>GNOME_MDI_MODAL</TT
> and <TT
CLASS="LITERAL"
>GNOME_MDI_TOPLEVEL</TT
>
modes, but in <TT
CLASS="LITERAL"
>GNOME_MDI_NOTEBOOK</TT
> mode, the view is added in a new
toplevel window unless the active one has no views in it.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23260"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDIChild object to be added to the MDI.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> 
<TT
CLASS="LITERAL"
>TRUE</TT
> if adding the view succeeded and <TT
CLASS="LITERAL"
>FALSE</TT
> otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23279"
></A
><H3
><A
NAME="GNOME-MDI-REMOVE-VIEW"
></A
>gnome_mdi_remove_view ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_mdi_remove_view           (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *view,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> force);</PRE
></TD
></TR
></TABLE
><P
>Removes a view from an MDI. 
A "remove_view" signal is emitted to the MDI before actually removing
view. The view is removed only if the signal handler (if it exists and
the <TT
CLASS="PARAMETER"
><I
>force</I
></TT
> is set to <TT
CLASS="LITERAL"
>FALSE</TT
>) returns <TT
CLASS="LITERAL"
>TRUE</TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23292"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>view</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> View to remove.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>force</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> If TRUE, the "remove_view" signal is not emitted.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> 
<TT
CLASS="LITERAL"
>TRUE</TT
> if the view was removed and <TT
CLASS="LITERAL"
>FALSE</TT
> otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23315"
></A
><H3
><A
NAME="GNOME-MDI-GET-ACTIVE-VIEW"
></A
>gnome_mdi_get_active_view ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_mdi_get_active_view       (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi);</PRE
></TD
></TR
></TABLE
><P
>Returns a pointer to the active view (the one with the focus).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23323"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> 
A pointer to a GtkWidget *.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23336"
></A
><H3
><A
NAME="GNOME-MDI-SET-ACTIVE-VIEW"
></A
>gnome_mdi_set_active_view ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_set_active_view       (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *view);</PRE
></TD
></TR
></TABLE
><P
>Sets the active view to <TT
CLASS="PARAMETER"
><I
>view</I
></TT
>. It also raises the window containing it
and gives it focus.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23345"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to an MDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>view</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to the view that is to become the active one.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23358"
></A
><H3
><A
NAME="GNOME-MDI-ADD-CHILD"
></A
>gnome_mdi_add_child ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_mdi_add_child             (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *child);</PRE
></TD
></TR
></TABLE
><P
>Adds a new child to the MDI. No views are added: this has to be done with
a call to gnome_mdi_add_view. 
First an "add_child" signal is emitted to the MDI with a pointer to the
child as its parameter. The child is added to the MDI only if the signal
handler (if it exists) returns <TT
CLASS="LITERAL"
>TRUE</TT
>. If the handler returns <TT
CLASS="LITERAL"
>FALSE</TT
>, the
child is not added to the MDI.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23369"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDIChild to add to the MDI.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> 
<TT
CLASS="LITERAL"
>TRUE</TT
> if the child was added successfully and <TT
CLASS="LITERAL"
>FALSE</TT
> otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23388"
></A
><H3
><A
NAME="GNOME-MDI-REMOVE-CHILD"
></A
>gnome_mdi_remove_child ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_mdi_remove_child          (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *child,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> force);</PRE
></TD
></TR
></TABLE
><P
>Removes a child and all of its views from the MDI. 
A "remove_child" signal is emitted to the MDI with <TT
CLASS="PARAMETER"
><I
>child</I
></TT
> as its parameter
before actually removing the child. The child is removed only if the signal
handler (if it exists and the <TT
CLASS="PARAMETER"
><I
>force</I
></TT
> is set to <TT
CLASS="LITERAL"
>FALSE</TT
>) returns <TT
CLASS="LITERAL"
>TRUE</TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23402"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Child to remove.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>force</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> If TRUE, the "remove_child" signal is not emitted</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> 
<TT
CLASS="LITERAL"
>TRUE</TT
> if the removal was successful and <TT
CLASS="LITERAL"
>FALSE</TT
> otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23425"
></A
><H3
><A
NAME="GNOME-MDI-REMOVE-ALL"
></A
>gnome_mdi_remove_all ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_mdi_remove_all            (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> force);</PRE
></TD
></TR
></TABLE
><P
>Removes all children and all views from the MDI. 
A "remove_child" signal is emitted to the MDI for each child before
actually trying to remove any. If signal handlers for all children (if
they exist and the <TT
CLASS="PARAMETER"
><I
>force</I
></TT
> is set to <TT
CLASS="LITERAL"
>FALSE</TT
>) return <TT
CLASS="LITERAL"
>TRUE</TT
>, all children
and their views are removed and none otherwise.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23437"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>force</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> If TRUE, the "remove_child" signal is not emitted</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if the removal was successful and <TT
CLASS="LITERAL"
>FALSE</TT
> otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23456"
></A
><H3
><A
NAME="GNOME-MDI-OPEN-TOPLEVEL"
></A
>gnome_mdi_open_toplevel ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_open_toplevel         (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi);</PRE
></TD
></TR
></TABLE
><P
>Opens a new toplevel window (unless in <TT
CLASS="LITERAL"
>GNOME_MDI_MODAL</TT
> mode and a
toplevel window is already open). This is usually used only for opening
the initial window on startup (just before calling gtkmain()) if no
windows were open because a session was restored or children were added
because of command line args).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23465"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23474"
></A
><H3
><A
NAME="GNOME-MDI-UPDATE-CHILD"
></A
>gnome_mdi_update_child ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_update_child          (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *child);</PRE
></TD
></TR
></TABLE
><P
>Updates all notebook labels of <TT
CLASS="PARAMETER"
><I
>child</I
></TT
>'s views and their window titles
after its name changes. It is not required if <A
HREF="gnomemdichild.html#GNOME-MDI-CHILD-SET-NAME"
>gnome_mdi_child_set_name</A
>()
is used for setting the child's name.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23484"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Child to update.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23497"
></A
><H3
><A
NAME="GNOME-MDI-GET-ACTIVE-CHILD"
></A
>gnome_mdi_get_active_child ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>* gnome_mdi_get_active_child   (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi);</PRE
></TD
></TR
></TABLE
><P
>Returns a pointer to the active GnomeMDIChild object.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23505"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> 
A pointer to the active GnomeMDIChild object. <TT
CLASS="LITERAL"
>NULL</TT
>, if there is none.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23519"
></A
><H3
><A
NAME="GNOME-MDI-FIND-CHILD"
></A
>gnome_mdi_find_child ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>* gnome_mdi_find_child         (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);</PRE
></TD
></TR
></TABLE
><P
>Finds a child named <TT
CLASS="PARAMETER"
><I
>name</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23529"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A string with a name of the child to find.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> 
A pointer to the GnomeMDIChild object if the child was found and NULL
otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23546"
></A
><H3
><A
NAME="GNOME-MDI-GET-ACTIVE-WINDOW"
></A
>gnome_mdi_get_active_window ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeapp.html"
>GnomeApp</A
>*   gnome_mdi_get_active_window     (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi);</PRE
></TD
></TR
></TABLE
><P
>Returns a pointer to the toplevel window containing the active view.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23554"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a GnomeApp that has the focus.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23567"
></A
><H3
><A
NAME="GNOME-MDI-REGISTER"
></A
>gnome_mdi_register ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_register              (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF=../gtk/gtkobject.html
>GtkObject</A> *object);</PRE
></TD
></TR
></TABLE
><P
>Registers GtkObject <TT
CLASS="PARAMETER"
><I
>object</I
></TT
> with MDI. 
This is mostly intended for applications that open other windows besides
those opened by the MDI and want to continue to run even when no MDI
windows exist (an example of this would be GIMP's window with tools, if
the pictures were MDI children). As long as there is an object registered
with the MDI, the MDI will not destroy itself when the last of its windows
is closed. If no objects are registered, closing the last MDI window
results in MDI being destroyed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23576"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Object to register.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23589"
></A
><H3
><A
NAME="GNOME-MDI-UNREGISTER"
></A
>gnome_mdi_unregister ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_unregister            (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF=../gtk/gtkobject.html
>GtkObject</A> *object);</PRE
></TD
></TR
></TABLE
><P
>Removes GtkObject <TT
CLASS="PARAMETER"
><I
>object</I
></TT
> from the list of registered objects.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23598"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Object to unregister.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23611"
></A
><H3
><A
NAME="GNOME-MDI-GET-APP-FROM-VIEW"
></A
>gnome_mdi_get_app_from_view ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeapp.html"
>GnomeApp</A
>*   gnome_mdi_get_app_from_view     (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *view);</PRE
></TD
></TR
></TABLE
><P
>Returns the toplevel window for this view.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23619"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>view</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GtkWidget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to the GnomeApp containg the specified view.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23632"
></A
><H3
><A
NAME="GNOME-MDI-GET-CHILD-FROM-VIEW"
></A
>gnome_mdi_get_child_from_view ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>* gnome_mdi_get_child_from_view
                                            (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *view);</PRE
></TD
></TR
></TABLE
><P
>Returns a child that <TT
CLASS="PARAMETER"
><I
>view</I
></TT
> is a view of.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23641"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>view</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GtkWidget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to the GnomeMDIChild the view belongs to.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23654"
></A
><H3
><A
NAME="GNOME-MDI-GET-VIEW-FROM-WINDOW"
></A
>gnome_mdi_get_view_from_window ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_mdi_get_view_from_window  (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             <A
HREF="gnomeapp.html"
>GnomeApp</A
> *app);</PRE
></TD
></TR
></TABLE
><P
>Returns the pointer to the view in the MDI toplevel window <TT
CLASS="PARAMETER"
><I
>app</I
></TT
>.
If the mode is set to <TT
CLASS="LITERAL"
>GNOME_MDI_NOTEBOOK</TT
>, the view in the current
page is returned.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23665"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeApp widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> 
A pointer to a view.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23682"
></A
><H3
><A
NAME="GNOME-MDI-GET-MENUBAR-INFO"
></A
>gnome_mdi_get_menubar_info ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
>* gnome_mdi_get_menubar_info     (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23690"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeApp widget created by the MDI.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> 
A GnomeUIInfo array used for menubar in <TT
CLASS="PARAMETER"
><I
>app</I
></TT
> if the menubar has been created with a template.
<TT
CLASS="LITERAL"
>NULL</TT
> otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23705"
></A
><H3
><A
NAME="GNOME-MDI-GET-TOOLBAR-INFO"
></A
>gnome_mdi_get_toolbar_info ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
>* gnome_mdi_get_toolbar_info     (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23713"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeApp widget created by the MDI.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> 
A GnomeUIInfo array used for toolbar in <TT
CLASS="PARAMETER"
><I
>app</I
></TT
> if the toolbar has been created with a template.
<TT
CLASS="LITERAL"
>NULL</TT
> otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23728"
></A
><H3
><A
NAME="GNOME-MDI-GET-CHILD-MENU-INFO"
></A
>gnome_mdi_get_child_menu_info ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
>* gnome_mdi_get_child_menu_info  (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23736"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeApp widget created by the MDI.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> 
A GnomeUIInfo array used for child's menus in <TT
CLASS="PARAMETER"
><I
>app</I
></TT
> if they have been created with a template.
<TT
CLASS="LITERAL"
>NULL</TT
> otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN23751"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN23753"
></A
><H3
><A
NAME="GNOMEMDI-ADD-CHILD"
></A
>The &quot;add-child&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function                  (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                            <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>  Emitted before actually adding a child. If the handler returns <TT
CLASS="LITERAL"
>TRUE</TT
>, the
  child is added, otherwise, nothing happens.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23763"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>child to be added</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>boolean, to indicate if the child is to be added&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23784"
></A
><H3
><A
NAME="GNOMEMDI-REMOVE-CHILD"
></A
>The &quot;remove-child&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function                  (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                            <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>  Emitted before actually removing a child. If the handler returns <TT
CLASS="LITERAL"
>TRUE</TT
>, the
  child is remove, otherwise, nothing happens.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23794"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>child to be remove</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>boolean, to indicate if the child is to be removed&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23815"
></A
><H3
><A
NAME="GNOMEMDI-ADD-VIEW"
></A
>The &quot;add-view&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function                  (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                            <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>  Emitted before actually adding a view. If the handler returns <TT
CLASS="LITERAL"
>TRUE</TT
>, the
  view is added, otherwise, nothing happens.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23825"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>view to be added</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>boolean, to indicate if the view is to be added&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23846"
></A
><H3
><A
NAME="GNOMEMDI-REMOVE-VIEW"
></A
>The &quot;remove-view&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    user_function                  (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                            <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>  Emitted before actually removing a view. If the handler returns <TT
CLASS="LITERAL"
>TRUE</TT
>, the
  view is remove, otherwise, nothing happens.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23856"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the view to be removed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>boolean, to indicate if the view is to be removed&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23877"
></A
><H3
><A
NAME="GNOMEMDI-CHILD-CHANGED"
></A
>The &quot;child-changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                            <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> *arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>  Emitted each time when active child is changed with the second argument
  pointing to the old child. mdi-&#62;active_view and mdi-&#62;active_child already
  hold the new values</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23885"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the old child&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23902"
></A
><H3
><A
NAME="GNOMEMDI-VIEW-CHANGED"
></A
>The &quot;view-changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                            <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>  Emitted whenever a view is changed, regardless of it being the view of the same child as
  the old view or not. the second argument points to the old view, mdi-&#62;active_view and
  mdi-&#62;active_child hold the new values. If the child has also been changed, this signal is
  emitted after the child_changed signal.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23911"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the old view&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN23928"
></A
><H3
><A
NAME="GNOMEMDI-APP-CREATED"
></A
>The &quot;app-created&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                            <A
HREF="gnomeapp.html"
>GnomeApp</A
> *arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>  Emitted with each newly created <A
HREF="gnomeapp.html"
>GnomeApp</A
> to allow the MDI user to customize it (add a
  statusbar, toolbars or menubar if the method with <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> templates is not sufficient,
  etc.).  No contents may be set since <A
HREF="gnomemdi.html"
>GnomeMDI</A
> uses them for storing either a view of a child
  or a notebook.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN23939"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the <A
HREF="gnomeapp.html"
>GnomeApp</A
> being created&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN23957"
></A
><H2
>See Also</H2
><P
>  <A
HREF="gnomeapp.html"
>GnomeApp</A
>, <A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>, <A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
>, GnomeMDISession</P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomemdigenericchild.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomemessagebox.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
>GnomeMDIGenericChild</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeMessageBox</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeMessageBox</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeMDI"
HREF="gnomemdi.html"><LINK
REL="NEXT"
TITLE="GnomeNumberEntry"
HREF="gnomenumberentry.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomemdi.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomenumberentry.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEMESSAGEBOX"
>GnomeMessageBox</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN23969"
></A
><H2
>Name</H2
>GnomeMessageBox&nbsp;--&nbsp;Message box display routines</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN23972"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomemessagebox.html#GNOMEMESSAGEBOX-STRUCT"
>GnomeMessageBox</A
>;
#define     <A
HREF="gnomemessagebox.html#GNOME-MESSAGE-BOX-INFO-CAPS"
>GNOME_MESSAGE_BOX_INFO</A
>
#define     <A
HREF="gnomemessagebox.html#GNOME-MESSAGE-BOX-WARNING-CAPS"
>GNOME_MESSAGE_BOX_WARNING</A
>
#define     <A
HREF="gnomemessagebox.html#GNOME-MESSAGE-BOX-ERROR-CAPS"
>GNOME_MESSAGE_BOX_ERROR</A
>
#define     <A
HREF="gnomemessagebox.html#GNOME-MESSAGE-BOX-QUESTION-CAPS"
>GNOME_MESSAGE_BOX_QUESTION</A
>
#define     <A
HREF="gnomemessagebox.html#GNOME-MESSAGE-BOX-GENERIC-CAPS"
>GNOME_MESSAGE_BOX_GENERIC</A
>
struct      <A
HREF="gnomemessagebox.html#GNOMEMESSAGEBOXBUTTON"
>GnomeMessageBoxButton</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomemessagebox.html#GNOME-MESSAGE-BOX-NEW"
>gnome_message_box_new</A
>           (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *messagebox_type,
                                             ...);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomemessagebox.html#GNOME-MESSAGE-BOX-NEWV"
>gnome_message_box_newv</A
>          (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *messagebox_type,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **buttons);
void        <A
HREF="gnomemessagebox.html#GNOME-MESSAGE-BOX-SET-MODAL"
>gnome_message_box_set_modal</A
>     (<A
HREF="gnomemessagebox.html"
>GnomeMessageBox</A
> *messagebox);
void        <A
HREF="gnomemessagebox.html#GNOME-MESSAGE-BOX-SET-DEFAULT"
>gnome_message_box_set_default</A
>   (<A
HREF="gnomemessagebox.html"
>GnomeMessageBox</A
> *messagebox,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> button);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN23996"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----<A
HREF=../gtk/gtkwindow.html
>GtkWindow</A>
                           +----<A
HREF="gnomedialog.html"
>GnomeDialog</A
>
                                 +----GnomeMessageBox</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24005"
></A
><H2
>Description</H2
><P
>    The <A
HREF="gnomemessagebox.html"
>GnomeMessageBox</A
> widget creates dialog boxes (of type
    <A
HREF="gnomedialog.html"
>GnomeDialog</A
>) that contain a severity level (indicated by an icon
    and a title), a message to be displayed and a list of buttons that
    will be in the dialog.  
  </P
><P
>    The programmer will use strings desired for each button.  If the
    strings are any of the GNOME_STOCK macros, then instead of
    creating a button with the text, the button will be a GNOME stock
    button with a stock icon.
  </P
><P
>    The list of known types for message boxes are:
    <TT
CLASS="LITERAL"
>GNOME_MESSAGE_BOX_INFO</TT
>, <TT
CLASS="LITERAL"
>GNOME_MESSAGE_BOX_WARNING</TT
>,
    <TT
CLASS="LITERAL"
>GNOME_MESSAGE_BOX_ERROR</TT
>, <TT
CLASS="LITERAL"
>GNOME_MESSAGE_BOX_QUESTION</TT
> and
    <TT
CLASS="LITERAL"
>GNOME_MESSAGE_BOX_GENERIC</TT
>.  
  </P
><P
>    Here is an example that informs the user of an error:

    <TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>      GtkWidget *error_dialog;
      int ret;
      
      error_dialog = gnome_message_box_new (
              "Wrong password",
              GNOME_MESSAGE_BOX_ERROR,
              "Retry", "Ignore",
              NULL);
      ret = gnome_dialog_run (GNOME_DIALOG (error_dialog));
      switch (ret){
             case 0:
                    do_retry();
                    break;
             case 1:
                    do_ignore()
                    break;
             default:
                    /* User closed dialog with window manager,
                     * assume "ignore"
                     */
                    do_ignore();
                    break;
      }
    </PRE
></TD
></TR
></TABLE
>

    This other example uses stock buttons:

    <TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>      GtkWidget *yes_no_dialog;
      int ret;
      
      yes_no_dialog = gnome_message_box_new (
              "Do you want to make a chocolate cake?",
              GNOME_MESSAGE_BOX_QUESTION,
              GNOME_STOCK_BUTTON_YES,
              GNOME_STOCK_BUTTON_NO,
              NULL);
      ret = gnome_dialog_run (GNOME_DIALOG (yes_no_dialog));
      switch (ret){
             case 0:
                    make_chocolate_cake();
                    break;
             case 1:
                    /* User does not desire chocolate cake *./
                    break;
             default:
                    /*
		     * User closed dialog with window manager,
                     * assume he is not into chocolate cake.
                     */
                    do_ignore();
                    break;
      }
    </PRE
></TD
></TR
></TABLE
>
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24025"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN24027"
></A
><H3
><A
NAME="GNOMEMESSAGEBOX-STRUCT"
></A
>struct GnomeMessageBox</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeMessageBox;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24032"
></A
><H3
><A
NAME="GNOME-MESSAGE-BOX-INFO-CAPS"
></A
>GNOME_MESSAGE_BOX_INFO</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MESSAGE_BOX_INFO      "info"</PRE
></TD
></TR
></TABLE
><P
>    Use this macro for displaying an informational message.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24037"
></A
><H3
><A
NAME="GNOME-MESSAGE-BOX-WARNING-CAPS"
></A
>GNOME_MESSAGE_BOX_WARNING</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MESSAGE_BOX_WARNING   "warning"</PRE
></TD
></TR
></TABLE
><P
>    Use this macro for displaying a warning message.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24042"
></A
><H3
><A
NAME="GNOME-MESSAGE-BOX-ERROR-CAPS"
></A
>GNOME_MESSAGE_BOX_ERROR</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MESSAGE_BOX_ERROR     "error"</PRE
></TD
></TR
></TABLE
><P
>    Use this macro for displaying an error message.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24047"
></A
><H3
><A
NAME="GNOME-MESSAGE-BOX-QUESTION-CAPS"
></A
>GNOME_MESSAGE_BOX_QUESTION</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MESSAGE_BOX_QUESTION  "question"</PRE
></TD
></TR
></TABLE
><P
>    Use this macro when you want to query the user for information. 
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24052"
></A
><H3
><A
NAME="GNOME-MESSAGE-BOX-GENERIC-CAPS"
></A
>GNOME_MESSAGE_BOX_GENERIC</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MESSAGE_BOX_GENERIC   "generic"</PRE
></TD
></TR
></TABLE
><P
>    Use this macro if none of the other message box types apply.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24057"
></A
><H3
><A
NAME="GNOMEMESSAGEBOXBUTTON"
></A
>struct GnomeMessageBoxButton</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeMessageBoxButton;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24062"
></A
><H3
><A
NAME="GNOME-MESSAGE-BOX-NEW"
></A
>gnome_message_box_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_message_box_new           (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *messagebox_type,
                                             ...);</PRE
></TD
></TR
></TABLE
><P
>Creates a dialog box of type <TT
CLASS="PARAMETER"
><I
>message_box_type</I
></TT
> with <TT
CLASS="PARAMETER"
><I
>message</I
></TT
>.  A number
of buttons are inserted on it.  You can use the GNOME stock identifiers
to create gnome-stock-buttons.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24073"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The message to be displayed.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>messagebox_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>...</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A NULL terminated list of strings to use in each button.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a widget that has the dialog box.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24094"
></A
><H3
><A
NAME="GNOME-MESSAGE-BOX-NEWV"
></A
>gnome_message_box_newv ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_message_box_newv          (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *messagebox_type,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **buttons);</PRE
></TD
></TR
></TABLE
><P
>Creates a dialog box of type <TT
CLASS="PARAMETER"
><I
>message_box_type</I
></TT
> with <TT
CLASS="PARAMETER"
><I
>message</I
></TT
>.  A number
of buttons are inserted on it, the messages come from the <TT
CLASS="PARAMETER"
><I
>buttons</I
></TT
> array.
You can use the GNOME stock identifiers to create gnome-stock-buttons.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24107"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The message to be displayed.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>messagebox_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>buttons</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a NULL terminated array with the buttons to insert.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a widget that has the dialog box.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24128"
></A
><H3
><A
NAME="GNOME-MESSAGE-BOX-SET-MODAL"
></A
>gnome_message_box_set_modal ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_message_box_set_modal     (<A
HREF="gnomemessagebox.html"
>GnomeMessageBox</A
> *messagebox);</PRE
></TD
></TR
></TABLE
><P
>Deprecated. Use <TT
CLASS="FUNCTION"
><A
HREF=../gtk/gtkwindow.html#GTK-WINDOW-SET-MODAL
>gtk_window_set_modal</A>()</TT
>.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24136"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>messagebox</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24145"
></A
><H3
><A
NAME="GNOME-MESSAGE-BOX-SET-DEFAULT"
></A
>gnome_message_box_set_default ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_message_box_set_default   (<A
HREF="gnomemessagebox.html"
>GnomeMessageBox</A
> *messagebox,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> button);</PRE
></TD
></TR
></TABLE
><P
>Deprecated. Use <TT
CLASS="FUNCTION"
>gnome_dialog_set_modal()</TT
>.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24154"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>messagebox</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>button</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24167"
></A
><H2
>See Also</H2
><P
>    <A
HREF="gnomedialog.html"
>GnomeDialog</A
>
  </P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomemdi.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomenumberentry.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
>GnomeMDI</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeNumberEntry</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeNumberEntry</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeMessageBox"
HREF="gnomemessagebox.html"><LINK
REL="NEXT"
TITLE="GnomePaperSelector"
HREF="gnomepaperselector.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomemessagebox.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomepaperselector.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMENUMBERENTRY"
>GnomeNumberEntry</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN24176"
></A
><H2
>Name</H2
>GnomeNumberEntry&nbsp;--&nbsp;An entry line for number input.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN24179"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomenumberentry.html#GNOMENUMBERENTRY-STRUCT"
>GnomeNumberEntry</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomenumberentry.html#GNOME-NUMBER-ENTRY-NEW"
>gnome_number_entry_new</A
>          (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *history_id,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *calc_dialog_title);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomenumberentry.html#GNOME-NUMBER-ENTRY-GNOME-ENTRY"
>gnome_number_entry_gnome_entry</A
>  (<A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
> *nentry);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomenumberentry.html#GNOME-NUMBER-ENTRY-GTK-ENTRY"
>gnome_number_entry_gtk_entry</A
>    (<A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
> *nentry);
void        <A
HREF="gnomenumberentry.html#GNOME-NUMBER-ENTRY-SET-TITLE"
>gnome_number_entry_set_title</A
>    (<A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
> *nentry,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *calc_dialog_title);
<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>     <A
HREF="gnomenumberentry.html#GNOME-NUMBER-ENTRY-GET-NUMBER"
>gnome_number_entry_get_number</A
>   (<A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
> *nentry);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24199"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbox.html
>GtkBox</A>
                     +----<A
HREF=../gtk/gtkhbox.html
>GtkHBox</A>
                           +----GnomeNumberEntry</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24207"
></A
><H2
>Description</H2
><P
>    Provides an entry line for numbers.  This routine does not attempt
    to do any validation on the valid number ranges, but provides a
    button that will let the user bring up a calculator to fill in the
    value of the entry widget.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24210"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN24212"
></A
><H3
><A
NAME="GNOMENUMBERENTRY-STRUCT"
></A
>struct GnomeNumberEntry</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeNumberEntry;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24217"
></A
><H3
><A
NAME="GNOME-NUMBER-ENTRY-NEW"
></A
>gnome_number_entry_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_number_entry_new          (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *history_id,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *calc_dialog_title);</PRE
></TD
></TR
></TABLE
><P
>Creates a new number entry widget, with a history id
and title for the calculator dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24226"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>history_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The history id given to <A
HREF="gnomeentry.html#GNOME-ENTRY-NEW"
>gnome_entry_new</A
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>calc_dialog_title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Title of the calculator dialog</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24244"
></A
><H3
><A
NAME="GNOME-NUMBER-ENTRY-GNOME-ENTRY"
></A
>gnome_number_entry_gnome_entry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_number_entry_gnome_entry  (<A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
> *nentry);</PRE
></TD
></TR
></TABLE
><P
>Get the GnomeEntry component of the
GnomeNumberEntry for lower-level manipulation.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24252"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeNumberEntry widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeEntry widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24265"
></A
><H3
><A
NAME="GNOME-NUMBER-ENTRY-GTK-ENTRY"
></A
>gnome_number_entry_gtk_entry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_number_entry_gtk_entry    (<A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
> *nentry);</PRE
></TD
></TR
></TABLE
><P
>Get the GtkEntry component of the
GnomeNumberEntry for Gtk+-level manipulation.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24273"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeNumberEntry widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GtkEntry widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24286"
></A
><H3
><A
NAME="GNOME-NUMBER-ENTRY-SET-TITLE"
></A
>gnome_number_entry_set_title ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_number_entry_set_title    (<A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
> *nentry,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *calc_dialog_title);</PRE
></TD
></TR
></TABLE
><P
>Set the title of the calculator dialog to <TT
CLASS="PARAMETER"
><I
>calc_dialog_title</I
></TT
>.
Takes effect the next time the calculator button is pressed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24295"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeNumberEntry widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>calc_dialog_title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New title</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24308"
></A
><H3
><A
NAME="GNOME-NUMBER-ENTRY-GET-NUMBER"
></A
>gnome_number_entry_get_number ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>     gnome_number_entry_get_number   (<A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
> *nentry);</PRE
></TD
></TR
></TABLE
><P
>Get the current number from the entry</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24316"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeNumberEntry widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Value currently in the entry.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24329"
></A
><H2
>See Also</H2
><P
>    <A
HREF="gnomecalculator.html"
>GnomeCalculator</A
>, <A
HREF="gnomeentry.html"
>GnomeEntry</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomemessagebox.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomepaperselector.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
>GnomeMessageBox</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomePaperSelector</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GNOME Widgets and Objects</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="PREVIOUS"
TITLE="gtkcauldron"
HREF="gnomeui-gtkcauldron.html"><LINK
REL="NEXT"
TITLE="GnomeAbout"
HREF="gnomeabout.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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gtkcauldron.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="book1.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="gnomeabout.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="GNOME-OBJECTS"
>GNOME Widgets and Objects</A
></H1
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="gnomeabout.html"
>GnomeAbout</A
> &#8212; Simple way to provide an About box for your application.</DT
><DT
><A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> &#8212; A widget for adding simple animations to GNOME applications.</DT
><DT
><A
HREF="gnomeapp.html"
>GnomeApp</A
> &#8212; The toplevel GNOME container</DT
><DT
><A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> &#8212; Statusbar/Progress/Minibuffer widget</DT
><DT
><A
HREF="gnomecalculator.html"
>GnomeCalculator</A
> &#8212; Calculator widget.</DT
><DT
><A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> &#8212;   A generic engine for structured graphics.</DT
><DT
><A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvasgroup.html"
>GnomeCanvasGroup</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvasline.html"
>GnomeCanvasLine</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvaspolygon.html"
>GnomeCanvasPolygon</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvasre.html"
>GnomeCanvasRE</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvasrect.html"
>GnomeCanvasRect</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvasellipse.html"
>GnomeCanvasEllipse</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvastext.html"
>GnomeCanvasText</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvasimage.html"
>GnomeCanvasImage</A
> &#8212; </DT
><DT
><A
HREF="gnomecanvaswidget.html"
>GnomeCanvasWidget</A
> &#8212; </DT
><DT
><A
HREF="gnomeclient.html"
>GnomeClient</A
> &#8212; Routines to provide session management support in your application</DT
><DT
><A
HREF="gnomecolorpicker.html"
>GnomeColorPicker</A
> &#8212; Widget for selecting colors.</DT
><DT
><A
HREF="gnomedateedit.html"
>GnomeDateEdit</A
> &#8212; Date and time entry widget.</DT
><DT
><A
HREF="gnomedentryedit.html"
>GnomeDEntryEdit</A
> &#8212; Editing object for dentries (.desktop files)</DT
><DT
><A
HREF="gnomedialog.html"
>GnomeDialog</A
> &#8212; Transient ("popup") dialogs.</DT
><DT
><A
HREF="gnomedockband.html"
>GnomeDockBand</A
> &#8212; A widget implementing dock bands.</DT
><DT
><A
HREF="gnomedockitem.html"
>GnomeDockItem</A
> &#8212; A dockable widget.</DT
><DT
><A
HREF="gnomedock.html"
>GnomeDock</A
> &#8212; A widget supporting movable and detachable widgets.</DT
><DT
><A
HREF="gnomedruid.html"
>GnomeDruid</A
> &#8212;   The main widget of the GNOME druid system.</DT
><DT
><A
HREF="gnomedruidpage.html"
>GnomeDruidPage</A
> &#8212; A virtual widget defining the druid page.</DT
><DT
><A
HREF="gnomedruidpagestart.html"
>GnomeDruidPageStart</A
> &#8212; A GnomeDruidPage for the beginning of a DRUID.</DT
><DT
><A
HREF="gnomedruidpagestandard.html"
>GnomeDruidPageStandard</A
> &#8212; </DT
><DT
><A
HREF="gnomedruidpagefinish.html"
>GnomeDruidPageFinish</A
> &#8212; </DT
><DT
><A
HREF="gnomeentry.html"
>GnomeEntry</A
> &#8212; Entry widget with history tracking.</DT
><DT
><A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> &#8212; An entry widget for file names.</DT
><DT
><A
HREF="gnomefontpicker.html"
>GnomeFontPicker</A
> &#8212; Button that displays current font; click to select new font.</DT
><DT
><A
HREF="gnomefontselector.html"
>GnomeFontSelector</A
> &#8212; Deprecated, use GtkFontSelection in a GnomeDialog or GnomeFontPicker</DT
><DT
><A
HREF="gnomehref.html"
>GnomeHRef</A
> &#8212; A clickable URL button.</DT
><DT
><A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
> &#8212; A widget to select an icon.</DT
><DT
><A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
> &#8212; Canvas item for editable text captions in icon lists.</DT
><DT
><A
HREF="gnomeiconlist.html"
>GnomeIconList</A
> &#8212; A list of icons with captions, with optional caption editing.</DT
><DT
><A
HREF="gnomeiconselection.html"
>GnomeIconSelection</A
> &#8212; An icon listing/chooser display.</DT
><DT
><A
HREF="gnomeless.html"
>GnomeLess</A
> &#8212; Simple file content browser widget.</DT
><DT
><A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
> &#8212; An abstract MDI child class</DT
><DT
><A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> &#8212; A generic <SPAN
CLASS="TYPE"
>GnomeMDI</SPAN
> child</DT
><DT
><A
HREF="gnomemdi.html"
>GnomeMDI</A
> &#8212; GNOME Multiple Document Interface</DT
><DT
><A
HREF="gnomemessagebox.html"
>GnomeMessageBox</A
> &#8212; Message box display routines</DT
><DT
><A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
> &#8212; An entry line for number input.</DT
><DT
><A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> &#8212; </DT
><DT
><A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> &#8212; Entry widget for selection of large images.</DT
><DT
><A
HREF="gnomepixmap.html"
>GnomePixmap</A
> &#8212; A widget to display and load images (pixmaps)</DT
><DT
><A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> &#8212; Standarized dialog box for handling configuration</DT
><DT
><A
HREF="gnomescores.html"
>GnomeScores</A
> &#8212; Dialog box which displays high scores</DT
><DT
><A
HREF="gnomestock.html"
>GnomeStock</A
> &#8212; 50% finished, API-docs not done; Default icons for toolbars, menus and buttons.</DT
><DT
><A
HREF="gtkclock.html"
>GtkClock</A
> &#8212; A small text clock widget, capable of realtime, count-up and count-down modes</DT
><DT
><A
HREF="gtkted.html"
>GtkTed</A
> &#8212; Deprecated.</DT
><DT
><A
HREF="gtkdial.html"
>GtkDial</A
> &#8212; Analog dial widget for number selection.</DT
><DT
><A
HREF="gtkpixmapmenuitem.html"
>GtkPixmapMenuItem</A
> &#8212; A special widget for GNOME menus.</DT
><DT
><A
HREF="gnomespell.html"
>GnomeSpell</A
> &#8212; Deprecated.</DT
><DT
><A
HREF="gnomedocklayout.html"
>GnomeDockLayout</A
> &#8212; A widget for saving and retrieving the layout of a
<SPAN
CLASS="TYPE"
>GnomeDock</SPAN
> widget.</DT
><DT
><A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> &#8212; Gnome Process Bar</DT
></DL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gtkcauldron.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="book1.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="gnomeabout.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
>gtkcauldron</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeAbout</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomePaperSelector</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeNumberEntry"
HREF="gnomenumberentry.html"><LINK
REL="NEXT"
TITLE="GnomePixmapEntry"
HREF="gnomepixmapentry.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomenumberentry.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomepixmapentry.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEPAPERSELECTOR"
>GnomePaperSelector</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN24339"
></A
><H2
>Name</H2
>GnomePaperSelector&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN24342"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomepaperselector.html#GNOMEPAPERSELECTOR-STRUCT"
>GnomePaperSelector</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepaperselector.html#GNOME-PAPER-SELECTOR-NEW"
>gnome_paper_selector_new</A
>        (void);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomepaperselector.html#GNOME-PAPER-SELECTOR-GET-NAME"
>gnome_paper_selector_get_name</A
>   (<A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> *gspaper);
<A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      <A
HREF="gnomepaperselector.html#GNOME-PAPER-SELECTOR-GET-WIDTH"
>gnome_paper_selector_get_width</A
>  (<A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> *gspaper);
<A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      <A
HREF="gnomepaperselector.html#GNOME-PAPER-SELECTOR-GET-HEIGHT"
>gnome_paper_selector_get_height</A
> (<A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> *gspaper);
<A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      <A
HREF="gnomepaperselector.html#GNOME-PAPER-SELECTOR-GET-LEFT-MARGIN"
>gnome_paper_selector_get_left_margin</A
>
                                            (<A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> *gspaper);
<A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      <A
HREF="gnomepaperselector.html#GNOME-PAPER-SELECTOR-GET-RIGHT-MARGIN"
>gnome_paper_selector_get_right_margin</A
>
                                            (<A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> *gspaper);
<A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      <A
HREF="gnomepaperselector.html#GNOME-PAPER-SELECTOR-GET-TOP-MARGIN"
>gnome_paper_selector_get_top_margin</A
>
                                            (<A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> *gspaper);
<A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      <A
HREF="gnomepaperselector.html#GNOME-PAPER-SELECTOR-GET-BOTTOM-MARGIN"
>gnome_paper_selector_get_bottom_margin</A
>
                                            (<A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> *gspaper);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24369"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbox.html
>GtkBox</A>
                     +----<A
HREF=../gtk/gtkvbox.html
>GtkVBox</A>
                           +----GnomePaperSelector</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24377"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24380"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN24382"
></A
><H3
><A
NAME="GNOMEPAPERSELECTOR-STRUCT"
></A
>struct GnomePaperSelector</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomePaperSelector;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24387"
></A
><H3
><A
NAME="GNOME-PAPER-SELECTOR-NEW"
></A
>gnome_paper_selector_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_paper_selector_new        (void);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24393"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24402"
></A
><H3
><A
NAME="GNOME-PAPER-SELECTOR-GET-NAME"
></A
>gnome_paper_selector_get_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_paper_selector_get_name   (<A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> *gspaper);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24409"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gspaper</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24422"
></A
><H3
><A
NAME="GNOME-PAPER-SELECTOR-GET-WIDTH"
></A
>gnome_paper_selector_get_width ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      gnome_paper_selector_get_width  (<A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> *gspaper);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24429"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gspaper</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24442"
></A
><H3
><A
NAME="GNOME-PAPER-SELECTOR-GET-HEIGHT"
></A
>gnome_paper_selector_get_height ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      gnome_paper_selector_get_height (<A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> *gspaper);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24449"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gspaper</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24462"
></A
><H3
><A
NAME="GNOME-PAPER-SELECTOR-GET-LEFT-MARGIN"
></A
>gnome_paper_selector_get_left_margin ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      gnome_paper_selector_get_left_margin
                                            (<A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> *gspaper);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24469"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gspaper</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24482"
></A
><H3
><A
NAME="GNOME-PAPER-SELECTOR-GET-RIGHT-MARGIN"
></A
>gnome_paper_selector_get_right_margin ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      gnome_paper_selector_get_right_margin
                                            (<A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> *gspaper);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24489"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gspaper</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24502"
></A
><H3
><A
NAME="GNOME-PAPER-SELECTOR-GET-TOP-MARGIN"
></A
>gnome_paper_selector_get_top_margin ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      gnome_paper_selector_get_top_margin
                                            (<A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> *gspaper);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24509"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gspaper</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24522"
></A
><H3
><A
NAME="GNOME-PAPER-SELECTOR-GET-BOTTOM-MARGIN"
></A
>gnome_paper_selector_get_bottom_margin ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      gnome_paper_selector_get_bottom_margin
                                            (<A
HREF="gnomepaperselector.html"
>GnomePaperSelector</A
> *gspaper);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24529"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gspaper</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomenumberentry.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomepixmapentry.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
>GnomeNumberEntry</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomePixmapEntry</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomePixmapEntry</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomePaperSelector"
HREF="gnomepaperselector.html"><LINK
REL="NEXT"
TITLE="GnomePixmap"
HREF="gnomepixmap.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomepaperselector.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomepixmap.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEPIXMAPENTRY"
>GnomePixmapEntry</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN24547"
></A
><H2
>Name</H2
>GnomePixmapEntry&nbsp;--&nbsp;Entry widget for selection of large images.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN24550"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomepixmapentry.html#GNOMEPIXMAPENTRY-STRUCT"
>GnomePixmapEntry</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmapentry.html#GNOME-PIXMAP-ENTRY-NEW"
>gnome_pixmap_entry_new</A
>          (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *history_id,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *browse_dialog_title,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> do_preview);
void        <A
HREF="gnomepixmapentry.html#GNOME-PIXMAP-ENTRY-SET-PIXMAP-SUBDIR"
>gnome_pixmap_entry_set_pixmap_subdir</A
>
                                            (<A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> *pentry,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *subdir);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmapentry.html#GNOME-PIXMAP-ENTRY-GNOME-FILE-ENTRY"
>gnome_pixmap_entry_gnome_file_entry</A
>
                                            (<A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> *pentry);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmapentry.html#GNOME-PIXMAP-ENTRY-GNOME-ENTRY"
>gnome_pixmap_entry_gnome_entry</A
>  (<A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> *pentry);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmapentry.html#GNOME-PIXMAP-ENTRY-GTK-ENTRY"
>gnome_pixmap_entry_gtk_entry</A
>    (<A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> *pentry);
void        <A
HREF="gnomepixmapentry.html#GNOME-PIXMAP-ENTRY-SET-PREVIEW"
>gnome_pixmap_entry_set_preview</A
>  (<A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> *pentry,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> do_preview);
void        <A
HREF="gnomepixmapentry.html#GNOME-PIXMAP-ENTRY-SET-PREVIEW-SIZE"
>gnome_pixmap_entry_set_preview_size</A
>
                                            (<A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> *pentry,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> preview_w,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> preview_h);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomepixmapentry.html#GNOME-PIXMAP-ENTRY-GET-FILENAME"
>gnome_pixmap_entry_get_filename</A
> (<A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> *pentry);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24581"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbox.html
>GtkBox</A>
                     +----<A
HREF=../gtk/gtkvbox.html
>GtkVBox</A>
                           +----GnomePixmapEntry</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24589"
></A
><H2
>Description</H2
><P
>  Entry for large images with a preview.  Unlike <A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
>, it does
  not scale the images to a specific size and shows them 1:1.  This is
  perfect for selection of backgrounds and such.  It also allows DND to
  be performed on the preview box.  It also provides all the <A
HREF="gnomeentry.html"
>GnomeEntry</A
>
  functionality as well.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24594"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN24596"
></A
><H3
><A
NAME="GNOMEPIXMAPENTRY-STRUCT"
></A
>struct GnomePixmapEntry</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomePixmapEntry;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24601"
></A
><H3
><A
NAME="GNOME-PIXMAP-ENTRY-NEW"
></A
>gnome_pixmap_entry_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_entry_new          (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *history_id,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *browse_dialog_title,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> do_preview);</PRE
></TD
></TR
></TABLE
><P
>Creates a new pixmap entry widget, if do_preview is false,
the preview is hidden but the files are still loaded so that it's easy
to show it. For a pixmap entry without preview, use the
<A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
> widget..</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24612"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>history_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The id given to <A
HREF="gnomeentry.html#GNOME-ENTRY-NEW"
>gnome_entry_new</A
></TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>browse_dialog_title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Title of the browse dialog</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>do_preview</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> boolean</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New GnomePixmapEntry object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24634"
></A
><H3
><A
NAME="GNOME-PIXMAP-ENTRY-SET-PIXMAP-SUBDIR"
></A
>gnome_pixmap_entry_set_pixmap_subdir ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_pixmap_entry_set_pixmap_subdir
                                            (<A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> *pentry,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *subdir);</PRE
></TD
></TR
></TABLE
><P
>Sets the default path for the file entry. The new
subdirectory should be specified relative to the default GNOME
pixmap directory.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24642"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomePixmapEntry widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>subdir</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Subdirectory</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24655"
></A
><H3
><A
NAME="GNOME-PIXMAP-ENTRY-GNOME-FILE-ENTRY"
></A
>gnome_pixmap_entry_gnome_file_entry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_entry_gnome_file_entry
                                            (<A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> *pentry);</PRE
></TD
></TR
></TABLE
><P
>Get the GnomeFileEntry component of the
GnomePixmapEntry widget for lower-level manipulation.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24663"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomePixmapEntry widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeFileEntry widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24676"
></A
><H3
><A
NAME="GNOME-PIXMAP-ENTRY-GNOME-ENTRY"
></A
>gnome_pixmap_entry_gnome_entry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_entry_gnome_entry  (<A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> *pentry);</PRE
></TD
></TR
></TABLE
><P
>Get the GnomeEntry component of the
GnomePixmapEntry widget for lower-level manipulation.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24684"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomePixmapEntry widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GnomeEntry widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24697"
></A
><H3
><A
NAME="GNOME-PIXMAP-ENTRY-GTK-ENTRY"
></A
>gnome_pixmap_entry_gtk_entry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_entry_gtk_entry    (<A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> *pentry);</PRE
></TD
></TR
></TABLE
><P
>Get the GtkEntry component of the
GnomePixmapEntry for Gtk+-level manipulation.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24705"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomePixmapEntry widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GtkEntry widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24718"
></A
><H3
><A
NAME="GNOME-PIXMAP-ENTRY-SET-PREVIEW"
></A
>gnome_pixmap_entry_set_preview ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_pixmap_entry_set_preview  (<A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> *pentry,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> do_preview);</PRE
></TD
></TR
></TABLE
><P
>Sets whether or not previews of the currently selected 
pixmap should be shown in the file selector.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24726"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomePixmapEntry widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>do_preview</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> to show previews, <TT
CLASS="LITERAL"
>FALSE</TT
> to hide.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24741"
></A
><H3
><A
NAME="GNOME-PIXMAP-ENTRY-SET-PREVIEW-SIZE"
></A
>gnome_pixmap_entry_set_preview_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_pixmap_entry_set_preview_size
                                            (<A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> *pentry,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> preview_w,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> preview_h);</PRE
></TD
></TR
></TABLE
><P
>Sets the minimum size of the preview frame in pixels.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24750"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomePixmapEntry widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>preview_w</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Preview width in pixels</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>preview_h</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Preview height in pixels</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24767"
></A
><H3
><A
NAME="GNOME-PIXMAP-ENTRY-GET-FILENAME"
></A
>gnome_pixmap_entry_get_filename ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_pixmap_entry_get_filename (<A
HREF="gnomepixmapentry.html"
>GnomePixmapEntry</A
> *pentry);</PRE
></TD
></TR
></TABLE
><P
>Gets the filename of the image if the preview
successfully loaded.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24775"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pentry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomePixmapEntry widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Newly allocated string containing path, or <TT
CLASS="LITERAL"
>NULL</TT
> on error. </TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24789"
></A
><H2
>See Also</H2
><P
>  <A
HREF="gnomeentry.html"
>GnomeEntry</A
>, <A
HREF="gnomefileentry.html"
>GnomeFileEntry</A
>, <A
HREF="gnomeiconentry.html"
>GnomeIconEntry</A
>, <A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomepaperselector.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomepixmap.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
>GnomePaperSelector</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomePixmap</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomePixmap</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomePixmapEntry"
HREF="gnomepixmapentry.html"><LINK
REL="NEXT"
TITLE="GnomePropertyBox"
HREF="gnomepropertybox.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomepixmapentry.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomepropertybox.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEPIXMAP"
>GnomePixmap</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN24801"
></A
><H2
>Name</H2
>GnomePixmap&nbsp;--&nbsp;A widget to display and load images (pixmaps)</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN24804"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomepixmap.html#GNOMEPIXMAP-STRUCT"
>GnomePixmap</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmap.html#GNOME-PIXMAP-NEW-FROM-FILE"
>gnome_pixmap_new_from_file</A
>      (const char *filename);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmap.html#GNOME-PIXMAP-NEW-FROM-FILE-AT-SIZE"
>gnome_pixmap_new_from_file_at_size</A
>
                                            (const char *filename,
                                             int width,
                                             int height);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmap.html#GNOME-PIXMAP-NEW-FROM-XPM-D"
>gnome_pixmap_new_from_xpm_d</A
>     (char **xpm_data);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmap.html#GNOME-PIXMAP-NEW-FROM-XPM-D-AT-SIZE"
>gnome_pixmap_new_from_xpm_d_at_size</A
>
                                            (char **xpm_data,
                                             int width,
                                             int height);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmap.html#GNOME-PIXMAP-NEW-FROM-RGB-D"
>gnome_pixmap_new_from_rgb_d</A
>     (unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmap.html#GNOME-PIXMAP-NEW-FROM-RGB-D-SHAPED"
>gnome_pixmap_new_from_rgb_d_shaped</A
>
                                            (unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height,
                                             GdkImlibColor *shape_color);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmap.html#GNOME-PIXMAP-NEW-FROM-RGB-D-SHAPED-AT-SIZE"
>gnome_pixmap_new_from_rgb_d_shaped_at_size</A
>
                                            (unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height,
                                             int width,
                                             int height,
                                             GdkImlibColor *shape_color);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmap.html#GNOME-PIXMAP-NEW-FROM-RGB-D-AT-SIZE"
>gnome_pixmap_new_from_rgb_d_at_size</A
>
                                            (unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height,
                                             int width,
                                             int height);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmap.html#GNOME-PIXMAP-NEW-FROM-GNOME-PIXMAP"
>gnome_pixmap_new_from_gnome_pixmap</A
>
                                            (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmap.html#GNOME-PIXMAP-NEW-FROM-IMLIB"
>gnome_pixmap_new_from_imlib</A
>     (GdkImlibImage *im);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepixmap.html#GNOME-PIXMAP-NEW-FROM-IMLIB-AT-SIZE"
>gnome_pixmap_new_from_imlib_at_size</A
>
                                            (GdkImlibImage *im,
                                             int width,
                                             int height);
void        <A
HREF="gnomepixmap.html#GNOME-PIXMAP-LOAD-FILE"
>gnome_pixmap_load_file</A
>          (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             const char *filename);
void        <A
HREF="gnomepixmap.html#GNOME-PIXMAP-LOAD-FILE-AT-SIZE"
>gnome_pixmap_load_file_at_size</A
>  (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             const char *filename,
                                             int width,
                                             int height);
void        <A
HREF="gnomepixmap.html#GNOME-PIXMAP-LOAD-XPM-D"
>gnome_pixmap_load_xpm_d</A
>         (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             char **xpm_data);
void        <A
HREF="gnomepixmap.html#GNOME-PIXMAP-LOAD-XPM-D-AT-SIZE"
>gnome_pixmap_load_xpm_d_at_size</A
> (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             char **xpm_data,
                                             int width,
                                             int height);
void        <A
HREF="gnomepixmap.html#GNOME-PIXMAP-LOAD-RGB-D"
>gnome_pixmap_load_rgb_d</A
>         (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height);
void        <A
HREF="gnomepixmap.html#GNOME-PIXMAP-LOAD-RGB-D-SHAPED"
>gnome_pixmap_load_rgb_d_shaped</A
>  (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height,
                                             GdkImlibColor *shape_color);
void        <A
HREF="gnomepixmap.html#GNOME-PIXMAP-LOAD-RGB-D-SHAPED-AT-SIZE"
>gnome_pixmap_load_rgb_d_shaped_at_size</A
>
                                            (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height,
                                             int width,
                                             int height,
                                             GdkImlibColor *shape_color);
void        <A
HREF="gnomepixmap.html#GNOME-PIXMAP-LOAD-RGB-D-AT-SIZE"
>gnome_pixmap_load_rgb_d_at_size</A
> (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height,
                                             int width,
                                             int height);
void        <A
HREF="gnomepixmap.html#GNOME-PIXMAP-LOAD-IMLIB"
>gnome_pixmap_load_imlib</A
>         (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             GdkImlibImage *im);
void        <A
HREF="gnomepixmap.html#GNOME-PIXMAP-LOAD-IMLIB-AT-SIZE"
>gnome_pixmap_load_imlib_at_size</A
> (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             GdkImlibImage *im,
                                             int width,
                                             int height);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24859"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----GnomePixmap</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24864"
></A
><H2
>Description</H2
><P
>    This widget can display an image created or provided by a number
    of sources (a file from various supported file formats, memory,
    in-memory-xpm, Imlib handle, RGB buffer) and it can scale the
    image during the load process.
  </P
><P
>    The <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget is particularly useful, as it load an
    image and provides it as a <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>.  While doing this, it does
    also make sure that the visuals and colormaps are correctly set so
    that the application will work properly on multi-depth display
    machines. 
  </P
><P
>    You should use this widget instead of the less powerful and more
    error-prone GtkPixmap widget.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24871"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN24873"
></A
><H3
><A
NAME="GNOMEPIXMAP-STRUCT"
></A
>struct GnomePixmap</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomePixmap;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24878"
></A
><H3
><A
NAME="GNOME-PIXMAP-NEW-FROM-FILE"
></A
>gnome_pixmap_new_from_file ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_new_from_file      (const char *filename);</PRE
></TD
></TR
></TABLE
><P
>Returns a widget that contains the image, or <TT
CLASS="LITERAL"
>NULL</TT
>
if it fails to load the image.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24886"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>filename</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The name of a file containing a graphics image</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A new <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget or <TT
CLASS="LITERAL"
>NULL</TT
></TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24901"
></A
><H3
><A
NAME="GNOME-PIXMAP-NEW-FROM-FILE-AT-SIZE"
></A
>gnome_pixmap_new_from_file_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_new_from_file_at_size
                                            (const char *filename,
                                             int width,
                                             int height);</PRE
></TD
></TR
></TABLE
><P
>Returns a widget that contains the image scaled to
<TT
CLASS="PARAMETER"
><I
>width</I
></TT
> by <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> pixels, or <TT
CLASS="LITERAL"
>NULL</TT
> if it fails to load the image.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24911"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>filename</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The name of a file containing a graphics image</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired width</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired height.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A new <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget or <TT
CLASS="LITERAL"
>NULL</TT
></TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24934"
></A
><H3
><A
NAME="GNOME-PIXMAP-NEW-FROM-XPM-D"
></A
>gnome_pixmap_new_from_xpm_d ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_new_from_xpm_d     (char **xpm_data);</PRE
></TD
></TR
></TABLE
><P
>Returns a widget that contains the image, or <TT
CLASS="LITERAL"
>NULL</TT
>
if it fails to load the image.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24942"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>xpm_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to an inlined xpm image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A new <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget or <TT
CLASS="LITERAL"
>NULL</TT
></TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24957"
></A
><H3
><A
NAME="GNOME-PIXMAP-NEW-FROM-XPM-D-AT-SIZE"
></A
>gnome_pixmap_new_from_xpm_d_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_new_from_xpm_d_at_size
                                            (char **xpm_data,
                                             int width,
                                             int height);</PRE
></TD
></TR
></TABLE
><P
>Returns a widget that contains the image scaled to
<TT
CLASS="PARAMETER"
><I
>width</I
></TT
> by <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> pixels, or <TT
CLASS="LITERAL"
>NULL</TT
> if it fails to load the image.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24967"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>xpm_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to an inlined xpm image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired widht</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired height.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A new <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget or <TT
CLASS="LITERAL"
>NULL</TT
></TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24990"
></A
><H3
><A
NAME="GNOME-PIXMAP-NEW-FROM-RGB-D"
></A
>gnome_pixmap_new_from_rgb_d ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_new_from_rgb_d     (unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height);</PRE
></TD
></TR
></TABLE
><P
>Returns a widget that contains the image, or <TT
CLASS="LITERAL"
>NULL</TT
>
if it fails to load the image.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24998"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to an inlined rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>alpha</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A new <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget or <TT
CLASS="LITERAL"
>NULL</TT
></TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25025"
></A
><H3
><A
NAME="GNOME-PIXMAP-NEW-FROM-RGB-D-SHAPED"
></A
>gnome_pixmap_new_from_rgb_d_shaped ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_new_from_rgb_d_shaped
                                            (unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height,
                                             GdkImlibColor *shape_color);</PRE
></TD
></TR
></TABLE
><P
>Returns a widget that contains the image, or <TT
CLASS="LITERAL"
>NULL</TT
>
if it fails to load the image.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25034"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to an inlined rgb image</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>alpha</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pointer to the alpha channel.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> width of the rgb data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> height of the rgb data.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>shape_color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> which color encodes the transparency</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A new <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget or <TT
CLASS="LITERAL"
>NULL</TT
></TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25065"
></A
><H3
><A
NAME="GNOME-PIXMAP-NEW-FROM-RGB-D-SHAPED-AT-SIZE"
></A
>gnome_pixmap_new_from_rgb_d_shaped_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_new_from_rgb_d_shaped_at_size
                                            (unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height,
                                             int width,
                                             int height,
                                             GdkImlibColor *shape_color);</PRE
></TD
></TR
></TABLE
><P
>Returns a widget that contains the image scaled to
<TT
CLASS="PARAMETER"
><I
>width</I
></TT
> by <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> pixels, or <TT
CLASS="LITERAL"
>NULL</TT
> if it fails to load the image.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25076"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to an inlined rgb image</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>alpha</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pointer to the alpha channel.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> width of the rgb data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> height of the rgb data.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired width.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired height.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>shape_color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> which color encodes the transparency</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A new <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget or <TT
CLASS="LITERAL"
>NULL</TT
></TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25115"
></A
><H3
><A
NAME="GNOME-PIXMAP-NEW-FROM-RGB-D-AT-SIZE"
></A
>gnome_pixmap_new_from_rgb_d_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_new_from_rgb_d_at_size
                                            (unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height,
                                             int width,
                                             int height);</PRE
></TD
></TR
></TABLE
><P
>Returns a widget that contains the image scaled to
<TT
CLASS="PARAMETER"
><I
>width</I
></TT
> by <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> pixels, or <TT
CLASS="LITERAL"
>NULL</TT
> if it fails to load the image.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25125"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to an inlined rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>alpha</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the width of the rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the height of the rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired width.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired height.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A new <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget or <TT
CLASS="LITERAL"
>NULL</TT
></TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25160"
></A
><H3
><A
NAME="GNOME-PIXMAP-NEW-FROM-GNOME-PIXMAP"
></A
>gnome_pixmap_new_from_gnome_pixmap ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_new_from_gnome_pixmap
                                            (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap);</PRE
></TD
></TR
></TABLE
><P
>Returns a widget that contains a copy of <TT
CLASS="PARAMETER"
><I
>gpixmap_old</I
></TT
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25169"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gpixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A new <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25183"
></A
><H3
><A
NAME="GNOME-PIXMAP-NEW-FROM-IMLIB"
></A
>gnome_pixmap_new_from_imlib ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_new_from_imlib     (GdkImlibImage *im);</PRE
></TD
></TR
></TABLE
><P
>Returns a widget that contains the image, or <TT
CLASS="LITERAL"
>NULL</TT
>
if it fails to load the image. Note that <TT
CLASS="PARAMETER"
><I
>im</I
></TT
> will not be
rendered after this call.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25193"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>im</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to GdkImlibImage data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A new <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget or <TT
CLASS="LITERAL"
>NULL</TT
></TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25208"
></A
><H3
><A
NAME="GNOME-PIXMAP-NEW-FROM-IMLIB-AT-SIZE"
></A
>gnome_pixmap_new_from_imlib_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_new_from_imlib_at_size
                                            (GdkImlibImage *im,
                                             int width,
                                             int height);</PRE
></TD
></TR
></TABLE
><P
>Returns a widget that contains the image scaled to
<TT
CLASS="PARAMETER"
><I
>width</I
></TT
> by <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> pixels, or <TT
CLASS="LITERAL"
>NULL</TT
> if it fails to load the image.
Note that <TT
CLASS="PARAMETER"
><I
>im</I
></TT
> will not be * rendered after this call.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25220"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>im</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to GdkImlibImage data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired width.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired height.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A new <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget or <TT
CLASS="LITERAL"
>NULL</TT
></TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25243"
></A
><H3
><A
NAME="GNOME-PIXMAP-LOAD-FILE"
></A
>gnome_pixmap_load_file ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_pixmap_load_file          (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             const char *filename);</PRE
></TD
></TR
></TABLE
><P
>Sets the gnome pixmap to image stored
in <TT
CLASS="PARAMETER"
><I
>filename</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25251"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gpixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>filename</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a new filename</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25265"
></A
><H3
><A
NAME="GNOME-PIXMAP-LOAD-FILE-AT-SIZE"
></A
>gnome_pixmap_load_file_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_pixmap_load_file_at_size  (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             const char *filename,
                                             int width,
                                             int height);</PRE
></TD
></TR
></TABLE
><P
>Sets the gnome pixmap to image stored in
<TT
CLASS="PARAMETER"
><I
>filename</I
></TT
> scaled to <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> pixels.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25275"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gpixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>filename</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a new filename</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired width.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired height.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25297"
></A
><H3
><A
NAME="GNOME-PIXMAP-LOAD-XPM-D"
></A
>gnome_pixmap_load_xpm_d ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_pixmap_load_xpm_d         (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             char **xpm_data);</PRE
></TD
></TR
></TABLE
><P
>Sets the gnome pixmap to image stored in <TT
CLASS="PARAMETER"
><I
>xpm_data</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25305"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gpixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>xpm_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> xpm image data</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25319"
></A
><H3
><A
NAME="GNOME-PIXMAP-LOAD-XPM-D-AT-SIZE"
></A
>gnome_pixmap_load_xpm_d_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_pixmap_load_xpm_d_at_size (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             char **xpm_data,
                                             int width,
                                             int height);</PRE
></TD
></TR
></TABLE
><P
>Sets the gnome pixmap to image stored in
<TT
CLASS="PARAMETER"
><I
>xpm_data</I
></TT
> scaled to <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> pixels.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25329"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gpixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>xpm_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> xpm image data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired width.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired height.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25351"
></A
><H3
><A
NAME="GNOME-PIXMAP-LOAD-RGB-D"
></A
>gnome_pixmap_load_rgb_d ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_pixmap_load_rgb_d         (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height);</PRE
></TD
></TR
></TABLE
><P
>Sets the gnome pixmap to the image.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25358"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gpixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to an inlined rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>alpha</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the width of the rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the height of the rgb image.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25384"
></A
><H3
><A
NAME="GNOME-PIXMAP-LOAD-RGB-D-SHAPED"
></A
>gnome_pixmap_load_rgb_d_shaped ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_pixmap_load_rgb_d_shaped  (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height,
                                             GdkImlibColor *shape_color);</PRE
></TD
></TR
></TABLE
><P
>Sets the gnome pixmap to the image.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25392"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gpixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to an inlined rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>alpha</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the width of the rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the height of the rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>shape_color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> which color encodes the transparency</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25422"
></A
><H3
><A
NAME="GNOME-PIXMAP-LOAD-RGB-D-SHAPED-AT-SIZE"
></A
>gnome_pixmap_load_rgb_d_shaped_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_pixmap_load_rgb_d_shaped_at_size
                                            (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height,
                                             int width,
                                             int height,
                                             GdkImlibColor *shape_color);</PRE
></TD
></TR
></TABLE
><P
>Sets the gnome pixmap to the image scaled to
<TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> pixels.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25432"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gpixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to an inlined rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>alpha</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the width of the rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the height of the rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired width.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired height.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>shape_color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> which color encodes the transparency</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25470"
></A
><H3
><A
NAME="GNOME-PIXMAP-LOAD-RGB-D-AT-SIZE"
></A
>gnome_pixmap_load_rgb_d_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_pixmap_load_rgb_d_at_size (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             unsigned char *data,
                                             unsigned char *alpha,
                                             int rgb_width,
                                             int rgb_height,
                                             int width,
                                             int height);</PRE
></TD
></TR
></TABLE
><P
>Sets the gnome pixmap to the image scaled to
<TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> pixels.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25479"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gpixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to an inlined rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>alpha</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the width of the rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgb_height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the height of the rgb image.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired width.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired height.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25513"
></A
><H3
><A
NAME="GNOME-PIXMAP-LOAD-IMLIB"
></A
>gnome_pixmap_load_imlib ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_pixmap_load_imlib         (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             GdkImlibImage *im);</PRE
></TD
></TR
></TABLE
><P
>Sets the gnome pixmap to image stored in <TT
CLASS="PARAMETER"
><I
>im</I
></TT
>. Note
that <TT
CLASS="PARAMETER"
><I
>im</I
></TT
> will not be rendered after this call.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25523"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gpixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>im</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to GdkImlibImage data</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25537"
></A
><H3
><A
NAME="GNOME-PIXMAP-LOAD-IMLIB-AT-SIZE"
></A
>gnome_pixmap_load_imlib_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_pixmap_load_imlib_at_size (<A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *gpixmap,
                                             GdkImlibImage *im,
                                             int width,
                                             int height);</PRE
></TD
></TR
></TABLE
><P
>Sets the gnome pixmap to image stored in <TT
CLASS="PARAMETER"
><I
>im</I
></TT
>
scaled to <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> pixels. Note that <TT
CLASS="PARAMETER"
><I
>im</I
></TT
> will not
be rendered after this call.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25549"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gpixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>im</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to GdkImlibImage data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired width.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> desired height.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN25571"
></A
><H2
>See Also</H2
><P
>    GdkImlib</P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomepixmapentry.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomepropertybox.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
>GnomePixmapEntry</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomePropertyBox</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeProcBar</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeDockLayout"
HREF="gnomedocklayout.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedocklayout.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
>&nbsp;</TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEPROCBAR"
>GnomeProcBar</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN29031"
></A
><H2
>Name</H2
>GnomeProcBar&nbsp;--&nbsp;Gnome Process Bar</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN29034"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeprocbar.html#GNOMEPROCBAR-STRUCT"
>GnomeProcBar</A
>;
#define     <A
HREF="gnomeprocbar.html#GNOME-PROC-BAR--CLASS-CAPS"
>GNOME_PROC_BAR__CLASS</A
>           (klass)
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeprocbar.html#GNOME-PROC-BAR-NEW"
>gnome_proc_bar_new</A
>              (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *label,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> n,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *colors,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> (*cb) ());
void        <A
HREF="gnomeprocbar.html#GNOME-PROC-BAR-SET-VALUES"
>gnome_proc_bar_set_values</A
>       (<A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> *pb,
                                             const <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> val[]);
void        <A
HREF="gnomeprocbar.html#GNOME-PROC-BAR-SET-ORIENT"
>gnome_proc_bar_set_orient</A
>       (<A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> *pb,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> vertical);
void        <A
HREF="gnomeprocbar.html#GNOME-PROC-BAR-START"
>gnome_proc_bar_start</A
>            (<A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> *pb,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> gtime,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
void        <A
HREF="gnomeprocbar.html#GNOME-PROC-BAR-STOP"
>gnome_proc_bar_stop</A
>             (<A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> *pb);
void        <A
HREF="gnomeprocbar.html#GNOME-PROC-BAR-UPDATE"
>gnome_proc_bar_update</A
>           (<A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> *pb,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *colors);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN29060"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbox.html
>GtkBox</A>
                     +----<A
HREF=../gtk/gtkhbox.html
>GtkHBox</A>
                           +----GnomeProcBar</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN29068"
></A
><H2
>Description</H2
><P
>The GnomeProcBar widget is used to display load graphs like cpu usage, memory
and swap load. It is for instance used in the cpumemusage applet and in GTop.&#13;</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN29071"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN29073"
></A
><H3
><A
NAME="GNOMEPROCBAR-STRUCT"
></A
>struct GnomeProcBar</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeProcBar;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN29078"
></A
><H3
><A
NAME="GNOME-PROC-BAR--CLASS-CAPS"
></A
>GNOME_PROC_BAR__CLASS()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_PROC_BAR__CLASS(klass)   (GTK_CHECK_CLASS_CAST ((klass), GNOME_TYPE_PROC_BAR, GnomeProcBarClass))</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN29083"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>klass</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN29092"
></A
><H3
><A
NAME="GNOME-PROC-BAR-NEW"
></A
>gnome_proc_bar_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_proc_bar_new              (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *label,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> n,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *colors,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> (*cb) ());</PRE
></TD
></TR
></TABLE
><P
>Creates a new Gnome Process Bar with <TT
CLASS="PARAMETER"
><I
>n</I
></TT
> items with the
colors of <TT
CLASS="PARAMETER"
><I
>colors</I
></TT
>. To do automatic updating, you set the <TT
CLASS="PARAMETER"
><I
>cb</I
></TT
> to a function
which takes a single void pointer as an argument and returns <TT
CLASS="LITERAL"
>TRUE</TT
> or <TT
CLASS="LITERAL"
>FALSE</TT
>.
When it returns <TT
CLASS="LITERAL"
>FALSE</TT
> the timer stops running and the function stops getting
called. You need to call <A
HREF="gnomeprocbar.html#GNOME-PROC-BAR-START"
>gnome_proc_bar_start</A
> with the time interval and
the data argument that will be passed to the callback to actually start
executing the timer.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN29110"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Either <TT
CLASS="LITERAL"
>NULL</TT
> or a <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> that will be shown at the left
side of the process bar.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>n</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of items.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>colors</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to an array of <TT
CLASS="PARAMETER"
><I
>n</I
></TT
> <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> elements.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function to update the process bar.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The newly created <A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN29140"
></A
><H3
><A
NAME="GNOME-PROC-BAR-SET-VALUES"
></A
>gnome_proc_bar_set_values ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_proc_bar_set_values       (<A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> *pb,
                                             const <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> val[]);</PRE
></TD
></TR
></TABLE
><P
>Set the values of <TT
CLASS="PARAMETER"
><I
>pb</I
></TT
> to <TT
CLASS="PARAMETER"
><I
>val</I
></TT
> and redraw it. You will
probably call this function in the callback to update the values.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN29150"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to a <A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>Param2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN29164"
></A
><H3
><A
NAME="GNOME-PROC-BAR-SET-ORIENT"
></A
>gnome_proc_bar_set_orient ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_proc_bar_set_orient       (<A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> *pb,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> vertical);</PRE
></TD
></TR
></TABLE
><P
>Sets the orientation of <TT
CLASS="PARAMETER"
><I
>pb</I
></TT
> to vertical if
<TT
CLASS="PARAMETER"
><I
>vertical</I
></TT
> is <TT
CLASS="LITERAL"
>TRUE</TT
> or to horizontal if <TT
CLASS="PARAMETER"
><I
>vertical</I
></TT
> is <TT
CLASS="LITERAL"
>FALSE</TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN29177"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to a <A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>vertical</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if vertical <TT
CLASS="LITERAL"
>FALSE</TT
> if horizontal</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN29193"
></A
><H3
><A
NAME="GNOME-PROC-BAR-START"
></A
>gnome_proc_bar_start ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_proc_bar_start            (<A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> *pb,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> gtime,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Start a timer, and call the callback that was set
on <A
HREF="gnomeprocbar.html#GNOME-PROC-BAR-NEW"
>gnome_proc_bar_new</A
> with the <TT
CLASS="PARAMETER"
><I
>data</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN29204"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to a <A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gtime</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> time interval in ms</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> data to the callback</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN29222"
></A
><H3
><A
NAME="GNOME-PROC-BAR-STOP"
></A
>gnome_proc_bar_stop ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_proc_bar_stop             (<A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> *pb);</PRE
></TD
></TR
></TABLE
><P
>Stop running the callback in the timer.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN29229"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to a <A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> object</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN29239"
></A
><H3
><A
NAME="GNOME-PROC-BAR-UPDATE"
></A
>gnome_proc_bar_update ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_proc_bar_update           (<A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> *pb,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *colors);</PRE
></TD
></TR
></TABLE
><P
>Update <TT
CLASS="PARAMETER"
><I
>pb</I
></TT
> with <TT
CLASS="PARAMETER"
><I
>colors</I
></TT
>. <TT
CLASS="PARAMETER"
><I
>pb</I
></TT
> is not redrawn,
it is only redrawn when you call <A
HREF="gnomeprocbar.html#GNOME-PROC-BAR-SET-VALUES"
>gnome_proc_bar_set_values</A
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN29251"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to a <A
HREF="gnomeprocbar.html"
>GnomeProcBar</A
> object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>colors</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to an array of <TT
CLASS="PARAMETER"
><I
>pb</I
></TT
>-&gt;n <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> elements</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomedocklayout.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
>&nbsp;</TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeDockLayout</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
>&nbsp;</TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomePropertyBox</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomePixmap"
HREF="gnomepixmap.html"><LINK
REL="NEXT"
TITLE="GnomeScores"
HREF="gnomescores.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomepixmap.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomescores.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEPROPERTYBOX"
>GnomePropertyBox</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN25579"
></A
><H2
>Name</H2
>GnomePropertyBox&nbsp;--&nbsp;Standarized dialog box for handling configuration</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN25582"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomepropertybox.html#GNOMEPROPERTYBOX-STRUCT"
>GnomePropertyBox</A
>;
#define     <A
HREF="gnomepropertybox.html#GNOME-PROPERTY-BOX-DIRTY-CAPS"
>GNOME_PROPERTY_BOX_DIRTY</A
>
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomepropertybox.html#GNOME-PROPERTY-BOX-NEW"
>gnome_property_box_new</A
>          (void);
void        <A
HREF="gnomepropertybox.html#GNOME-PROPERTY-BOX-CHANGED"
>gnome_property_box_changed</A
>      (<A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> *property_box);
void        <A
HREF="gnomepropertybox.html#GNOME-PROPERTY-BOX-SET-STATE"
>gnome_property_box_set_state</A
>    (<A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> *property_box,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> state);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomepropertybox.html#GNOME-PROPERTY-BOX-APPEND-PAGE"
>gnome_property_box_append_page</A
>  (<A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> *property_box,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *child,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *tab_label);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN25599"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----<A
HREF=../gtk/gtkwindow.html
>GtkWindow</A>
                           +----<A
HREF="gnomedialog.html"
>GnomeDialog</A
>
                                 +----GnomePropertyBox</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN25608"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomepropertybox.html#GNOMEPROPERTYBOX-APPLY"
>apply</A
>&quot;     void        user_function      (<A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> *propertybox,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomepropertybox.html#GNOMEPROPERTYBOX-HELP"
>help</A
>&quot;      void        user_function      (<A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> *propertybox,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN25619"
></A
><H2
>Description</H2
><P
>    The <SPAN
CLASS="TYPE"
>GnomePropertyBox</SPAN
> widget simplifies coding a
    consistent dialog box for configuring properties of any kind.
  </P
><P
>    The <SPAN
CLASS="TYPE"
>GnomePropertyBox</SPAN
> is a toplevel widget (it will
    create its own window), inside it contains a <SPAN
CLASS="TYPE"
>GtkNotebook</SPAN
>
    which is used to hold the various property pages.
  </P
><P
>    The box will include ok, cancel, apply and help buttons (the
    actual buttons depends on the settings the user has, for example,
    apply can be hidden).  The ok and apply buttons will start up in
    non-sensitive state, the programmer needs to configure the widgets
    inserted into the property box to inform the widget of any state
    changes to enable the ok and apply buttons.  This is done by
    calling the <A
HREF="gnomepropertybox.html#GNOME-PROPERTY-BOX-CHANGED"
>gnome_property_box_changed</A
>() function.
  </P
><P
>    To use this widget, you create the widget using
    <A
HREF="gnomepropertybox.html#GNOME-PROPERTY-BOX-NEW"
>gnome_property_box_new</A
>() and then you call
    <A
HREF="gnomepropertybox.html#GNOME-PROPERTY-BOX-APPEND-PAGE"
>gnome_property_box_append_page</A
>() for each property page you want
    in the property box.
  </P
><P
>    The widget emits two signals: "apply" and "help".  To make a
    functional dialog box you will want to connect to at least the
    "apply" signal. Your function will be invoked once for each page
    and one more time at the end, passing a special value of -1 for
    the page number.
  </P
><P
>Here is a sample callback routine layout

    <DIV
CLASS="EXAMPLE"
><A
NAME="AEN25633"
></A
><P
><B
>Example 1. Sample callback for the "apply" signal</B
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void
dialog_apply_callback (GnomePropertyBox *property_box, gint page_num)
{
        switch (page_num){
	case 0:
	        apply_changes_page_0 (property_box);
		break;
	case 1:
	        apply_changes_page_1 (property_box);
		break;
	default:
	}
}
      </PRE
></TD
></TR
></TABLE
></DIV
>
  </P
><P
>Some people just check for the last condition like this:
    <DIV
CLASS="EXAMPLE"
><A
NAME="AEN25637"
></A
><P
><B
>Example 2. Sample callback for the "apply" signal</B
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void
dialog_apply_callback (GnomePropertyBox *property_box, gint page_num)
{
        if (page_num != -1)
                return;

        apply_all_changes (property_box);
}
      </PRE
></TD
></TR
></TABLE
></DIV
>
  </P
><P
>    A fully finished program should also hook up to the "help" signal
    to provide context sensitive help in the dialog box.  This signal
    also receives the page number in which the help is invoked, so you
    can provide different help nodes for each page if you desire to do
    so.
  </P
><P
>    The GNOME libraries include a number of helper routines that will
    help you provide help in your application.  Here is a sample piece
    of code:

    <DIV
CLASS="EXAMPLE"
><A
NAME="AEN25642"
></A
><P
><B
>Example 3. Sample callback for the "help" signal</B
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void
dialog_help_callback (GnomePropertyBox *property_box, gint page_num)
{
        GnomeHelpMenuEntry help_entry_page_0 = { "application-id", "page-0-help" };
	GnomeHelpMenuEntry help_entry_page_1 = { "application-id", "page-1-help" };

	switch (page_num){
	case 0:
	       gnome_help_display (0, help_entry_page_0);
	       break;

	case 1:
	       gnome_help_display (0, help_entry_page_1);
	       break;
        }
}
      </PRE
></TD
></TR
></TABLE
></DIV
>

    The value "0" in the example above is ignored by the
    gnome_help_display routines.  This is done so that you can use a
    hack to connect to help in simpler situations without having to
    provide a full callback (like in this example).
  </P
><P
>    You can actually save some time if you use the
    <A
HREF=../gnome/gnome-gnome-help.html#GNOME-HELP-PBOX-DISPLAY
>gnome_help_pbox_display</A>() routine.  This routine is designed to
    work side-by-side with the <SPAN
CLASS="TYPE"
>GnomePropertyBox</SPAN
> object.
    It works like this:

    <DIV
CLASS="EXAMPLE"
><A
NAME="AEN25648"
></A
><P
><B
>Example 4. Connecting the "help" signal using the
	<A
HREF=../gnome/gnome-gnome-help.html#GNOME-HELP-PBOX-DISPLAY
>gnome_help_pbox_display</A>() routine</B
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void
property_dialog_do_connections (GnomePropertyBox *property_box)
{
        static GnomeHelpMenuEntry help_entry = { "application-id", "base-name" };

	gtk_signal_connect (GTK_OBJECT (property_box), "help",
	                    GTK_SIGNAL_FUNC(gnome_help_pbox_display), &amp;help_entry);
}
      </PRE
></TD
></TR
></TABLE
></DIV
>

    This will use the "base-name" as a template to create the
    fully-qualified name of the help file using the page number as
    part of the filename component (the result is in the form
    "base-name-$pagenum.html", where $pagenum is substituted with the
    page number).
  </P
><P
>    See the documentation for <A
HREF=../gnome/gnome-gnome-help.html#GNOME-HELP-PBOX-DISPLAY
>gnome_help_pbox_display</A>() for more information
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN25654"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN25656"
></A
><H3
><A
NAME="GNOMEPROPERTYBOX-STRUCT"
></A
>struct GnomePropertyBox</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomePropertyBox;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25661"
></A
><H3
><A
NAME="GNOME-PROPERTY-BOX-DIRTY-CAPS"
></A
>GNOME_PROPERTY_BOX_DIRTY</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_PROPERTY_BOX_DIRTY	"gnome_property_box_dirty"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25666"
></A
><H3
><A
NAME="GNOME-PROPERTY-BOX-NEW"
></A
>gnome_property_box_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_property_box_new          (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a new GnomePropertyBox widget.  The PropertyBox widget
is useful for making consistent configuration dialog boxes.</P
><P
>When a setting has been made to a property in the PropertyBox
your program needs to invoke the gnome_property_box_changed to signal
a change (this will enable the Ok/Apply buttons).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25674"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a newly created GnomePropertyBox widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25683"
></A
><H3
><A
NAME="GNOME-PROPERTY-BOX-CHANGED"
></A
>gnome_property_box_changed ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_property_box_changed      (<A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> *property_box);</PRE
></TD
></TR
></TABLE
><P
>When a setting has changed, the code needs to invoke this routine
to make the Ok/Apply buttons sensitive.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25690"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>property_box</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomePropertyBox that contains the changed data</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25699"
></A
><H3
><A
NAME="GNOME-PROPERTY-BOX-SET-STATE"
></A
>gnome_property_box_set_state ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_property_box_set_state    (<A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> *property_box,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> state);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25706"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>property_box</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>state</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25719"
></A
><H3
><A
NAME="GNOME-PROPERTY-BOX-APPEND-PAGE"
></A
>gnome_property_box_append_page ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_property_box_append_page  (<A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> *property_box,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *child,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *tab_label);</PRE
></TD
></TR
></TABLE
><P
>Appends a new page to the GnomePropertyBox.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25729"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>property_box</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The property box where we are inserting a new page</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>        The widget that is being inserted</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tab_label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    The widget used as the label for this confiugration page</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the assigned index of the page inside the GnomePropertyBox or
-1 if one of the arguments is invalid.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN25750"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN25752"
></A
><H3
><A
NAME="GNOMEPROPERTYBOX-APPLY"
></A
>The &quot;apply&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> *propertybox,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is invoked with the page number that is being applied.
The signal is emited with the special page number -1 when it has
finished emiting the signals for all of the property pages.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25760"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>propertybox</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The page number.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25777"
></A
><H3
><A
NAME="GNOMEPROPERTYBOX-HELP"
></A
>The &quot;help&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> *propertybox,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is invoked when the user clicks on the help button in the
property box.  An argument is passed that identifies the currently
active page number.</P
><P
>There are a number of utility functions in the module gnome-help that
can help you hook help into your application: <A
HREF=../gnome/gnome-gnome-help.html#GNOME-HELP-PBOX-GOTO
>gnome_help_pbox_goto</A>()
and gnome_help_pbox_display provide two different ways to hook the
help into this signal.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25787"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>propertybox</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN25804"
></A
><H2
>See Also</H2
><P
><A
HREF=../gnome/gnome-gnome-help.html#GNOME-HELP-PBOX-DISPLAY
>gnome_help_pbox_display</A>(), <A
HREF=../gnome/gnome-gnome-help.html#GNOME-HELP-DISPLAY
>gnome_help_display</A>(), <A
HREF="gnomedialog.html"
>GnomeDialog</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomepixmap.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomescores.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
>GnomePixmap</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeScores</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeScores</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomePropertyBox"
HREF="gnomepropertybox.html"><LINK
REL="NEXT"
TITLE="GnomeStock"
HREF="gnomestock.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomepropertybox.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomestock.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMESCORES"
>GnomeScores</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN25815"
></A
><H2
>Name</H2
>GnomeScores&nbsp;--&nbsp;Dialog box which displays high scores</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN25818"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomescores.html#GNOMESCORES-STRUCT"
>GnomeScores</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomescores.html#GNOME-SCORES-NEW"
>gnome_scores_new</A
>                (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> n_scores,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **names,
                                             <A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A> *scores,
                                             time_t *times,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> clear);
void        <A
HREF="gnomescores.html#GNOME-SCORES-SET-LOGO-LABEL"
>gnome_scores_set_logo_label</A
>     (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *txt,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *font,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);
void        <A
HREF="gnomescores.html#GNOME-SCORES-SET-LOGO-PIXMAP"
>gnome_scores_set_logo_pixmap</A
>    (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *logo);
void        <A
HREF="gnomescores.html#GNOME-SCORES-SET-LOGO-WIDGET"
>gnome_scores_set_logo_widget</A
>    (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *w);
void        <A
HREF="gnomescores.html#GNOME-SCORES-SET-COLOR"
>gnome_scores_set_color</A
>          (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> pos,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *col);
void        <A
HREF="gnomescores.html#GNOME-SCORES-SET-DEF-COLOR"
>gnome_scores_set_def_color</A
>      (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *col);
void        <A
HREF="gnomescores.html#GNOME-SCORES-SET-COLORS"
>gnome_scores_set_colors</A
>         (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *col);
void        <A
HREF="gnomescores.html#GNOME-SCORES-SET-LOGO-LABEL-TITLE"
>gnome_scores_set_logo_label_title</A
>
                                            (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *txt);
void        <A
HREF="gnomescores.html#GNOME-SCORES-SET-CURRENT-PLAYER"
>gnome_scores_set_current_player</A
> (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> i);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN25856"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----<A
HREF=../gtk/gtkwindow.html
>GtkWindow</A>
                           +----<A
HREF="gnomedialog.html"
>GnomeDialog</A
>
                                 +----GnomeScores</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN25865"
></A
><H2
>Description</H2
><P
>This is a high-scores dialog box. The GNOME libraries also handle
loading/saving systemwide high scores in a secure way.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN25868"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN25870"
></A
><H3
><A
NAME="GNOMESCORES-STRUCT"
></A
>struct GnomeScores</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeScores;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25875"
></A
><H3
><A
NAME="GNOME-SCORES-NEW"
></A
>gnome_scores_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_scores_new                (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> n_scores,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **names,
                                             <A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A> *scores,
                                             time_t *times,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> clear);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25887"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>n_scores</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>names</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>scores</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>times</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>clear</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A new <A
HREF="gnomescores.html"
>GnomeScores</A
> widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25917"
></A
><H3
><A
NAME="GNOME-SCORES-SET-LOGO-LABEL"
></A
>gnome_scores_set_logo_label ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_scores_set_logo_label     (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *txt,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *font,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *color);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25927"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gs</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomescores.html"
>GnomeScores</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>txt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>font</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>color</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25949"
></A
><H3
><A
NAME="GNOME-SCORES-SET-LOGO-PIXMAP"
></A
>gnome_scores_set_logo_pixmap ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_scores_set_logo_pixmap    (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *logo);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25957"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gs</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomescores.html"
>GnomeScores</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>logo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25971"
></A
><H3
><A
NAME="GNOME-SCORES-SET-LOGO-WIDGET"
></A
>gnome_scores_set_logo_widget ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_scores_set_logo_widget    (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *w);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN25979"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gs</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomescores.html"
>GnomeScores</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>w</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN25993"
></A
><H3
><A
NAME="GNOME-SCORES-SET-COLOR"
></A
>gnome_scores_set_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_scores_set_color          (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> pos,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *col);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN26002"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gs</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomescores.html"
>GnomeScores</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>col</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26020"
></A
><H3
><A
NAME="GNOME-SCORES-SET-DEF-COLOR"
></A
>gnome_scores_set_def_color ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_scores_set_def_color      (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *col);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN26028"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gs</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomescores.html"
>GnomeScores</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>col</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26042"
></A
><H3
><A
NAME="GNOME-SCORES-SET-COLORS"
></A
>gnome_scores_set_colors ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_scores_set_colors         (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *col);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN26050"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gs</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomescores.html"
>GnomeScores</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>col</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26064"
></A
><H3
><A
NAME="GNOME-SCORES-SET-LOGO-LABEL-TITLE"
></A
>gnome_scores_set_logo_label_title ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_scores_set_logo_label_title
                                            (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *txt);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN26072"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gs</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomescores.html"
>GnomeScores</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>txt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26086"
></A
><H3
><A
NAME="GNOME-SCORES-SET-CURRENT-PLAYER"
></A
>gnome_scores_set_current_player ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_scores_set_current_player (<A
HREF="gnomescores.html"
>GnomeScores</A
> *gs,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> i);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN26094"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gs</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF="gnomescores.html"
>GnomeScores</A
> widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>i</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomepropertybox.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomestock.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
>GnomePropertyBox</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeStock</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeSpell</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GtkPixmapMenuItem"
HREF="gtkpixmapmenuitem.html"><LINK
REL="NEXT"
TITLE="GnomeDockLayout"
HREF="gnomedocklayout.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gtkpixmapmenuitem.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedocklayout.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMESPELL"
>GnomeSpell</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN28355"
></A
><H2
>Name</H2
>GnomeSpell&nbsp;--&nbsp;Deprecated.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN28358"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomespell.html#GNOMESPELL-STRUCT"
>GnomeSpell</A
>;
struct      <A
HREF="gnomespell.html#GNOMESPELLINFO"
>GnomeSpellInfo</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomespell.html#GNOME-SPELL-NEW"
>gnome_spell_new</A
>                 (void);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomespell.html#GNOME-SPELL-CHECK"
>gnome_spell_check</A
>               (<A
HREF="gnomespell.html"
>GnomeSpell</A
> *gtkspell,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *str);
void        <A
HREF="gnomespell.html#GNOME-SPELL-ACCEPT"
>gnome_spell_accept</A
>              (<A
HREF="gnomespell.html"
>GnomeSpell</A
> *gtkspell,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *word);
void        <A
HREF="gnomespell.html#GNOME-SPELL-INSERT"
>gnome_spell_insert</A
>              (<A
HREF="gnomespell.html"
>GnomeSpell</A
> *gtkspell,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *word,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> lowercase);
int         <A
HREF="gnomespell.html#GNOME-SPELL-NEXT"
>gnome_spell_next</A
>                (<A
HREF="gnomespell.html"
>GnomeSpell</A
> *gtkspell);
void        <A
HREF="gnomespell.html#GNOME-SPELL-KILL"
>gnome_spell_kill</A
>                (<A
HREF="gnomespell.html"
>GnomeSpell</A
> *gtkspell);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28380"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbox.html
>GtkBox</A>
                     +----<A
HREF=../gtk/gtkvbox.html
>GtkVBox</A>
                           +----GnomeSpell</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28388"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="gnomespell.html#GNOMESPELL-FOUND-WORD"
>found-word</A
>&quot;
            void        user_function      (<A
HREF="gnomespell.html"
>GnomeSpell</A
> *spell,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
&quot;<A
HREF="gnomespell.html#GNOMESPELL-HANDLED-WORD"
>handled-word</A
>&quot;
            void        user_function      (<A
HREF="gnomespell.html"
>GnomeSpell</A
> *spell,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28399"
></A
><H2
>Description</H2
><P
>Deprecated spell-checker widget.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28402"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN28404"
></A
><H3
><A
NAME="GNOMESPELL-STRUCT"
></A
>struct GnomeSpell</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeSpell;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28409"
></A
><H3
><A
NAME="GNOMESPELLINFO"
></A
>struct GnomeSpellInfo</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeSpellInfo {
	const gchar* original;
	gchar* replacement;
	gchar* word;
	guint offset;
	GSList * words;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28414"
></A
><H3
><A
NAME="GNOME-SPELL-NEW"
></A
>gnome_spell_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_spell_new                 (void);</PRE
></TD
></TR
></TABLE
><P
>Create a new GNOME spell checker object.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28421"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME spell checker object, or <TT
CLASS="LITERAL"
>NULL</TT
> on
failure.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28431"
></A
><H3
><A
NAME="GNOME-SPELL-CHECK"
></A
>gnome_spell_check ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_spell_check               (<A
HREF="gnomespell.html"
>GnomeSpell</A
> *gtkspell,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *str);</PRE
></TD
></TR
></TABLE
><P
>Perform spell-checking on one or more words.</P
><P
>FIXME: there is a problem when you call gnome_spell_check(spell, "bogus bogus"):
if you accept bogus the first time, it will be reported again
because ispell checked it before...
The easiest solution is to spell-check a word at a time (but it's slow).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28441"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>spell</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME spell checker object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>str</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> String to be spell-checked.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> 1 if spelling is ok, 0 if not, -1 on system error.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28458"
></A
><H3
><A
NAME="GNOME-SPELL-ACCEPT"
></A
>gnome_spell_accept ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_spell_accept              (<A
HREF="gnomespell.html"
>GnomeSpell</A
> *gtkspell,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *word);</PRE
></TD
></TR
></TABLE
><P
>Adds a single word to the runtime list of words that the spelling
checker should ignore.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28466"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>spell</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME spell checker object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>word</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Word to be ignored.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28479"
></A
><H3
><A
NAME="GNOME-SPELL-INSERT"
></A
>gnome_spell_insert ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_spell_insert              (<A
HREF="gnomespell.html"
>GnomeSpell</A
> *gtkspell,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *word,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> lowercase);</PRE
></TD
></TR
></TABLE
><P
>Adds a single word to the spelling checker's private dictionary.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28488"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>spell</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME spell checker object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>word</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Word to be added to private dictionary.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>lowercase</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if the added word should be changed to lowercase, <TT
CLASS="LITERAL"
>FALSE</TT
> if not.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28507"
></A
><H3
><A
NAME="GNOME-SPELL-NEXT"
></A
>gnome_spell_next ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_spell_next                (<A
HREF="gnomespell.html"
>GnomeSpell</A
> *gtkspell);</PRE
></TD
></TR
></TABLE
><P
>Adds a single word to the runtime list of words that the spelling
checker should ignore.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28514"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>spell</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME spell checker object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> on success, <TT
CLASS="LITERAL"
>FALSE</TT
> on failure.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28529"
></A
><H3
><A
NAME="GNOME-SPELL-KILL"
></A
>gnome_spell_kill ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_spell_kill                (<A
HREF="gnomespell.html"
>GnomeSpell</A
> *gtkspell);</PRE
></TD
></TR
></TABLE
><P
>Terminates the external spelling checker process, if present.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28536"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>spell</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME spell checker object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28545"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN28547"
></A
><H3
><A
NAME="GNOMESPELL-FOUND-WORD"
></A
>The &quot;found-word&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomespell.html"
>GnomeSpell</A
> *spell,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28555"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>spell</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>User data&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28572"
></A
><H3
><A
NAME="GNOMESPELL-HANDLED-WORD"
></A
>The &quot;handled-word&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gnomespell.html"
>GnomeSpell</A
> *spell,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> arg1,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28580"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>spell</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>arg1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>User data&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gtkpixmapmenuitem.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomedocklayout.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
>GtkPixmapMenuItem</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeDockLayout</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GnomeStock</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeScores"
HREF="gnomescores.html"><LINK
REL="NEXT"
TITLE="GtkClock"
HREF="gtkclock.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomescores.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gtkclock.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMESTOCK"
>GnomeStock</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN26113"
></A
><H2
>Name</H2
>GnomeStock&nbsp;--&nbsp;50% finished, API-docs not done; Default icons for toolbars, menus and buttons.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN26116"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomestock.html#GNOMESTOCK-STRUCT"
>GnomeStock</A
>;
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-NEW-CAPS"
>GNOME_STOCK_PIXMAP_NEW</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-OPEN-CAPS"
>GNOME_STOCK_PIXMAP_OPEN</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-CLOSE-CAPS"
>GNOME_STOCK_PIXMAP_CLOSE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-REVERT-CAPS"
>GNOME_STOCK_PIXMAP_REVERT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-SAVE-CAPS"
>GNOME_STOCK_PIXMAP_SAVE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-SAVE-AS-CAPS"
>GNOME_STOCK_PIXMAP_SAVE_AS</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-CUT-CAPS"
>GNOME_STOCK_PIXMAP_CUT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-COPY-CAPS"
>GNOME_STOCK_PIXMAP_COPY</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-PASTE-CAPS"
>GNOME_STOCK_PIXMAP_PASTE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-CLEAR-CAPS"
>GNOME_STOCK_PIXMAP_CLEAR</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-PROPERTIES-CAPS"
>GNOME_STOCK_PIXMAP_PROPERTIES</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-PREFERENCES-CAPS"
>GNOME_STOCK_PIXMAP_PREFERENCES</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-HELP-CAPS"
>GNOME_STOCK_PIXMAP_HELP</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-SCORES-CAPS"
>GNOME_STOCK_PIXMAP_SCORES</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-PRINT-CAPS"
>GNOME_STOCK_PIXMAP_PRINT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-SEARCH-CAPS"
>GNOME_STOCK_PIXMAP_SEARCH</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-SRCHRPL-CAPS"
>GNOME_STOCK_PIXMAP_SRCHRPL</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-BACK-CAPS"
>GNOME_STOCK_PIXMAP_BACK</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-FORWARD-CAPS"
>GNOME_STOCK_PIXMAP_FORWARD</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-FIRST-CAPS"
>GNOME_STOCK_PIXMAP_FIRST</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-LAST-CAPS"
>GNOME_STOCK_PIXMAP_LAST</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-HOME-CAPS"
>GNOME_STOCK_PIXMAP_HOME</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-STOP-CAPS"
>GNOME_STOCK_PIXMAP_STOP</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-REFRESH-CAPS"
>GNOME_STOCK_PIXMAP_REFRESH</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-UNDO-CAPS"
>GNOME_STOCK_PIXMAP_UNDO</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-REDO-CAPS"
>GNOME_STOCK_PIXMAP_REDO</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TIMER-CAPS"
>GNOME_STOCK_PIXMAP_TIMER</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TIMER-STOP-CAPS"
>GNOME_STOCK_PIXMAP_TIMER_STOP</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-MAIL-CAPS"
>GNOME_STOCK_PIXMAP_MAIL</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-MAIL-RCV-CAPS"
>GNOME_STOCK_PIXMAP_MAIL_RCV</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-MAIL-SND-CAPS"
>GNOME_STOCK_PIXMAP_MAIL_SND</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-MAIL-RPL-CAPS"
>GNOME_STOCK_PIXMAP_MAIL_RPL</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-MAIL-FWD-CAPS"
>GNOME_STOCK_PIXMAP_MAIL_FWD</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-MAIL-NEW-CAPS"
>GNOME_STOCK_PIXMAP_MAIL_NEW</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TRASH-CAPS"
>GNOME_STOCK_PIXMAP_TRASH</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TRASH-FULL-CAPS"
>GNOME_STOCK_PIXMAP_TRASH_FULL</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-UNDELETE-CAPS"
>GNOME_STOCK_PIXMAP_UNDELETE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-SPELLCHECK-CAPS"
>GNOME_STOCK_PIXMAP_SPELLCHECK</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-MIC-CAPS"
>GNOME_STOCK_PIXMAP_MIC</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-LINE-IN-CAPS"
>GNOME_STOCK_PIXMAP_LINE_IN</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-CDROM-CAPS"
>GNOME_STOCK_PIXMAP_CDROM</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-VOLUME-CAPS"
>GNOME_STOCK_PIXMAP_VOLUME</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-BOOK-RED-CAPS"
>GNOME_STOCK_PIXMAP_BOOK_RED</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-BOOK-GREEN-CAPS"
>GNOME_STOCK_PIXMAP_BOOK_GREEN</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-BOOK-BLUE-CAPS"
>GNOME_STOCK_PIXMAP_BOOK_BLUE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-BOOK-YELLOW-CAPS"
>GNOME_STOCK_PIXMAP_BOOK_YELLOW</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-BOOK-OPEN-CAPS"
>GNOME_STOCK_PIXMAP_BOOK_OPEN</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-ABOUT-CAPS"
>GNOME_STOCK_PIXMAP_ABOUT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-QUIT-CAPS"
>GNOME_STOCK_PIXMAP_QUIT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-MULTIPLE-CAPS"
>GNOME_STOCK_PIXMAP_MULTIPLE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-NOT-CAPS"
>GNOME_STOCK_PIXMAP_NOT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-CONVERT-CAPS"
>GNOME_STOCK_PIXMAP_CONVERT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-JUMP-TO-CAPS"
>GNOME_STOCK_PIXMAP_JUMP_TO</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-UP-CAPS"
>GNOME_STOCK_PIXMAP_UP</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-DOWN-CAPS"
>GNOME_STOCK_PIXMAP_DOWN</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TOP-CAPS"
>GNOME_STOCK_PIXMAP_TOP</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-BOTTOM-CAPS"
>GNOME_STOCK_PIXMAP_BOTTOM</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-ATTACH-CAPS"
>GNOME_STOCK_PIXMAP_ATTACH</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-INDEX-CAPS"
>GNOME_STOCK_PIXMAP_INDEX</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-FONT-CAPS"
>GNOME_STOCK_PIXMAP_FONT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-EXEC-CAPS"
>GNOME_STOCK_PIXMAP_EXEC</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-ALIGN-LEFT-CAPS"
>GNOME_STOCK_PIXMAP_ALIGN_LEFT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-ALIGN-RIGHT-CAPS"
>GNOME_STOCK_PIXMAP_ALIGN_RIGHT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-ALIGN-CENTER-CAPS"
>GNOME_STOCK_PIXMAP_ALIGN_CENTER</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-ALIGN-JUSTIFY-CAPS"
>GNOME_STOCK_PIXMAP_ALIGN_JUSTIFY</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TEXT-BOLD-CAPS"
>GNOME_STOCK_PIXMAP_TEXT_BOLD</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TEXT-ITALIC-CAPS"
>GNOME_STOCK_PIXMAP_TEXT_ITALIC</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TEXT-UNDERLINE-CAPS"
>GNOME_STOCK_PIXMAP_TEXT_UNDERLINE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TEXT-STRIKEOUT-CAPS"
>GNOME_STOCK_PIXMAP_TEXT_STRIKEOUT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TEXT-INDENT-CAPS"
>GNOME_STOCK_PIXMAP_TEXT_INDENT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TEXT-UNINDENT-CAPS"
>GNOME_STOCK_PIXMAP_TEXT_UNINDENT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-EXIT-CAPS"
>GNOME_STOCK_PIXMAP_EXIT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-COLORSELECTOR-CAPS"
>GNOME_STOCK_PIXMAP_COLORSELECTOR</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-ADD-CAPS"
>GNOME_STOCK_PIXMAP_ADD</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-REMOVE-CAPS"
>GNOME_STOCK_PIXMAP_REMOVE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TABLE-BORDERS-CAPS"
>GNOME_STOCK_PIXMAP_TABLE_BORDERS</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TABLE-FILL-CAPS"
>GNOME_STOCK_PIXMAP_TABLE_FILL</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TEXT-BULLETED-LIST-CAPS"
>GNOME_STOCK_PIXMAP_TEXT_BULLETED_LIST</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-TEXT-NUMBERED-LIST-CAPS"
>GNOME_STOCK_PIXMAP_TEXT_NUMBERED_LIST</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-REGULAR-CAPS"
>GNOME_STOCK_PIXMAP_REGULAR</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-DISABLED-CAPS"
>GNOME_STOCK_PIXMAP_DISABLED</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-FOCUSED-CAPS"
>GNOME_STOCK_PIXMAP_FOCUSED</A
>
struct      <A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRYANY"
>GnomeStockPixmapEntryAny</A
>;
struct      <A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRYDATA"
>GnomeStockPixmapEntryData</A
>;
struct      <A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRYFILE"
>GnomeStockPixmapEntryFile</A
>;
struct      <A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRYPATH"
>GnomeStockPixmapEntryPath</A
>;
struct      <A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRYWIDGET"
>GnomeStockPixmapEntryWidget</A
>;
struct      <A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRYGPIXMAP"
>GnomeStockPixmapEntryGPixmap</A
>;
enum        <A
HREF="gnomestock.html#GNOMESTOCKPIXMAPTYPE"
>GnomeStockPixmapType</A
>;
struct      <A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRYIMLIB"
>GnomeStockPixmapEntryImlib</A
>;
struct      <A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRYIMLIBSCALED"
>GnomeStockPixmapEntryImlibScaled</A
>;
union       <A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRY"
>GnomeStockPixmapEntry</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomestock.html#GNOME-STOCK-NEW"
>gnome_stock_new</A
>                 (void);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomestock.html#GNOME-STOCK-NEW-WITH-ICON"
>gnome_stock_new_with_icon</A
>       (const char *icon);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomestock.html#GNOME-STOCK-SET-ICON"
>gnome_stock_set_icon</A
>            (<A
HREF="gnomestock.html"
>GnomeStock</A
> *stock,
                                             const char *icon);
<A
HREF="gnomepixmap.html"
>GnomePixmap</A
>* <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP"
>gnome_stock_pixmap</A
>             (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             const char *icon,
                                             const char *subtype);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-WIDGET"
>gnome_stock_pixmap_widget</A
>       (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             const char *icon);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-WIDGET-AT-SIZE"
>gnome_stock_pixmap_widget_at_size</A
>
                                            (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             const char *icon,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> width,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> height);
void        <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-WIDGET-SET-ICON"
>gnome_stock_pixmap_widget_set_icon</A
>
                                            (<A
HREF="gnomestock.html"
>GnomeStock</A
> *widget,
                                             const char *icon);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-REGISTER"
>gnome_stock_pixmap_register</A
>     (const char *icon,
                                             const char *subtype,
                                             <A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRY"
>GnomeStockPixmapEntry</A
> *entry);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-CHANGE"
>gnome_stock_pixmap_change</A
>       (const char *icon,
                                             const char *subtype,
                                             <A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRY"
>GnomeStockPixmapEntry</A
> *entry);
<A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRY"
>GnomeStockPixmapEntry</A
>* <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-CHECKFOR"
>gnome_stock_pixmap_checkfor</A
>
                                            (const char *icon,
                                             const char *subtype);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomestock.html#GNOME-PIXMAP-BUTTON"
>gnome_pixmap_button</A
>             (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *pixmap,
                                             const char *text);
void        <A
HREF="gnomestock.html#GNOME-BUTTON-CAN-DEFAULT"
>gnome_button_can_default</A
>        (<A
HREF=../gtk/gtkbutton.html
>GtkButton</A> *button,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> can_default);
#define     <A
HREF="gnomestock.html#GNOME-STOCK-BUTTON-OK-CAPS"
>GNOME_STOCK_BUTTON_OK</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-BUTTON-CANCEL-CAPS"
>GNOME_STOCK_BUTTON_CANCEL</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-BUTTON-YES-CAPS"
>GNOME_STOCK_BUTTON_YES</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-BUTTON-NO-CAPS"
>GNOME_STOCK_BUTTON_NO</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-BUTTON-CLOSE-CAPS"
>GNOME_STOCK_BUTTON_CLOSE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-BUTTON-APPLY-CAPS"
>GNOME_STOCK_BUTTON_APPLY</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-BUTTON-HELP-CAPS"
>GNOME_STOCK_BUTTON_HELP</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-BUTTON-NEXT-CAPS"
>GNOME_STOCK_BUTTON_NEXT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-BUTTON-PREV-CAPS"
>GNOME_STOCK_BUTTON_PREV</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-BUTTON-UP-CAPS"
>GNOME_STOCK_BUTTON_UP</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-BUTTON-DOWN-CAPS"
>GNOME_STOCK_BUTTON_DOWN</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-BUTTON-FONT-CAPS"
>GNOME_STOCK_BUTTON_FONT</A
>
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomestock.html#GNOME-STOCK-BUTTON"
>gnome_stock_button</A
>              (const char *type);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomestock.html#GNOME-STOCK-OR-ORDINARY-BUTTON"
>gnome_stock_or_ordinary_button</A
>  (const char *type);
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-BLANK-CAPS"
>GNOME_STOCK_MENU_BLANK</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-NEW-CAPS"
>GNOME_STOCK_MENU_NEW</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-SAVE-CAPS"
>GNOME_STOCK_MENU_SAVE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-SAVE-AS-CAPS"
>GNOME_STOCK_MENU_SAVE_AS</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-REVERT-CAPS"
>GNOME_STOCK_MENU_REVERT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-OPEN-CAPS"
>GNOME_STOCK_MENU_OPEN</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-CLOSE-CAPS"
>GNOME_STOCK_MENU_CLOSE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-QUIT-CAPS"
>GNOME_STOCK_MENU_QUIT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-CUT-CAPS"
>GNOME_STOCK_MENU_CUT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-COPY-CAPS"
>GNOME_STOCK_MENU_COPY</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-PASTE-CAPS"
>GNOME_STOCK_MENU_PASTE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-PROP-CAPS"
>GNOME_STOCK_MENU_PROP</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-PREF-CAPS"
>GNOME_STOCK_MENU_PREF</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-ABOUT-CAPS"
>GNOME_STOCK_MENU_ABOUT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-SCORES-CAPS"
>GNOME_STOCK_MENU_SCORES</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-UNDO-CAPS"
>GNOME_STOCK_MENU_UNDO</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-REDO-CAPS"
>GNOME_STOCK_MENU_REDO</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-PRINT-CAPS"
>GNOME_STOCK_MENU_PRINT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-SEARCH-CAPS"
>GNOME_STOCK_MENU_SEARCH</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-SRCHRPL-CAPS"
>GNOME_STOCK_MENU_SRCHRPL</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-BACK-CAPS"
>GNOME_STOCK_MENU_BACK</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-FORWARD-CAPS"
>GNOME_STOCK_MENU_FORWARD</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-FIRST-CAPS"
>GNOME_STOCK_MENU_FIRST</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-LAST-CAPS"
>GNOME_STOCK_MENU_LAST</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-HOME-CAPS"
>GNOME_STOCK_MENU_HOME</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-STOP-CAPS"
>GNOME_STOCK_MENU_STOP</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-REFRESH-CAPS"
>GNOME_STOCK_MENU_REFRESH</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-MAIL-CAPS"
>GNOME_STOCK_MENU_MAIL</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-MAIL-RCV-CAPS"
>GNOME_STOCK_MENU_MAIL_RCV</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-MAIL-SND-CAPS"
>GNOME_STOCK_MENU_MAIL_SND</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-MAIL-RPL-CAPS"
>GNOME_STOCK_MENU_MAIL_RPL</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-MAIL-FWD-CAPS"
>GNOME_STOCK_MENU_MAIL_FWD</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-MAIL-NEW-CAPS"
>GNOME_STOCK_MENU_MAIL_NEW</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-TRASH-CAPS"
>GNOME_STOCK_MENU_TRASH</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-TRASH-FULL-CAPS"
>GNOME_STOCK_MENU_TRASH_FULL</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-UNDELETE-CAPS"
>GNOME_STOCK_MENU_UNDELETE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-TIMER-CAPS"
>GNOME_STOCK_MENU_TIMER</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-TIMER-STOP-CAPS"
>GNOME_STOCK_MENU_TIMER_STOP</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-SPELLCHECK-CAPS"
>GNOME_STOCK_MENU_SPELLCHECK</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-MIC-CAPS"
>GNOME_STOCK_MENU_MIC</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-LINE-IN-CAPS"
>GNOME_STOCK_MENU_LINE_IN</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-CDROM-CAPS"
>GNOME_STOCK_MENU_CDROM</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-VOLUME-CAPS"
>GNOME_STOCK_MENU_VOLUME</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-BOOK-RED-CAPS"
>GNOME_STOCK_MENU_BOOK_RED</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-BOOK-GREEN-CAPS"
>GNOME_STOCK_MENU_BOOK_GREEN</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-BOOK-BLUE-CAPS"
>GNOME_STOCK_MENU_BOOK_BLUE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-BOOK-YELLOW-CAPS"
>GNOME_STOCK_MENU_BOOK_YELLOW</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-BOOK-OPEN-CAPS"
>GNOME_STOCK_MENU_BOOK_OPEN</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-CONVERT-CAPS"
>GNOME_STOCK_MENU_CONVERT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-JUMP-TO-CAPS"
>GNOME_STOCK_MENU_JUMP_TO</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-UP-CAPS"
>GNOME_STOCK_MENU_UP</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-DOWN-CAPS"
>GNOME_STOCK_MENU_DOWN</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-TOP-CAPS"
>GNOME_STOCK_MENU_TOP</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-BOTTOM-CAPS"
>GNOME_STOCK_MENU_BOTTOM</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-ATTACH-CAPS"
>GNOME_STOCK_MENU_ATTACH</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-INDEX-CAPS"
>GNOME_STOCK_MENU_INDEX</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-FONT-CAPS"
>GNOME_STOCK_MENU_FONT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-EXEC-CAPS"
>GNOME_STOCK_MENU_EXEC</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-ALIGN-LEFT-CAPS"
>GNOME_STOCK_MENU_ALIGN_LEFT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-ALIGN-RIGHT-CAPS"
>GNOME_STOCK_MENU_ALIGN_RIGHT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-ALIGN-CENTER-CAPS"
>GNOME_STOCK_MENU_ALIGN_CENTER</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-ALIGN-JUSTIFY-CAPS"
>GNOME_STOCK_MENU_ALIGN_JUSTIFY</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-TEXT-BOLD-CAPS"
>GNOME_STOCK_MENU_TEXT_BOLD</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-TEXT-ITALIC-CAPS"
>GNOME_STOCK_MENU_TEXT_ITALIC</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-TEXT-UNDERLINE-CAPS"
>GNOME_STOCK_MENU_TEXT_UNDERLINE</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-TEXT-STRIKEOUT-CAPS"
>GNOME_STOCK_MENU_TEXT_STRIKEOUT</A
>
#define     <A
HREF="gnomestock.html#GNOME-STOCK-MENU-EXIT-CAPS"
>GNOME_STOCK_MENU_EXIT</A
>
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomestock.html#GNOME-STOCK-MENU-ITEM"
>gnome_stock_menu_item</A
>           (const char *type,
                                             const char *text);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomestock.html#GNOME-STOCK-MENU-ACCEL"
>gnome_stock_menu_accel</A
>          (const char *type,
                                             <A
HREF=../glib/glib-basic-types.html#GUCHAR
>guchar</A> *key,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> *mod);
void        <A
HREF="gnomestock.html#GNOME-STOCK-MENU-ACCEL-PARSE"
>gnome_stock_menu_accel_parse</A
>    (const char *section);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomestock.html#GNOME-STOCK-TRANSPARENT-WINDOW"
>gnome_stock_transparent_window</A
>  (const char *icon,
                                             const char *subtype);
void        <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-GDK"
>gnome_stock_pixmap_gdk</A
>          (const char *icon,
                                             const char *subtype,
                                             <A
HREF=../gdk/gdk-bitmaps-and-pixmaps.html#GDKPIXMAP
>GdkPixmap</A> **pixmap,
                                             <A
HREF=../gdk/gdk-bitmaps-and-pixmaps.html#GDKPIXMAP
>GdkPixmap</A> **mask);
&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN26341"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF="gnomepixmap.html"
>GnomePixmap</A
>
               +----GnomeStock</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN26347"
></A
><H2
>Description</H2
><P
>    These functions provide an applications programmer with default
    icons for toolbars, menu pixmaps and buttons. 
  </P
><P
>    To support themability, we use (char *) to call those functions. A
    new theme might register new icons by calling
    <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-REGISTER"
>gnome_stock_pixmap_register</A
>(), or may change existing icons by
    calling <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-CHANGE"
>gnome_stock_pixmap_change</A
>(). An application should check (by
    calling gnome_stock_pixmap_checkfor)(), if the current theme
    supports an uncommon icon, before using it. The only icons an app
    can rely on, are those defined in this header file.
  </P
><P
>    We have stock buttons too. To use them, use the
    <A
HREF="gnomestock.html#GNOME-STOCK-BUTTON"
>gnome_stock_button</A
>() function with a GNOME_STOCK constant.  This
    function returns a <A
HREF=../gtk/gtkbutton.html
>GtkButton</A> with a gettexted default text and an
    icon.
  </P
><P
>    There is an additional feature, which might be interesting. If an
    application calls <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-REGISTER"
>gnome_stock_pixmap_register</A
>() and uses it by
    calling <A
HREF="gnomestock.html#GNOME-STOCK-PIXMAP-WIDGET"
>gnome_stock_pixmap_widget</A
>(), it doesn't have to care about
    the state_changed signal to display the appropriate pixmap
    itself. Additionally gnome-stock generates a disabled version of a
    pixmap automatically, when no pixmap for a disabled state is
    provided.
  </P
><DIV
CLASS="REFSECT2"
><A
NAME="AEN26359"
></A
><H3
>GNOME_STOCK icons internals</H3
><P
>      One such `icon' should have at least three pixmaps to reflect its
      state. There is a `regular' pixmap, a `disabled' pixmap and a
      `focused' pixmap. You can get either each of these pixmaps by
      calling gnome_stock_pixmap or you can get a widget by calling
      gnome_stock_pixmap_widget. This widget is a container which
      gtk_widget_shows the pixmap, that is reflecting the current state
      of the widget. If for example you gtk_container_add this widget to
    a button, which is currently not sensitive, the widget will just
      show the `disabled' pixmap. If the state of the button changes to
      sensitive, the widget will change to the `regular' pixmap. The
      `focused' pixmap will be shown, when the mouse pointer enters the
      widget.
    </P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN26362"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN26364"
></A
><H3
><A
NAME="GNOMESTOCK-STRUCT"
></A
>struct GnomeStock</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeStock;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26369"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-NEW-CAPS"
></A
>GNOME_STOCK_PIXMAP_NEW</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_NEW         "New"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "New".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26374"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-OPEN-CAPS"
></A
>GNOME_STOCK_PIXMAP_OPEN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_OPEN        "Open"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Open".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26379"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-CLOSE-CAPS"
></A
>GNOME_STOCK_PIXMAP_CLOSE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_CLOSE       "Close"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Close".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26384"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-REVERT-CAPS"
></A
>GNOME_STOCK_PIXMAP_REVERT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_REVERT      "Revert"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Revert".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26389"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-SAVE-CAPS"
></A
>GNOME_STOCK_PIXMAP_SAVE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_SAVE        "Save"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Save".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26394"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-SAVE-AS-CAPS"
></A
>GNOME_STOCK_PIXMAP_SAVE_AS</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_SAVE_AS     "Save As"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Save as".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26399"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-CUT-CAPS"
></A
>GNOME_STOCK_PIXMAP_CUT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_CUT         "Cut"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Cut".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26404"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-COPY-CAPS"
></A
>GNOME_STOCK_PIXMAP_COPY</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_COPY        "Copy"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Copy".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26409"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-PASTE-CAPS"
></A
>GNOME_STOCK_PIXMAP_PASTE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_PASTE       "Paste"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Paste".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26414"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-CLEAR-CAPS"
></A
>GNOME_STOCK_PIXMAP_CLEAR</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_CLEAR       "Clear"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Clear".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26419"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-PROPERTIES-CAPS"
></A
>GNOME_STOCK_PIXMAP_PROPERTIES</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_PROPERTIES  "Properties"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Properties". Please note the difference
between "Properties" and "Preferences". "Properties" should be used
when editing the properties of a specific object, such as a file or a
database. "Preferences" should be used when editing user preferences
application-wide, such as display colors or default servers.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26424"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-PREFERENCES-CAPS"
></A
>GNOME_STOCK_PIXMAP_PREFERENCES</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_PREFERENCES "Preferences"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Preferences". Please see note for
"Properties" above.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26429"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-HELP-CAPS"
></A
>GNOME_STOCK_PIXMAP_HELP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_HELP        "Help"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Help".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26434"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-SCORES-CAPS"
></A
>GNOME_STOCK_PIXMAP_SCORES</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_SCORES      "Scores"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Scores".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26439"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-PRINT-CAPS"
></A
>GNOME_STOCK_PIXMAP_PRINT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_PRINT       "Print"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Print".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26444"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-SEARCH-CAPS"
></A
>GNOME_STOCK_PIXMAP_SEARCH</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_SEARCH      "Search"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Search".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26449"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-SRCHRPL-CAPS"
></A
>GNOME_STOCK_PIXMAP_SRCHRPL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_SRCHRPL     "Search/Replace"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Search and replace".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26454"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-BACK-CAPS"
></A
>GNOME_STOCK_PIXMAP_BACK</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_BACK        "Back"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Back".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26459"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-FORWARD-CAPS"
></A
>GNOME_STOCK_PIXMAP_FORWARD</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_FORWARD     "Forward"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Forward".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26464"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-FIRST-CAPS"
></A
>GNOME_STOCK_PIXMAP_FIRST</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_FIRST       "First"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26469"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-LAST-CAPS"
></A
>GNOME_STOCK_PIXMAP_LAST</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_LAST        "Last"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26474"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-HOME-CAPS"
></A
>GNOME_STOCK_PIXMAP_HOME</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_HOME        "Home"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Home".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26479"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-STOP-CAPS"
></A
>GNOME_STOCK_PIXMAP_STOP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_STOP        "Stop"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Stop".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26484"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-REFRESH-CAPS"
></A
>GNOME_STOCK_PIXMAP_REFRESH</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_REFRESH     "Refresh"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Refresh".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26489"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-UNDO-CAPS"
></A
>GNOME_STOCK_PIXMAP_UNDO</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_UNDO        "Undo"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Undo".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26494"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-REDO-CAPS"
></A
>GNOME_STOCK_PIXMAP_REDO</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_REDO        "Redo"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Redo".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26499"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TIMER-CAPS"
></A
>GNOME_STOCK_PIXMAP_TIMER</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TIMER       "Timer"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Timer".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26504"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TIMER-STOP-CAPS"
></A
>GNOME_STOCK_PIXMAP_TIMER_STOP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TIMER_STOP  "Timer Stopped"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Timer stop".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26509"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-MAIL-CAPS"
></A
>GNOME_STOCK_PIXMAP_MAIL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_MAIL	       "Mail"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Mail".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26514"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-MAIL-RCV-CAPS"
></A
>GNOME_STOCK_PIXMAP_MAIL_RCV</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_MAIL_RCV    "Receive Mail"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Mail get".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26519"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-MAIL-SND-CAPS"
></A
>GNOME_STOCK_PIXMAP_MAIL_SND</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_MAIL_SND    "Send Mail"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Mail send".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26524"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-MAIL-RPL-CAPS"
></A
>GNOME_STOCK_PIXMAP_MAIL_RPL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_MAIL_RPL    "Reply to Mail"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Mail reply".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26529"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-MAIL-FWD-CAPS"
></A
>GNOME_STOCK_PIXMAP_MAIL_FWD</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_MAIL_FWD    "Forward Mail"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Timer".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26534"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-MAIL-NEW-CAPS"
></A
>GNOME_STOCK_PIXMAP_MAIL_NEW</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_MAIL_NEW    "New Mail"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Mail new".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26539"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TRASH-CAPS"
></A
>GNOME_STOCK_PIXMAP_TRASH</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TRASH       "Trash"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Trashcan".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26544"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TRASH-FULL-CAPS"
></A
>GNOME_STOCK_PIXMAP_TRASH_FULL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TRASH_FULL  "Trash Full"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Trashcan is full".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26549"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-UNDELETE-CAPS"
></A
>GNOME_STOCK_PIXMAP_UNDELETE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_UNDELETE    "Undelete"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Undelete".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26554"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-SPELLCHECK-CAPS"
></A
>GNOME_STOCK_PIXMAP_SPELLCHECK</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_SPELLCHECK  "Spellchecker"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Spellcheck".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26559"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-MIC-CAPS"
></A
>GNOME_STOCK_PIXMAP_MIC</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_MIC         "Microphone"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Microphone".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26564"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-LINE-IN-CAPS"
></A
>GNOME_STOCK_PIXMAP_LINE_IN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_LINE_IN     "Line In"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Line in".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26569"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-CDROM-CAPS"
></A
>GNOME_STOCK_PIXMAP_CDROM</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_CDROM       "Cdrom"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "CD-ROM".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26574"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-VOLUME-CAPS"
></A
>GNOME_STOCK_PIXMAP_VOLUME</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_VOLUME      "Volume"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Volume".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26579"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-BOOK-RED-CAPS"
></A
>GNOME_STOCK_PIXMAP_BOOK_RED</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_BOOK_RED    "Book Red"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "A red book".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26584"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-BOOK-GREEN-CAPS"
></A
>GNOME_STOCK_PIXMAP_BOOK_GREEN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_BOOK_GREEN  "Book Green"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "A green book".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26589"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-BOOK-BLUE-CAPS"
></A
>GNOME_STOCK_PIXMAP_BOOK_BLUE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_BOOK_BLUE   "Book Blue"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "A blue book".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26594"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-BOOK-YELLOW-CAPS"
></A
>GNOME_STOCK_PIXMAP_BOOK_YELLOW</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_BOOK_YELLOW "Book Yellow"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "A yellow book".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26599"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-BOOK-OPEN-CAPS"
></A
>GNOME_STOCK_PIXMAP_BOOK_OPEN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_BOOK_OPEN   "Book Open"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "An open book".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26604"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-ABOUT-CAPS"
></A
>GNOME_STOCK_PIXMAP_ABOUT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_ABOUT       "About"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "About".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26609"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-QUIT-CAPS"
></A
>GNOME_STOCK_PIXMAP_QUIT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_QUIT        "Quit"</PRE
></TD
></TR
></TABLE
><P
>    Image for representing "Quit".</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26614"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-MULTIPLE-CAPS"
></A
>GNOME_STOCK_PIXMAP_MULTIPLE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_MULTIPLE    "Multiple"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26619"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-NOT-CAPS"
></A
>GNOME_STOCK_PIXMAP_NOT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_NOT         "Not"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26624"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-CONVERT-CAPS"
></A
>GNOME_STOCK_PIXMAP_CONVERT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_CONVERT     "Convert"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26629"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-JUMP-TO-CAPS"
></A
>GNOME_STOCK_PIXMAP_JUMP_TO</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_JUMP_TO     "Jump To"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26634"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-UP-CAPS"
></A
>GNOME_STOCK_PIXMAP_UP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_UP          "Up"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26639"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-DOWN-CAPS"
></A
>GNOME_STOCK_PIXMAP_DOWN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_DOWN        "Down"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26644"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TOP-CAPS"
></A
>GNOME_STOCK_PIXMAP_TOP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TOP         "Top"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26649"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-BOTTOM-CAPS"
></A
>GNOME_STOCK_PIXMAP_BOTTOM</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_BOTTOM      "Bottom"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26654"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-ATTACH-CAPS"
></A
>GNOME_STOCK_PIXMAP_ATTACH</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_ATTACH      "Attach"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26659"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-INDEX-CAPS"
></A
>GNOME_STOCK_PIXMAP_INDEX</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_INDEX       "Index"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26664"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-FONT-CAPS"
></A
>GNOME_STOCK_PIXMAP_FONT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_FONT        "Font"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26669"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-EXEC-CAPS"
></A
>GNOME_STOCK_PIXMAP_EXEC</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_EXEC        "Exec"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26674"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-ALIGN-LEFT-CAPS"
></A
>GNOME_STOCK_PIXMAP_ALIGN_LEFT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_ALIGN_LEFT    "Left"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26679"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-ALIGN-RIGHT-CAPS"
></A
>GNOME_STOCK_PIXMAP_ALIGN_RIGHT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_ALIGN_RIGHT   "Right"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26684"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-ALIGN-CENTER-CAPS"
></A
>GNOME_STOCK_PIXMAP_ALIGN_CENTER</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_ALIGN_CENTER  "Center"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26689"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-ALIGN-JUSTIFY-CAPS"
></A
>GNOME_STOCK_PIXMAP_ALIGN_JUSTIFY</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_ALIGN_JUSTIFY "Justify"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26694"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TEXT-BOLD-CAPS"
></A
>GNOME_STOCK_PIXMAP_TEXT_BOLD</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TEXT_BOLD      "Bold"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26699"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TEXT-ITALIC-CAPS"
></A
>GNOME_STOCK_PIXMAP_TEXT_ITALIC</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TEXT_ITALIC    "Italic"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26704"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TEXT-UNDERLINE-CAPS"
></A
>GNOME_STOCK_PIXMAP_TEXT_UNDERLINE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TEXT_UNDERLINE "Underline"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26709"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TEXT-STRIKEOUT-CAPS"
></A
>GNOME_STOCK_PIXMAP_TEXT_STRIKEOUT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TEXT_STRIKEOUT "Strikeout"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26714"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TEXT-INDENT-CAPS"
></A
>GNOME_STOCK_PIXMAP_TEXT_INDENT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TEXT_INDENT "Text Indent"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26719"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TEXT-UNINDENT-CAPS"
></A
>GNOME_STOCK_PIXMAP_TEXT_UNINDENT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TEXT_UNINDENT "Text Unindent"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26724"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-EXIT-CAPS"
></A
>GNOME_STOCK_PIXMAP_EXIT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_EXIT        GNOME_STOCK_PIXMAP_QUIT</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26729"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-COLORSELECTOR-CAPS"
></A
>GNOME_STOCK_PIXMAP_COLORSELECTOR</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_COLORSELECTOR "Color Select"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26734"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-ADD-CAPS"
></A
>GNOME_STOCK_PIXMAP_ADD</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_ADD    "Add"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26739"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-REMOVE-CAPS"
></A
>GNOME_STOCK_PIXMAP_REMOVE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_REMOVE "Remove"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26744"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TABLE-BORDERS-CAPS"
></A
>GNOME_STOCK_PIXMAP_TABLE_BORDERS</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TABLE_BORDERS "Table Borders"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26749"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TABLE-FILL-CAPS"
></A
>GNOME_STOCK_PIXMAP_TABLE_FILL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TABLE_FILL "Table Fill"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26754"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TEXT-BULLETED-LIST-CAPS"
></A
>GNOME_STOCK_PIXMAP_TEXT_BULLETED_LIST</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TEXT_BULLETED_LIST "Text Bulleted List"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26759"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-TEXT-NUMBERED-LIST-CAPS"
></A
>GNOME_STOCK_PIXMAP_TEXT_NUMBERED_LIST</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_TEXT_NUMBERED_LIST "Text Numbered List"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26764"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-REGULAR-CAPS"
></A
>GNOME_STOCK_PIXMAP_REGULAR</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_REGULAR     "regular"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26769"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-DISABLED-CAPS"
></A
>GNOME_STOCK_PIXMAP_DISABLED</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_DISABLED    "disabled"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26774"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-FOCUSED-CAPS"
></A
>GNOME_STOCK_PIXMAP_FOCUSED</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_PIXMAP_FOCUSED     "focused"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26779"
></A
><H3
><A
NAME="GNOMESTOCKPIXMAPENTRYANY"
></A
>struct GnomeStockPixmapEntryAny</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeStockPixmapEntryAny {
        GnomeStockPixmapType type;
	int width, height;
	char *label;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26784"
></A
><H3
><A
NAME="GNOMESTOCKPIXMAPENTRYDATA"
></A
>struct GnomeStockPixmapEntryData</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeStockPixmapEntryData {
        GnomeStockPixmapType type;
	int width, height;
	char *label;
        gchar **xpm_data;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26789"
></A
><H3
><A
NAME="GNOMESTOCKPIXMAPENTRYFILE"
></A
>struct GnomeStockPixmapEntryFile</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeStockPixmapEntryFile {
        GnomeStockPixmapType type;
	int width, height;
	char *label;
        gchar *filename;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26794"
></A
><H3
><A
NAME="GNOMESTOCKPIXMAPENTRYPATH"
></A
>struct GnomeStockPixmapEntryPath</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeStockPixmapEntryPath {
        GnomeStockPixmapType type;
	int width, height;
	char *label;
        gchar *pathname;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26799"
></A
><H3
><A
NAME="GNOMESTOCKPIXMAPENTRYWIDGET"
></A
>struct GnomeStockPixmapEntryWidget</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeStockPixmapEntryWidget {
        GnomeStockPixmapType type;
	int width, height;
	char *label;
        GtkWidget *widget;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26804"
></A
><H3
><A
NAME="GNOMESTOCKPIXMAPENTRYGPIXMAP"
></A
>struct GnomeStockPixmapEntryGPixmap</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeStockPixmapEntryGPixmap {
        GnomeStockPixmapType type;
	int width, height;
	char *label;
        GnomePixmap *pixmap;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26809"
></A
><H3
><A
NAME="GNOMESTOCKPIXMAPTYPE"
></A
>enum GnomeStockPixmapType</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum {
        GNOME_STOCK_PIXMAP_TYPE_NONE,
        GNOME_STOCK_PIXMAP_TYPE_DATA,
        GNOME_STOCK_PIXMAP_TYPE_FILE,
        GNOME_STOCK_PIXMAP_TYPE_PATH,
        GNOME_STOCK_PIXMAP_TYPE_WIDGET,
	GNOME_STOCK_PIXMAP_TYPE_IMLIB,
	GNOME_STOCK_PIXMAP_TYPE_IMLIB_SCALED,
	GNOME_STOCK_PIXMAP_TYPE_GPIXMAP
} GnomeStockPixmapType;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26814"
></A
><H3
><A
NAME="GNOMESTOCKPIXMAPENTRYIMLIB"
></A
>struct GnomeStockPixmapEntryImlib</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeStockPixmapEntryImlib {
        GnomeStockPixmapType type;
	int width, height;
	char *label;
        const gchar *rgb_data;
	GdkImlibColor shape;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26819"
></A
><H3
><A
NAME="GNOMESTOCKPIXMAPENTRYIMLIBSCALED"
></A
>struct GnomeStockPixmapEntryImlibScaled</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeStockPixmapEntryImlibScaled {
        GnomeStockPixmapType type;
	int width, height;
	char *label;
        const gchar *rgb_data;
	GdkImlibColor shape;
	int scaled_width, scaled_height;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26824"
></A
><H3
><A
NAME="GNOMESTOCKPIXMAPENTRY"
></A
>union GnomeStockPixmapEntry</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>union GnomeStockPixmapEntry {
        GnomeStockPixmapType type;
        GnomeStockPixmapEntryAny any;
        GnomeStockPixmapEntryData data;
        GnomeStockPixmapEntryFile file;
        GnomeStockPixmapEntryPath path;
        GnomeStockPixmapEntryWidget widget;
	GnomeStockPixmapEntryImlib imlib;
	GnomeStockPixmapEntryImlibScaled imlib_s;
        GnomeStockPixmapEntryGPixmap gpixmap;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26829"
></A
><H3
><A
NAME="GNOME-STOCK-NEW"
></A
>gnome_stock_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_stock_new                 (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN26836"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a new empty GnomeStock widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26845"
></A
><H3
><A
NAME="GNOME-STOCK-NEW-WITH-ICON"
></A
>gnome_stock_new_with_icon ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_stock_new_with_icon       (const char *icon);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN26852"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> icon code.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GnomeStock widget created with the initial icon code
set to <TT
CLASS="PARAMETER"
><I
>icon</I
></TT
>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26866"
></A
><H3
><A
NAME="GNOME-STOCK-SET-ICON"
></A
>gnome_stock_set_icon ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_stock_set_icon            (<A
HREF="gnomestock.html"
>GnomeStock</A
> *stock,
                                             const char *icon);</PRE
></TD
></TR
></TABLE
><P
>Sets the <TT
CLASS="PARAMETER"
><I
>stock</I
></TT
> object icon to be the one whose code is <TT
CLASS="PARAMETER"
><I
>icon</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN26876"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>stock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The GnomeStock object on which to operate</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Icon code to set</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> TRUE if the icon was set successfully.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26893"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP"
></A
>gnome_stock_pixmap ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomepixmap.html"
>GnomePixmap</A
>* gnome_stock_pixmap             (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             const char *icon,
                                             const char *subtype);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN26900"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>subtype</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26921"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-WIDGET"
></A
>gnome_stock_pixmap_widget ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_stock_pixmap_widget       (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             const char *icon);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN26928"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26945"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-WIDGET-AT-SIZE"
></A
>gnome_stock_pixmap_widget_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_stock_pixmap_widget_at_size
                                            (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             const char *icon,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> width,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> height);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN26954"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26979"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-WIDGET-SET-ICON"
></A
>gnome_stock_pixmap_widget_set_icon ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_stock_pixmap_widget_set_icon
                                            (<A
HREF="gnomestock.html"
>GnomeStock</A
> *widget,
                                             const char *icon);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN26985"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN26998"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-REGISTER"
></A
>gnome_stock_pixmap_register ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_stock_pixmap_register     (const char *icon,
                                             const char *subtype,
                                             <A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRY"
>GnomeStockPixmapEntry</A
> *entry);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27005"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>subtype</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>entry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27026"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-CHANGE"
></A
>gnome_stock_pixmap_change ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_stock_pixmap_change       (const char *icon,
                                             const char *subtype,
                                             <A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRY"
>GnomeStockPixmapEntry</A
> *entry);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27033"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>subtype</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>entry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27054"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-CHECKFOR"
></A
>gnome_stock_pixmap_checkfor ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomestock.html#GNOMESTOCKPIXMAPENTRY"
>GnomeStockPixmapEntry</A
>* gnome_stock_pixmap_checkfor
                                            (const char *icon,
                                             const char *subtype);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27060"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>subtype</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27077"
></A
><H3
><A
NAME="GNOME-PIXMAP-BUTTON"
></A
>gnome_pixmap_button ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_pixmap_button             (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *pixmap,
                                             const char *text);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27084"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27101"
></A
><H3
><A
NAME="GNOME-BUTTON-CAN-DEFAULT"
></A
>gnome_button_can_default ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_button_can_default        (<A
HREF=../gtk/gtkbutton.html
>GtkButton</A> *button,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> can_default);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27108"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>button</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>can_default</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27121"
></A
><H3
><A
NAME="GNOME-STOCK-BUTTON-OK-CAPS"
></A
>GNOME_STOCK_BUTTON_OK</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_BUTTON_OK     "Button_Ok"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27126"
></A
><H3
><A
NAME="GNOME-STOCK-BUTTON-CANCEL-CAPS"
></A
>GNOME_STOCK_BUTTON_CANCEL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_BUTTON_CANCEL "Button_Cancel"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27131"
></A
><H3
><A
NAME="GNOME-STOCK-BUTTON-YES-CAPS"
></A
>GNOME_STOCK_BUTTON_YES</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_BUTTON_YES    "Button_Yes"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27136"
></A
><H3
><A
NAME="GNOME-STOCK-BUTTON-NO-CAPS"
></A
>GNOME_STOCK_BUTTON_NO</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_BUTTON_NO     "Button_No"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27141"
></A
><H3
><A
NAME="GNOME-STOCK-BUTTON-CLOSE-CAPS"
></A
>GNOME_STOCK_BUTTON_CLOSE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_BUTTON_CLOSE  "Button_Close"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27146"
></A
><H3
><A
NAME="GNOME-STOCK-BUTTON-APPLY-CAPS"
></A
>GNOME_STOCK_BUTTON_APPLY</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_BUTTON_APPLY  "Button_Apply"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27151"
></A
><H3
><A
NAME="GNOME-STOCK-BUTTON-HELP-CAPS"
></A
>GNOME_STOCK_BUTTON_HELP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_BUTTON_HELP   "Button_Help"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27156"
></A
><H3
><A
NAME="GNOME-STOCK-BUTTON-NEXT-CAPS"
></A
>GNOME_STOCK_BUTTON_NEXT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_BUTTON_NEXT   "Button_Next"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27161"
></A
><H3
><A
NAME="GNOME-STOCK-BUTTON-PREV-CAPS"
></A
>GNOME_STOCK_BUTTON_PREV</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_BUTTON_PREV   "Button_Prev"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27166"
></A
><H3
><A
NAME="GNOME-STOCK-BUTTON-UP-CAPS"
></A
>GNOME_STOCK_BUTTON_UP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_BUTTON_UP     "Button_Up"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27171"
></A
><H3
><A
NAME="GNOME-STOCK-BUTTON-DOWN-CAPS"
></A
>GNOME_STOCK_BUTTON_DOWN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_BUTTON_DOWN   "Button_Down"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27176"
></A
><H3
><A
NAME="GNOME-STOCK-BUTTON-FONT-CAPS"
></A
>GNOME_STOCK_BUTTON_FONT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_BUTTON_FONT   "Button_Font"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27181"
></A
><H3
><A
NAME="GNOME-STOCK-BUTTON"
></A
>gnome_stock_button ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_stock_button              (const char *type);</PRE
></TD
></TR
></TABLE
><P
>Constructs a new <A
HREF=../gtk/gtkbutton.html
>GtkButton</A> which contains a stock icon and text
whose type is <TT
CLASS="PARAMETER"
><I
>type</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27190"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> gnome stock type code.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A configured <A
HREF=../gtk/gtkbutton.html
>GtkButton</A> widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27204"
></A
><H3
><A
NAME="GNOME-STOCK-OR-ORDINARY-BUTTON"
></A
>gnome_stock_or_ordinary_button ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_stock_or_ordinary_button  (const char *type);</PRE
></TD
></TR
></TABLE
><P
>It <TT
CLASS="PARAMETER"
><I
>type</I
></TT
> contains a valid GNOME stock code, it constructs a new
<A
HREF=../gtk/gtkbutton.html
>GtkButton</A> which contains a stock icon and text for the matching
type, or if the type does not exist, it creates a button with the
label being the same as "type".</P
><P
>The use of this routine is discouraged, given that on international 
setups it might break subtly.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27214"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> gnome stock type code.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A <A
HREF=../gtk/gtkbutton.html
>GtkButton</A>.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27228"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-BLANK-CAPS"
></A
>GNOME_STOCK_MENU_BLANK</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_BLANK        "Menu_"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27233"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-NEW-CAPS"
></A
>GNOME_STOCK_MENU_NEW</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_NEW          "Menu_New"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27238"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-SAVE-CAPS"
></A
>GNOME_STOCK_MENU_SAVE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_SAVE         "Menu_Save"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27243"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-SAVE-AS-CAPS"
></A
>GNOME_STOCK_MENU_SAVE_AS</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_SAVE_AS      "Menu_Save As"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27248"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-REVERT-CAPS"
></A
>GNOME_STOCK_MENU_REVERT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_REVERT       "Menu_Revert"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27253"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-OPEN-CAPS"
></A
>GNOME_STOCK_MENU_OPEN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_OPEN         "Menu_Open"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27258"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-CLOSE-CAPS"
></A
>GNOME_STOCK_MENU_CLOSE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_CLOSE        "Menu_Close"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27263"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-QUIT-CAPS"
></A
>GNOME_STOCK_MENU_QUIT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_QUIT         "Menu_Quit"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27268"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-CUT-CAPS"
></A
>GNOME_STOCK_MENU_CUT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_CUT          "Menu_Cut"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27273"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-COPY-CAPS"
></A
>GNOME_STOCK_MENU_COPY</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_COPY         "Menu_Copy"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27278"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-PASTE-CAPS"
></A
>GNOME_STOCK_MENU_PASTE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_PASTE        "Menu_Paste"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27283"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-PROP-CAPS"
></A
>GNOME_STOCK_MENU_PROP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_PROP         "Menu_Properties"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27288"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-PREF-CAPS"
></A
>GNOME_STOCK_MENU_PREF</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_PREF         "Menu_Preferences"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27293"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-ABOUT-CAPS"
></A
>GNOME_STOCK_MENU_ABOUT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_ABOUT        "Menu_About"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27298"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-SCORES-CAPS"
></A
>GNOME_STOCK_MENU_SCORES</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_SCORES       "Menu_Scores"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27303"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-UNDO-CAPS"
></A
>GNOME_STOCK_MENU_UNDO</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_UNDO         "Menu_Undo"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27308"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-REDO-CAPS"
></A
>GNOME_STOCK_MENU_REDO</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_REDO         "Menu_Redo"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27313"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-PRINT-CAPS"
></A
>GNOME_STOCK_MENU_PRINT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_PRINT        "Menu_Print"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27318"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-SEARCH-CAPS"
></A
>GNOME_STOCK_MENU_SEARCH</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_SEARCH       "Menu_Search"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27323"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-SRCHRPL-CAPS"
></A
>GNOME_STOCK_MENU_SRCHRPL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_SRCHRPL      "Menu_Search/Replace"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27328"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-BACK-CAPS"
></A
>GNOME_STOCK_MENU_BACK</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_BACK         "Menu_Back"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27333"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-FORWARD-CAPS"
></A
>GNOME_STOCK_MENU_FORWARD</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_FORWARD      "Menu_Forward"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27338"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-FIRST-CAPS"
></A
>GNOME_STOCK_MENU_FIRST</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_FIRST        "Menu_First"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27343"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-LAST-CAPS"
></A
>GNOME_STOCK_MENU_LAST</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_LAST         "Menu_Last"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27348"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-HOME-CAPS"
></A
>GNOME_STOCK_MENU_HOME</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_HOME         "Menu_Home"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27353"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-STOP-CAPS"
></A
>GNOME_STOCK_MENU_STOP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_STOP         "Menu_Stop"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27358"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-REFRESH-CAPS"
></A
>GNOME_STOCK_MENU_REFRESH</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_REFRESH      "Menu_Refresh"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27363"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-MAIL-CAPS"
></A
>GNOME_STOCK_MENU_MAIL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_MAIL         "Menu_Mail"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27368"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-MAIL-RCV-CAPS"
></A
>GNOME_STOCK_MENU_MAIL_RCV</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_MAIL_RCV     "Menu_Receive Mail"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27373"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-MAIL-SND-CAPS"
></A
>GNOME_STOCK_MENU_MAIL_SND</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_MAIL_SND     "Menu_Send Mail"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27378"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-MAIL-RPL-CAPS"
></A
>GNOME_STOCK_MENU_MAIL_RPL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_MAIL_RPL     "Menu_Reply to Mail"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27383"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-MAIL-FWD-CAPS"
></A
>GNOME_STOCK_MENU_MAIL_FWD</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_MAIL_FWD     "Menu_Forward Mail"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27388"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-MAIL-NEW-CAPS"
></A
>GNOME_STOCK_MENU_MAIL_NEW</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_MAIL_NEW     "Menu_New Mail"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27393"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-TRASH-CAPS"
></A
>GNOME_STOCK_MENU_TRASH</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_TRASH        "Menu_Trash"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27398"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-TRASH-FULL-CAPS"
></A
>GNOME_STOCK_MENU_TRASH_FULL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_TRASH_FULL   "Menu_Trash Full"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27403"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-UNDELETE-CAPS"
></A
>GNOME_STOCK_MENU_UNDELETE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_UNDELETE     "Menu_Undelete"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27408"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-TIMER-CAPS"
></A
>GNOME_STOCK_MENU_TIMER</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_TIMER        "Menu_Timer"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27413"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-TIMER-STOP-CAPS"
></A
>GNOME_STOCK_MENU_TIMER_STOP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_TIMER_STOP   "Menu_Timer Stopped"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27418"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-SPELLCHECK-CAPS"
></A
>GNOME_STOCK_MENU_SPELLCHECK</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_SPELLCHECK   "Menu_Spellchecker"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27423"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-MIC-CAPS"
></A
>GNOME_STOCK_MENU_MIC</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_MIC          "Menu_Microphone"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27428"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-LINE-IN-CAPS"
></A
>GNOME_STOCK_MENU_LINE_IN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_LINE_IN      "Menu_Line In"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27433"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-CDROM-CAPS"
></A
>GNOME_STOCK_MENU_CDROM</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_CDROM	     "Menu_Cdrom"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27438"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-VOLUME-CAPS"
></A
>GNOME_STOCK_MENU_VOLUME</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_VOLUME       "Menu_Volume"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27443"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-BOOK-RED-CAPS"
></A
>GNOME_STOCK_MENU_BOOK_RED</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_BOOK_RED     "Menu_Book Red"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27448"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-BOOK-GREEN-CAPS"
></A
>GNOME_STOCK_MENU_BOOK_GREEN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_BOOK_GREEN   "Menu_Book Green"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27453"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-BOOK-BLUE-CAPS"
></A
>GNOME_STOCK_MENU_BOOK_BLUE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_BOOK_BLUE    "Menu_Book Blue"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27458"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-BOOK-YELLOW-CAPS"
></A
>GNOME_STOCK_MENU_BOOK_YELLOW</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_BOOK_YELLOW  "Menu_Book Yellow"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27463"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-BOOK-OPEN-CAPS"
></A
>GNOME_STOCK_MENU_BOOK_OPEN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_BOOK_OPEN    "Menu_Book Open"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27468"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-CONVERT-CAPS"
></A
>GNOME_STOCK_MENU_CONVERT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_CONVERT      "Menu_Convert"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27473"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-JUMP-TO-CAPS"
></A
>GNOME_STOCK_MENU_JUMP_TO</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_JUMP_TO      "Menu_Jump To"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27478"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-UP-CAPS"
></A
>GNOME_STOCK_MENU_UP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_UP           "Menu_Up"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27483"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-DOWN-CAPS"
></A
>GNOME_STOCK_MENU_DOWN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_DOWN         "Menu_Down"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27488"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-TOP-CAPS"
></A
>GNOME_STOCK_MENU_TOP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_TOP          "Menu_Top"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27493"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-BOTTOM-CAPS"
></A
>GNOME_STOCK_MENU_BOTTOM</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_BOTTOM       "Menu_Bottom"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27498"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-ATTACH-CAPS"
></A
>GNOME_STOCK_MENU_ATTACH</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_ATTACH       "Menu_Attach"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27503"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-INDEX-CAPS"
></A
>GNOME_STOCK_MENU_INDEX</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_INDEX        "Menu_Index"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27508"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-FONT-CAPS"
></A
>GNOME_STOCK_MENU_FONT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_FONT         "Menu_Font"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27513"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-EXEC-CAPS"
></A
>GNOME_STOCK_MENU_EXEC</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_EXEC         "Menu_Exec"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27518"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-ALIGN-LEFT-CAPS"
></A
>GNOME_STOCK_MENU_ALIGN_LEFT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_ALIGN_LEFT     "Menu_Left"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27523"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-ALIGN-RIGHT-CAPS"
></A
>GNOME_STOCK_MENU_ALIGN_RIGHT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_ALIGN_RIGHT    "Menu_Right"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27528"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-ALIGN-CENTER-CAPS"
></A
>GNOME_STOCK_MENU_ALIGN_CENTER</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_ALIGN_CENTER   "Menu_Center"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27533"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-ALIGN-JUSTIFY-CAPS"
></A
>GNOME_STOCK_MENU_ALIGN_JUSTIFY</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_ALIGN_JUSTIFY  "Menu_Justify"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27538"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-TEXT-BOLD-CAPS"
></A
>GNOME_STOCK_MENU_TEXT_BOLD</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_TEXT_BOLD      "Menu_Bold"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27543"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-TEXT-ITALIC-CAPS"
></A
>GNOME_STOCK_MENU_TEXT_ITALIC</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_TEXT_ITALIC    "Menu_Italic"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27548"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-TEXT-UNDERLINE-CAPS"
></A
>GNOME_STOCK_MENU_TEXT_UNDERLINE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_TEXT_UNDERLINE "Menu_Underline"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27553"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-TEXT-STRIKEOUT-CAPS"
></A
>GNOME_STOCK_MENU_TEXT_STRIKEOUT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_TEXT_STRIKEOUT "Menu_Strikeout"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27558"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-EXIT-CAPS"
></A
>GNOME_STOCK_MENU_EXIT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_STOCK_MENU_EXIT     GNOME_STOCK_MENU_QUIT</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27563"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-ITEM"
></A
>gnome_stock_menu_item ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_stock_menu_item           (const char *type,
                                             const char *text);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27569"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27586"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-ACCEL"
></A
>gnome_stock_menu_accel ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_stock_menu_accel          (const char *type,
                                             <A
HREF=../glib/glib-basic-types.html#GUCHAR
>guchar</A> *key,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT8
>guint8</A> *mod);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27594"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>key</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mod</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27615"
></A
><H3
><A
NAME="GNOME-STOCK-MENU-ACCEL-PARSE"
></A
>gnome_stock_menu_accel_parse ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_stock_menu_accel_parse    (const char *section);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27620"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>section</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27629"
></A
><H3
><A
NAME="GNOME-STOCK-TRANSPARENT-WINDOW"
></A
>gnome_stock_transparent_window ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_stock_transparent_window  (const char *icon,
                                             const char *subtype);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27635"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>subtype</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27652"
></A
><H3
><A
NAME="GNOME-STOCK-PIXMAP-GDK"
></A
>gnome_stock_pixmap_gdk ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_stock_pixmap_gdk          (const char *icon,
                                             const char *subtype,
                                             <A
HREF=../gdk/gdk-bitmaps-and-pixmaps.html#GDKPIXMAP
>GdkPixmap</A> **pixmap,
                                             <A
HREF=../gdk/gdk-bitmaps-and-pixmaps.html#GDKPIXMAP
>GdkPixmap</A> **mask);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27659"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>icon</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>subtype</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mask</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN27680"
></A
><H2
>See Also</H2
><P
><A
HREF=../gtk/gtkbutton.html
>GtkButton</A>, <A
HREF="gnomepixmap.html"
>GnomePixmap</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomescores.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gtkclock.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
>GnomeScores</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GtkClock</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-app-helper</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="NEXT"
TITLE="gnome-app-util"
HREF="gnomeui-gnome-app-util.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="libgnomeui.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-app-util.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-APP-HELPER"
>gnome-app-helper</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN11"
></A
><H2
>Name</H2
>gnome-app-helper&nbsp;--&nbsp;Simplified menu and toolbar creation.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN14"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


enum        <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFOTYPE"
>GnomeUIInfoType</A
>;
enum        <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFOCONFIGURABLETYPES"
>GnomeUIInfoConfigurableTypes</A
>;
enum        <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIPIXMAPTYPE"
>GnomeUIPixmapType</A
>;
typedef     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
>;
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-KEY-UIDATA-CAPS"
>GNOMEUIINFO_KEY_UIDATA</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-KEY-UIBDATA-CAPS"
>GNOMEUIINFO_KEY_UIBDATA</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-END-CAPS"
>GNOMEUIINFO_END</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-SEPARATOR-CAPS"
>GNOMEUIINFO_SEPARATOR</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-ITEM-CAPS"
>GNOMEUIINFO_ITEM</A
>                (label, tooltip, callback, xpm_data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-ITEM-STOCK-CAPS"
>GNOMEUIINFO_ITEM_STOCK</A
>          (label, tooltip, callback, stock_id)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-ITEM-NONE-CAPS"
>GNOMEUIINFO_ITEM_NONE</A
>           (label, tooltip, callback)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-ITEM-DATA-CAPS"
>GNOMEUIINFO_ITEM_DATA</A
>           (label, tooltip, callback, user_data, xpm_data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-TOGGLEITEM-CAPS"
>GNOMEUIINFO_TOGGLEITEM</A
>          (label, tooltip, callback, xpm_data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-TOGGLEITEM-DATA-CAPS"
>GNOMEUIINFO_TOGGLEITEM_DATA</A
>     (label, tooltip, callback, user_data, xpm_data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-HELP-CAPS"
>GNOMEUIINFO_HELP</A
>                (app_name)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-SUBTREE-CAPS"
>GNOMEUIINFO_SUBTREE</A
>             (label, tree)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-SUBTREE-STOCK-CAPS"
>GNOMEUIINFO_SUBTREE_STOCK</A
>       (label, tree, stock_id)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-RADIOLIST-CAPS"
>GNOMEUIINFO_RADIOLIST</A
>           (list)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-RADIOITEM-CAPS"
>GNOMEUIINFO_RADIOITEM</A
>           (label, tooltip, callback, xpm_data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-RADIOITEM-DATA-CAPS"
>GNOMEUIINFO_RADIOITEM_DATA</A
>      (label, tooltip, callback, user_data, xpm_data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-ABOUT-ITEM-CAPS"
>GNOMEUIINFO_MENU_ABOUT_ITEM</A
>     (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-CLEAR-ITEM-CAPS"
>GNOMEUIINFO_MENU_CLEAR_ITEM</A
>     (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-CLOSE-ITEM-CAPS"
>GNOMEUIINFO_MENU_CLOSE_ITEM</A
>     (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-CLOSE-WINDOW-ITEM-CAPS"
>GNOMEUIINFO_MENU_CLOSE_WINDOW_ITEM</A
>(cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-COPY-ITEM-CAPS"
>GNOMEUIINFO_MENU_COPY_ITEM</A
>      (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-CUT-ITEM-CAPS"
>GNOMEUIINFO_MENU_CUT_ITEM</A
>       (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-EDIT-TREE-CAPS"
>GNOMEUIINFO_MENU_EDIT_TREE</A
>      (tree)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-END-GAME-ITEM-CAPS"
>GNOMEUIINFO_MENU_END_GAME_ITEM</A
>  (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-EXIT-ITEM-CAPS"
>GNOMEUIINFO_MENU_EXIT_ITEM</A
>      (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FILES-TREE-CAPS"
>GNOMEUIINFO_MENU_FILES_TREE</A
>     (tree)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FILE-TREE-CAPS"
>GNOMEUIINFO_MENU_FILE_TREE</A
>      (tree)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FIND-AGAIN-ITEM-CAPS"
>GNOMEUIINFO_MENU_FIND_AGAIN_ITEM</A
>(cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-FIND-ITEM-CAPS"
>GNOMEUIINFO_MENU_FIND_ITEM</A
>      (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-GAME-TREE-CAPS"
>GNOMEUIINFO_MENU_GAME_TREE</A
>      (tree)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-HELP-TREE-CAPS"
>GNOMEUIINFO_MENU_HELP_TREE</A
>      (tree)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-HINT-ITEM-CAPS"
>GNOMEUIINFO_MENU_HINT_ITEM</A
>      (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-NEW-GAME-ITEM-CAPS"
>GNOMEUIINFO_MENU_NEW_GAME_ITEM</A
>  (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-NEW-ITEM-CAPS"
>GNOMEUIINFO_MENU_NEW_ITEM</A
>       (label, tip, cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-NEW-SUBTREE-CAPS"
>GNOMEUIINFO_MENU_NEW_SUBTREE</A
>    (tree)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-NEW-WINDOW-ITEM-CAPS"
>GNOMEUIINFO_MENU_NEW_WINDOW_ITEM</A
>(cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-OPEN-ITEM-CAPS"
>GNOMEUIINFO_MENU_OPEN_ITEM</A
>      (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-PASTE-ITEM-CAPS"
>GNOMEUIINFO_MENU_PASTE_ITEM</A
>     (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-PAUSE-GAME-ITEM-CAPS"
>GNOMEUIINFO_MENU_PAUSE_GAME_ITEM</A
>(cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-PREFERENCES-ITEM-CAPS"
>GNOMEUIINFO_MENU_PREFERENCES_ITEM</A
>(cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-PRINT-ITEM-CAPS"
>GNOMEUIINFO_MENU_PRINT_ITEM</A
>     (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-PRINT-SETUP-ITEM-CAPS"
>GNOMEUIINFO_MENU_PRINT_SETUP_ITEM</A
>(cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-PROPERTIES-ITEM-CAPS"
>GNOMEUIINFO_MENU_PROPERTIES_ITEM</A
>(cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-REDO-ITEM-CAPS"
>GNOMEUIINFO_MENU_REDO_ITEM</A
>      (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-REDO-MOVE-ITEM-CAPS"
>GNOMEUIINFO_MENU_REDO_MOVE_ITEM</A
> (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-REPLACE-ITEM-CAPS"
>GNOMEUIINFO_MENU_REPLACE_ITEM</A
>   (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-RESTART-GAME-ITEM-CAPS"
>GNOMEUIINFO_MENU_RESTART_GAME_ITEM</A
>(cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-REVERT-ITEM-CAPS"
>GNOMEUIINFO_MENU_REVERT_ITEM</A
>    (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-SAVE-AS-ITEM-CAPS"
>GNOMEUIINFO_MENU_SAVE_AS_ITEM</A
>   (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-SAVE-ITEM-CAPS"
>GNOMEUIINFO_MENU_SAVE_ITEM</A
>      (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-SCORES-ITEM-CAPS"
>GNOMEUIINFO_MENU_SCORES_ITEM</A
>    (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-SELECT-ALL-ITEM-CAPS"
>GNOMEUIINFO_MENU_SELECT_ALL_ITEM</A
>(cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-SETTINGS-TREE-CAPS"
>GNOMEUIINFO_MENU_SETTINGS_TREE</A
>  (tree)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-UNDO-ITEM-CAPS"
>GNOMEUIINFO_MENU_UNDO_ITEM</A
>      (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-UNDO-MOVE-ITEM-CAPS"
>GNOMEUIINFO_MENU_UNDO_MOVE_ITEM</A
> (cb, data)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-VIEW-TREE-CAPS"
>GNOMEUIINFO_MENU_VIEW_TREE</A
>      (tree)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-MENU-WINDOWS-TREE-CAPS"
>GNOMEUIINFO_MENU_WINDOWS_TREE</A
>   (tree)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO-SUBTREE-HINT-CAPS"
>GNOMEUIINFO_SUBTREE_HINT</A
>        (label, hint, tree)
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOME-MENU-FILE-STRING-CAPS"
>GNOME_MENU_FILE_STRING</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOME-MENU-FILE-PATH-CAPS"
>GNOME_MENU_FILE_PATH</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOME-MENU-EDIT-STRING-CAPS"
>GNOME_MENU_EDIT_STRING</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOME-MENU-EDIT-PATH-CAPS"
>GNOME_MENU_EDIT_PATH</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOME-MENU-VIEW-STRING-CAPS"
>GNOME_MENU_VIEW_STRING</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOME-MENU-VIEW-PATH-CAPS"
>GNOME_MENU_VIEW_PATH</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOME-MENU-SETTINGS-STRING-CAPS"
>GNOME_MENU_SETTINGS_STRING</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOME-MENU-SETTINGS-PATH-CAPS"
>GNOME_MENU_SETTINGS_PATH</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOME-MENU-FILES-STRING-CAPS"
>GNOME_MENU_FILES_STRING</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOME-MENU-FILES-PATH-CAPS"
>GNOME_MENU_FILES_PATH</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOME-MENU-WINDOWS-STRING-CAPS"
>GNOME_MENU_WINDOWS_STRING</A
>
#define     <A
HREF="gnomeui-gnome-app-helper.html#GNOME-MENU-WINDOWS-PATH-CAPS"
>GNOME_MENU_WINDOWS_PATH</A
>
struct      <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIBUILDERDATA"
>GnomeUIBuilderData</A
>;
void        (<A
HREF="gnomeui-gnome-app-helper.html#GNOMEUISIGNALCONNECTFUNC"
>*GnomeUISignalConnectFunc</A
>)     (<A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *signal_name,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIBUILDERDATA"
>GnomeUIBuilderData</A
> *uibdata);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-FILL-MENU"
>gnome_app_fill_menu</A
>             (<A
HREF=../gtk/gtkmenushell.html
>GtkMenuShell</A> *menu_shell,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../gtk/gtk-keyboard-accelerators.html#GTKACCELGROUP
>GtkAccelGroup</A> *accel_group,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> uline_accels,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> pos);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-FILL-MENU-CUSTOM"
>gnome_app_fill_menu_custom</A
>      (<A
HREF=../gtk/gtkmenushell.html
>GtkMenuShell</A> *menu_shell,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIBUILDERDATA"
>GnomeUIBuilderData</A
> *uibdata,
                                             <A
HREF=../gtk/gtk-keyboard-accelerators.html#GTKACCELGROUP
>GtkAccelGroup</A> *accel_group,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> uline_accels,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> pos);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-UI-CONFIGURE-CONFIGURABLE"
>gnome_app_ui_configure_configurable</A
>
                                            (<A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-CREATE-MENUS"
>gnome_app_create_menus</A
>          (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-CREATE-MENUS-INTERP"
>gnome_app_create_menus_interp</A
>   (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> relay_func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> destroy_func);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-CREATE-MENUS-WITH-DATA"
>gnome_app_create_menus_with_data</A
>
                                            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-CREATE-MENUS-CUSTOM"
>gnome_app_create_menus_custom</A
>   (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIBUILDERDATA"
>GnomeUIBuilderData</A
> *uibdata);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-FILL-TOOLBAR"
>gnome_app_fill_toolbar</A
>          (<A
HREF=../gtk/gtktoolbar.html
>GtkToolbar</A> *toolbar,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../gtk/gtk-keyboard-accelerators.html#GTKACCELGROUP
>GtkAccelGroup</A> *accel_group);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-FILL-TOOLBAR-CUSTOM"
>gnome_app_fill_toolbar_custom</A
>   (<A
HREF=../gtk/gtktoolbar.html
>GtkToolbar</A> *toolbar,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIBUILDERDATA"
>GnomeUIBuilderData</A
> *uibdata,
                                             <A
HREF=../gtk/gtk-keyboard-accelerators.html#GTKACCELGROUP
>GtkAccelGroup</A> *accel_group);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-CREATE-TOOLBAR"
>gnome_app_create_toolbar</A
>        (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-CREATE-TOOLBAR-INTERP"
>gnome_app_create_toolbar_interp</A
> (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> relay_func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> destroy_func);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-CREATE-TOOLBAR-WITH-DATA"
>gnome_app_create_toolbar_with_data</A
>
                                            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-CREATE-TOOLBAR-CUSTOM"
>gnome_app_create_toolbar_custom</A
> (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIBUILDERDATA"
>GnomeUIBuilderData</A
> *uibdata);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-FIND-MENU-POS"
>gnome_app_find_menu_pos</A
>         (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *parent,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *pos);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-REMOVE-MENUS"
>gnome_app_remove_menus</A
>          (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> items);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-REMOVE-MENU-RANGE"
>gnome_app_remove_menu_range</A
>     (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> start,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> items);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-INSERT-MENUS-CUSTOM"
>gnome_app_insert_menus_custom</A
>   (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *menuinfo,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIBUILDERDATA"
>GnomeUIBuilderData</A
> *uibdata);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-INSERT-MENUS"
>gnome_app_insert_menus</A
>          (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *menuinfo);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-INSERT-MENUS-WITH-DATA"
>gnome_app_insert_menus_with_data</A
>
                                            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *menuinfo,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-INSERT-MENUS-INTERP"
>gnome_app_insert_menus_interp</A
>   (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *menuinfo,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> relay_func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> destroy_func);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-INSTALL-APPBAR-MENU-HINTS"
>gnome_app_install_appbar_menu_hints</A
>
                                            (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-INSTALL-STATUSBAR-MENU-HINTS"
>gnome_app_install_statusbar_menu_hints</A
>
                                            (<A
HREF=../gtk/gtkstatusbar.html
>GtkStatusbar</A> *bar,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo);
void        <A
HREF="gnomeui-gnome-app-helper.html#GNOME-APP-INSTALL-MENU-HINTS"
>gnome_app_install_menu_hints</A
>    (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uinfo);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN198"
></A
><H2
>Description</H2
><P
>The GNOME App Helper module contains macros, functions and data
structures used to simplify the creation of menus and toolbars
for GNOME applications.</P
><P
>Menus and toolbars created with GnomeApp helper ensure
a consistent user interface.</P
><P
> The basic building block is an array of
<SPAN
CLASS="STRUCTNAME"
>GnomeUIInfoType</SPAN
> structures.  You can use a
number of macros to fill in each one of these structure entries, or
you can fill each parameter manually if you wish to do so (although,
it is not recommended, as it is an error-prone task).</P
><DIV
CLASS="REFSECT2"
><A
NAME="AEN204"
></A
><H3
>GNOME user interface recomendations for
    applications</H3
><P
>      The following is a list of suggestions to improve the
      consistency of your application with the rest of the GNOME
      tools
    </P
><P
></P
><UL
><LI
><P
>The order of the toplevel menus should be:</P
><P
>File, &lt; any MDI child menus &gt;, Edit, View, Game, CUSTOM MENUS,
	  Settings, Windows and Help</P
><P
>The Help menu should not be right-justified.</P
><P
>CUSTOM MENUS is where you should put your
          application-specific top-level menus, such as Gnumeric's
          "Insert" menu.  These are all optional except Help.</P
></LI
><LI
><P
>The prescribed order of standard menu items in
          the "File" menu is the following:</P
><P
>New Window, SEPARATOR, New, Open, Save, Save As, Revert,
          SEPARATOR, Print, Print Setup, SEPARATOR, Close, and Exit</P
><P
>The first menu must always be the "File" menu (unless
          there are no files in your application, for example, in a
          game you can call this "Game"), and it must always be called
          "_File".</P
><P
>The main reason for this is that it is important for
         the menu accelerators to be consistent.  Your application is
         required to have at the very least a "File" menu containing
         at the very least "Exit".</P
><P
>The New Window menu item should be a subtree if there
         are different types of new windows which can be spawned.</P
><P
>All of these are optional, except Exit.</P
></LI
><LI
><P
>The prescribed order of standard menu items in the "Edit"
         menu is the following:</P
><P
>Undo, Redo, SEPARATOR, Cut, Copy, Paste, Clear, Select
         All, SEPARATOR, Add, SEPARATOR, Find, Find Again, and Replace</P
><P
>The "Add" item should be used to insert new editable
         items, e.g. a new card in a rolodex app.  If there is more
         than one type of insertable editable item, "Add" should be a
         menu subtree.</P
></LI
><LI
><P
>The 'Windows' menu should be used by MDI
        applications to contain a list of the document windows.  It
        should be structured like this:</P
><P
>MDI window list</P
></LI
><LI
><P
>For standard menu items (Save, Save As, Close,
        Quit, etc), use the macros defined in gnome-app-helper.h,
        e.g.</P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN229"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="90%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>	     GNOMEUIINFO_MENU_EXIT_ITEM(CB, DATA)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><P
>except for New where the define is:</P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN232"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="90%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>	     GNOMEUIINFO_MENU_NEW_ITEM(LABEL,TIP,CB,DATA)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><P
>Where LABEL is the the text which appears in the menu
         for this menu item.  You should put LABEL in the form of
         N_("_New Document"), or whatever is appropriate for your
         application.  TIP should be the description of this menu
         item's function, e.g. N_("Create a new document").  This
         ensures that your application menus can be translated to the
         language of the user.</P
></LI
><LI
><P
>The standard print menu item should immediately print
         the document without popping up a dialog.  If the user wants
         a dialog, he will use the print_setup menu item.</P
><P
>For some standard toplevel menus (File, Edit, Help,
         etc), you should use the macros GNOMEUIINFO_*_MENU(tree).</P
></LI
><LI
><P
>For the help menu, you should have this:
     <TT
CLASS="LITERAL"
>GNOMEUIINFO_HELP</TT
>(app_name), <TT
CLASS="LITERAL"
>GNOMEUIINFO_MENU_ABOUT_ITEM</TT
>(cb,
     data), <TT
CLASS="LITERAL"
>GNOMEUIINFO_END</TT
></P
></LI
><LI
><P
>Ellipsis ("...") should be used on menu items that
     require the application to prompt the user for extra information
     before the command can execute.  "Save as..." is one of these
     because the application needs to ask the user for the filename.
     "About" is not because the command *is* to pop up an about box,
     and it does not need to prompt for information before doing that.</P
></LI
><LI
><P
>Your menu hints should not have a trailing period.
     They should be phrased like commands, e.g. "Open a new file".  Do
     not phrase them like a description, e.g. "Opens a new file".</P
></LI
><LI
><P
> All menu text should be internationalized.  Use
     the <A
HREF=../gnome/gnome-gnome-i18n.html#N--CAPS
>N_</A>() macro, e.g.  N_("Open new mailbox")</P
></LI
><LI
><P
>You may notice that most of these guidelines seem
     geared towards "productivity" applications (editors,
     spreadsheets, ...).  If you're writing a game, most of your menu
     items won't be appropriate in these menus.  The solution is to
     create a "Game" menu which contains the game-related menu items.
     The contents of the Game menu are as follows:</P
><P
>New Game, Pause Game, Restart Game, SEPARATOR, Undo Move,
	 Redo Move, Hint, SEPARATOR, Scores, and End game</P
><P
>End game should just end the current game -- it shouldn't
     close the application.  That's the job of File/Exit.</P
></LI
></UL
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN254"
></A
><H3
>Defining menus and toolbars.</H3
><P
>All of the macros prefixed with <TT
CLASS="LITERAL"
>GNOMEUIINFO_MENU_</TT
> can be
    used to simplify the task of making your application consistent
    with the GNOME user interface recomendations.  The macros include
    the default texts to show, images (in case they have one), pop-up
    tooltips and in some cases default key-bindings. </P
><P
>A toplevel menu (like the one used by the GnomeApp widget)
    is just an array of structures of type
    <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfoType</SPAN
>.  Each record of type
    <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfoType</SPAN
> in this array can
    represent a menu item that the user can select, a radio-button, a
    check-box, a division line, or a submenu.</P
><P
>There are a number of macros that will help you fill in this
    structure to make your application conform to the GNOME user
    interface guidelines.</P
><P
>The following macros can be used to create consistent
    toplevel menus and they provide the standard naming for your
    toplevel menus as well as translated texts for the various
    languages supported by the GNOME libraries:</P
><P
></P
><UL
><LI
><P
><TT
CLASS="LITERAL"
>GNOMEUIINFO_MENU_FILE_TREE</TT
>: Used for the
	program "File" menu.  </P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOMEUIINFO_MENU_EDIT_TREE</TT
>: Used for the
	program "Edit" menu.  </P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOMEUIINFO_MENU_VIEW_TREE</TT
>: Used for the
	program "View" menu.  </P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOMEUIINFO_MENU_SETTINGS_TREE</TT
>: Used for the
	program "Settings" menu.  </P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOMEUIINFO_MENU_FILES_TREE</TT
>: Used for the
	program "Files" menu.  </P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOMEUIINFO_MENU_WINDOWS_TREE</TT
>: Used for the
	program "Windows" menu.  </P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOMEUIINFO_MENU_HELP_TREE</TT
>: Used for the
	program "Help" menu.  </P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOMEUIINFO_MENU_GAME_TREE</TT
>: Used for the
	program "Game" menu.  Games should use the "Game" menu is used
	instead of the "File" menu as the main menu entry in the GNOME
	user interface guidelines </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN288"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN290"
></A
><H3
><A
NAME="GNOMEUIINFOTYPE"
></A
>enum GnomeUIInfoType</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum {
	GNOME_APP_UI_ENDOFINFO,		/* No more items, use it at the end of 
					   an array */
	GNOME_APP_UI_ITEM,		/* Normal item, or radio item if it is 
					   inside a radioitems group */
	GNOME_APP_UI_TOGGLEITEM,	/* Toggle (check box) item */
	GNOME_APP_UI_RADIOITEMS,	/* Radio item group */
	GNOME_APP_UI_SUBTREE,		/* Item that defines a 
					   subtree/submenu */
	GNOME_APP_UI_SEPARATOR,		/* Separator line (menus) or blank 
					   space (toolbars) */
	GNOME_APP_UI_HELP,		/* Create a list of help topics, 
					   used in the Help menu */
	GNOME_APP_UI_BUILDER_DATA,	/* Specifies the builder data for the 
					   following entries, see code for 
					   further info */
	GNOME_APP_UI_ITEM_CONFIGURABLE, /* A configurable menu item. */
	/* one should be careful when using 
	 * gnome_app_create_*_[custom|interp|with_data]() functions with 
	 * GnomeUIInfo arrays containing GNOME_APP_UI_BUILDER_DATA items since 
	 * their GnomeUIBuilderData structures completely override the ones 
	 * generated or supplied by the above functions. */
	GNOME_APP_UI_SUBTREE_STOCK	/* Item that defines a 
					   subtree/submenu, same as GNOME_APP_UI_SUBTREE,
					   but the texts should be looked up in the
					   gnome-libs catalog
					*/
} GnomeUIInfoType;</PRE
></TD
></TR
></TABLE
><P
>This enumeration is used to set the value in a
<SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> record to specify the type of the
record.  There are macros that can do all the work for you.  Use
those instead of these macros.  It is defined as follows:</P
><P
></P
><UL
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_APP_UI_ENDOFINFO</TT
>: Use this to denote
	     the end of the records in a <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> array.
	     </P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_APP_UI_ITEM</TT
>: Use this for a normal
             item, or radio item if it is inside a radioitems group.
             </P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_APP_UI_TOGGLEITEM</TT
>: Use this for a
             toggle (check box) item. </P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_APP_UI_RADIOITEMS</TT
>: Use this for a radio
	     item group.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_APP_UI_SUBTREE</TT
>: Use this to define a
	     subtree or a submenu.  Set the
	     <TT
CLASS="STRUCTFIELD"
><I
>moreinfo</I
></TT
> field in the
	     structure to point to another array of <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
>
	     structures.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_APP_UI_SEPARATOR</TT
>: Use this to introduce
	     a separator line (for menus) or a blank (for toolbars).
	     </P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_APP_UI_HELP</TT
>: Use this to create a list
             of help topics.  This is usually employed on the Help
             menu.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_APP_UI_BUILDER_DATA</TT
>: Specifies the
	     builder data for the following entries, see code for
	     further info.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_APP_UI_ITEM_CONFIGURABLE</TT
>: A
	     configurable menu item.  You should be careful when using
	     gnome_app_create_*_[custom|interp|with_data]() functions
	     with GnomeUIInfo arrays containing
	     GNOME_APP_UI_BUILDER_DATA items since their
	     GnomeUIBuilderData structures completely override the
	     ones generated or supplied by the above
	     functions. </P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_APP_UI_SUBTREE_STOCK</TT
>: Use this to
              specifiy a subtree/submenu. Same as
              GNOME_APP_UI_SUBTREE, but the texts should be looked up
              in the gnome-libs catalog. </P
></LI
></UL
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN330"
></A
><H3
><A
NAME="GNOMEUIINFOCONFIGURABLETYPES"
></A
>enum GnomeUIInfoConfigurableTypes</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum {
        /* 0 */
        GNOME_APP_CONFIGURABLE_ITEM_NEW,
        GNOME_APP_CONFIGURABLE_ITEM_OPEN,
        GNOME_APP_CONFIGURABLE_ITEM_SAVE,
        GNOME_APP_CONFIGURABLE_ITEM_SAVE_AS,
        GNOME_APP_CONFIGURABLE_ITEM_REVERT,
        GNOME_APP_CONFIGURABLE_ITEM_PRINT,
        GNOME_APP_CONFIGURABLE_ITEM_PRINT_SETUP,
        GNOME_APP_CONFIGURABLE_ITEM_CLOSE,
        GNOME_APP_CONFIGURABLE_ITEM_EXIT,
        GNOME_APP_CONFIGURABLE_ITEM_CUT,
	/* 10 */
        GNOME_APP_CONFIGURABLE_ITEM_COPY,
        GNOME_APP_CONFIGURABLE_ITEM_PASTE,
        GNOME_APP_CONFIGURABLE_ITEM_CLEAR,
        GNOME_APP_CONFIGURABLE_ITEM_UNDO,
        GNOME_APP_CONFIGURABLE_ITEM_REDO,
        GNOME_APP_CONFIGURABLE_ITEM_FIND,
        GNOME_APP_CONFIGURABLE_ITEM_FIND_AGAIN,
        GNOME_APP_CONFIGURABLE_ITEM_REPLACE,
        GNOME_APP_CONFIGURABLE_ITEM_PROPERTIES,
        GNOME_APP_CONFIGURABLE_ITEM_PREFERENCES,
	/* 20 */
        GNOME_APP_CONFIGURABLE_ITEM_ABOUT,
	GNOME_APP_CONFIGURABLE_ITEM_SELECT_ALL,
	GNOME_APP_CONFIGURABLE_ITEM_NEW_WINDOW,
	GNOME_APP_CONFIGURABLE_ITEM_CLOSE_WINDOW,
	GNOME_APP_CONFIGURABLE_ITEM_NEW_GAME,
	GNOME_APP_CONFIGURABLE_ITEM_PAUSE_GAME,
	GNOME_APP_CONFIGURABLE_ITEM_RESTART_GAME,
	GNOME_APP_CONFIGURABLE_ITEM_UNDO_MOVE,
	GNOME_APP_CONFIGURABLE_ITEM_REDO_MOVE,
	GNOME_APP_CONFIGURABLE_ITEM_HINT,
	/* 30 */
	GNOME_APP_CONFIGURABLE_ITEM_SCORES,
	GNOME_APP_CONFIGURABLE_ITEM_END_GAME
} GnomeUIInfoConfigurableTypes;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN335"
></A
><H3
><A
NAME="GNOMEUIPIXMAPTYPE"
></A
>enum GnomeUIPixmapType</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum {
	GNOME_APP_PIXMAP_NONE,		/* No pixmap specified */
	GNOME_APP_PIXMAP_STOCK,		/* Use a stock pixmap (GnomeStock) */
	GNOME_APP_PIXMAP_DATA,		/* Use a pixmap from inline xpm data */
	GNOME_APP_PIXMAP_FILENAME	/* Use a pixmap from the specified 
					   filename */
} GnomeUIPixmapType;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN340"
></A
><H3
><A
NAME="GNOMEUIINFO"
></A
>GnomeUIInfo</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct {
	GnomeUIInfoType type;		/* Type of item */
	gchar *label;			/* String to use in the label */
	gchar *hint;			/* For toolbar items, the tooltip. For 
					   menu items, the status bar message */
	gpointer moreinfo;		/* For an item, toggleitem, or 
					   radioitem, this is a pointer to the 
					   function to call when the item is 
					   activated. For a subtree, a pointer 
					   to another array of GnomeUIInfo 
					   structures. For a radioitem lead 
					   entry, a pointer to an array of 
					   GnomeUIInfo structures for the radio 
					   item group. For a help item, 
					   specifies the help node to load 
					   (i.e. the application's identifier) 
					   or NULL for the main program's name.
					   For builder data, points to the 
					   GnomeUIBuilderData structure for 
					   the following items */
	gpointer user_data;		/* Data pointer to pass to callbacks */
	gpointer unused_data;		/* Reserved for future expansion, 
					   should be NULL */
	GnomeUIPixmapType pixmap_type;	/* Type of pixmap for the item */
	gconstpointer pixmap_info;      /* Pointer to the pixmap information:
					 *
					 * For GNOME_APP_PIXMAP_STOCK, a 
					 * pointer to the stock icon name.
					 *
					 * For GNOME_APP_PIXMAP_DATA, a 
					 * pointer to the inline xpm data.
					 *
					 * For GNOME_APP_PIXMAP_FILENAME, a 
					 * pointer to the filename string.
					 */
	guint accelerator_key;		/* Accelerator key, or 0 for none */
	GdkModifierType ac_mods;	/* Mask of modifier keys for the 
					   accelerator */

	GtkWidget *widget;		/* Filled in by gnome_app_create*, you 
					   can use this to tweak the widgets 
					   once they have been created */
} GnomeUIInfo;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN345"
></A
><H3
><A
NAME="GNOMEUIINFO-KEY-UIDATA-CAPS"
></A
>GNOMEUIINFO_KEY_UIDATA</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOMEUIINFO_KEY_UIDATA		"uidata"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN350"
></A
><H3
><A
NAME="GNOMEUIINFO-KEY-UIBDATA-CAPS"
></A
>GNOMEUIINFO_KEY_UIBDATA</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOMEUIINFO_KEY_UIBDATA		"uibdata"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN355"
></A
><H3
><A
NAME="GNOMEUIINFO-END-CAPS"
></A
>GNOMEUIINFO_END</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_END</PRE
></TD
></TR
></TABLE
><P
>Use this macro to tag the end of a menu or toolbar definition.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN360"
></A
><H3
><A
NAME="GNOMEUIINFO-SEPARATOR-CAPS"
></A
>GNOMEUIINFO_SEPARATOR</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_SEPARATOR</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a separator in your menu.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN365"
></A
><H3
><A
NAME="GNOMEUIINFO-ITEM-CAPS"
></A
>GNOMEUIINFO_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_ITEM(label, tooltip, callback, xpm_data)</PRE
></TD
></TR
></TABLE
><P
>Generic menu or toolbar item which includes a label, a tooltip and an
optional pixmap (in xpm format) to be displayed next to the entry. </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN370"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The text that will be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tooltip</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The tooltip that will popup.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Callback routine to invoke.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>xpm_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to a pixmap to display (in C-xpm format).
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN391"
></A
><H3
><A
NAME="GNOMEUIINFO-ITEM-STOCK-CAPS"
></A
>GNOMEUIINFO_ITEM_STOCK()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_ITEM_STOCK(label, tooltip, callback, stock_id)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include an item in your menu that includes a
GNOME-stock image.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN396"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The text that will be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tooltip</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The tooltip that will popup.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Callback routine to invoke.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>stock_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A GNOME-stock pixmap name.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN417"
></A
><H3
><A
NAME="GNOMEUIINFO-ITEM-NONE-CAPS"
></A
>GNOMEUIINFO_ITEM_NONE()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_ITEM_NONE(label, tooltip, callback)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to add an item to the menu that has no pixmap
associated with it. </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN422"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The text that will be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tooltip</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The tooltip that will popup.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Callback routine to invoke.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN439"
></A
><H3
><A
NAME="GNOMEUIINFO-ITEM-DATA-CAPS"
></A
>GNOMEUIINFO_ITEM_DATA()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_ITEM_DATA(label, tooltip, callback, user_data, xpm_data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to create a menu item and keep some information in the
structure.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN444"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The text that will be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tooltip</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The tooltip that will popup.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Callback routine to invoke.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Data passed around.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>xpm_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to a pixmap to display (in C-xpm format).
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN469"
></A
><H3
><A
NAME="GNOMEUIINFO-TOGGLEITEM-CAPS"
></A
>GNOMEUIINFO_TOGGLEITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_TOGGLEITEM(label, tooltip, callback, xpm_data)</PRE
></TD
></TR
></TABLE
><P
>Creates a toggle-item (a checkbox) in a menu, this includes an xpm
graphic. </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN474"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The text that will be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tooltip</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The tooltip that will popup.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Callback routine to invoke.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>xpm_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to a pixmap to display (in C-xpm format).
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN495"
></A
><H3
><A
NAME="GNOMEUIINFO-TOGGLEITEM-DATA-CAPS"
></A
>GNOMEUIINFO_TOGGLEITEM_DATA()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_TOGGLEITEM_DATA(label, tooltip, callback, user_data, xpm_data)</PRE
></TD
></TR
></TABLE
><P
>Creates a toggle-item (a checkbox) in a menu, this includes an xpm
graphic.  Allows you to specify the data to be passed around to your
callback routine.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN500"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The text that will be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tooltip</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The tooltip that will popup.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Callback routine to invoke.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Data to pass to callback routine.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>xpm_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to a pixmap to display (in C-xpm format).
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN525"
></A
><H3
><A
NAME="GNOMEUIINFO-HELP-CAPS"
></A
>GNOMEUIINFO_HELP()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_HELP(app_name)</PRE
></TD
></TR
></TABLE
><P
>This special item inserts all of the topics defined by the application
in the <TT
CLASS="FILENAME"
>topic.dat</TT
> file.  The menu is constructed
from the information stored in the file associated with the <TT
CLASS="PARAMETER"
><I
>app_name</I
></TT
>
you provide.  The information is usually taken from
<TT
CLASS="FILENAME"
>$(datadir)/help/<TT
CLASS="PARAMETER"
><I
>app_name</I
></TT
>/$LANG/topic.dat</TT
>.  Where
$LANG is the language chosen when running the application.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN534"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app_name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The application name.  Used to locate the correct topic.dat file.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN543"
></A
><H3
><A
NAME="GNOMEUIINFO-SUBTREE-CAPS"
></A
>GNOMEUIINFO_SUBTREE()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_SUBTREE(label, tree)</PRE
></TD
></TR
></TABLE
><P
>Creates a submenu or a sub-tree in the menu structure.  The argument
passed is an array of <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
>.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN549"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The text that will be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
>.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN563"
></A
><H3
><A
NAME="GNOMEUIINFO-SUBTREE-STOCK-CAPS"
></A
>GNOMEUIINFO_SUBTREE_STOCK()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_SUBTREE_STOCK(label, tree, stock_id)</PRE
></TD
></TR
></TABLE
><P
>Creates a submenu or a sub-tree in the menu structure with a stock
pixmap displayed.  The argument
passed is an array of <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
>.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN569"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The text that will be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>stock_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A GNOME-stock pixmap name.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN587"
></A
><H3
><A
NAME="GNOMEUIINFO-RADIOLIST-CAPS"
></A
>GNOMEUIINFO_RADIOLIST()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_RADIOLIST(list)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN592"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN601"
></A
><H3
><A
NAME="GNOMEUIINFO-RADIOITEM-CAPS"
></A
>GNOMEUIINFO_RADIOITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_RADIOITEM(label, tooltip, callback, xpm_data)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN606"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The text that will be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tooltip</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The tooltip that will popup.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Callback routine to invoke.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>xpm_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to a pixmap to display (in C-xpm format).
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN627"
></A
><H3
><A
NAME="GNOMEUIINFO-RADIOITEM-DATA-CAPS"
></A
>GNOMEUIINFO_RADIOITEM_DATA()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_RADIOITEM_DATA(label, tooltip, callback, user_data, xpm_data)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN632"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The text that will be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tooltip</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The tooltip that will popup.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Callback routine to invoke.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>xpm_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to a pixmap to display (in C-xpm format).
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN657"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-ABOUT-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_ABOUT_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_ABOUT_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro inside a GnomeUIInfo structure to include an "About"
menu entry.  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN662"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN675"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-CLEAR-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_CLEAR_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_CLEAR_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro inside a GnomeUIInfo structure to include a "Clear"
option.  This is used typically in the Edit menu. </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN680"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN693"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-CLOSE-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_CLOSE_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_CLOSE_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro inside a GnomeUIInfo structure to include a "Close"
menu entry.  This is used typically in the File menu or the Game menu
to close the toplevel window.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN698"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN711"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-CLOSE-WINDOW-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_CLOSE_WINDOW_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_CLOSE_WINDOW_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro inside a GnomeUIInfo structure to include a "Close"
option.  This is used typically in the Window menu if your application
includes one.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN716"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN729"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-COPY-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_COPY_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_COPY_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro inside a GnomeUIInfo structure to include a "Copy"
option.  This is used typically in the Edit menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN734"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN747"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-CUT-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_CUT_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_CUT_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro inside a GnomeUIInfo structure to include a "Cut"
option.  This is used typically in the Edit menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN752"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN765"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-EDIT-TREE-CAPS"
></A
>GNOMEUIINFO_MENU_EDIT_TREE()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_EDIT_TREE(tree)</PRE
></TD
></TR
></TABLE
><P
>Inserts a top-level "Edit" menu.  The argument is a pointer to
<SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> that will contain the submenu to
insert. </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN771"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>array of <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> structures for
the submenu.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN781"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-END-GAME-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_END_GAME_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_END_GAME_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include an "End game" menu item.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN786"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN799"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-EXIT-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_EXIT_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_EXIT_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include an "Exit" menu entry.  To be included in the
"File" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN804"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN817"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-FILES-TREE-CAPS"
></A
>GNOMEUIINFO_MENU_FILES_TREE()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_FILES_TREE(tree)</PRE
></TD
></TR
></TABLE
><P
>Inserts a top-level "Files" menu.  The argument is pointer to
<SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> that will contain the submenu to
insert. </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN823"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>array of <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> structures for
the submenu.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN833"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-FILE-TREE-CAPS"
></A
>GNOMEUIINFO_MENU_FILE_TREE()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_FILE_TREE(tree)</PRE
></TD
></TR
></TABLE
><P
>Inserts a top-level "File" menu.  The argument is pointer to
<SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> that will contain the submenu to
insert. </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN839"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>array of <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> structures for
the submenu.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN849"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-FIND-AGAIN-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_FIND_AGAIN_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_FIND_AGAIN_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Find again" menu entry.  To be included
in the "Edit" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN854"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN867"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-FIND-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_FIND_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_FIND_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Find" menu entry.  To be included in the
"Edit" menu.&#13;</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN872"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN885"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-GAME-TREE-CAPS"
></A
>GNOMEUIINFO_MENU_GAME_TREE()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_GAME_TREE(tree)</PRE
></TD
></TR
></TABLE
><P
>Inserts a top-level "Game" menu.  The argument is a pointer to
<SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> that will contain the submenu to
insert. </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN891"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>array of <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> structures for
the submenu.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN901"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-HELP-TREE-CAPS"
></A
>GNOMEUIINFO_MENU_HELP_TREE()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_HELP_TREE(tree)</PRE
></TD
></TR
></TABLE
><P
>Inserts a top-level "Game" menu.  The argument is pointer to
<SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> that will contain the submenu to
insert. </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN907"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>array of <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> structures for
the submenu.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN917"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-HINT-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_HINT_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_HINT_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN922"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN935"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-NEW-GAME-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_NEW_GAME_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_NEW_GAME_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include an "New game" menu entry.  To be included in the
"Game" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN940"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN953"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-NEW-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_NEW_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_NEW_ITEM(label, tip, cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "New" menu entry.  To be included in the
"File" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN958"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The text that will be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tip</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN979"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-NEW-SUBTREE-CAPS"
></A
>GNOMEUIINFO_MENU_NEW_SUBTREE()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_NEW_SUBTREE(tree)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN984"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>array of <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> structures for
the submenu.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN994"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-NEW-WINDOW-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_NEW_WINDOW_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_NEW_WINDOW_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "New window" menu entry.  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN999"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1012"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-OPEN-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_OPEN_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_OPEN_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include an "Open" menu entry.  To be used in the
"File" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1017"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1030"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-PASTE-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_PASTE_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_PASTE_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Paste" menu entry.  To be used in the
"Edit" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1035"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1048"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-PAUSE-GAME-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_PAUSE_GAME_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_PAUSE_GAME_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Pause game" menu entry.  To be used in the
"Game" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1053"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1066"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-PREFERENCES-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_PREFERENCES_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_PREFERENCES_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Preferences" menu entry.  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1071"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1084"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-PRINT-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_PRINT_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_PRINT_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Print" menu entry.  To be used in the
"File" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1089"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1102"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-PRINT-SETUP-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_PRINT_SETUP_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_PRINT_SETUP_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Print setup" menu entry.  To be used in the
"File" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1107"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1120"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-PROPERTIES-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_PROPERTIES_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_PROPERTIES_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Properties" menu entry.  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1125"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1138"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-REDO-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_REDO_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_REDO_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Redo" menu entry.  Most likely to be put
in the "Edit" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1143"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1156"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-REDO-MOVE-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_REDO_MOVE_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_REDO_MOVE_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Redo move" menu entry.  Most likely to be put
in the "Edit" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1161"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1174"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-REPLACE-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_REPLACE_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_REPLACE_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Replace" menu entry.  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1179"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1192"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-RESTART-GAME-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_RESTART_GAME_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_RESTART_GAME_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Restart game" menu entry.  To be used in
the "Game" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1197"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1210"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-REVERT-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_REVERT_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_REVERT_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Revert" menu entry.  </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1215"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1228"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-SAVE-AS-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_SAVE_AS_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_SAVE_AS_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Save as" menu entry.  To be used in
the "File" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1233"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1246"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-SAVE-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_SAVE_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_SAVE_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Save" menu entry.  To be used in
the "File" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1251"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1264"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-SCORES-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_SCORES_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_SCORES_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Scores" menu entry.  To be used in
the "Game" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1269"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1282"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-SELECT-ALL-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_SELECT_ALL_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_SELECT_ALL_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include a "Select all" menu entry.  Most likely to
be used in the "Edit" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1287"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1300"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-SETTINGS-TREE-CAPS"
></A
>GNOMEUIINFO_MENU_SETTINGS_TREE()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_SETTINGS_TREE(tree)</PRE
></TD
></TR
></TABLE
><P
>Inserts a top-level "Settings" menu.  The argument is a pointer to
<SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> that will contain the submenu to
insert. </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1306"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>array of <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> structures for
the submenu.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1316"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-UNDO-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_UNDO_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_UNDO_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include an "Undo" menu entry.  Most likely to
be used in the "Edit" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1321"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1334"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-UNDO-MOVE-ITEM-CAPS"
></A
>GNOMEUIINFO_MENU_UNDO_MOVE_ITEM()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_UNDO_MOVE_ITEM(cb, data)</PRE
></TD
></TR
></TABLE
><P
>Use this macro to include an "Undo move" menu entry.  Most likely to
be used in the "Edit" menu.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1339"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Specifies the routine to be invoked when the menu is selected</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The data passed to your routine.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1352"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-VIEW-TREE-CAPS"
></A
>GNOMEUIINFO_MENU_VIEW_TREE()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_VIEW_TREE(tree)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1357"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>array of <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> structures for
the submenu.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1367"
></A
><H3
><A
NAME="GNOMEUIINFO-MENU-WINDOWS-TREE-CAPS"
></A
>GNOMEUIINFO_MENU_WINDOWS_TREE()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_MENU_WINDOWS_TREE(tree)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1372"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>array of <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> structures for
the submenu.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1382"
></A
><H3
><A
NAME="GNOMEUIINFO-SUBTREE-HINT-CAPS"
></A
>GNOMEUIINFO_SUBTREE_HINT()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     GNOMEUIINFO_SUBTREE_HINT(label, hint, tree)</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1387"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The text that will be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>hint</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tree</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>array of <SPAN
CLASS="STRUCTNAME"
>GnomeUIInfo</SPAN
> structures for
the submenu.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1405"
></A
><H3
><A
NAME="GNOME-MENU-FILE-STRING-CAPS"
></A
>GNOME_MENU_FILE_STRING</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MENU_FILE_STRING D_("_File")</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1410"
></A
><H3
><A
NAME="GNOME-MENU-FILE-PATH-CAPS"
></A
>GNOME_MENU_FILE_PATH</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MENU_FILE_PATH D_("_File/")</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1415"
></A
><H3
><A
NAME="GNOME-MENU-EDIT-STRING-CAPS"
></A
>GNOME_MENU_EDIT_STRING</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MENU_EDIT_STRING D_("_Edit")</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1420"
></A
><H3
><A
NAME="GNOME-MENU-EDIT-PATH-CAPS"
></A
>GNOME_MENU_EDIT_PATH</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MENU_EDIT_PATH D_("_Edit/")</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1425"
></A
><H3
><A
NAME="GNOME-MENU-VIEW-STRING-CAPS"
></A
>GNOME_MENU_VIEW_STRING</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MENU_VIEW_STRING D_("_View")</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1430"
></A
><H3
><A
NAME="GNOME-MENU-VIEW-PATH-CAPS"
></A
>GNOME_MENU_VIEW_PATH</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MENU_VIEW_PATH D_("_View/")</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1435"
></A
><H3
><A
NAME="GNOME-MENU-SETTINGS-STRING-CAPS"
></A
>GNOME_MENU_SETTINGS_STRING</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MENU_SETTINGS_STRING D_("_Settings")</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1440"
></A
><H3
><A
NAME="GNOME-MENU-SETTINGS-PATH-CAPS"
></A
>GNOME_MENU_SETTINGS_PATH</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MENU_SETTINGS_PATH D_("_Settings/")</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1445"
></A
><H3
><A
NAME="GNOME-MENU-FILES-STRING-CAPS"
></A
>GNOME_MENU_FILES_STRING</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MENU_FILES_STRING D_("Fi_les")</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1450"
></A
><H3
><A
NAME="GNOME-MENU-FILES-PATH-CAPS"
></A
>GNOME_MENU_FILES_PATH</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MENU_FILES_PATH D_("Fi_les/")</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1455"
></A
><H3
><A
NAME="GNOME-MENU-WINDOWS-STRING-CAPS"
></A
>GNOME_MENU_WINDOWS_STRING</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MENU_WINDOWS_STRING D_("_Windows")</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1460"
></A
><H3
><A
NAME="GNOME-MENU-WINDOWS-PATH-CAPS"
></A
>GNOME_MENU_WINDOWS_PATH</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_MENU_WINDOWS_PATH D_("_Windows/")</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1465"
></A
><H3
><A
NAME="GNOMEUIBUILDERDATA"
></A
>struct GnomeUIBuilderData</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeUIBuilderData {
	GnomeUISignalConnectFunc connect_func;	/* Function that connects to the item's signals */
	gpointer data;				/* User data pointer */
	gboolean is_interp;			/* Should use gtk_signal_connect_interp or normal gtk_signal_connect? */
	GtkCallbackMarshal relay_func;		/* Marshaller function for language bindings */
	GtkDestroyNotify destroy_func;		/* Destroy notification function for language bindings */
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1470"
></A
><H3
><A
NAME="GNOMEUISIGNALCONNECTFUNC"
></A
>GnomeUISignalConnectFunc ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        (*GnomeUISignalConnectFunc)     (<A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *signal_name,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIBUILDERDATA"
>GnomeUIBuilderData</A
> *uibdata);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1478"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>signal_name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uibdata</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1495"
></A
><H3
><A
NAME="GNOME-APP-FILL-MENU"
></A
>gnome_app_fill_menu ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_fill_menu             (<A
HREF=../gtk/gtkmenushell.html
>GtkMenuShell</A> *menu_shell,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../gtk/gtk-keyboard-accelerators.html#GTKACCELGROUP
>GtkAccelGroup</A> *accel_group,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> uline_accels,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> pos);</PRE
></TD
></TR
></TABLE
><P
>Fills the specified menu shell with items created from the specified
info, inserting them from the item no. pos on.
The accel group will be used as the accel group for all newly created
sub menus and serves as the global accel group for all menu item
hotkeys. If it is passed as NULL, global hotkeys will be disabled.
The uline_accels argument determines whether underline accelerators
will be featured from the menu item labels.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1506"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>menu_shell</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>accel_group</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uline_accels</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1531"
></A
><H3
><A
NAME="GNOME-APP-FILL-MENU-CUSTOM"
></A
>gnome_app_fill_menu_custom ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_fill_menu_custom      (<A
HREF=../gtk/gtkmenushell.html
>GtkMenuShell</A> *menu_shell,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIBUILDERDATA"
>GnomeUIBuilderData</A
> *uibdata,
                                             <A
HREF=../gtk/gtk-keyboard-accelerators.html#GTKACCELGROUP
>GtkAccelGroup</A> *accel_group,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> uline_accels,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> pos);</PRE
></TD
></TR
></TABLE
><P
>Fills the specified menu shell with items created from the specified
info, inserting them from item no. pos on and using the specified
builder data -- this is intended for language bindings.
The accel group will be used as the accel group for all newly created
sub menus and serves as the global accel group for all menu item
hotkeys. If it is passed as NULL, global hotkeys will be disabled.
The uline_accels argument determines whether underline accelerators
will be featured from the menu item labels.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1543"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>menu_shell</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uibdata</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>accel_group</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uline_accels</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1572"
></A
><H3
><A
NAME="GNOME-APP-UI-CONFIGURE-CONFIGURABLE"
></A
>gnome_app_ui_configure_configurable ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_ui_configure_configurable
                                            (<A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo);</PRE
></TD
></TR
></TABLE
><P
>Configure all user-configurable elements in the given UI info 
structure.  This includes loading and setting previously-set options from
GNOME config files.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1579"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME UI menu/toolbar info</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1588"
></A
><H3
><A
NAME="GNOME-APP-CREATE-MENUS"
></A
>gnome_app_create_menus ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_create_menus          (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo);</PRE
></TD
></TR
></TABLE
><P
>Constructs a menu bar and attaches it to the specified application
window.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1596"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1609"
></A
><H3
><A
NAME="GNOME-APP-CREATE-MENUS-INTERP"
></A
>gnome_app_create_menus_interp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_create_menus_interp   (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> relay_func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> destroy_func);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1620"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>relay_func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>destroy_func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1645"
></A
><H3
><A
NAME="GNOME-APP-CREATE-MENUS-WITH-DATA"
></A
>gnome_app_create_menus_with_data ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_create_menus_with_data
                                            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1654"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1671"
></A
><H3
><A
NAME="GNOME-APP-CREATE-MENUS-CUSTOM"
></A
>gnome_app_create_menus_custom ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_create_menus_custom   (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIBUILDERDATA"
>GnomeUIBuilderData</A
> *uibdata);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1680"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uibdata</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1697"
></A
><H3
><A
NAME="GNOME-APP-FILL-TOOLBAR"
></A
>gnome_app_fill_toolbar ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_fill_toolbar          (<A
HREF=../gtk/gtktoolbar.html
>GtkToolbar</A> *toolbar,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../gtk/gtk-keyboard-accelerators.html#GTKACCELGROUP
>GtkAccelGroup</A> *accel_group);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1706"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>toolbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>accel_group</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1723"
></A
><H3
><A
NAME="GNOME-APP-FILL-TOOLBAR-CUSTOM"
></A
>gnome_app_fill_toolbar_custom ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_fill_toolbar_custom   (<A
HREF=../gtk/gtktoolbar.html
>GtkToolbar</A> *toolbar,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIBUILDERDATA"
>GnomeUIBuilderData</A
> *uibdata,
                                             <A
HREF=../gtk/gtk-keyboard-accelerators.html#GTKACCELGROUP
>GtkAccelGroup</A> *accel_group);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1733"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>toolbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uibdata</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>accel_group</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1754"
></A
><H3
><A
NAME="GNOME-APP-CREATE-TOOLBAR"
></A
>gnome_app_create_toolbar ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_create_toolbar        (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo);</PRE
></TD
></TR
></TABLE
><P
>Constructs a toolbar and attaches it to the specified application
window.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1762"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1775"
></A
><H3
><A
NAME="GNOME-APP-CREATE-TOOLBAR-INTERP"
></A
>gnome_app_create_toolbar_interp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_create_toolbar_interp (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> relay_func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> destroy_func);</PRE
></TD
></TR
></TABLE
><P
>Constructs a toolbar and attaches it to the specified application
window -- this version is intended for language bindings.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1786"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>relay_func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>destroy_func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1811"
></A
><H3
><A
NAME="GNOME-APP-CREATE-TOOLBAR-WITH-DATA"
></A
>gnome_app_create_toolbar_with_data ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_create_toolbar_with_data
                                            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>Constructs a toolbar, sets all the user data pointers to
<TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>, and attaches it to <TT
CLASS="PARAMETER"
><I
>app</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1822"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1839"
></A
><H3
><A
NAME="GNOME-APP-CREATE-TOOLBAR-CUSTOM"
></A
>gnome_app_create_toolbar_custom ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_create_toolbar_custom (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIBUILDERDATA"
>GnomeUIBuilderData</A
> *uibdata);</PRE
></TD
></TR
></TABLE
><P
>Constructs a toolbar and attaches it to the <TT
CLASS="PARAMETER"
><I
>app</I
></TT
> window,
using <TT
CLASS="PARAMETER"
><I
>uibdata</I
></TT
> builder data -- intended for language bindings.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1850"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uibdata</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1867"
></A
><H3
><A
NAME="GNOME-APP-FIND-MENU-POS"
></A
>gnome_app_find_menu_pos ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_app_find_menu_pos         (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *parent,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *pos);</PRE
></TD
></TR
></TABLE
><P
>finds menu item described by path starting
in the GtkMenuShell top and returns its parent GtkMenuShell and the
position after this item in pos:  gtk_menu_shell_insert(p, w, pos)
would then insert widget w in GtkMenuShell p right after the menu item
described by path.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1877"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Root menu shell widget containing menu items to be searched</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Specifies the target menu item by menu path</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> (output) returned item position</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1898"
></A
><H3
><A
NAME="GNOME-APP-REMOVE-MENUS"
></A
>gnome_app_remove_menus ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_remove_menus          (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> items);</PRE
></TD
></TR
></TABLE
><P
>removes num items from the existing app's menu structure
beginning with item described by path</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1907"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>items</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1924"
></A
><H3
><A
NAME="GNOME-APP-REMOVE-MENU-RANGE"
></A
>gnome_app_remove_menu_range ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_remove_menu_range     (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> start,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> items);</PRE
></TD
></TR
></TABLE
><P
>Same as the gnome_app_remove_menus, except it removes the specified number
of <TT
CLASS="PARAMETER"
><I
>items</I
></TT
> from the existing app's menu structure begining with item described
by path, plus the number specified by <TT
CLASS="PARAMETER"
><I
>start</I
></TT
> - very useful for adding and
removing Recent document items in the File menu.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1936"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>start</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>items</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1957"
></A
><H3
><A
NAME="GNOME-APP-INSERT-MENUS-CUSTOM"
></A
>gnome_app_insert_menus_custom ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_insert_menus_custom   (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *menuinfo,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIBUILDERDATA"
>GnomeUIBuilderData</A
> *uibdata);</PRE
></TD
></TR
></TABLE
><P
>inserts menus described by <TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
> in existing app's menu
structure right after the item described by <TT
CLASS="PARAMETER"
><I
>path</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1969"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>menuinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uibdata</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1990"
></A
><H3
><A
NAME="GNOME-APP-INSERT-MENUS"
></A
>gnome_app_insert_menus ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_insert_menus          (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *menuinfo);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN1999"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>menuinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2016"
></A
><H3
><A
NAME="GNOME-APP-INSERT-MENUS-WITH-DATA"
></A
>gnome_app_insert_menus_with_data ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_insert_menus_with_data
                                            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *menuinfo,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2026"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>menuinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2047"
></A
><H3
><A
NAME="GNOME-APP-INSERT-MENUS-INTERP"
></A
>gnome_app_insert_menus_interp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_insert_menus_interp   (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *path,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *menuinfo,
                                             <A
HREF=../gtk/gtk-types.html#GTKCALLBACKMARSHAL
>GtkCallbackMarshal</A> relay_func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtk-types.html#GTKDESTROYNOTIFY
>GtkDestroyNotify</A> destroy_func);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2059"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>menuinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>relay_func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>destroy_func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2088"
></A
><H3
><A
NAME="GNOME-APP-INSTALL-APPBAR-MENU-HINTS"
></A
>gnome_app_install_appbar_menu_hints ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_install_appbar_menu_hints
                                            (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo);</PRE
></TD
></TR
></TABLE
><P
>Install menu hints for the given GNOME app bar object.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2096"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>appbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app bar object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GNOME UI info for menu</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2109"
></A
><H3
><A
NAME="GNOME-APP-INSTALL-STATUSBAR-MENU-HINTS"
></A
>gnome_app_install_statusbar_menu_hints ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_install_statusbar_menu_hints
                                            (<A
HREF=../gtk/gtkstatusbar.html
>GtkStatusbar</A> *bar,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo);</PRE
></TD
></TR
></TABLE
><P
>Install menu hints for the given status bar.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2117"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>bar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to Gtk+ status bar object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Gnome UI info for the menu to be changed</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2130"
></A
><H3
><A
NAME="GNOME-APP-INSTALL-MENU-HINTS"
></A
>gnome_app_install_menu_hints ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_install_menu_hints    (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uinfo);</PRE
></TD
></TR
></TABLE
><P
>Set menu hints for the GNOME app object's attached status bar.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2138"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="libgnomeui.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-app-util.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
>Gnome User Interface Library</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-app-util</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-app-util</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-app-helper"
HREF="gnomeui-gnome-app-helper.html"><LINK
REL="NEXT"
TITLE="gnome-canvas-util"
HREF="gnomeui-gnome-canvas-util.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-app-helper.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-canvas-util.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-APP-UTIL"
>gnome-app-util</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN2156"
></A
><H2
>Name</H2
>gnome-app-util&nbsp;--&nbsp;Utility functions for manipulating GnomeApp container widgets.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN2159"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-app-util.html#GNOME-APP-MESSAGE"
>gnome_app_message</A
>               (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message);
void        <A
HREF="gnomeui-gnome-app-util.html#GNOME-APP-FLASH"
>gnome_app_flash</A
>                 (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *flash);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-app-util.html#GNOME-APP-ERROR"
>gnome_app_error</A
>                 (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *error);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-app-util.html#GNOME-APP-WARNING"
>gnome_app_warning</A
>               (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *warning);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-app-util.html#GNOME-APP-QUESTION"
>gnome_app_question</A
>              (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-app-util.html#GNOME-APP-QUESTION-MODAL"
>gnome_app_question_modal</A
>        (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-app-util.html#GNOME-APP-OK-CANCEL"
>gnome_app_ok_cancel</A
>             (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-app-util.html#GNOME-APP-OK-CANCEL-MODAL"
>gnome_app_ok_cancel_modal</A
>       (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-app-util.html#GNOME-APP-REQUEST-STRING"
>gnome_app_request_string</A
>        (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-app-util.html#GNOME-APP-REQUEST-PASSWORD"
>gnome_app_request_password</A
>      (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
<A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>     (<A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSFUNC"
>*GnomeAppProgressFunc</A
>)         (<A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
void        (<A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSCANCELFUNC"
>*GnomeAppProgressCancelFunc</A
>)   (<A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
typedef     <A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSKEY"
>GnomeAppProgressKey</A
>;
<A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSKEY"
>GnomeAppProgressKey</A
> <A
HREF="gnomeui-gnome-app-util.html#GNOME-APP-PROGRESS-TIMEOUT"
>gnome_app_progress_timeout</A
>
                                            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *description,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval,
                                             <A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSFUNC"
>GnomeAppProgressFunc</A
> percentage_cb,
                                             <A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSCANCELFUNC"
>GnomeAppProgressCancelFunc</A
> cancel_cb,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
<A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSKEY"
>GnomeAppProgressKey</A
> <A
HREF="gnomeui-gnome-app-util.html#GNOME-APP-PROGRESS-MANUAL"
>gnome_app_progress_manual</A
>
                                            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *description,
                                             <A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSCANCELFUNC"
>GnomeAppProgressCancelFunc</A
> cancel_cb,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
void        <A
HREF="gnomeui-gnome-app-util.html#GNOME-APP-SET-PROGRESS"
>gnome_app_set_progress</A
>          (<A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSKEY"
>GnomeAppProgressKey</A
> key,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> percent);
void        <A
HREF="gnomeui-gnome-app-util.html#GNOME-APP-PROGRESS-DONE"
>gnome_app_progress_done</A
>         (<A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSKEY"
>GnomeAppProgressKey</A
> key);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2238"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2241"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN2243"
></A
><H3
><A
NAME="GNOME-APP-MESSAGE"
></A
>gnome_app_message ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_app_message               (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message);</PRE
></TD
></TR
></TABLE
><P
>A simple message, in an OK dialog or the status bar.
Requires confirmation from the user before it goes away.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2252"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text of message to be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to dialog widget, or <TT
CLASS="LITERAL"
>NULL</TT
> if error or message in
status bar.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2270"
></A
><H3
><A
NAME="GNOME-APP-FLASH"
></A
>gnome_app_flash ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_flash                 (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *flash);</PRE
></TD
></TR
></TABLE
><P
>Flash the message in the statusbar for a few moments; if no
statusbar, do nothing (?). For trivial little status messages,
e.g. "Auto saving..."</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2278"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>flash</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text of message to be flashed</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2291"
></A
><H3
><A
NAME="GNOME-APP-ERROR"
></A
>gnome_app_error ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_app_error                 (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *error);</PRE
></TD
></TR
></TABLE
><P
>An important fatal error; if it appears in the statusbar, 
it might <A
HREF=../gdk/gdk-general.html#GDK-BEEP
>gdk_beep</A>() and require acknowledgement.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2301"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>error</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text of error message to be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to dialog widget, or <TT
CLASS="LITERAL"
>NULL</TT
> if error or message in
status bar.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2319"
></A
><H3
><A
NAME="GNOME-APP-WARNING"
></A
>gnome_app_warning ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_app_warning               (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *warning);</PRE
></TD
></TR
></TABLE
><P
>A not-so-important error, but still marked better than a flash</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2328"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>warning</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text of warning message to be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to dialog widget, or <TT
CLASS="LITERAL"
>NULL</TT
> if error or message in
status bar.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2346"
></A
><H3
><A
NAME="GNOME-APP-QUESTION"
></A
>gnome_app_question ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_app_question              (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Ask a yes or no question, and call the callback when it's answered.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2357"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>question</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text of question to be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to dialog widget, or <TT
CLASS="LITERAL"
>NULL</TT
> if error or message in
status bar.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2383"
></A
><H3
><A
NAME="GNOME-APP-QUESTION-MODAL"
></A
>gnome_app_question_modal ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_app_question_modal        (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Ask a yes or no question, and call the callback when it's answered.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2394"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>question</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text of question to be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to dialog widget, or <TT
CLASS="LITERAL"
>NULL</TT
> if error or message in
status bar.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2420"
></A
><H3
><A
NAME="GNOME-APP-OK-CANCEL"
></A
>gnome_app_ok_cancel ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_app_ok_cancel             (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2431"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text of message to be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to dialog widget, or <TT
CLASS="LITERAL"
>NULL</TT
> if error or message in
status bar.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2457"
></A
><H3
><A
NAME="GNOME-APP-OK-CANCEL-MODAL"
></A
>gnome_app_ok_cancel_modal ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_app_ok_cancel_modal       (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2468"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text of message to be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to dialog widget, or <TT
CLASS="LITERAL"
>NULL</TT
> if error or message in
status bar.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2494"
></A
><H3
><A
NAME="GNOME-APP-REQUEST-STRING"
></A
>gnome_app_request_string ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_app_request_string        (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2505"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>prompt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text of prompt to be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to dialog widget, or <TT
CLASS="LITERAL"
>NULL</TT
> if error or message in
status bar.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2531"
></A
><H3
><A
NAME="GNOME-APP-REQUEST-PASSWORD"
></A
>gnome_app_request_password ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_app_request_password      (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2542"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME app object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>prompt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text of prompt to be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Pointer to dialog widget, or <TT
CLASS="LITERAL"
>NULL</TT
> if error or message in
status bar.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2568"
></A
><H3
><A
NAME="GNOMEAPPPROGRESSFUNC"
></A
>GnomeAppProgressFunc ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A>     (*GnomeAppProgressFunc)         (<A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2575"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2588"
></A
><H3
><A
NAME="GNOMEAPPPROGRESSCANCELFUNC"
></A
>GnomeAppProgressCancelFunc ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        (*GnomeAppProgressCancelFunc)   (<A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2594"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2603"
></A
><H3
><A
NAME="GNOMEAPPPROGRESSKEY"
></A
>GnomeAppProgressKey</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef gpointer GnomeAppProgressKey;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2608"
></A
><H3
><A
NAME="GNOME-APP-PROGRESS-TIMEOUT"
></A
>gnome_app_progress_timeout ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSKEY"
>GnomeAppProgressKey</A
> gnome_app_progress_timeout
                                            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *description,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> interval,
                                             <A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSFUNC"
>GnomeAppProgressFunc</A
> percentage_cb,
                                             <A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSCANCELFUNC"
>GnomeAppProgressCancelFunc</A
> cancel_cb,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2621"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>description</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>percentage_cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cancel_cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2654"
></A
><H3
><A
NAME="GNOME-APP-PROGRESS-MANUAL"
></A
>gnome_app_progress_manual ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSKEY"
>GnomeAppProgressKey</A
> gnome_app_progress_manual
                                            (<A
HREF="gnomeapp.html"
>GnomeApp</A
> *app,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *description,
                                             <A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSCANCELFUNC"
>GnomeAppProgressCancelFunc</A
> cancel_cb,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2665"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>description</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cancel_cb</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2690"
></A
><H3
><A
NAME="GNOME-APP-SET-PROGRESS"
></A
>gnome_app_set_progress ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_set_progress          (<A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSKEY"
>GnomeAppProgressKey</A
> key,
                                             <A
HREF=../glib/glib-basic-types.html#GDOUBLE
>gdouble</A> percent);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2698"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>key</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>percent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2711"
></A
><H3
><A
NAME="GNOME-APP-PROGRESS-DONE"
></A
>gnome_app_progress_done ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_app_progress_done         (<A
HREF="gnomeui-gnome-app-util.html#GNOMEAPPPROGRESSKEY"
>GnomeAppProgressKey</A
> key);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2718"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>key</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2727"
></A
><H2
>See Also</H2
><P
>GnomeApp</P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-app-helper.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-canvas-util.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
>gnome-app-helper</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-canvas-util</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-canvas-util</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-app-util"
HREF="gnomeui-gnome-app-util.html"><LINK
REL="NEXT"
TITLE="gnome-dialog-util"
HREF="gnomeui-gnome-dialog-util.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-app-util.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-dialog-util.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-CANVAS-UTIL"
>gnome-canvas-util</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN2735"
></A
><H2
>Name</H2
>gnome-canvas-util&nbsp;--&nbsp;Auxiliary canvas functions.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN2738"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


typedef     <A
HREF="gnomeui-gnome-canvas-util.html#GNOMECANVASPOINTS"
>GnomeCanvasPoints</A
>;
<A
HREF="gnomeui-gnome-canvas-util.html#GNOMECANVASPOINTS"
>GnomeCanvasPoints</A
>* <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-POINTS-NEW"
>gnome_canvas_points_new</A
>  (int num_points);
void        <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-POINTS-FREE"
>gnome_canvas_points_free</A
>        (<A
HREF="gnomeui-gnome-canvas-util.html#GNOMECANVASPOINTS"
>GnomeCanvasPoints</A
> *points);
int         <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-GET-MITER-POINTS"
>gnome_canvas_get_miter_points</A
>   (double x1,
                                             double y1,
                                             double x2,
                                             double y2,
                                             double x3,
                                             double y3,
                                             double width,
                                             double *mx1,
                                             double *my1,
                                             double *mx2,
                                             double *my2);
void        <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-GET-BUTT-POINTS"
>gnome_canvas_get_butt_points</A
>    (double x1,
                                             double y1,
                                             double x2,
                                             double y2,
                                             double width,
                                             int project,
                                             double *bx1,
                                             double *by1,
                                             double *bx2,
                                             double *by2);
double      <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-POLYGON-TO-POINT"
>gnome_canvas_polygon_to_point</A
>   (double *poly,
                                             int num_points,
                                             double x,
                                             double y);
void        <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-RENDER-SVP"
>gnome_canvas_render_svp</A
>         (<A
HREF="gnomecanvas.html#GNOMECANVASBUF"
>GnomeCanvasBuf</A
> *buf,
                                             ArtSVP *svp,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> rgba);
void        <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-UPDATE-SVP"
>gnome_canvas_update_svp</A
>         (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp);
void        <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-UPDATE-SVP-CLIP"
>gnome_canvas_update_svp_clip</A
>    (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp,
                                             ArtSVP *clip_svp);
void        <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-ITEM-RESET-BOUNDS"
>gnome_canvas_item_reset_bounds</A
>  (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);
void        <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-ITEM-UPDATE-SVP"
>gnome_canvas_item_update_svp</A
>    (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp);
void        <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-ITEM-UPDATE-SVP-CLIP"
>gnome_canvas_item_update_svp_clip</A
>
                                            (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp,
                                             ArtSVP *clip_svp);
void        <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-ITEM-REQUEST-REDRAW-SVP"
>gnome_canvas_item_request_redraw_svp</A
>
                                            (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             const ArtSVP *svp);
void        <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-UPDATE-BBOX"
>gnome_canvas_update_bbox</A
>        (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             int x1,
                                             int y1,
                                             int x2,
                                             int y2);
void        <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-BUF-ENSURE-BUF"
>gnome_canvas_buf_ensure_buf</A
>     (<A
HREF="gnomecanvas.html#GNOMECANVASBUF"
>GnomeCanvasBuf</A
> *buf);
GdkImlibImage* <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-LOAD-ALPHA"
>gnome_canvas_load_alpha</A
>      (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *file);
void        <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-DESTROY-IMAGE"
>gnome_canvas_destroy_image</A
>      (GdkImlibImage *image);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2809"
></A
><H2
>Description</H2
><P
>These miscellaneous functions are useful with the GnomeCanvas.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2812"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN2814"
></A
><H3
><A
NAME="GNOMECANVASPOINTS"
></A
>GnomeCanvasPoints</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct {
	int num_points;
	double *coords;
	int ref_count;
} GnomeCanvasPoints;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2819"
></A
><H3
><A
NAME="GNOME-CANVAS-POINTS-NEW"
></A
>gnome_canvas_points_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeui-gnome-canvas-util.html#GNOMECANVASPOINTS"
>GnomeCanvasPoints</A
>* gnome_canvas_points_new  (int num_points);</PRE
></TD
></TR
></TABLE
><P
>Creates a structure that should be used to pass an array of points to
items.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2826"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>num_points</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The number of points to allocate space for in the array.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A newly-created array of points.  It should be filled in
by the user.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2839"
></A
><H3
><A
NAME="GNOME-CANVAS-POINTS-FREE"
></A
>gnome_canvas_points_free ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_points_free        (<A
HREF="gnomeui-gnome-canvas-util.html#GNOMECANVASPOINTS"
>GnomeCanvasPoints</A
> *points);</PRE
></TD
></TR
></TABLE
><P
>Decreases the reference count of the specified points structure.  If it
reaches zero, then the structure is freed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2846"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>points</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas points structure.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2855"
></A
><H3
><A
NAME="GNOME-CANVAS-GET-MITER-POINTS"
></A
>gnome_canvas_get_miter_points ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_canvas_get_miter_points   (double x1,
                                             double y1,
                                             double x2,
                                             double y2,
                                             double x3,
                                             double y3,
                                             double width,
                                             double *mx1,
                                             double *my1,
                                             double *mx2,
                                             double *my2);</PRE
></TD
></TR
></TABLE
><P
>Given three points forming an angle, computes the coordinates of the inside
and outside points of the mitered corner formed by a line of a given width at
that angle.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2872"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of the first point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate of the first point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of the second (angle) point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate of the second (angle) point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x3</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of the third point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y3</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate of the third point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Width of the line</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mx1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The X coordinate of the first miter point is returned here.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>my1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The Y coordinate of the first miter point is returned here.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mx2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The X coordinate of the second miter point is returned here.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>my2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The Y coordinate of the second miter point is returned here.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> FALSE if the angle is less than 11 degrees (this is the same
threshold as X uses.  If this occurs, the return points are not modified.
Otherwise, returns TRUE.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2925"
></A
><H3
><A
NAME="GNOME-CANVAS-GET-BUTT-POINTS"
></A
>gnome_canvas_get_butt_points ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_get_butt_points    (double x1,
                                             double y1,
                                             double x2,
                                             double y2,
                                             double width,
                                             int project,
                                             double *bx1,
                                             double *by1,
                                             double *bx2,
                                             double *by2);</PRE
></TD
></TR
></TABLE
><P
>Computes the butt points of a line segment.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2940"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of first point in the line</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y cooordinate of first point in the line</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of second point (endpoint) of the line</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate of second point (endpoint) of the line</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Width of the line</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>project</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Whether the butt points should project out by width/2 distance</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>bx1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of first butt point is returned here</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>by1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate of first butt point is returned here</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>bx2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of second butt point is returned here</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>by2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate of second butt point is returned here</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2985"
></A
><H3
><A
NAME="GNOME-CANVAS-POLYGON-TO-POINT"
></A
>gnome_canvas_polygon_to_point ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>double      gnome_canvas_polygon_to_point   (double *poly,
                                             int num_points,
                                             double x,
                                             double y);</PRE
></TD
></TR
></TABLE
><P
>Computes the distance between a point and a polygon.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2995"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>poly</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Vertices of the polygon.  X coordinates are in the even indices, and Y
coordinates are in the odd indices</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>num_points</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of points in the polygon</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of the point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate of the point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The distance from the point to the polygon, or zero if the
point is inside the polygon.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3020"
></A
><H3
><A
NAME="GNOME-CANVAS-RENDER-SVP"
></A
>gnome_canvas_render_svp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_render_svp         (<A
HREF="gnomecanvas.html#GNOMECANVASBUF"
>GnomeCanvasBuf</A
> *buf,
                                             ArtSVP *svp,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> rgba);</PRE
></TD
></TR
></TABLE
><P
>Render the svp over the buf.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3029"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>buf</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the canvas buffer to render over</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>svp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the vector path to render</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgba</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the rgba color to render</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3046"
></A
><H3
><A
NAME="GNOME-CANVAS-UPDATE-SVP"
></A
>gnome_canvas_update_svp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_update_svp         (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp);</PRE
></TD
></TR
></TABLE
><P
>Sets the svp to the new value, requesting repaint on what's changed. This
function takes responsibility for freeing new_svp.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3055"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the canvas containing the svp that needs updating.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>p_svp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a pointer to the existing svp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_svp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the new svp</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3072"
></A
><H3
><A
NAME="GNOME-CANVAS-UPDATE-SVP-CLIP"
></A
>gnome_canvas_update_svp_clip ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_update_svp_clip    (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp,
                                             ArtSVP *clip_svp);</PRE
></TD
></TR
></TABLE
><P
>Sets the svp to the new value, clipping if necessary, and requesting repaint
on what's changed. This function takes responsibility for freeing new_svp.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3082"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the canvas containing the svp that needs updating.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>p_svp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a pointer to the existing svp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_svp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the new svp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>clip_svp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a clip path, if non-null</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3103"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-RESET-BOUNDS"
></A
>gnome_canvas_item_reset_bounds ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_reset_bounds  (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);</PRE
></TD
></TR
></TABLE
><P
>Resets the bounding box of a canvas item to an empty rectangle.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3110"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3119"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-UPDATE-SVP"
></A
>gnome_canvas_item_update_svp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_update_svp    (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp);</PRE
></TD
></TR
></TABLE
><P
>Sets the svp to the new value, requesting repaint on what's changed. This
function takes responsibility for freeing new_svp. This routine also adds the
svp's bbox to the item's.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3128"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the canvas item containing the svp that needs updating.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>p_svp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a pointer to the existing svp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_svp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the new svp</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3145"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-UPDATE-SVP-CLIP"
></A
>gnome_canvas_item_update_svp_clip ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_update_svp_clip
                                            (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp,
                                             ArtSVP *clip_svp);</PRE
></TD
></TR
></TABLE
><P
>Sets the svp to the new value, clipping if necessary, and requesting repaint
on what's changed. This function takes responsibility for freeing new_svp.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3155"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the canvas item containing the svp that needs updating.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>p_svp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a pointer to the existing svp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_svp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the new svp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>clip_svp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a clip path, if non-null</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3176"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-REQUEST-REDRAW-SVP"
></A
>gnome_canvas_item_request_redraw_svp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_item_request_redraw_svp
                                            (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             const ArtSVP *svp);</PRE
></TD
></TR
></TABLE
><P
>Request redraw of the svp if in aa mode, or the entire item in in xlib mode.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3184"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the item containing the svp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>svp</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the svp that needs to be redrawn</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3197"
></A
><H3
><A
NAME="GNOME-CANVAS-UPDATE-BBOX"
></A
>gnome_canvas_update_bbox ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_update_bbox        (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
                                             int x1,
                                             int y1,
                                             int x2,
                                             int y2);</PRE
></TD
></TR
></TABLE
><P
>Sets the bbox to the new value, requesting full repaint.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3204"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Left coordinate of the new bounding box</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Top coordinate of the new bounding box</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Right coordinate of the new bounding box</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y2</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Bottom coordinate of the new bounding box</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3229"
></A
><H3
><A
NAME="GNOME-CANVAS-BUF-ENSURE-BUF"
></A
>gnome_canvas_buf_ensure_buf ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_buf_ensure_buf     (<A
HREF="gnomecanvas.html#GNOMECANVASBUF"
>GnomeCanvasBuf</A
> *buf);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3235"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>buf</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3244"
></A
><H3
><A
NAME="GNOME-CANVAS-LOAD-ALPHA"
></A
>gnome_canvas_load_alpha ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>GdkImlibImage* gnome_canvas_load_alpha      (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *file);</PRE
></TD
></TR
></TABLE
><P
>This routine loads a PNG file with full alpha transparency and</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3252"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>file</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> filename to load</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a (GdkImlibImage *).

Note that images created by this routine are not intended to be
passed to GdkImlib, we just use this to remain compatible with
the GnomeCanvasImage Canvas item.  Use this with GdkImlib at
your own risk.

To release images loaded by gnome_canvas_load_alpha, use
gnome_canvas_destroy_image preferably although it works
with imlib now, in the future this might not be the case.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3265"
></A
><H3
><A
NAME="GNOME-CANVAS-DESTROY-IMAGE"
></A
>gnome_canvas_destroy_image ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_canvas_destroy_image      (GdkImlibImage *image);</PRE
></TD
></TR
></TABLE
><P
>Do not pass a regular GdkImlibImage to this routine, only pass
GdkImlibImage pointer that were created by gnome_canvas_load_alpha</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3272"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>image</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GdkImlibImage allocated by gnome_canvas_load_alpha</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-app-util.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-dialog-util.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
>gnome-app-util</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-dialog-util</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-dialog-util</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-canvas-util"
HREF="gnomeui-gnome-canvas-util.html"><LINK
REL="NEXT"
TITLE="gnome-dns"
HREF="gnomeui-gnome-dns.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-canvas-util.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-dns.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-DIALOG-UTIL"
>gnome-dialog-util</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN3286"
></A
><H2
>Name</H2
>gnome-dialog-util&nbsp;--&nbsp;Convenience functions for making dialogs.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN3289"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-OK-DIALOG"
>gnome_ok_dialog</A
>                 (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-OK-DIALOG-PARENTED"
>gnome_ok_dialog_parented</A
>        (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-ERROR-DIALOG"
>gnome_error_dialog</A
>              (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *error);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-ERROR-DIALOG-PARENTED"
>gnome_error_dialog_parented</A
>     (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *error,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-WARNING-DIALOG"
>gnome_warning_dialog</A
>            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *warning);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-WARNING-DIALOG-PARENTED"
>gnome_warning_dialog_parented</A
>   (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *warning,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-QUESTION-DIALOG"
>gnome_question_dialog</A
>           (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-QUESTION-DIALOG-PARENTED"
>gnome_question_dialog_parented</A
>  (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-QUESTION-DIALOG-MODAL"
>gnome_question_dialog_modal</A
>     (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-QUESTION-DIALOG-MODAL-PARENTED"
>gnome_question_dialog_modal_parented</A
>
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-OK-CANCEL-DIALOG"
>gnome_ok_cancel_dialog</A
>          (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-OK-CANCEL-DIALOG-PARENTED"
>gnome_ok_cancel_dialog_parented</A
> (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-OK-CANCEL-DIALOG-MODAL"
>gnome_ok_cancel_dialog_modal</A
>    (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-OK-CANCEL-DIALOG-MODAL-PARENTED"
>gnome_ok_cancel_dialog_modal_parented</A
>
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-STRING-DIALOG"
>gnome_request_string_dialog</A
>     (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-STRING-DIALOG-PARENTED"
>gnome_request_string_dialog_parented</A
>
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-PASSWORD-DIALOG"
>gnome_request_password_dialog</A
>   (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-PASSWORD-DIALOG-PARENTED"
>gnome_request_password_dialog_parented</A
>
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-DIALOG"
>gnome_request_dialog</A
>            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> password,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *default_text,
                                             const <A
HREF=../glib/glib-basic-types.html#GUINT16
>guint16</A> max_length,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN3388"
></A
><H2
>Description</H2
><P
>These functions create common dialogs for you. In all cases, you
should prefer the _parented() variants, because they will properly
call <A
HREF="gnomedialog.html#GNOME-DIALOG-SET-PARENT"
>gnome_dialog_set_parent</A
>() prior to showing the dialog. All of
these functions automatically show the dialog before they return.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN3393"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN3395"
></A
><H3
><A
NAME="GNOME-OK-DIALOG"
></A
>gnome_ok_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_ok_dialog                 (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows a simple message dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3403"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3416"
></A
><H3
><A
NAME="GNOME-OK-DIALOG-PARENTED"
></A
>gnome_ok_dialog_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_ok_dialog_parented        (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows a simple message dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3425"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3442"
></A
><H3
><A
NAME="GNOME-ERROR-DIALOG"
></A
>gnome_error_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_error_dialog              (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *error);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows a error dialog.  This is an OK
dialog to display on fatally failed operations.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3450"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>error</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3463"
></A
><H3
><A
NAME="GNOME-ERROR-DIALOG-PARENTED"
></A
>gnome_error_dialog_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_error_dialog_parented     (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *error,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows a error dialog.  This is an OK
dialog to display on fatally failed operations.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3472"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>error</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3489"
></A
><H3
><A
NAME="GNOME-WARNING-DIALOG"
></A
>gnome_warning_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_warning_dialog            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *warning);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows a warning dialog.  For non-fatal
warnings.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3497"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>warning</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3510"
></A
><H3
><A
NAME="GNOME-WARNING-DIALOG-PARENTED"
></A
>gnome_warning_dialog_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_warning_dialog_parented   (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *warning,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows a warning dialog.  For non-fatal
warnings.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3519"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>warning</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3536"
></A
><H3
><A
NAME="GNOME-QUESTION-DIALOG"
></A
>gnome_question_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_question_dialog           (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Creates a question dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3548"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>question</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Question to ask</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3569"
></A
><H3
><A
NAME="GNOME-QUESTION-DIALOG-PARENTED"
></A
>gnome_question_dialog_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_question_dialog_parented  (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates a question dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3582"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>question</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Question to ask</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3607"
></A
><H3
><A
NAME="GNOME-QUESTION-DIALOG-MODAL"
></A
>gnome_question_dialog_modal ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_question_dialog_modal     (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Creates a question dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'.  The dialog is created as a modal
dialog and the user will have to answer this before proceeding.</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3619"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>question</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Question to ask</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3640"
></A
><H3
><A
NAME="GNOME-QUESTION-DIALOG-MODAL-PARENTED"
></A
>gnome_question_dialog_modal_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_question_dialog_modal_parented
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates a question dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'.  The dialog is created as a modal
dialog and the user will have to answer this before proceeding.</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3653"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>question</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Question to ask</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3678"
></A
><H3
><A
NAME="GNOME-OK-CANCEL-DIALOG"
></A
>gnome_ok_cancel_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_ok_cancel_dialog          (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Creates an OK/Cancel dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3690"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3711"
></A
><H3
><A
NAME="GNOME-OK-CANCEL-DIALOG-PARENTED"
></A
>gnome_ok_cancel_dialog_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_ok_cancel_dialog_parented (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates an OK/Cancel dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3724"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3749"
></A
><H3
><A
NAME="GNOME-OK-CANCEL-DIALOG-MODAL"
></A
>gnome_ok_cancel_dialog_modal ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_ok_cancel_dialog_modal    (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Creates an OK/Cancel dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.  The dialog is created as a modal
dialog and the user will have to answer this before proceeding.</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3761"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3782"
></A
><H3
><A
NAME="GNOME-OK-CANCEL-DIALOG-MODAL-PARENTED"
></A
>gnome_ok_cancel_dialog_modal_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_ok_cancel_dialog_modal_parented
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows an OK/Cancel dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.  The dialog is created as a modal
dialog and the user will have to answer this before proceeding.</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3795"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3820"
></A
><H3
><A
NAME="GNOME-REQUEST-STRING-DIALOG"
></A
>gnome_request_string_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_request_string_dialog     (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Deprecated, use <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-DIALOG"
>gnome_request_dialog</A
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3831"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>prompt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3852"
></A
><H3
><A
NAME="GNOME-REQUEST-STRING-DIALOG-PARENTED"
></A
>gnome_request_string_dialog_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_request_string_dialog_parented
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);</PRE
></TD
></TR
></TABLE
><P
>Deprecated, use <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-DIALOG"
>gnome_request_dialog</A
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3864"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>prompt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3889"
></A
><H3
><A
NAME="GNOME-REQUEST-PASSWORD-DIALOG"
></A
>gnome_request_password_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_request_password_dialog   (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
>Deprecated, use <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-DIALOG"
>gnome_request_dialog</A
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3900"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>prompt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3921"
></A
><H3
><A
NAME="GNOME-REQUEST-PASSWORD-DIALOG-PARENTED"
></A
>gnome_request_password_dialog_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_request_password_dialog_parented
                                            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);</PRE
></TD
></TR
></TABLE
><P
>Deprecated, use <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-DIALOG"
>gnome_request_dialog</A
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3933"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>prompt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3958"
></A
><H3
><A
NAME="GNOME-REQUEST-DIALOG"
></A
>gnome_request_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_request_dialog            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> password,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *prompt,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *default_text,
                                             const <A
HREF=../glib/glib-basic-types.html#GUINT16
>guint16</A> max_length,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data,
                                             <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows a GNOME text entry request dialog.
<TT
CLASS="PARAMETER"
><I
>callback</I
></TT
> is called when the dialog closes, passing the text entry
input or <TT
CLASS="LITERAL"
>NULL</TT
> if the user cancelled.  <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
> is defined as</P
><P
>void (* GnomeStringCallback)(gchar * string, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3976"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>password</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if on-screen text input is masked</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>prompt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text of the prompt to be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>default_text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Default text in entry widget, <TT
CLASS="LITERAL"
>NULL</TT
> if none</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>max_length</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Maximum input chars allowed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data passed to the callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window, or <TT
CLASS="LITERAL"
>NULL</TT
> for no parent.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-canvas-util.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-dns.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
>gnome-canvas-util</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-dns</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-dns</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-dialog-util"
HREF="gnomeui-gnome-dialog-util.html"><LINK
REL="NEXT"
TITLE="gnome-geometry"
HREF="gnomeui-gnome-geometry.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-dialog-util.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-geometry.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-DNS"
>gnome-dns</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN4021"
></A
><H2
>Name</H2
>gnome-dns&nbsp;--&nbsp;Non-blocking name resolver interface.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN4024"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


void        <A
HREF="gnomeui-gnome-dns.html#GNOME-DNS-INIT"
>gnome_dns_init</A
>                  (<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> server_count);
<A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A>     <A
HREF="gnomeui-gnome-dns.html#GNOME-DNS-LOOKUP"
>gnome_dns_lookup</A
>                (const char *hostname,
                                             void (*callback) (guint32 ip_addr, void *callback_data),
                                             void *callback_data);
void        <A
HREF="gnomeui-gnome-dns.html#GNOME-DNS-ABORT"
>gnome_dns_abort</A
>                 (<A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> tag);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4033"
></A
><H2
>Description</H2
><P
>You can use this module to do name server lookups in a non-blocking
fashion.  You need to provide a callback function to be invoked when
the name has been resolved.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4036"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN4038"
></A
><H3
><A
NAME="GNOME-DNS-INIT"
></A
>gnome_dns_init ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dns_init                  (<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> server_count);</PRE
></TD
></TR
></TABLE
><P
>Initialize the dns functions for use.</P
><P
>server_count specifies the number of servers to fork() at
init, or &lt;= 0 to do dynamic server forking.  If you are
concerned about virtual mem usage, fork your servers as one of the
first things in your program.</P
><P
>Note that it will still do dynamic forking if you specify &gt; 0. 
when it runs out of servers.. a good init value may be 1 or 2.</P
><P
>Results:
<A
HREF="gnomeui-gnome-dns.html#GNOME-DNS-LOOKUP"
>gnome_dns_lookup</A
>() will be ready for use.</P
><P
>Side effects:
The library is initialized.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4051"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>server_count</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> server count to fork() at init.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4061"
></A
><H3
><A
NAME="GNOME-DNS-LOOKUP"
></A
>gnome_dns_lookup ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A>     gnome_dns_lookup                (const char *hostname,
                                             void (*callback) (guint32 ip_addr, void *callback_data),
                                             void *callback_data);</PRE
></TD
></TR
></TABLE
><P
>Looks up an address and returns a tag for use with
<A
HREF="gnomeui-gnome-dns.html#GNOME-DNS-ABORT"
>gnome_dns_abort</A
>() if desired.  May not return -1 if
hostname was in cache.</P
><P
>Callback function is called when dns_lookup is complete.</P
><P
>Side effects:
A new dns server may be spawned if all the current servers
are in use.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4071"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>hostname</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> hostname to lookup</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> function to call when dns lookup is complete.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> data to pass to the callback function</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A tag identifying this lookup or 0 if lookup was
in cache.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4092"
></A
><H3
><A
NAME="GNOME-DNS-ABORT"
></A
>gnome_dns_abort ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_dns_abort                 (<A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> tag);</PRE
></TD
></TR
></TABLE
><P
>Aborts a previous call to <A
HREF="gnomeui-gnome-dns.html#GNOME-DNS-LOOKUP"
>gnome_dns_lookup</A
>().
DNS callback function is not called.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4100"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>tag</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the tag returned from previous call to <A
HREF="gnomeui-gnome-dns.html#GNOME-DNS-LOOKUP"
>gnome_dns_lookup</A
>().</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-dialog-util.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-geometry.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
>gnome-dialog-util</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-geometry</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-geometry</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-dns"
HREF="gnomeui-gnome-dns.html"><LINK
REL="NEXT"
TITLE="gnome-ice"
HREF="gnomeui-gnome-ice.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-dns.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-ice.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-GEOMETRY"
>gnome-geometry</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN4115"
></A
><H2
>Name</H2
>gnome-geometry&nbsp;--&nbsp;Window geometry utility functions.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN4118"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-geometry.html#GNOME-PARSE-GEOMETRY"
>gnome_parse_geometry</A
>            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *geometry,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *xpos,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *ypos,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *width,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *height);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomeui-gnome-geometry.html#GNOME-GEOMETRY-STRING"
>gnome_geometry_string</A
>           (<A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A> *window);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4131"
></A
><H2
>Description</H2
><P
>This module provides functions to parse a string that specifies a
window geometry (window position on the screen and dimenssions) as
well as a routine to fetch the geometry of a <SPAN
CLASS="TYPE"
>GtkWindow</SPAN
>
(for example, a <SPAN
CLASS="TYPE"
>GnomeApp</SPAN
> top level window).</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4136"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN4138"
></A
><H3
><A
NAME="GNOME-PARSE-GEOMETRY"
></A
>gnome_parse_geometry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_parse_geometry            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *geometry,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *xpos,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *ypos,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *width,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *height);</PRE
></TD
></TR
></TABLE
><P
>Parses the geometry string passed in <TT
CLASS="PARAMETER"
><I
>geometry</I
></TT
>, and fills
<TT
CLASS="PARAMETER"
><I
>xpos</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>ypos</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>width</I
></TT
>, and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> with
the corresponding values upon completion of the parse.
If the parse fails, it should be assumed that <TT
CLASS="PARAMETER"
><I
>xpos</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>ypos</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>width</I
></TT
>,
and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> contain undefined values.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4159"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>geometry</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> geometry string to be parsed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>xpos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X position geometry component</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ypos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y position geometry component</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width geometry component</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel height geometry component</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if the geometry was successfully parsed, <TT
CLASS="LITERAL"
>FALSE</TT
> otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4190"
></A
><H3
><A
NAME="GNOME-GEOMETRY-STRING"
></A
>gnome_geometry_string ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gnome_geometry_string           (<A
HREF=../gdk/gdk-windows.html#GDKWINDOW
>GdkWindow</A> *window);</PRE
></TD
></TR
></TABLE
><P
>Determines the size and position of <TT
CLASS="PARAMETER"
><I
>window</I
></TT
> (must be a window or
dialog), and returns that information as an X geometry string.
Geometry strings are in the form of WIDTHxHEIGHT+X+Y.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4199"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to window or dialog object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Newly-allocated string containing geometry string for given
window.  Contents must be g_free'd.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-dns.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-ice.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
>gnome-dns</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-ice</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-ice</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-geometry"
HREF="gnomeui-gnome-geometry.html"><LINK
REL="NEXT"
TITLE="gnome-icon-text"
HREF="gnomeui-gnome-icon-text.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-geometry.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-icon-text.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-ICE"
>gnome-ice</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN4217"
></A
><H2
>Name</H2
>gnome-ice&nbsp;--&nbsp;Integrates the ICE library with the GTK+ event loop</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN4220"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


void        <A
HREF="gnomeui-gnome-ice.html#GNOME-ICE-INIT"
>gnome_ice_init</A
>                  (void);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4224"
></A
><H2
>Description</H2
><P
>You don't need to use this module. Just ignore it.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4227"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN4229"
></A
><H3
><A
NAME="GNOME-ICE-INIT"
></A
>gnome_ice_init ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_ice_init                  (void);</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-geometry.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-icon-text.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
>gnome-geometry</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-icon-text</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-icon-text</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-ice"
HREF="gnomeui-gnome-ice.html"><LINK
REL="NEXT"
TITLE="gnome-init"
HREF="gnomeui-gnome-init.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-ice.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-init.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-ICON-TEXT"
>gnome-icon-text</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN4239"
></A
><H2
>Name</H2
>gnome-icon-text&nbsp;--&nbsp;Text wrapping functions for icon captions.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN4242"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


typedef     <A
HREF="gnomeui-gnome-icon-text.html#GNOMEICONTEXTINFOROW"
>GnomeIconTextInfoRow</A
>;
typedef     <A
HREF="gnomeui-gnome-icon-text.html#GNOMEICONTEXTINFO"
>GnomeIconTextInfo</A
>;
<A
HREF="gnomeui-gnome-icon-text.html#GNOMEICONTEXTINFO"
>GnomeIconTextInfo</A
>* <A
HREF="gnomeui-gnome-icon-text.html#GNOME-ICON-LAYOUT-TEXT"
>gnome_icon_layout_text</A
>   (<A
HREF=../gdk/gdk-fonts.html#GDKFONT
>GdkFont</A> *font,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *separators,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> max_width,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> confine);
void        <A
HREF="gnomeui-gnome-icon-text.html#GNOME-ICON-PAINT-TEXT"
>gnome_icon_paint_text</A
>           (<A
HREF="gnomeui-gnome-icon-text.html#GNOMEICONTEXTINFO"
>GnomeIconTextInfo</A
> *ti,
                                             <A
HREF=../gdk/gdk-windows.html#GDKDRAWABLE
>GdkDrawable</A> *drawable,
                                             <A
HREF=../gdk/gdk-graphics-contexts.html#GDKGC
>GdkGC</A> *gc,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKJUSTIFICATION
>GtkJustification</A> just);
void        <A
HREF="gnomeui-gnome-icon-text.html#GNOME-ICON-TEXT-INFO-FREE"
>gnome_icon_text_info_free</A
>       (<A
HREF="gnomeui-gnome-icon-text.html#GNOMEICONTEXTINFO"
>GnomeIconTextInfo</A
> *ti);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4263"
></A
><H2
>Description</H2
><P
>    This module implements a generic and simple interface for wrapping
    text and painting it to a drawable.  It is used by the
    <SPAN
CLASS="STRUCTNAME"
>GnomeIconTextItem</SPAN
> object to perform word
    wrapping for icon text captions.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4267"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN4269"
></A
><H3
><A
NAME="GNOMEICONTEXTINFOROW"
></A
>GnomeIconTextInfoRow</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct {
	gchar *text;
	gint width;
	GdkWChar *text_wc;	/* text in wide characters */
	gint text_length;	/* number of characters */
} GnomeIconTextInfoRow;</PRE
></TD
></TR
></TABLE
><P
>    This structure defines a row of text in the list of wrapped text
    rows of the <SPAN
CLASS="STRUCTNAME"
>GnomeIconTextInfo</SPAN
> structure.
    The <TT
CLASS="STRUCTFIELD"
><I
>text</I
></TT
> field contains the text that
    fits in that row, and <TT
CLASS="STRUCTFIELD"
><I
>width</I
></TT
> contains
    the width in pixels of that text, calculated with respect to the
    font that was used to format the text.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4277"
></A
><H3
><A
NAME="GNOMEICONTEXTINFO"
></A
>GnomeIconTextInfo</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct {
	GList *rows;
	GdkFont *font;
	gint width;
	gint height;
	gint baseline_skip;
} GnomeIconTextInfo;</PRE
></TD
></TR
></TABLE
><P
>    This structure contains the information about a wrapped text
    string.  The <TT
CLASS="STRUCTFIELD"
><I
>rows</I
></TT
> field is a list of
    <SPAN
CLASS="STRUCTNAME"
>GnomeIconTextInfoRow</SPAN
> structures with the
    final rows of text.  The <TT
CLASS="STRUCTFIELD"
><I
>width</I
></TT
>,
    <TT
CLASS="STRUCTFIELD"
><I
>height</I
></TT
>, and
    <TT
CLASS="STRUCTFIELD"
><I
>baseline_skip</I
></TT
> fields contain the total
    width, total height, and baseline height of the text in pixels,
    respectively.
  </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4287"
></A
><H3
><A
NAME="GNOME-ICON-LAYOUT-TEXT"
></A
>gnome_icon_layout_text ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeui-gnome-icon-text.html#GNOMEICONTEXTINFO"
>GnomeIconTextInfo</A
>* gnome_icon_layout_text   (<A
HREF=../gdk/gdk-fonts.html#GDKFONT
>GdkFont</A> *font,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *text,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *separators,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> max_width,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> confine);</PRE
></TD
></TR
></TABLE
><P
>Creates a new &amp;GnomeIconTextInfo structure by wrapping the specified
text.  If non-NULL, the <TT
CLASS="PARAMETER"
><I
>separators</I
></TT
> argument defines a set of characters
to be used as word delimiters for performing word wrapping.  If it is
NULL, then only spaces will be used as word delimiters.</P
><P
>The <TT
CLASS="PARAMETER"
><I
>max_width</I
></TT
> argument is used to specify the width at which word
wrapping will be performed.  If there is a very long word that does not
fit in a single line, the <TT
CLASS="PARAMETER"
><I
>confine</I
></TT
> argument can be used to specify
whether the word should be unconditionally split to fit or whether
the maximum width should be increased as necessary.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4303"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>font</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>       Name of the font that will be used to render the text.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>       Text to be formatted.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>separators</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Separators used for word wrapping, can be NULL.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>max_width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Width in pixels to be used for word wrapping.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>confine</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>    Whether it is mandatory to wrap at <TT
CLASS="PARAMETER"
><I
>max_width</I
></TT
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A newly-created &amp;GnomeIconTextInfo structure.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4333"
></A
><H3
><A
NAME="GNOME-ICON-PAINT-TEXT"
></A
>gnome_icon_paint_text ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_paint_text           (<A
HREF="gnomeui-gnome-icon-text.html#GNOMEICONTEXTINFO"
>GnomeIconTextInfo</A
> *ti,
                                             <A
HREF=../gdk/gdk-windows.html#GDKDRAWABLE
>GdkDrawable</A> *drawable,
                                             <A
HREF=../gdk/gdk-graphics-contexts.html#GDKGC
>GdkGC</A> *gc,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKJUSTIFICATION
>GtkJustification</A> just);</PRE
></TD
></TR
></TABLE
><P
>Paints the formatted text in the icon text info structure onto a drawable.
This is just a sample implementation; applications can choose to use other
rendering functions.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4345"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ti</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>       An icon text info structure.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>drawable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Target drawable.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>       GC used to render the string.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>        Left coordinate for text.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>        Upper coordinate for text.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>just</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>     Justification for text.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4374"
></A
><H3
><A
NAME="GNOME-ICON-TEXT-INFO-FREE"
></A
>gnome_icon_text_info_free ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_icon_text_info_free       (<A
HREF="gnomeui-gnome-icon-text.html#GNOMEICONTEXTINFO"
>GnomeIconTextInfo</A
> *ti);</PRE
></TD
></TR
></TABLE
><P
>Frees a &amp;GnomeIconTextInfo structure.  You should call this instead of
freeing the structure yourself.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4381"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ti</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> An icon text info structure.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4390"
></A
><H2
>See Also</H2
><P
>    <A
HREF="gnomeicontextitem.html"
>GnomeIconTextItem</A
>
  </P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-ice.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-init.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
>gnome-ice</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-init</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-init</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-icon-text"
HREF="gnomeui-gnome-icon-text.html"><LINK
REL="NEXT"
TITLE="gnome-mdi-session"
HREF="gnomeui-gnome-mdi-session.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-icon-text.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-mdi-session.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-INIT"
>gnome-init</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN4399"
></A
><H2
>Name</H2
>gnome-init&nbsp;--&nbsp;Initialize GNOME libraries.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN4402"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


int         <A
HREF="gnomeui-gnome-init.html#GNOME-INIT"
>gnome_init</A
>                      (const char *app_id,
                                             const char *app_version,
                                             int argc,
                                             char **argv);
int         <A
HREF="gnomeui-gnome-init.html#GNOME-INIT-WITH-POPT-TABLE"
>gnome_init_with_popt_table</A
>      (const char *app_id,
                                             const char *app_version,
                                             int argc,
                                             char **argv,
                                             const struct poptOption *options,
                                             int flags,
                                             poptContext *return_ctx);
struct      <A
HREF="gnomeui-gnome-init.html#GNOMEGURU-STRUCT"
>GnomeGuru</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-init.html#GNOME-GURU-NEW"
>gnome_guru_new</A
>                  (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *graphic,
                                             <A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog);
void        <A
HREF="gnomeui-gnome-init.html#GNOME-GURU-CONSTRUCT"
>gnome_guru_construct</A
>            (GnomeGuru *guru,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *graphic,
                                             <A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog);
void        <A
HREF="gnomeui-gnome-init.html#GNOME-GURU-APPEND-PAGE"
>gnome_guru_append_page</A
>          (GnomeGuru *guru,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget);
void        <A
HREF="gnomeui-gnome-init.html#GNOME-GURU-NEXT-SET-SENSITIVE"
>gnome_guru_next_set_sensitive</A
>   (GnomeGuru *guru,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> sensitivity);
void        <A
HREF="gnomeui-gnome-init.html#GNOME-GURU-BACK-SET-SENSITIVE"
>gnome_guru_back_set_sensitive</A
>   (GnomeGuru *guru,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> sensitivity);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-init.html#GNOME-GURU-CURRENT-PAGE"
>gnome_guru_current_page</A
>         (GnomeGuru *guru);
#define     <A
HREF="gnomeui-gnome-init.html#GNOME-GURU-CAPS"
>GNOME_GURU</A
>                      (obj)
#define     <A
HREF="gnomeui-gnome-init.html#GNOME-IS-GURU-CAPS"
>GNOME_IS_GURU</A
>                   (obj)
<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>       <A
HREF="gnomeui-gnome-init.html#GNOME-GURU-GET-TYPE"
>gnome_guru_get_type</A
>             (void);
#define     <A
HREF="gnomeui-gnome-init.html#GNOME-GURU-CLASS-CAPS"
>GNOME_GURU_CLASS</A
>                (klass)</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4438"
></A
><H2
>Description</H2
><P
>    These routines initialize the GNOME libraries in an application.  As
    part of the initialization these routines do command line argument
    parsing.
  </P
><P
>    The <A
HREF="gnomeui-gnome-init.html#GNOME-INIT"
>gnome_init</A
>() function family initializes the Gtk+ toolkit, the
    Imlib graphics library, initializes session management for the
    application and loads the user preferences.  During this process it
    parses the command line arguments and dispatches the arguments to
    the proper argument parsers.
  </P
><P
>    To provide your own arguments, you need to provide a
    <SPAN
CLASS="STRUCTNAME"
>poptOption</SPAN
> array (see the man page for
    popt(3) for more information) that contains the list of arguments
    that your application recognizes.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4445"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN4447"
></A
><H3
><A
NAME="GNOME-INIT"
></A
>gnome_init ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_init                      (const char *app_id,
                                             const char *app_version,
                                             int argc,
                                             char **argv);</PRE
></TD
></TR
></TABLE
><P
>Initializes the application.  This sets up all of the GNOME
internals and prepares them (imlib, gdk, session-management, triggers,
sound, user preferences)</P
><P
>    </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4453"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Application id.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app_version</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Application version.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> argument count (for example argc as received by main)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argv</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> argument vector (for example argv as received by main)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4478"
></A
><H3
><A
NAME="GNOME-INIT-WITH-POPT-TABLE"
></A
>gnome_init_with_popt_table ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_init_with_popt_table      (const char *app_id,
                                             const char *app_version,
                                             int argc,
                                             char **argv,
                                             const struct poptOption *options,
                                             int flags,
                                             poptContext *return_ctx);</PRE
></TD
></TR
></TABLE
><P
>Initializes the application.  This sets up all of the GNOME
internals and prepares them (imlib, gdk, session-management, triggers,
sound, user preferences)</P
><P
>Unlike gnome_init, with gnome_init_with_popt_table you can provide
a table of popt options (popt is the command line argument parsing
library).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4487"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Application id.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>app_version</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Application version.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argc</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> argument count (for example argc as received by main)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>argv</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> argument vector (for example argv as received by main)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>options</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> poptOption table with options to parse</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>flags</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> popt flags.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>return_ctx</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> if non-NULL, the popt context is returned here.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4524"
></A
><H3
><A
NAME="GNOMEGURU-STRUCT"
></A
>struct GnomeGuru</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeGuru;</PRE
></TD
></TR
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4528"
></A
><H3
><A
NAME="GNOME-GURU-NEW"
></A
>gnome_guru_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_guru_new                  (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *graphic,
                                             <A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog);</PRE
></TD
></TR
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4536"
></A
><H3
><A
NAME="GNOME-GURU-CONSTRUCT"
></A
>gnome_guru_construct ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_guru_construct            (GnomeGuru *guru,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *graphic,
                                             <A
HREF="gnomedialog.html"
>GnomeDialog</A
> *dialog);</PRE
></TD
></TR
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4544"
></A
><H3
><A
NAME="GNOME-GURU-APPEND-PAGE"
></A
>gnome_guru_append_page ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_guru_append_page          (GnomeGuru *guru,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget);</PRE
></TD
></TR
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4551"
></A
><H3
><A
NAME="GNOME-GURU-NEXT-SET-SENSITIVE"
></A
>gnome_guru_next_set_sensitive ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_guru_next_set_sensitive   (GnomeGuru *guru,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> sensitivity);</PRE
></TD
></TR
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4557"
></A
><H3
><A
NAME="GNOME-GURU-BACK-SET-SENSITIVE"
></A
>gnome_guru_back_set_sensitive ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_guru_back_set_sensitive   (GnomeGuru *guru,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> sensitivity);</PRE
></TD
></TR
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4563"
></A
><H3
><A
NAME="GNOME-GURU-CURRENT-PAGE"
></A
>gnome_guru_current_page ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_guru_current_page         (GnomeGuru *guru);</PRE
></TD
></TR
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4569"
></A
><H3
><A
NAME="GNOME-GURU-CAPS"
></A
>GNOME_GURU()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_GURU(obj)            (GTK_CHECK_CAST ((obj), GNOME_TYPE_GURU, GnomeGuru))</PRE
></TD
></TR
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4573"
></A
><H3
><A
NAME="GNOME-IS-GURU-CAPS"
></A
>GNOME_IS_GURU()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_IS_GURU(obj)         (GTK_CHECK_TYPE ((obj), GNOME_TYPE_GURU))</PRE
></TD
></TR
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4577"
></A
><H3
><A
NAME="GNOME-GURU-GET-TYPE"
></A
>gnome_guru_get_type ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A>       gnome_guru_get_type             (void);</PRE
></TD
></TR
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4582"
></A
><H3
><A
NAME="GNOME-GURU-CLASS-CAPS"
></A
>GNOME_GURU_CLASS()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_GURU_CLASS(klass)    (GTK_CHECK_CLASS_CAST ((klass), GNOME_TYPE_GURU, GnomeGuruClass))</PRE
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4586"
></A
><H2
>See Also</H2
><P
>    Manual page popt(3).
  </P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-icon-text.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-mdi-session.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
>gnome-icon-text</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-mdi-session</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-mdi-session</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-init"
HREF="gnomeui-gnome-init.html"><LINK
REL="NEXT"
TITLE="gnome-popup-help"
HREF="gnomeui-gnome-popup-help.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-init.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-popup-help.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-MDI-SESSION"
>gnome-mdi-session</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN4594"
></A
><H2
>Name</H2
>gnome-mdi-session&nbsp;--&nbsp;Routines providing <SPAN
CLASS="TYPE"
>GnomeMDI</SPAN
> state saving and restoration</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN4598"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>* (<A
HREF="gnomeui-gnome-mdi-session.html#GNOMEMDICHILDCREATOR"
>*GnomeMDIChildCreator</A
>)      (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-mdi-session.html#GNOME-MDI-RESTORE-STATE"
>gnome_mdi_restore_state</A
>         (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *section,
                                             <A
HREF="gnomeui-gnome-mdi-session.html#GNOMEMDICHILDCREATOR"
>GnomeMDIChildCreator</A
> child_create_func);
void        <A
HREF="gnomeui-gnome-mdi-session.html#GNOME-MDI-SAVE-STATE"
>gnome_mdi_save_state</A
>            (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *section);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4612"
></A
><H2
>Description</H2
><P
>    In order to simplify saving the state of MDI and its children, the
    GnomeMDI interface provides a function that saves its layout and
    the state of its children (provided by each child through get_config_string
    virtual function defined in <SPAN
CLASS="TYPE"
>GnomeMDIChild</SPAN
> subclasses) and a
    function that restores a previously saved state, recreating the children
    from their configuration strings using a function provided by the programmer.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4616"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN4618"
></A
><H3
><A
NAME="GNOMEMDICHILDCREATOR"
></A
>GnomeMDIChildCreator ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>* (*GnomeMDIChildCreator)      (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4625"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>Param1</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4638"
></A
><H3
><A
NAME="GNOME-MDI-RESTORE-STATE"
></A
>gnome_mdi_restore_state ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_mdi_restore_state         (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *section,
                                             <A
HREF="gnomeui-gnome-mdi-session.html#GNOMEMDICHILDCREATOR"
>GnomeMDIChildCreator</A
> child_create_func);</PRE
></TD
></TR
></TABLE
><P
>Restores the MDI state. Children are recreated with <TT
CLASS="PARAMETER"
><I
>create_child_func</I
></TT
> that
restores information about a child from a config string that was provided
during saving state by the child.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4649"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>section</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of the section to restore MDI state from.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child_create_func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>TRUE if state was successfully restored, FALSE otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4670"
></A
><H3
><A
NAME="GNOME-MDI-SAVE-STATE"
></A
>gnome_mdi_save_state ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_save_state            (<A
HREF="gnomemdi.html"
>GnomeMDI</A
> *mdi,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *section);</PRE
></TD
></TR
></TABLE
><P
>Saves MDI state to the application's config file in section <TT
CLASS="PARAMETER"
><I
>section</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4679"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mdi</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A pointer to a GnomeMDI object.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>section</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Name of the section that the MDI config should be saved to.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-init.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-popup-help.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
>gnome-init</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-popup-help</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-popup-help</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-mdi-session"
HREF="gnomeui-gnome-mdi-session.html"><LINK
REL="NEXT"
TITLE="gnome-popup-menu"
HREF="gnomeui-gnome-popup-menu.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-mdi-session.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-popup-menu.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-POPUP-HELP"
>gnome-popup-help</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN4697"
></A
><H2
>Name</H2
>gnome-popup-help&nbsp;--&nbsp;  A popup-help system for GtkWidgets.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN4700"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


#define     <A
HREF="gnomeui-gnome-popup-help.html#GNOME-WIDGET-ADD-HELP"
>gnome_widget_add_help</A
>           (widget, help)
void        <A
HREF="gnomeui-gnome-popup-help.html#GNOME-WIDGET-ADD-HELP-WITH-UIDATA"
>gnome_widget_add_help_with_uidata</A
>
                                            (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *help,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *menuinfo,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4709"
></A
><H2
>Description</H2
><P
>  This will add a popup-menu to a non <A
HREF=../gtk/gtkwidget.html#GTK-WIDGET-NO-WINDOW-CAPS
>GTK_WIDGET_NO_WINDOW</A>() widget.  It
  also has the ability to add "cut", "copy" and "paste" to <A
HREF=../gtk/gtkeditable.html
>GtkEditable</A>
  widgets if needed.  It is important to not run this on a widget
  without a window, as doing so can lead to stuck pointer grabs.  This
  function should be used where possible everywhere else.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4714"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN4716"
></A
><H3
><A
NAME="GNOME-WIDGET-ADD-HELP"
></A
>gnome_widget_add_help()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define     gnome_widget_add_help(widget, help)</PRE
></TD
></TR
></TABLE
><P
>This is the same as <A
HREF="gnomeui-gnome-popup-help.html#GNOME-WIDGET-ADD-HELP-WITH-UIDATA"
>gnome_widget_add_help_with_uidata</A
>() but without the
options for the extra menu fields.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4722"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The widget to add the popup help to.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>help</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The help message text.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4735"
></A
><H3
><A
NAME="GNOME-WIDGET-ADD-HELP-WITH-UIDATA"
></A
>gnome_widget_add_help_with_uidata ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_widget_add_help_with_uidata
                                            (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *help,
                                             <A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *menuinfo,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This creates a popup menu on <TT
CLASS="PARAMETER"
><I
>widget</I
></TT
> with one entry.  The menu, invoked by
pressing button three on the widget, will have one entry entitled: "Help with
this."  Selecting this entry will bring up a tooltip with the help variable
as its text.  In addition, if the widget is a descendent of <A
HREF=../gtk/gtkeditable.html
>GtkEditable</A>, it
will add "cut", "copy", and "paste" to the menu.  If <TT
CLASS="PARAMETER"
><I
>help</I
></TT
> is NULL, then it
will &lt;emphasis&gt;just&lt;/emphasis&gt; add the "cut", "copy", and "paste".  Finally,
if <TT
CLASS="PARAMETER"
><I
>menuinfo</I
></TT
> is non-NULL, it will append the menu defined by it on the end of
the popup menu, with <TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
> passed to the callbacks.  This function
currently only works on non <A
HREF=../gtk/gtkwidget.html#GTK-WIDGET-NO-WINDOW-CAPS
>GTK_WIDGET_NO_WINDOW</A>() widgets (ie. it only
works on widgets with windows.)  If you would actually like a handle to the
popup menu, call gnome_popup_menu_get() as normal.</P
><P
>This creates a popup menu on <TT
CLASS="PARAMETER"
><I
>widget</I
></TT
> with one entry.  The menu,
invoked by pressing button three on the widget, will have one entry entitled:
"Help with this."  Selecting this entry will bring up a tooltip with the help
variable as its text.  In addition, if the widget is a descendent of
<A
HREF=../gtk/gtkeditable.html
>GtkEditable</A>, it will add "cut", "copy", and "paste" to the menu.  If <TT
CLASS="PARAMETER"
><I
>help</I
></TT
>
is NULL, then it will <I
CLASS="EMPHASIS"
>just</I
> add the "cut", "copy", and
"paste".  Finally, if <TT
CLASS="PARAMETER"
><I
>menuinfo</I
></TT
> is non-NULL, it will append the menu defined
by it on the end of the popup menu, with <TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
> passed to the callbacks.
This function currently only works on non <A
HREF=../gtk/gtkwidget.html#GTK-WIDGET-NO-WINDOW-CAPS
>GTK_WIDGET_NO_WINDOW</A>() widgets
(ie. it only works on widgets with windows.)  If you would actually like a
handle to the popup menu, call gnome_popup_menu_get() as normal.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4760"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The widget to add the popup help to.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>help</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The help message text.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>menuinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The template for possible additional menu items.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The user data to be passed to menu callbacks.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4781"
></A
><H2
>See Also</H2
><P
>  GnomePopupMenu</P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-mdi-session.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-popup-menu.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
>gnome-mdi-session</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-popup-menu</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-popup-menu</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-popup-help"
HREF="gnomeui-gnome-popup-help.html"><LINK
REL="NEXT"
TITLE="gnome-preferences"
HREF="gnomeui-gnome-preferences.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-popup-help.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-preferences.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-POPUP-MENU"
>gnome-popup-menu</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN4790"
></A
><H2
>Name</H2
>gnome-popup-menu&nbsp;--&nbsp;Routines for attaching popup menus to widgets.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN4793"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-popup-menu.html#GNOME-POPUP-MENU-NEW"
>gnome_popup_menu_new</A
>            (<A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-popup-menu.html#GNOME-POPUP-MENU-NEW-WITH-ACCELGROUP"
>gnome_popup_menu_new_with_accelgroup</A
>
                                            (<A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../gtk/gtk-keyboard-accelerators.html#GTKACCELGROUP
>GtkAccelGroup</A> *accelgroup);
<A
HREF=../gtk/gtk-keyboard-accelerators.html#GTKACCELGROUP
>GtkAccelGroup</A>* <A
HREF="gnomeui-gnome-popup-menu.html#GNOME-POPUP-MENU-GET-ACCEL-GROUP"
>gnome_popup_menu_get_accel_group</A
>
                                            (<A
HREF=../gtk/gtkmenu.html
>GtkMenu</A> *menu);
void        <A
HREF="gnomeui-gnome-popup-menu.html#GNOME-POPUP-MENU-ATTACH"
>gnome_popup_menu_attach</A
>         (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *popup,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
void        <A
HREF="gnomeui-gnome-popup-menu.html#GNOME-POPUP-MENU-DO-POPUP"
>gnome_popup_menu_do_popup</A
>       (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *popup,
                                             <A
HREF=../gtk/gtkmenu.html#GTKMENUPOSITIONFUNC
>GtkMenuPositionFunc</A> pos_func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> pos_data,
                                             <A
HREF=../gdk/gdk-event-structures.html#GDKEVENTBUTTON
>GdkEventButton</A> *event,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
int         <A
HREF="gnomeui-gnome-popup-menu.html#GNOME-POPUP-MENU-DO-POPUP-MODAL"
>gnome_popup_menu_do_popup_modal</A
> (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *popup,
                                             <A
HREF=../gtk/gtkmenu.html#GTKMENUPOSITIONFUNC
>GtkMenuPositionFunc</A> pos_func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> pos_data,
                                             <A
HREF=../gdk/gdk-event-structures.html#GDKEVENTBUTTON
>GdkEventButton</A> *event,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4822"
></A
><H2
>Description</H2
><P
>    The routines in this module provide various ways of displaying popup
    menus our application.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4825"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN4827"
></A
><H3
><A
NAME="GNOME-POPUP-MENU-NEW"
></A
>gnome_popup_menu_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_popup_menu_new            (<A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo);</PRE
></TD
></TR
></TABLE
><P
>This function behaves just like
<A
HREF="gnomeui-gnome-popup-menu.html#GNOME-POPUP-MENU-NEW-WITH-ACCELGROUP"
>gnome_popup_menu_new_with_accelgroup</A
>(), except that it creates an
accelgroup for you and attaches it to the menu object.  Use
<A
HREF="gnomeui-gnome-popup-menu.html#GNOME-POPUP-MENU-GET-ACCEL-GROUP"
>gnome_popup_menu_get_accel_group</A
>() to get the accelgroup that is
created.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4837"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a menu widget&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4850"
></A
><H3
><A
NAME="GNOME-POPUP-MENU-NEW-WITH-ACCELGROUP"
></A
>gnome_popup_menu_new_with_accelgroup ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_popup_menu_new_with_accelgroup
                                            (<A
HREF="gnomeui-gnome-app-helper.html#GNOMEUIINFO"
>GnomeUIInfo</A
> *uiinfo,
                                             <A
HREF=../gtk/gtk-keyboard-accelerators.html#GTKACCELGROUP
>GtkAccelGroup</A> *accelgroup);</PRE
></TD
></TR
></TABLE
><P
>Creates a popup menu out of the specified uiinfo array.  Use
<A
HREF="gnomeui-gnome-popup-menu.html#GNOME-POPUP-MENU-DO-POPUP"
>gnome_popup_menu_do_popup</A
>() to pop the menu up, or attach it to a
window with <A
HREF="gnomeui-gnome-popup-menu.html#GNOME-POPUP-MENU-ATTACH"
>gnome_popup_menu_attach</A
>().</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4861"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>uiinfo</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>accelgroup</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a menu widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4878"
></A
><H3
><A
NAME="GNOME-POPUP-MENU-GET-ACCEL-GROUP"
></A
>gnome_popup_menu_get_accel_group ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtk-keyboard-accelerators.html#GTKACCELGROUP
>GtkAccelGroup</A>* gnome_popup_menu_get_accel_group
                                            (<A
HREF=../gtk/gtkmenu.html
>GtkMenu</A> *menu);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4886"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>menu</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the accelgroup associated with the specified GtkMenu.  This
is the accelgroup that was created by <A
HREF="gnomeui-gnome-popup-menu.html#GNOME-POPUP-MENU-NEW"
>gnome_popup_menu_new</A
>().  If
you want to specify the accelgroup that the popup menu accelerators
use, then use <A
HREF="gnomeui-gnome-popup-menu.html#GNOME-POPUP-MENU-NEW-WITH-ACCELGROUP"
>gnome_popup_menu_new_with_accelgroup</A
>().</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4901"
></A
><H3
><A
NAME="GNOME-POPUP-MENU-ATTACH"
></A
>gnome_popup_menu_attach ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_popup_menu_attach         (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *popup,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>Attaches the specified popup menu to the specified widget.  The
menu can then be activated by pressing mouse button 3 over the
widget.  When a menu item callback is invoked, the specified
user_data will be passed to it.</P
><P
>This function requires the widget to have its own window
(i.e. GTK_WIDGET_NO_WINDOW (widget) == FALSE), This function will
try to set the GDK_BUTTON_PRESS_MASK flag on the widget's event
mask if it does not have it yet; if this is the case, then the
widget must not be realized for it to work.</P
><P
>The popup menu can be attached to different widgets at the same
time.  A reference count is kept on the popup menu; when all the
widgets it is attached to are destroyed, the popup menu will be
destroyed as well.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4912"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>popup</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4929"
></A
><H3
><A
NAME="GNOME-POPUP-MENU-DO-POPUP"
></A
>gnome_popup_menu_do_popup ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_popup_menu_do_popup       (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *popup,
                                             <A
HREF=../gtk/gtkmenu.html#GTKMENUPOSITIONFUNC
>GtkMenuPositionFunc</A> pos_func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> pos_data,
                                             <A
HREF=../gdk/gdk-event-structures.html#GDKEVENTBUTTON
>GdkEventButton</A> *event,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>You can use this function to pop up a menu.  When a menu item *
callback is invoked, the specified user_data will be passed to it.</P
><P
>The pos_func and pos_data parameters are the same as for
<A
HREF=../gtk/gtkmenu.html#GTK-MENU-POPUP
>gtk_menu_popup</A>(), i.e. you can use them to specify a function to
position the menu explicitly.  If you want the default position
(near the mouse), pass NULL for these parameters.</P
><P
>The event parameter is needed to figure out the mouse button that
activated the menu and the time at which this happened.  If you
pass in NULL, then no button and the current time will be used as
defaults.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4943"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>popup</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos_func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>event</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4968"
></A
><H3
><A
NAME="GNOME-POPUP-MENU-DO-POPUP-MODAL"
></A
>gnome_popup_menu_do_popup_modal ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_popup_menu_do_popup_modal (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *popup,
                                             <A
HREF=../gtk/gtkmenu.html#GTKMENUPOSITIONFUNC
>GtkMenuPositionFunc</A> pos_func,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> pos_data,
                                             <A
HREF=../gdk/gdk-event-structures.html#GDKEVENTBUTTON
>GdkEventButton</A> *event,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>Same as above, but runs the popup menu modally and returns the
index of the selected item, or -1 if none.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4979"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>popup</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos_func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pos_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>event</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-popup-help.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-preferences.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
>gnome-popup-help</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-preferences</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-preferences</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-popup-menu"
HREF="gnomeui-gnome-popup-menu.html"><LINK
REL="NEXT"
TITLE="gnome-properties"
HREF="gnomeui-gnome-properties.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-popup-menu.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-properties.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-PREFERENCES"
>gnome-preferences</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN5013"
></A
><H2
>Name</H2
>gnome-preferences&nbsp;--&nbsp;Fetching and setting GNOME preferences</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN5016"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeui-gnome-preferences.html#GNOMEPREFERENCES"
>GnomePreferences</A
>;
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-LOAD"
>gnome_preferences_load</A
>          (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SAVE"
>gnome_preferences_save</A
>          (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-LOAD-CUSTOM"
>gnome_preferences_load_custom</A
>   (<A
HREF="gnomeui-gnome-preferences.html#GNOMEPREFERENCES"
>GnomePreferences</A
> *settings);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SAVE-CUSTOM"
>gnome_preferences_save_custom</A
>   (<A
HREF="gnomeui-gnome-preferences.html#GNOMEPREFERENCES"
>GnomePreferences</A
> *settings);
<A
HREF=../gtk/gtk-standard-enumerations.html#GTKBUTTONBOXSTYLE
>GtkButtonBoxStyle</A> <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-BUTTON-LAYOUT"
>gnome_preferences_get_button_layout</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-BUTTON-LAYOUT"
>gnome_preferences_set_button_layout</A
>
                                            (<A
HREF=../gtk/gtk-standard-enumerations.html#GTKBUTTONBOXSTYLE
>GtkButtonBoxStyle</A> style);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-STATUSBAR-DIALOG"
>gnome_preferences_get_statusbar_dialog</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-STATUSBAR-DIALOG"
>gnome_preferences_set_statusbar_dialog</A
>
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> statusbar);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-STATUSBAR-INTERACTIVE"
>gnome_preferences_get_statusbar_interactive</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-STATUSBAR-INTERACTIVE"
>gnome_preferences_set_statusbar_interactive</A
>
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-STATUSBAR-METER-ON-RIGHT"
>gnome_preferences_get_statusbar_meter_on_right</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-STATUSBAR-METER-ON-RIGHT"
>gnome_preferences_set_statusbar_meter_on_right</A
>
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> status_meter_on_right);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-MENUBAR-DETACHABLE"
>gnome_preferences_get_menubar_detachable</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-MENUBAR-DETACHABLE"
>gnome_preferences_set_menubar_detachable</A
>
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-MENUBAR-RELIEF"
>gnome_preferences_get_menubar_relief</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-MENUBAR-RELIEF"
>gnome_preferences_set_menubar_relief</A
>
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-TOOLBAR-DETACHABLE"
>gnome_preferences_get_toolbar_detachable</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-TOOLBAR-DETACHABLE"
>gnome_preferences_set_toolbar_detachable</A
>
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-TOOLBAR-RELIEF"
>gnome_preferences_get_toolbar_relief</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-TOOLBAR-RELIEF"
>gnome_preferences_set_toolbar_relief</A
>
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-TOOLBAR-RELIEF-BTN"
>gnome_preferences_get_toolbar_relief_btn</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-TOOLBAR-RELIEF-BTN"
>gnome_preferences_set_toolbar_relief_btn</A
>
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-TOOLBAR-LINES"
>gnome_preferences_get_toolbar_lines</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-TOOLBAR-LINES"
>gnome_preferences_set_toolbar_lines</A
>
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-TOOLBAR-LABELS"
>gnome_preferences_get_toolbar_labels</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-TOOLBAR-LABELS"
>gnome_preferences_set_toolbar_labels</A
>
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-DIALOG-CENTERED"
>gnome_preferences_get_dialog_centered</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-DIALOG-CENTERED"
>gnome_preferences_set_dialog_centered</A
>
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);
<A
HREF=../gtk/gtk-standard-enumerations.html#GTKWINDOWTYPE
>GtkWindowType</A> <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-DIALOG-TYPE"
>gnome_preferences_get_dialog_type</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-DIALOG-TYPE"
>gnome_preferences_set_dialog_type</A
>
                                            (<A
HREF=../gtk/gtk-standard-enumerations.html#GTKWINDOWTYPE
>GtkWindowType</A> t);
<A
HREF=../gtk/gtk-standard-enumerations.html#GTKWINDOWPOSITION
>GtkWindowPosition</A> <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-DIALOG-POSITION"
>gnome_preferences_get_dialog_position</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-DIALOG-POSITION"
>gnome_preferences_set_dialog_position</A
>
                                            (<A
HREF=../gtk/gtk-standard-enumerations.html#GTKWINDOWPOSITION
>GtkWindowPosition</A> p);
<A
HREF="gnomemdi.html#GNOMEMDIMODE"
>GnomeMDIMode</A
> <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-MDI-MODE"
>gnome_preferences_get_mdi_mode</A
> (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-MDI-MODE"
>gnome_preferences_set_mdi_mode</A
>  (<A
HREF="gnomemdi.html#GNOMEMDIMODE"
>GnomeMDIMode</A
> m);
<A
HREF=../gtk/gtk-standard-enumerations.html#GTKPOSITIONTYPE
>GtkPositionType</A> <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-MDI-TAB-POS"
>gnome_preferences_get_mdi_tab_pos</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-MDI-TAB-POS"
>gnome_preferences_set_mdi_tab_pos</A
>
                                            (<A
HREF=../gtk/gtk-standard-enumerations.html#GTKPOSITIONTYPE
>GtkPositionType</A> p);
int         <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-PROPERTY-BOX-APPLY"
>gnome_preferences_get_property_box_apply</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-PROPERTY-BOX-BUTTON-APPLY"
>gnome_preferences_set_property_box_button_apply</A
>
                                            (int v);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-MENUS-HAVE-TEAROFF"
>gnome_preferences_get_menus_have_tearoff</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-MENUS-HAVE-TEAROFF"
>gnome_preferences_set_menus_have_tearoff</A
>
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);
int         <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-MENUS-HAVE-ICONS"
>gnome_preferences_get_menus_have_icons</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-MENUS-HAVE-ICONS"
>gnome_preferences_set_menus_have_icons</A
>
                                            (int have_icons);
int         <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-GET-DISABLE-IMLIB-CACHE"
>gnome_preferences_get_disable_imlib_cache</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-SET-DISABLE-IMLIB-CACHE"
>gnome_preferences_set_disable_imlib_cache</A
>
                                            (int disable_imlib_cache);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN5100"
></A
><H2
>Description</H2
><P
>    Routines used for loading, saving and accessing the various user
    preferences that are part of the GNOME configuration.
    <A
HREF="gnomeui-gnome-init.html#GNOME-INIT"
>gnome_init</A
>() calls <A
HREF="gnomeui-gnome-preferences.html#GNOME-PREFERENCES-LOAD"
>gnome_preferences_load</A
>() at startup.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN5105"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN5107"
></A
><H3
><A
NAME="GNOMEPREFERENCES"
></A
>struct GnomePreferences</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomePreferences {
  GtkButtonBoxStyle dialog_buttons_style;
  int property_box_buttons_ok : 1;
  int property_box_buttons_apply : 1;
  int property_box_buttons_close : 1;
  int property_box_buttons_help : 1;
  int statusbar_not_dialog : 1;
  int statusbar_is_interactive : 1;
  int statusbar_meter_on_right : 1;
  int menubar_detachable : 1;
  int menubar_relief : 1;
  int toolbar_detachable : 1;
  int toolbar_relief : 1;
  int toolbar_relief_btn : 1;
  int toolbar_lines : 1;
  int toolbar_labels : 1;
  int dialog_centered : 1;
  int menus_have_tearoff : 1;
  int menus_have_icons : 1;
  int disable_imlib_cache : 1;
  GtkWindowType dialog_type;
  GtkWindowPosition dialog_position;
  GnomeMDIMode mdi_mode;
  GtkPositionType mdi_tab_pos;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5112"
></A
><H3
><A
NAME="GNOME-PREFERENCES-LOAD"
></A
>gnome_preferences_load ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_load          (void);</PRE
></TD
></TR
></TABLE
><P
>Uses gnome_config_xxx() API to load a standard set of GNOME
preferences into the default GNOME preferences object.</P
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5119"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SAVE"
></A
>gnome_preferences_save ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_save          (void);</PRE
></TD
></TR
></TABLE
><P
>Uses gnome_config_xxx() API to store a standard set of GNOME
preferences using info in the default GNOME preferences object.</P
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5126"
></A
><H3
><A
NAME="GNOME-PREFERENCES-LOAD-CUSTOM"
></A
>gnome_preferences_load_custom ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_load_custom   (<A
HREF="gnomeui-gnome-preferences.html#GNOMEPREFERENCES"
>GnomePreferences</A
> *settings);</PRE
></TD
></TR
></TABLE
><P
>Uses gnome_config_xxx() interface to load a set of
standard GNOME preferences into the specified <TT
CLASS="PARAMETER"
><I
>settings</I
></TT
> object.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5135"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>settings</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> App-specified set of user preferences</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5144"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SAVE-CUSTOM"
></A
>gnome_preferences_save_custom ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_save_custom   (<A
HREF="gnomeui-gnome-preferences.html#GNOMEPREFERENCES"
>GnomePreferences</A
> *settings);</PRE
></TD
></TR
></TABLE
><P
>Uses gnome_config_xxx() interface to store a set of
standard GNOME preferences from info in the <TT
CLASS="PARAMETER"
><I
>settings</I
></TT
> object.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5153"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>settings</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> App-specified set of user preferences</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5162"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-BUTTON-LAYOUT"
></A
>gnome_preferences_get_button_layout ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtk-standard-enumerations.html#GTKBUTTONBOXSTYLE
>GtkButtonBoxStyle</A> gnome_preferences_get_button_layout
                                            (void);</PRE
></TD
></TR
></TABLE
><P
>Obtain the button style from the default GNOME preferences object.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5169"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Enumerated type indicating the default GNOME dialog button style.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5178"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-BUTTON-LAYOUT"
></A
>gnome_preferences_set_button_layout ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_button_layout
                                            (<A
HREF=../gtk/gtk-standard-enumerations.html#GTKBUTTONBOXSTYLE
>GtkButtonBoxStyle</A> style);</PRE
></TD
></TR
></TABLE
><P
>Set the default GNOME preferences object's default button style.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5185"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>style</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Enumerated type indicating the default GNOME dialog button style.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5194"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-STATUSBAR-DIALOG"
></A
>gnome_preferences_get_statusbar_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_preferences_get_statusbar_dialog
                                            (void);</PRE
></TD
></TR
></TABLE
><P
>Determine whether or not the statusbar is a dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5201"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>FALSE</TT
> if statusbar is a dialog, <TT
CLASS="LITERAL"
>TRUE</TT
> if not.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5212"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-STATUSBAR-DIALOG"
></A
>gnome_preferences_set_statusbar_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_statusbar_dialog
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> statusbar);</PRE
></TD
></TR
></TABLE
><P
>Indicate whether or not the default for GNOME status bars
is a dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5219"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>statusbar</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5228"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-STATUSBAR-INTERACTIVE"
></A
>gnome_preferences_get_statusbar_interactive ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_preferences_get_statusbar_interactive
                                            (void);</PRE
></TD
></TR
></TABLE
><P
>Determine whether or not the statusbar is interactive.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5235"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if statusbar is interactive, <TT
CLASS="LITERAL"
>FALSE</TT
> if not.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5246"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-STATUSBAR-INTERACTIVE"
></A
>gnome_preferences_set_statusbar_interactive ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_statusbar_interactive
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);</PRE
></TD
></TR
></TABLE
><P
>Indicate whether or not the GNOME status bars are, by default,
interactive.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5253"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if statusbar is interactive, <TT
CLASS="LITERAL"
>FALSE</TT
> if not.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5264"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-STATUSBAR-METER-ON-RIGHT"
></A
>gnome_preferences_get_statusbar_meter_on_right ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_preferences_get_statusbar_meter_on_right
                                            (void);</PRE
></TD
></TR
></TABLE
><P
>Determine whether or not the statusbar's meter is on the right-hand side.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5271"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if statusbar meter is on the right side, <TT
CLASS="LITERAL"
>FALSE</TT
> if not.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5282"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-STATUSBAR-METER-ON-RIGHT"
></A
>gnome_preferences_set_statusbar_meter_on_right ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_statusbar_meter_on_right
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> status_meter_on_right);</PRE
></TD
></TR
></TABLE
><P
>Indicate whether or not the GNOME status bars are, by default,
on the right-hand side.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5289"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>status_meter_on_right</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5298"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-MENUBAR-DETACHABLE"
></A
>gnome_preferences_get_menubar_detachable ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_preferences_get_menubar_detachable
                                            (void);</PRE
></TD
></TR
></TABLE
><P
>Determine whether or not a menu bar is, by default,
detachable from its parent frame.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5305"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if menu bars are detachable, <TT
CLASS="LITERAL"
>FALSE</TT
> if not.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5316"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-MENUBAR-DETACHABLE"
></A
>gnome_preferences_set_menubar_detachable ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_menubar_detachable
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);</PRE
></TD
></TR
></TABLE
><P
>Indicate whether or not the GNOME menu bars are, by default,
detachable from their parent frame.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5323"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if menu bars are detachable, <TT
CLASS="LITERAL"
>FALSE</TT
> if not.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5334"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-MENUBAR-RELIEF"
></A
>gnome_preferences_get_menubar_relief ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_preferences_get_menubar_relief
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5341"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the relieft settings for the menubar.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5350"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-MENUBAR-RELIEF"
></A
>gnome_preferences_set_menubar_relief ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_menubar_relief
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5357"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5366"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-TOOLBAR-DETACHABLE"
></A
>gnome_preferences_get_toolbar_detachable ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_preferences_get_toolbar_detachable
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5373"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5382"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-TOOLBAR-DETACHABLE"
></A
>gnome_preferences_set_toolbar_detachable ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_toolbar_detachable
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5389"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5398"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-TOOLBAR-RELIEF"
></A
>gnome_preferences_get_toolbar_relief ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_preferences_get_toolbar_relief
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5405"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5414"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-TOOLBAR-RELIEF"
></A
>gnome_preferences_set_toolbar_relief ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_toolbar_relief
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5421"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5430"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-TOOLBAR-RELIEF-BTN"
></A
>gnome_preferences_get_toolbar_relief_btn ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_preferences_get_toolbar_relief_btn
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5437"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5446"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-TOOLBAR-RELIEF-BTN"
></A
>gnome_preferences_set_toolbar_relief_btn ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_toolbar_relief_btn
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5453"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5462"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-TOOLBAR-LINES"
></A
>gnome_preferences_get_toolbar_lines ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_preferences_get_toolbar_lines
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5469"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5478"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-TOOLBAR-LINES"
></A
>gnome_preferences_set_toolbar_lines ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_toolbar_lines
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5485"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5494"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-TOOLBAR-LABELS"
></A
>gnome_preferences_get_toolbar_labels ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_preferences_get_toolbar_labels
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5501"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5510"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-TOOLBAR-LABELS"
></A
>gnome_preferences_set_toolbar_labels ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_toolbar_labels
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5517"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5526"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-DIALOG-CENTERED"
></A
>gnome_preferences_get_dialog_centered ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_preferences_get_dialog_centered
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5533"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5542"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-DIALOG-CENTERED"
></A
>gnome_preferences_set_dialog_centered ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_dialog_centered
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5549"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5558"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-DIALOG-TYPE"
></A
>gnome_preferences_get_dialog_type ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtk-standard-enumerations.html#GTKWINDOWTYPE
>GtkWindowType</A> gnome_preferences_get_dialog_type
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5565"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5574"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-DIALOG-TYPE"
></A
>gnome_preferences_set_dialog_type ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_dialog_type
                                            (<A
HREF=../gtk/gtk-standard-enumerations.html#GTKWINDOWTYPE
>GtkWindowType</A> t);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5581"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>t</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5590"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-DIALOG-POSITION"
></A
>gnome_preferences_get_dialog_position ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtk-standard-enumerations.html#GTKWINDOWPOSITION
>GtkWindowPosition</A> gnome_preferences_get_dialog_position
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5597"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5606"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-DIALOG-POSITION"
></A
>gnome_preferences_set_dialog_position ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_dialog_position
                                            (<A
HREF=../gtk/gtk-standard-enumerations.html#GTKWINDOWPOSITION
>GtkWindowPosition</A> p);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5613"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>p</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5622"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-MDI-MODE"
></A
>gnome_preferences_get_mdi_mode ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomemdi.html#GNOMEMDIMODE"
>GnomeMDIMode</A
> gnome_preferences_get_mdi_mode (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5629"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5638"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-MDI-MODE"
></A
>gnome_preferences_set_mdi_mode ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_mdi_mode  (<A
HREF="gnomemdi.html#GNOMEMDIMODE"
>GnomeMDIMode</A
> m);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5645"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>m</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5654"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-MDI-TAB-POS"
></A
>gnome_preferences_get_mdi_tab_pos ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtk-standard-enumerations.html#GTKPOSITIONTYPE
>GtkPositionType</A> gnome_preferences_get_mdi_tab_pos
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5661"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5670"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-MDI-TAB-POS"
></A
>gnome_preferences_set_mdi_tab_pos ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_mdi_tab_pos
                                            (<A
HREF=../gtk/gtk-standard-enumerations.html#GTKPOSITIONTYPE
>GtkPositionType</A> p);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5677"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>p</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5686"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-PROPERTY-BOX-APPLY"
></A
>gnome_preferences_get_property_box_apply ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_preferences_get_property_box_apply
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5692"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5701"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-PROPERTY-BOX-BUTTON-APPLY"
></A
>gnome_preferences_set_property_box_button_apply ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_property_box_button_apply
                                            (int v);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5707"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>v</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5716"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-MENUS-HAVE-TEAROFF"
></A
>gnome_preferences_get_menus_have_tearoff ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_preferences_get_menus_have_tearoff
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5723"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5732"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-MENUS-HAVE-TEAROFF"
></A
>gnome_preferences_set_menus_have_tearoff ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_menus_have_tearoff
                                            (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> b);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5739"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>b</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5748"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-MENUS-HAVE-ICONS"
></A
>gnome_preferences_get_menus_have_icons ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_preferences_get_menus_have_icons
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5754"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5763"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-MENUS-HAVE-ICONS"
></A
>gnome_preferences_set_menus_have_icons ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_menus_have_icons
                                            (int have_icons);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5769"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>have_icons</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5778"
></A
><H3
><A
NAME="GNOME-PREFERENCES-GET-DISABLE-IMLIB-CACHE"
></A
>gnome_preferences_get_disable_imlib_cache ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int         gnome_preferences_get_disable_imlib_cache
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5784"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5793"
></A
><H3
><A
NAME="GNOME-PREFERENCES-SET-DISABLE-IMLIB-CACHE"
></A
>gnome_preferences_set_disable_imlib_cache ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_preferences_set_disable_imlib_cache
                                            (int disable_imlib_cache);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5799"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>disable_imlib_cache</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN5808"
></A
><H2
>See Also</H2
><P
>    <A
HREF="gnomeui-gnome-init.html#GNOME-INIT"
>gnome_init</A
>(), <A
HREF="gnomeui-gnome-init.html#GNOME-INIT-WITH-POPT-TABLE"
>gnome_init_with_popt_table</A
>()</P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-popup-menu.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-properties.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
>gnome-popup-menu</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-properties</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-properties</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-preferences"
HREF="gnomeui-gnome-preferences.html"><LINK
REL="NEXT"
TITLE="gnome-property-entries"
HREF="gnomeui-gnome-property-entries.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-preferences.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-property-entries.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-PROPERTIES"
>gnome-properties</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN5818"
></A
><H2
>Name</H2
>gnome-properties&nbsp;--&nbsp;deprecated/experimental/unfinished</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN5821"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
>;
struct      <A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYDESCRIPTOR"
>GnomePropertyDescriptor</A
>;
enum        <A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYACTION"
>GnomePropertyAction</A
>;
<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
>* <A
HREF="gnomeui-gnome-properties.html#GNOME-PROPERTY-OBJECT-NEW"
>gnome_property_object_new</A
>
                                            (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYDESCRIPTOR"
>GnomePropertyDescriptor</A
> *descriptor,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> property_data_ptr);
void        <A
HREF="gnomeui-gnome-properties.html#GNOME-PROPERTY-OBJECT-REGISTER"
>gnome_property_object_register</A
>  (<A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> *property_box,
                                             <A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);
void        <A
HREF="gnomeui-gnome-properties.html#GNOME-PROPERTY-OBJECT-LIST-WALK"
>gnome_property_object_list_walk</A
> (<A
HREF=../glib/glib-doubly-linked-lists.html#GLIST
>GList</A> *property_object_list,
                                             <A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYACTION"
>GnomePropertyAction</A
> action);
void        <A
HREF="gnomeui-gnome-properties.html#GNOME-PROPERTY-OBJECT-APPLY"
>gnome_property_object_apply</A
>     (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);
void        <A
HREF="gnomeui-gnome-properties.html#GNOME-PROPERTY-OBJECT-UPDATE"
>gnome_property_object_update</A
>    (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);
void        <A
HREF="gnomeui-gnome-properties.html#GNOME-PROPERTY-OBJECT-LOAD"
>gnome_property_object_load</A
>      (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);
void        <A
HREF="gnomeui-gnome-properties.html#GNOME-PROPERTY-OBJECT-SAVE"
>gnome_property_object_save</A
>      (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);
void        <A
HREF="gnomeui-gnome-properties.html#GNOME-PROPERTY-OBJECT-LOAD-TEMP"
>gnome_property_object_load_temp</A
> (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);
void        <A
HREF="gnomeui-gnome-properties.html#GNOME-PROPERTY-OBJECT-SAVE-TEMP"
>gnome_property_object_save_temp</A
> (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);
void        <A
HREF="gnomeui-gnome-properties.html#GNOME-PROPERTY-OBJECT-DISCARD-TEMP"
>gnome_property_object_discard_temp</A
>
                                            (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);
void        <A
HREF="gnomeui-gnome-properties.html#GNOME-PROPERTY-OBJECT-CHANGED"
>gnome_property_object_changed</A
>   (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN5853"
></A
><H2
>Description</H2
><P
>This module is deprecated/experimental/unfinished. Don't use it.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN5856"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN5858"
></A
><H3
><A
NAME="GNOMEPROPERTYOBJECT"
></A
>struct GnomePropertyObject</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomePropertyObject {
	GtkWidget *label;
	GnomePropertyDescriptor *descriptor;
	gpointer prop_data, temp_data, user_data;
	GList *object_list;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5863"
></A
><H3
><A
NAME="GNOMEPROPERTYDESCRIPTOR"
></A
>struct GnomePropertyDescriptor</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomePropertyDescriptor {
	guint size;
	const gchar *label;
	GtkWidget * (*init_func) (GnomePropertyObject *);
	void (*apply_func) (GnomePropertyObject *);
	void (*update_func) (GnomePropertyObject *);
	void (*load_func) (GnomePropertyObject *);
	void (*save_func) (GnomePropertyObject *);
	void (*load_temp_func) (GnomePropertyObject *);
	gint (*save_temp_func) (GnomePropertyObject *);
	void (*discard_temp_func) (GnomePropertyObject *);
	void (*changed_func) (GnomePropertyObject *);
	GList *next;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5868"
></A
><H3
><A
NAME="GNOMEPROPERTYACTION"
></A
>enum GnomePropertyAction</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum {
	GNOME_PROPERTY_ACTION_APPLY = 1,
	GNOME_PROPERTY_ACTION_UPDATE,
	GNOME_PROPERTY_ACTION_LOAD,
	GNOME_PROPERTY_ACTION_SAVE,
	GNOME_PROPERTY_ACTION_LOAD_TEMP,
	GNOME_PROPERTY_ACTION_SAVE_TEMP,
	GNOME_PROPERTY_ACTION_DISCARD_TEMP,
	GNOME_PROPERTY_ACTION_CHANGED
} GnomePropertyAction;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5873"
></A
><H3
><A
NAME="GNOME-PROPERTY-OBJECT-NEW"
></A
>gnome_property_object_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
>* gnome_property_object_new
                                            (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYDESCRIPTOR"
>GnomePropertyDescriptor</A
> *descriptor,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> property_data_ptr);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5881"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>descriptor</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>property_data_ptr</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5898"
></A
><H3
><A
NAME="GNOME-PROPERTY-OBJECT-REGISTER"
></A
>gnome_property_object_register ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_property_object_register  (<A
HREF="gnomepropertybox.html"
>GnomePropertyBox</A
> *property_box,
                                             <A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5905"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>property_box</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5918"
></A
><H3
><A
NAME="GNOME-PROPERTY-OBJECT-LIST-WALK"
></A
>gnome_property_object_list_walk ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_property_object_list_walk (<A
HREF=../glib/glib-doubly-linked-lists.html#GLIST
>GList</A> *property_object_list,
                                             <A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYACTION"
>GnomePropertyAction</A
> action);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5925"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>property_object_list</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>action</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5938"
></A
><H3
><A
NAME="GNOME-PROPERTY-OBJECT-APPLY"
></A
>gnome_property_object_apply ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_property_object_apply     (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5944"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5953"
></A
><H3
><A
NAME="GNOME-PROPERTY-OBJECT-UPDATE"
></A
>gnome_property_object_update ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_property_object_update    (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5959"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5968"
></A
><H3
><A
NAME="GNOME-PROPERTY-OBJECT-LOAD"
></A
>gnome_property_object_load ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_property_object_load      (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5974"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5983"
></A
><H3
><A
NAME="GNOME-PROPERTY-OBJECT-SAVE"
></A
>gnome_property_object_save ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_property_object_save      (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN5989"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN5998"
></A
><H3
><A
NAME="GNOME-PROPERTY-OBJECT-LOAD-TEMP"
></A
>gnome_property_object_load_temp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_property_object_load_temp (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6004"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6013"
></A
><H3
><A
NAME="GNOME-PROPERTY-OBJECT-SAVE-TEMP"
></A
>gnome_property_object_save_temp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_property_object_save_temp (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6019"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6028"
></A
><H3
><A
NAME="GNOME-PROPERTY-OBJECT-DISCARD-TEMP"
></A
>gnome_property_object_discard_temp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_property_object_discard_temp
                                            (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6034"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6043"
></A
><H3
><A
NAME="GNOME-PROPERTY-OBJECT-CHANGED"
></A
>gnome_property_object_changed ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_property_object_changed   (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6049"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-preferences.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-property-entries.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
>gnome-preferences</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-property-entries</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-property-entries</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-properties"
HREF="gnomeui-gnome-properties.html"><LINK
REL="NEXT"
TITLE="gnome-startup"
HREF="gnomeui-gnome-startup.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-properties.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-startup.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-PROPERTY-ENTRIES"
>gnome-property-entries</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6063"
></A
><H2
>Name</H2
>gnome-property-entries&nbsp;--&nbsp;deprecated/experimental/unfinished</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6066"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-property-entries.html#GNOME-PROPERTY-ENTRY-FONT"
>gnome_property_entry_font</A
>       (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *label,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **font_name_ptr,
                                             <A
HREF=../gdk/gdk-fonts.html#GDKFONT
>GdkFont</A> **font_ptr);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gnomeui-gnome-property-entries.html#GNOME-PROPERTY-ENTRY-COLORS"
>gnome_property_entry_colors</A
>     (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *label,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> num_colors,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> columns,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *table_pos,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *colors,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *texts[]);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6084"
></A
><H2
>Description</H2
><P
>This module is deprecated/experimental/unfinished. Don't use it.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6087"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN6089"
></A
><H3
><A
NAME="GNOME-PROPERTY-ENTRY-FONT"
></A
>gnome_property_entry_font ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_property_entry_font       (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *label,
                                             <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> **font_name_ptr,
                                             <A
HREF=../gdk/gdk-fonts.html#GDKFONT
>GdkFont</A> **font_ptr);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6099"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>font_name_ptr</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>font_ptr</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6124"
></A
><H3
><A
NAME="GNOME-PROPERTY-ENTRY-COLORS"
></A
>gnome_property_entry_colors ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gnome_property_entry_colors     (<A
HREF="gnomeui-gnome-properties.html#GNOMEPROPERTYOBJECT"
>GnomePropertyObject</A
> *object,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *label,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> num_colors,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> columns,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *table_pos,
                                             <A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLOR
>GdkColor</A> *colors,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *texts[]);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6137"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>label</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>num_colors</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>columns</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>table_pos</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>colors</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>texts</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-properties.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-startup.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
>gnome-properties</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-startup</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-startup</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-property-entries"
HREF="gnomeui-gnome-property-entries.html"><LINK
REL="NEXT"
TITLE="gnome-types"
HREF="gnomeui-gnome-types.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-property-entries.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-types.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-STARTUP"
>gnome-startup</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6179"
></A
><H2
>Name</H2
>gnome-startup&nbsp;--&nbsp;Internal routines for session management.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6182"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-startup.html#GNOME-STARTUP-ACQUIRE-TOKEN"
>gnome_startup_acquire_token</A
>     (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *property_name,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *sm_id);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6189"
></A
><H2
>Description</H2
><P
>These routines should be considered internal to GNOME and might change
without notice.  Do not use.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6192"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN6194"
></A
><H3
><A
NAME="GNOME-STARTUP-ACQUIRE-TOKEN"
></A
>gnome_startup_acquire_token ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_startup_acquire_token     (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *property_name,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *sm_id);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6202"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>property_name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>sm_id</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-property-entries.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-types.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
>gnome-property-entries</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-types</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-types</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-startup"
HREF="gnomeui-gnome-startup.html"><LINK
REL="NEXT"
TITLE="gnome-uidefs"
HREF="gnomeui-gnome-uidefs.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-startup.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-uidefs.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-TYPES"
>gnome-types</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6224"
></A
><H2
>Name</H2
>gnome-types&nbsp;--&nbsp;Some global types used by the GNOME libraries.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6227"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


void        (<A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>*GnomeStringCallback</A
>)          (<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *string,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
void        (<A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>*GnomeReplyCallback</A
>)           (<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> reply,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);
enum        <A
HREF="gnomeui-gnome-types.html#GNOMEPREFERENCESTYPE"
>GnomePreferencesType</A
>;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6237"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6240"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN6242"
></A
><H3
><A
NAME="GNOMESTRINGCALLBACK"
></A
>GnomeStringCallback ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        (*GnomeStringCallback)          (<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *string,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6249"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>string</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6262"
></A
><H3
><A
NAME="GNOMEREPLYCALLBACK"
></A
>GnomeReplyCallback ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        (*GnomeReplyCallback)           (<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> reply,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6269"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>reply</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6282"
></A
><H3
><A
NAME="GNOMEPREFERENCESTYPE"
></A
>enum GnomePreferencesType</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum {
  GNOME_PREFERENCES_NEVER,
  GNOME_PREFERENCES_USER,
  GNOME_PREFERENCES_ALWAYS
} GnomePreferencesType;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-startup.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-uidefs.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
>gnome-startup</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-uidefs</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-uidefs</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-types"
HREF="gnomeui-gnome-types.html"><LINK
REL="NEXT"
TITLE="gnome-window-icon"
HREF="gnomeui-gnome-window-icon.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-types.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-window-icon.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-UIDEFS"
>gnome-uidefs</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6292"
></A
><H2
>Name</H2
>gnome-uidefs&nbsp;--&nbsp;Useful GNOME macros</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6295"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-PAD-CAPS"
>GNOME_PAD</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-PAD-SMALL-CAPS"
>GNOME_PAD_SMALL</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-PAD-BIG-CAPS"
>GNOME_PAD_BIG</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-YES-CAPS"
>GNOME_YES</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-NO-CAPS"
>GNOME_NO</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-OK-CAPS"
>GNOME_OK</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-CANCEL-CAPS"
>GNOME_CANCEL</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-EXIT-CAPS"
>GNOME_KEY_NAME_EXIT</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-EXIT-CAPS"
>GNOME_KEY_MOD_EXIT</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-CLOSE-CAPS"
>GNOME_KEY_NAME_CLOSE</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-CLOSE-CAPS"
>GNOME_KEY_MOD_CLOSE</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-CUT-CAPS"
>GNOME_KEY_NAME_CUT</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-CUT-CAPS"
>GNOME_KEY_MOD_CUT</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-COPY-CAPS"
>GNOME_KEY_NAME_COPY</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-COPY-CAPS"
>GNOME_KEY_MOD_COPY</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-PASTE-CAPS"
>GNOME_KEY_NAME_PASTE</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-PASTE-CAPS"
>GNOME_KEY_MOD_PASTE</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-SELECT-ALL-CAPS"
>GNOME_KEY_NAME_SELECT_ALL</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-SELECT-ALL-CAPS"
>GNOME_KEY_MOD_SELECT_ALL</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-CLEAR-CAPS"
>GNOME_KEY_NAME_CLEAR</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-CLEAR-CAPS"
>GNOME_KEY_MOD_CLEAR</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-UNDO-CAPS"
>GNOME_KEY_NAME_UNDO</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-UNDO-CAPS"
>GNOME_KEY_MOD_UNDO</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-REDO-CAPS"
>GNOME_KEY_NAME_REDO</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-REDO-CAPS"
>GNOME_KEY_MOD_REDO</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-NEW-CAPS"
>GNOME_KEY_NAME_NEW</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-NEW-CAPS"
>GNOME_KEY_MOD_NEW</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-SAVE-CAPS"
>GNOME_KEY_NAME_SAVE</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-SAVE-CAPS"
>GNOME_KEY_MOD_SAVE</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-SAVE-AS-CAPS"
>GNOME_KEY_NAME_SAVE_AS</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-SAVE-AS-CAPS"
>GNOME_KEY_MOD_SAVE_AS</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-OPEN-CAPS"
>GNOME_KEY_NAME_OPEN</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-OPEN-CAPS"
>GNOME_KEY_MOD_OPEN</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-NEW-WINDOW-CAPS"
>GNOME_KEY_NAME_NEW_WINDOW</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-NEW-WINDOW-CAPS"
>GNOME_KEY_MOD_NEW_WINDOW</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-CLOSE-WINDOW-CAPS"
>GNOME_KEY_NAME_CLOSE_WINDOW</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-CLOSE-WINDOW-CAPS"
>GNOME_KEY_MOD_CLOSE_WINDOW</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-REDO-MOVE-CAPS"
>GNOME_KEY_NAME_REDO_MOVE</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-REDO-MOVE-CAPS"
>GNOME_KEY_MOD_REDO_MOVE</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-UNDO-MOVE-CAPS"
>GNOME_KEY_NAME_UNDO_MOVE</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-UNDO-MOVE-CAPS"
>GNOME_KEY_MOD_UNDO_MOVE</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-FIND-CAPS"
>GNOME_KEY_NAME_FIND</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-FIND-CAPS"
>GNOME_KEY_MOD_FIND</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-FIND-AGAIN-CAPS"
>GNOME_KEY_NAME_FIND_AGAIN</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-FIND-AGAIN-CAPS"
>GNOME_KEY_MOD_FIND_AGAIN</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-REPLACE-CAPS"
>GNOME_KEY_NAME_REPLACE</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-REPLACE-CAPS"
>GNOME_KEY_MOD_REPLACE</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-PAUSE-GAME-CAPS"
>GNOME_KEY_NAME_PAUSE_GAME</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-PAUSE-GAME-CAPS"
>GNOME_KEY_MOD_PAUSE_GAME</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-NEW-GAME-CAPS"
>GNOME_KEY_NAME_NEW_GAME</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-NEW-GAME-CAPS"
>GNOME_KEY_MOD_NEW_GAME</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-PRINT-CAPS"
>GNOME_KEY_NAME_PRINT</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-PRINT-CAPS"
>GNOME_KEY_MOD_PRINT</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-NAME-PRINT-SETUP-CAPS"
>GNOME_KEY_NAME_PRINT_SETUP</A
>
#define     <A
HREF="gnomeui-gnome-uidefs.html#GNOME-KEY-MOD-PRINT-SETUP-CAPS"
>GNOME_KEY_MOD_PRINT_SETUP</A
></PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6353"
></A
><H2
>Description</H2
><P
>Use the GNOME_PAD macros to make GNOME spacing and distances more
consistent. GNOME_YES and GNOME_NO, GNOME_OK and GNOME_CANCEL are used
to represent button numbers in yes-no or ok-cancel GnomeDialogs.
Ignore the GNOME_KEY_ macros, they are old cruft.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6356"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN6358"
></A
><H3
><A
NAME="GNOME-PAD-CAPS"
></A
>GNOME_PAD</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_PAD          8</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6363"
></A
><H3
><A
NAME="GNOME-PAD-SMALL-CAPS"
></A
>GNOME_PAD_SMALL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_PAD_SMALL    4</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6368"
></A
><H3
><A
NAME="GNOME-PAD-BIG-CAPS"
></A
>GNOME_PAD_BIG</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_PAD_BIG      12</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6373"
></A
><H3
><A
NAME="GNOME-YES-CAPS"
></A
>GNOME_YES</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_YES 0 </PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6378"
></A
><H3
><A
NAME="GNOME-NO-CAPS"
></A
>GNOME_NO</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_NO 1 </PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6383"
></A
><H3
><A
NAME="GNOME-OK-CAPS"
></A
>GNOME_OK</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_OK 0</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6388"
></A
><H3
><A
NAME="GNOME-CANCEL-CAPS"
></A
>GNOME_CANCEL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_CANCEL 1</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6393"
></A
><H3
><A
NAME="GNOME-KEY-NAME-EXIT-CAPS"
></A
>GNOME_KEY_NAME_EXIT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_EXIT 	        'Q'</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6398"
></A
><H3
><A
NAME="GNOME-KEY-MOD-EXIT-CAPS"
></A
>GNOME_KEY_MOD_EXIT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_EXIT	        (GDK_CONTROL_MASK)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6403"
></A
><H3
><A
NAME="GNOME-KEY-NAME-CLOSE-CAPS"
></A
>GNOME_KEY_NAME_CLOSE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_CLOSE 	        'W'</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6408"
></A
><H3
><A
NAME="GNOME-KEY-MOD-CLOSE-CAPS"
></A
>GNOME_KEY_MOD_CLOSE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define	GNOME_KEY_MOD_CLOSE	        (GDK_CONTROL_MASK)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6413"
></A
><H3
><A
NAME="GNOME-KEY-NAME-CUT-CAPS"
></A
>GNOME_KEY_NAME_CUT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_CUT 	        'X'</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6418"
></A
><H3
><A
NAME="GNOME-KEY-MOD-CUT-CAPS"
></A
>GNOME_KEY_MOD_CUT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_CUT 	        (GDK_CONTROL_MASK)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6423"
></A
><H3
><A
NAME="GNOME-KEY-NAME-COPY-CAPS"
></A
>GNOME_KEY_NAME_COPY</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_COPY	        'C'</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6428"
></A
><H3
><A
NAME="GNOME-KEY-MOD-COPY-CAPS"
></A
>GNOME_KEY_MOD_COPY</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_COPY	        (GDK_CONTROL_MASK)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6433"
></A
><H3
><A
NAME="GNOME-KEY-NAME-PASTE-CAPS"
></A
>GNOME_KEY_NAME_PASTE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_PASTE 	        'V'</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6438"
></A
><H3
><A
NAME="GNOME-KEY-MOD-PASTE-CAPS"
></A
>GNOME_KEY_MOD_PASTE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_PASTE 	        (GDK_CONTROL_MASK)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6443"
></A
><H3
><A
NAME="GNOME-KEY-NAME-SELECT-ALL-CAPS"
></A
>GNOME_KEY_NAME_SELECT_ALL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_SELECT_ALL       0</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6448"
></A
><H3
><A
NAME="GNOME-KEY-MOD-SELECT-ALL-CAPS"
></A
>GNOME_KEY_MOD_SELECT_ALL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_SELECT_ALL        (0)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6453"
></A
><H3
><A
NAME="GNOME-KEY-NAME-CLEAR-CAPS"
></A
>GNOME_KEY_NAME_CLEAR</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_CLEAR 	        0</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6458"
></A
><H3
><A
NAME="GNOME-KEY-MOD-CLEAR-CAPS"
></A
>GNOME_KEY_MOD_CLEAR</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_CLEAR 	        (0)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6463"
></A
><H3
><A
NAME="GNOME-KEY-NAME-UNDO-CAPS"
></A
>GNOME_KEY_NAME_UNDO</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_UNDO  	        'Z'</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6468"
></A
><H3
><A
NAME="GNOME-KEY-MOD-UNDO-CAPS"
></A
>GNOME_KEY_MOD_UNDO</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_UNDO  	        (GDK_CONTROL_MASK)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6473"
></A
><H3
><A
NAME="GNOME-KEY-NAME-REDO-CAPS"
></A
>GNOME_KEY_NAME_REDO</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_REDO	        'R'</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6478"
></A
><H3
><A
NAME="GNOME-KEY-MOD-REDO-CAPS"
></A
>GNOME_KEY_MOD_REDO</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_REDO	        (GDK_CONTROL_MASK)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6483"
></A
><H3
><A
NAME="GNOME-KEY-NAME-NEW-CAPS"
></A
>GNOME_KEY_NAME_NEW</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_NEW	        0</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6488"
></A
><H3
><A
NAME="GNOME-KEY-MOD-NEW-CAPS"
></A
>GNOME_KEY_MOD_NEW</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_NEW	        (0)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6493"
></A
><H3
><A
NAME="GNOME-KEY-NAME-SAVE-CAPS"
></A
>GNOME_KEY_NAME_SAVE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_SAVE	        'S'</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6498"
></A
><H3
><A
NAME="GNOME-KEY-MOD-SAVE-CAPS"
></A
>GNOME_KEY_MOD_SAVE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_SAVE	        (GDK_CONTROL_MASK)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6503"
></A
><H3
><A
NAME="GNOME-KEY-NAME-SAVE-AS-CAPS"
></A
>GNOME_KEY_NAME_SAVE_AS</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_SAVE_AS	        0</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6508"
></A
><H3
><A
NAME="GNOME-KEY-MOD-SAVE-AS-CAPS"
></A
>GNOME_KEY_MOD_SAVE_AS</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_SAVE_AS           (0)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6513"
></A
><H3
><A
NAME="GNOME-KEY-NAME-OPEN-CAPS"
></A
>GNOME_KEY_NAME_OPEN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_OPEN	        GDK_F3</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6518"
></A
><H3
><A
NAME="GNOME-KEY-MOD-OPEN-CAPS"
></A
>GNOME_KEY_MOD_OPEN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_OPEN	        (0)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6523"
></A
><H3
><A
NAME="GNOME-KEY-NAME-NEW-WINDOW-CAPS"
></A
>GNOME_KEY_NAME_NEW_WINDOW</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_NEW_WINDOW       0</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6528"
></A
><H3
><A
NAME="GNOME-KEY-MOD-NEW-WINDOW-CAPS"
></A
>GNOME_KEY_MOD_NEW_WINDOW</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_NEW_WINDOW        (0)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6533"
></A
><H3
><A
NAME="GNOME-KEY-NAME-CLOSE-WINDOW-CAPS"
></A
>GNOME_KEY_NAME_CLOSE_WINDOW</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_CLOSE_WINDOW     0</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6538"
></A
><H3
><A
NAME="GNOME-KEY-MOD-CLOSE-WINDOW-CAPS"
></A
>GNOME_KEY_MOD_CLOSE_WINDOW</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_CLOSE_WINDOW      (0)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6543"
></A
><H3
><A
NAME="GNOME-KEY-NAME-REDO-MOVE-CAPS"
></A
>GNOME_KEY_NAME_REDO_MOVE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_REDO_MOVE        'R'</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6548"
></A
><H3
><A
NAME="GNOME-KEY-MOD-REDO-MOVE-CAPS"
></A
>GNOME_KEY_MOD_REDO_MOVE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_REDO_MOVE         (GDK_CONTROL_MASK)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6553"
></A
><H3
><A
NAME="GNOME-KEY-NAME-UNDO-MOVE-CAPS"
></A
>GNOME_KEY_NAME_UNDO_MOVE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_UNDO_MOVE        'Z'</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6558"
></A
><H3
><A
NAME="GNOME-KEY-MOD-UNDO-MOVE-CAPS"
></A
>GNOME_KEY_MOD_UNDO_MOVE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_UNDO_MOVE         (GDK_CONTROL_MASK)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6563"
></A
><H3
><A
NAME="GNOME-KEY-NAME-FIND-CAPS"
></A
>GNOME_KEY_NAME_FIND</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_FIND             GDK_F6</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6568"
></A
><H3
><A
NAME="GNOME-KEY-MOD-FIND-CAPS"
></A
>GNOME_KEY_MOD_FIND</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_FIND              (0)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6573"
></A
><H3
><A
NAME="GNOME-KEY-NAME-FIND-AGAIN-CAPS"
></A
>GNOME_KEY_NAME_FIND_AGAIN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_FIND_AGAIN       GDK_F6</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6578"
></A
><H3
><A
NAME="GNOME-KEY-MOD-FIND-AGAIN-CAPS"
></A
>GNOME_KEY_MOD_FIND_AGAIN</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_FIND_AGAIN        (GDK_SHIFT_MASK)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6583"
></A
><H3
><A
NAME="GNOME-KEY-NAME-REPLACE-CAPS"
></A
>GNOME_KEY_NAME_REPLACE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_REPLACE          GDK_F7</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6588"
></A
><H3
><A
NAME="GNOME-KEY-MOD-REPLACE-CAPS"
></A
>GNOME_KEY_MOD_REPLACE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_REPLACE           (0)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6593"
></A
><H3
><A
NAME="GNOME-KEY-NAME-PAUSE-GAME-CAPS"
></A
>GNOME_KEY_NAME_PAUSE_GAME</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_PAUSE_GAME       0</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6598"
></A
><H3
><A
NAME="GNOME-KEY-MOD-PAUSE-GAME-CAPS"
></A
>GNOME_KEY_MOD_PAUSE_GAME</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_PAUSE_GAME        (0)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6603"
></A
><H3
><A
NAME="GNOME-KEY-NAME-NEW-GAME-CAPS"
></A
>GNOME_KEY_NAME_NEW_GAME</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_NEW_GAME         'N'</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6608"
></A
><H3
><A
NAME="GNOME-KEY-MOD-NEW-GAME-CAPS"
></A
>GNOME_KEY_MOD_NEW_GAME</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_NEW_GAME          (GDK_CONTROL_MASK)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6613"
></A
><H3
><A
NAME="GNOME-KEY-NAME-PRINT-CAPS"
></A
>GNOME_KEY_NAME_PRINT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_PRINT            0</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6618"
></A
><H3
><A
NAME="GNOME-KEY-MOD-PRINT-CAPS"
></A
>GNOME_KEY_MOD_PRINT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_PRINT             (0)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6623"
></A
><H3
><A
NAME="GNOME-KEY-NAME-PRINT-SETUP-CAPS"
></A
>GNOME_KEY_NAME_PRINT_SETUP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_NAME_PRINT_SETUP      0</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6628"
></A
><H3
><A
NAME="GNOME-KEY-MOD-PRINT-SETUP-CAPS"
></A
>GNOME_KEY_MOD_PRINT_SETUP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GNOME_KEY_MOD_PRINT_SETUP       (0)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-types.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-window-icon.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
>gnome-types</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-window-icon</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-window-icon</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-uidefs"
HREF="gnomeui-gnome-uidefs.html"><LINK
REL="NEXT"
TITLE="gnome-winhints"
HREF="gnomeui-gnome-winhints.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-uidefs.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-winhints.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-WINDOW-ICON"
>gnome-window-icon</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6638"
></A
><H2
>Name</H2
>gnome-window-icon&nbsp;--&nbsp;Convenience functions for window mini-icons</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6641"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


void        <A
HREF="gnomeui-gnome-window-icon.html#GNOME-WINDOW-ICON-SET-FROM-DEFAULT"
>gnome_window_icon_set_from_default</A
>
                                            (<A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *w);
void        <A
HREF="gnomeui-gnome-window-icon.html#GNOME-WINDOW-ICON-SET-FROM-FILE"
>gnome_window_icon_set_from_file</A
> (<A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *w,
                                             const char *filename);
void        <A
HREF="gnomeui-gnome-window-icon.html#GNOME-WINDOW-ICON-SET-FROM-IMLIB"
>gnome_window_icon_set_from_imlib</A
>
                                            (<A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *w,
                                             GdkImlibImage *im);
void        <A
HREF="gnomeui-gnome-window-icon.html#GNOME-WINDOW-ICON-SET-DEFAULT-FROM-FILE"
>gnome_window_icon_set_default_from_file</A
>
                                            (const char *filename);
void        <A
HREF="gnomeui-gnome-window-icon.html#GNOME-WINDOW-ICON-SET-DEFAULT-FROM-IMLIB"
>gnome_window_icon_set_default_from_imlib</A
>
                                            (GdkImlibImage *im);
void        <A
HREF="gnomeui-gnome-window-icon.html#GNOME-WINDOW-ICON-INIT"
>gnome_window_icon_init</A
>          (void);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6655"
></A
><H2
>Description</H2
><P
>  These functions are a convenience wrapper for the <A
HREF=../gdk/gdk-windows.html#GDK-WINDOW-SET-ICON
>gdk_window_set_icon</A>()
  function.  They allow setting a default icon, which is used by many
  top level windows in libgnomeui, such as GnomeApp and GnomeDialog
  windows.</P
><P
>  They also handle drawing the icon on the iconified window's icon in
  window managers such as TWM and Window Maker.</P
><P
>  These functions were added with the 1.2.0 release of the GNOME libraries
  in May, 2000.  This means that not all users will have this functionality
  in the GNOME libraries, and should only be used accordingly.  The header file
  must be explicitely included, also (include &lt;libgnomeui/gnome-window-icon.h&#62;).</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6661"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN6663"
></A
><H3
><A
NAME="GNOME-WINDOW-ICON-SET-FROM-DEFAULT"
></A
>gnome_window_icon_set_from_default ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_window_icon_set_from_default
                                            (<A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *w);</PRE
></TD
></TR
></TABLE
><P
>Makes the <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> <TT
CLASS="PARAMETER"
><I
>w</I
></TT
> use the default icon.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6672"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>w</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> to set the icon on</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6682"
></A
><H3
><A
NAME="GNOME-WINDOW-ICON-SET-FROM-FILE"
></A
>gnome_window_icon_set_from_file ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_window_icon_set_from_file (<A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *w,
                                             const char *filename);</PRE
></TD
></TR
></TABLE
><P
>Makes the <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> <TT
CLASS="PARAMETER"
><I
>w</I
></TT
> use the icon in <TT
CLASS="PARAMETER"
><I
>filename</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6692"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>w</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> to set the icon on</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>filename</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the name of the file to load</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6706"
></A
><H3
><A
NAME="GNOME-WINDOW-ICON-SET-FROM-IMLIB"
></A
>gnome_window_icon_set_from_imlib ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_window_icon_set_from_imlib
                                            (<A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> *w,
                                             GdkImlibImage *im);</PRE
></TD
></TR
></TABLE
><P
>Makes the <A
HREF=../gtk/gtkwindow.html
>GtkWindow</A> <TT
CLASS="PARAMETER"
><I
>w</I
></TT
> use the icon in <TT
CLASS="PARAMETER"
><I
>im</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6717"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>w</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> to set the icon on</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>im</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the imlib image to use for the icon</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6731"
></A
><H3
><A
NAME="GNOME-WINDOW-ICON-SET-DEFAULT-FROM-FILE"
></A
>gnome_window_icon_set_default_from_file ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_window_icon_set_default_from_file
                                            (const char *filename);</PRE
></TD
></TR
></TABLE
><P
>Set the default icon to the image in <TT
CLASS="PARAMETER"
><I
>filename</I
></TT
>, if one 
of the gnome_window_icon_set_default_from* functions have not already
been called.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6738"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>filename</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> filename for the default window icon</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6747"
></A
><H3
><A
NAME="GNOME-WINDOW-ICON-SET-DEFAULT-FROM-IMLIB"
></A
>gnome_window_icon_set_default_from_imlib ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_window_icon_set_default_from_imlib
                                            (GdkImlibImage *im);</PRE
></TD
></TR
></TABLE
><P
>Set the default icon to the image in <TT
CLASS="PARAMETER"
><I
>im</I
></TT
>, if one of
the gnome_window_icon_set_default_from* functions have not already
been called.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6755"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>im</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> imlib image for the default icon </TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6764"
></A
><H3
><A
NAME="GNOME-WINDOW-ICON-INIT"
></A
>gnome_window_icon_init ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_window_icon_init          (void);</PRE
></TD
></TR
></TABLE
><P
>Initialize the gnome window icon by checking the
GNOME_DESKTOP_ICON environment variable.  This function is 
automatically called by the gnome_init process.</P
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6770"
></A
><H2
>See Also</H2
><P
>  <A
HREF=../gdk/gdk-windows.html#GDK-WINDOW-SET-ICON
>gdk_window_set_icon</A>()</P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-uidefs.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-winhints.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
>gnome-uidefs</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-winhints</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gnome-winhints</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-window-icon"
HREF="gnomeui-gnome-window-icon.html"><LINK
REL="NEXT"
TITLE="gtkcauldron"
HREF="gnomeui-gtkcauldron.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-window-icon.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gtkcauldron.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-WINHINTS"
>gnome-winhints</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN6779"
></A
><H2
>Name</H2
>gnome-winhints&nbsp;--&nbsp;Manipulate GNOME-specific window manager hints.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN6782"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


#define     <A
HREF="gnomeui-gnome-winhints.html#XA-WIN-PROTOCOLS-CAPS"
>XA_WIN_PROTOCOLS</A
>
#define     <A
HREF="gnomeui-gnome-winhints.html#XA-WIN-ICONS-CAPS"
>XA_WIN_ICONS</A
>
#define     <A
HREF="gnomeui-gnome-winhints.html#XA-WIN-WORKSPACE-CAPS"
>XA_WIN_WORKSPACE</A
>
#define     <A
HREF="gnomeui-gnome-winhints.html#XA-WIN-WORKSPACE-COUNT-CAPS"
>XA_WIN_WORKSPACE_COUNT</A
>
#define     <A
HREF="gnomeui-gnome-winhints.html#XA-WIN-WORKSPACE-NAMES-CAPS"
>XA_WIN_WORKSPACE_NAMES</A
>
#define     <A
HREF="gnomeui-gnome-winhints.html#XA-WIN-LAYER-CAPS"
>XA_WIN_LAYER</A
>
#define     <A
HREF="gnomeui-gnome-winhints.html#XA-WIN-STATE-CAPS"
>XA_WIN_STATE</A
>
#define     <A
HREF="gnomeui-gnome-winhints.html#XA-WIN-HINTS-CAPS"
>XA_WIN_HINTS</A
>
#define     <A
HREF="gnomeui-gnome-winhints.html#XA-WIN-WORKAREA-CAPS"
>XA_WIN_WORKAREA</A
>
#define     <A
HREF="gnomeui-gnome-winhints.html#XA-WIN-CLIENT-LIST-CAPS"
>XA_WIN_CLIENT_LIST</A
>
#define     <A
HREF="gnomeui-gnome-winhints.html#XA-WIN-APP-STATE-CAPS"
>XA_WIN_APP_STATE</A
>
#define     <A
HREF="gnomeui-gnome-winhints.html#XA-WIN-EXPANDED-SIZE-CAPS"
>XA_WIN_EXPANDED_SIZE</A
>
#define     <A
HREF="gnomeui-gnome-winhints.html#XA-WIN-CLIENT-MOVING-CAPS"
>XA_WIN_CLIENT_MOVING</A
>
#define     <A
HREF="gnomeui-gnome-winhints.html#XA-WIN-SUPPORTING-WM-CHECK-CAPS"
>XA_WIN_SUPPORTING_WM_CHECK</A
>
enum        <A
HREF="gnomeui-gnome-winhints.html#GNOMEWINLAYER"
>GnomeWinLayer</A
>;
enum        <A
HREF="gnomeui-gnome-winhints.html#GNOMEWINSTATE"
>GnomeWinState</A
>;
enum        <A
HREF="gnomeui-gnome-winhints.html#GNOMEWINHINTS"
>GnomeWinHints</A
>;
enum        <A
HREF="gnomeui-gnome-winhints.html#GNOMEWINAPPSTATE"
>GnomeWinAppState</A
>;
void        <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-INIT"
>gnome_win_hints_init</A
>            (void);
void        <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-SET-LAYER"
>gnome_win_hints_set_layer</A
>       (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF="gnomeui-gnome-winhints.html#GNOMEWINLAYER"
>GnomeWinLayer</A
> layer);
<A
HREF="gnomeui-gnome-winhints.html#GNOMEWINLAYER"
>GnomeWinLayer</A
> <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-GET-LAYER"
>gnome_win_hints_get_layer</A
>     (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window);
void        <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-SET-STATE"
>gnome_win_hints_set_state</A
>       (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF="gnomeui-gnome-winhints.html#GNOMEWINSTATE"
>GnomeWinState</A
> state);
<A
HREF="gnomeui-gnome-winhints.html#GNOMEWINSTATE"
>GnomeWinState</A
> <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-GET-STATE"
>gnome_win_hints_get_state</A
>     (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window);
void        <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-SET-HINTS"
>gnome_win_hints_set_hints</A
>       (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF="gnomeui-gnome-winhints.html#GNOMEWINHINTS"
>GnomeWinHints</A
> skip);
<A
HREF="gnomeui-gnome-winhints.html#GNOMEWINHINTS"
>GnomeWinHints</A
> <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-GET-HINTS"
>gnome_win_hints_get_hints</A
>     (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window);
void        <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-SET-WORKSPACE"
>gnome_win_hints_set_workspace</A
>   (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> workspace);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-GET-WORKSPACE"
>gnome_win_hints_get_workspace</A
>   (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window);
void        <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-SET-CURRENT-WORKSPACE"
>gnome_win_hints_set_current_workspace</A
>
                                            (<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> workspace);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-GET-CURRENT-WORKSPACE"
>gnome_win_hints_get_current_workspace</A
>
                                            (void);
<A
HREF=../glib/glib-doubly-linked-lists.html#GLIST
>GList</A>*      <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-GET-WORKSPACE-NAMES"
>gnome_win_hints_get_workspace_names</A
>
                                            (void);
<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-GET-WORKSPACE-COUNT"
>gnome_win_hints_get_workspace_count</A
>
                                            (void);
void        <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-SET-EXPANDED-SIZE"
>gnome_win_hints_set_expanded_size</A
>
                                            (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> width,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> height);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-GET-EXPANDED-SIZE"
>gnome_win_hints_get_expanded_size</A
>
                                            (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *y,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *width,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *height);
void        <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-SET-MOVING"
>gnome_win_hints_set_moving</A
>      (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> moving);
void        <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-SET-APP-STATE"
>gnome_win_hints_set_app_state</A
>   (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF="gnomeui-gnome-winhints.html#GNOMEWINAPPSTATE"
>GnomeWinAppState</A
> state);
<A
HREF="gnomeui-gnome-winhints.html#GNOMEWINAPPSTATE"
>GnomeWinAppState</A
> <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-GET-APP-STATE"
>gnome_win_hints_get_app_state</A
>
                                            (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window);
<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-WM-EXISTS"
>gnome_win_hints_wm_exists</A
>       (void);
<A
HREF=../glib/glib-doubly-linked-lists.html#GLIST
>GList</A>*      <A
HREF="gnomeui-gnome-winhints.html#GNOME-WIN-HINTS-GET-CLIENT-WINDOW-IDS"
>gnome_win_hints_get_client_window_ids</A
>
                                            (void);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6862"
></A
><H2
>Description</H2
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN6865"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN6867"
></A
><H3
><A
NAME="XA-WIN-PROTOCOLS-CAPS"
></A
>XA_WIN_PROTOCOLS</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define XA_WIN_PROTOCOLS           "_WIN_PROTOCOLS"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6872"
></A
><H3
><A
NAME="XA-WIN-ICONS-CAPS"
></A
>XA_WIN_ICONS</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define XA_WIN_ICONS               "_WIN_ICONS"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6877"
></A
><H3
><A
NAME="XA-WIN-WORKSPACE-CAPS"
></A
>XA_WIN_WORKSPACE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define XA_WIN_WORKSPACE           "_WIN_WORKSPACE"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6882"
></A
><H3
><A
NAME="XA-WIN-WORKSPACE-COUNT-CAPS"
></A
>XA_WIN_WORKSPACE_COUNT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define XA_WIN_WORKSPACE_COUNT     "_WIN_WORKSPACE_COUNT"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6887"
></A
><H3
><A
NAME="XA-WIN-WORKSPACE-NAMES-CAPS"
></A
>XA_WIN_WORKSPACE_NAMES</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define XA_WIN_WORKSPACE_NAMES     "_WIN_WORKSPACE_NAMES"    </PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6892"
></A
><H3
><A
NAME="XA-WIN-LAYER-CAPS"
></A
>XA_WIN_LAYER</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define XA_WIN_LAYER               "_WIN_LAYER"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6897"
></A
><H3
><A
NAME="XA-WIN-STATE-CAPS"
></A
>XA_WIN_STATE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define XA_WIN_STATE               "_WIN_STATE"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6902"
></A
><H3
><A
NAME="XA-WIN-HINTS-CAPS"
></A
>XA_WIN_HINTS</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define XA_WIN_HINTS               "_WIN_HINTS"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6907"
></A
><H3
><A
NAME="XA-WIN-WORKAREA-CAPS"
></A
>XA_WIN_WORKAREA</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define XA_WIN_WORKAREA            "_WIN_WORKAREA"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6912"
></A
><H3
><A
NAME="XA-WIN-CLIENT-LIST-CAPS"
></A
>XA_WIN_CLIENT_LIST</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define XA_WIN_CLIENT_LIST         "_WIN_CLIENT_LIST"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6917"
></A
><H3
><A
NAME="XA-WIN-APP-STATE-CAPS"
></A
>XA_WIN_APP_STATE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define XA_WIN_APP_STATE           "_WIN_APP_STATE"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6922"
></A
><H3
><A
NAME="XA-WIN-EXPANDED-SIZE-CAPS"
></A
>XA_WIN_EXPANDED_SIZE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define XA_WIN_EXPANDED_SIZE       "_WIN_EXPANDED_SIZE"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6927"
></A
><H3
><A
NAME="XA-WIN-CLIENT-MOVING-CAPS"
></A
>XA_WIN_CLIENT_MOVING</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define XA_WIN_CLIENT_MOVING       "_WIN_CLIENT_MOVING"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6932"
></A
><H3
><A
NAME="XA-WIN-SUPPORTING-WM-CHECK-CAPS"
></A
>XA_WIN_SUPPORTING_WM_CHECK</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define XA_WIN_SUPPORTING_WM_CHECK "_WIN_SUPPORTING_WM_CHECK"</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6937"
></A
><H3
><A
NAME="GNOMEWINLAYER"
></A
>enum GnomeWinLayer</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  WIN_LAYER_DESKTOP     = 0,
  WIN_LAYER_BELOW       = 2,
  WIN_LAYER_NORMAL      = 4,
  WIN_LAYER_ONTOP       = 6,
  WIN_LAYER_DOCK        = 8,
  WIN_LAYER_ABOVE_DOCK  = 10
} GnomeWinLayer;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6942"
></A
><H3
><A
NAME="GNOMEWINSTATE"
></A
>enum GnomeWinState</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  WIN_STATE_STICKY          = (1&lt;&lt;0), /* everyone knows sticky */
  WIN_STATE_MINIMIZED       = (1&lt;&lt;1), /* ??? */
  WIN_STATE_MAXIMIZED_VERT  = (1&lt;&lt;2), /* window in maximized V state */
  WIN_STATE_MAXIMIZED_HORIZ = (1&lt;&lt;3), /* window in maximized H state */
  WIN_STATE_HIDDEN          = (1&lt;&lt;4), /* not on taskbar but window visible */
  WIN_STATE_SHADED          = (1&lt;&lt;5), /* shaded (NeXT style) */
  WIN_STATE_HID_WORKSPACE   = (1&lt;&lt;6), /* not on current desktop */
  WIN_STATE_HID_TRANSIENT   = (1&lt;&lt;7), /* owner of transient is hidden */
  WIN_STATE_FIXED_POSITION  = (1&lt;&lt;8), /* window is fixed in position even */
  WIN_STATE_ARRANGE_IGNORE  = (1&lt;&lt;9)  /* ignore for auto arranging */
} GnomeWinState;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6947"
></A
><H3
><A
NAME="GNOMEWINHINTS"
></A
>enum GnomeWinHints</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  WIN_HINTS_SKIP_FOCUS      = (1&lt;&lt;0), /* "alt-tab" skips this win */
  WIN_HINTS_SKIP_WINLIST    = (1&lt;&lt;1), /* not in win list */
  WIN_HINTS_SKIP_TASKBAR    = (1&lt;&lt;2), /* not on taskbar */
  WIN_HINTS_GROUP_TRANSIENT = (1&lt;&lt;3), /* ??????? */
  WIN_HINTS_FOCUS_ON_CLICK  = (1&lt;&lt;4), /* app only accepts focus when clicked */
  WIN_HINTS_DO_NOT_COVER    = (1&lt;&lt;5)  /* attempt to not cover this window */
} GnomeWinHints;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6952"
></A
><H3
><A
NAME="GNOMEWINAPPSTATE"
></A
>enum GnomeWinAppState</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  WIN_APP_STATE_NONE,
  WIN_APP_STATE_ACTIVE1,
  WIN_APP_STATE_ACTIVE2,
  WIN_APP_STATE_ERROR1,
  WIN_APP_STATE_ERROR2,
  WIN_APP_STATE_FATAL_ERROR1,
  WIN_APP_STATE_FATAL_ERROR2,
  WIN_APP_STATE_IDLE1,
  WIN_APP_STATE_IDLE2,
  WIN_APP_STATE_WAITING1,
  WIN_APP_STATE_WAITING2,
  WIN_APP_STATE_WORKING1,
  WIN_APP_STATE_WORKING2,
  WIN_APP_STATE_NEED_USER_INPUT1,
  WIN_APP_STATE_NEED_USER_INPUT2,
  WIN_APP_STATE_STRUGGLING1,
  WIN_APP_STATE_STRUGGLING2,
  WIN_APP_STATE_DISK_TRAFFIC1,
  WIN_APP_STATE_DISK_TRAFFIC2,
  WIN_APP_STATE_NETWORK_TRAFFIC1,
  WIN_APP_STATE_NETWORK_TRAFFIC2,
  WIN_APP_STATE_OVERLOADED1,
  WIN_APP_STATE_OVERLOADED2,
  WIN_APP_STATE_PERCENT000_1,
  WIN_APP_STATE_PERCENT000_2,
  WIN_APP_STATE_PERCENT010_1,
  WIN_APP_STATE_PERCENT010_2,
  WIN_APP_STATE_PERCENT020_1,
  WIN_APP_STATE_PERCENT020_2,
  WIN_APP_STATE_PERCENT030_1,
  WIN_APP_STATE_PERCENT030_2,
  WIN_APP_STATE_PERCENT040_1,
  WIN_APP_STATE_PERCENT040_2,
  WIN_APP_STATE_PERCENT050_1,
  WIN_APP_STATE_PERCENT050_2,
  WIN_APP_STATE_PERCENT060_1,
  WIN_APP_STATE_PERCENT060_2,
  WIN_APP_STATE_PERCENT070_1,
  WIN_APP_STATE_PERCENT070_2,
  WIN_APP_STATE_PERCENT080_1,
  WIN_APP_STATE_PERCENT080_2,
  WIN_APP_STATE_PERCENT090_1,
  WIN_APP_STATE_PERCENT090_2,
  WIN_APP_STATE_PERCENT100_1,
  WIN_APP_STATE_PERCENT100_2
} GnomeWinAppState;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6957"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-INIT"
></A
>gnome_win_hints_init ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_win_hints_init            (void);</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6962"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-SET-LAYER"
></A
>gnome_win_hints_set_layer ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_win_hints_set_layer       (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF="gnomeui-gnome-winhints.html#GNOMEWINLAYER"
>GnomeWinLayer</A
> layer);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6969"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>layer</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN6982"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-GET-LAYER"
></A
>gnome_win_hints_get_layer ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeui-gnome-winhints.html#GNOMEWINLAYER"
>GnomeWinLayer</A
> gnome_win_hints_get_layer     (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN6989"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7002"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-SET-STATE"
></A
>gnome_win_hints_set_state ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_win_hints_set_state       (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF="gnomeui-gnome-winhints.html#GNOMEWINSTATE"
>GnomeWinState</A
> state);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7009"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>state</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7022"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-GET-STATE"
></A
>gnome_win_hints_get_state ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeui-gnome-winhints.html#GNOMEWINSTATE"
>GnomeWinState</A
> gnome_win_hints_get_state     (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7029"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7042"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-SET-HINTS"
></A
>gnome_win_hints_set_hints ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_win_hints_set_hints       (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF="gnomeui-gnome-winhints.html#GNOMEWINHINTS"
>GnomeWinHints</A
> skip);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7049"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>skip</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7062"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-GET-HINTS"
></A
>gnome_win_hints_get_hints ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeui-gnome-winhints.html#GNOMEWINHINTS"
>GnomeWinHints</A
> gnome_win_hints_get_hints     (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7069"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7082"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-SET-WORKSPACE"
></A
>gnome_win_hints_set_workspace ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_win_hints_set_workspace   (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> workspace);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7089"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>workspace</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7102"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-GET-WORKSPACE"
></A
>gnome_win_hints_get_workspace ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_win_hints_get_workspace   (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7109"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7122"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-SET-CURRENT-WORKSPACE"
></A
>gnome_win_hints_set_current_workspace ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_win_hints_set_current_workspace
                                            (<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> workspace);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7128"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>workspace</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7137"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-GET-CURRENT-WORKSPACE"
></A
>gnome_win_hints_get_current_workspace ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_win_hints_get_current_workspace
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7143"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7152"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-GET-WORKSPACE-NAMES"
></A
>gnome_win_hints_get_workspace_names ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-doubly-linked-lists.html#GLIST
>GList</A>*      gnome_win_hints_get_workspace_names
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7158"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7167"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-GET-WORKSPACE-COUNT"
></A
>gnome_win_hints_get_workspace_count ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gnome_win_hints_get_workspace_count
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7173"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7182"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-SET-EXPANDED-SIZE"
></A
>gnome_win_hints_set_expanded_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_win_hints_set_expanded_size
                                            (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> y,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> width,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> height);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7192"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7217"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-GET-EXPANDED-SIZE"
></A
>gnome_win_hints_get_expanded_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_win_hints_get_expanded_size
                                            (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *x,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *y,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *width,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *height);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7228"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7257"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-SET-MOVING"
></A
>gnome_win_hints_set_moving ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_win_hints_set_moving      (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> moving);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7264"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>moving</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7277"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-SET-APP-STATE"
></A
>gnome_win_hints_set_app_state ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_win_hints_set_app_state   (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window,
                                             <A
HREF="gnomeui-gnome-winhints.html#GNOMEWINAPPSTATE"
>GnomeWinAppState</A
> state);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7284"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>state</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7297"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-GET-APP-STATE"
></A
>gnome_win_hints_get_app_state ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeui-gnome-winhints.html#GNOMEWINAPPSTATE"
>GnomeWinAppState</A
> gnome_win_hints_get_app_state
                                            (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *window);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7304"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7317"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-WM-EXISTS"
></A
>gnome_win_hints_wm_exists ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A>    gnome_win_hints_wm_exists       (void);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7323"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7332"
></A
><H3
><A
NAME="GNOME-WIN-HINTS-GET-CLIENT-WINDOW-IDS"
></A
>gnome_win_hints_get_client_window_ids ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-doubly-linked-lists.html#GLIST
>GList</A>*      gnome_win_hints_get_client_window_ids
                                            (void);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7338"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-window-icon.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gtkcauldron.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
>gnome-window-icon</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gtkcauldron</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>gtkcauldron</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-winhints"
HREF="gnomeui-gnome-winhints.html"><LINK
REL="NEXT"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-winhints.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GTKCAULDRON"
>gtkcauldron</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7352"
></A
><H2
>Name</H2
>gtkcauldron&nbsp;--&nbsp;Produce gtk/gnome dialog boxes from format strings.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN7355"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-TOPLEVEL-CAPS"
>GTK_CAULDRON_TOPLEVEL</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-DIALOG-CAPS"
>GTK_CAULDRON_DIALOG</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-POPUP-CAPS"
>GTK_CAULDRON_POPUP</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE-SHIFT-CAPS"
>GTK_CAULDRON_SPACE_SHIFT</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE-MASK-CAPS"
>GTK_CAULDRON_SPACE_MASK</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE1-CAPS"
>GTK_CAULDRON_SPACE1</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE2-CAPS"
>GTK_CAULDRON_SPACE2</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE3-CAPS"
>GTK_CAULDRON_SPACE3</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE4-CAPS"
>GTK_CAULDRON_SPACE4</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE5-CAPS"
>GTK_CAULDRON_SPACE5</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE6-CAPS"
>GTK_CAULDRON_SPACE6</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE7-CAPS"
>GTK_CAULDRON_SPACE7</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE8-CAPS"
>GTK_CAULDRON_SPACE8</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE9-CAPS"
>GTK_CAULDRON_SPACE9</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE10-CAPS"
>GTK_CAULDRON_SPACE10</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE11-CAPS"
>GTK_CAULDRON_SPACE11</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE12-CAPS"
>GTK_CAULDRON_SPACE12</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE13-CAPS"
>GTK_CAULDRON_SPACE13</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE14-CAPS"
>GTK_CAULDRON_SPACE14</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-SPACE15-CAPS"
>GTK_CAULDRON_SPACE15</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-IGNOREESCAPE-CAPS"
>GTK_CAULDRON_IGNOREESCAPE</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-IGNOREENTER-CAPS"
>GTK_CAULDRON_IGNOREENTER</A
>
#define     <A
HREF="gnomeui-gtkcauldron.html#GTK-CAULDRON-GRAB-CAPS"
>GTK_CAULDRON_GRAB</A
>
void        (<A
HREF="gnomeui-gtkcauldron.html#GTKCAULDRONNEXTARGCALLBACK"
>*GtkCauldronNextArgCallback</A
>)   (<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> cauldron_type,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data,
                                             void *result);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  (<A
HREF="gnomeui-gtkcauldron.html#GTKCAULDRONCUSTOMCALLBACK"
>*GtkCauldronCustomCallback</A
>)    (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomeui-gtkcauldron.html#GTK-DIALOG-CAULDRON"
>gtk_dialog_cauldron</A
>             (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             <A
HREF=../glib/glib-basic-types.html#GLONG
>glong</A> options,
                                             ...);
<A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      <A
HREF="gnomeui-gtkcauldron.html#GTK-DIALOG-CAULDRON-PARSE"
>gtk_dialog_cauldron_parse</A
>       (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             <A
HREF=../glib/glib-basic-types.html#GLONG
>glong</A> options,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *format,
                                             <A
HREF="gnomeui-gtkcauldron.html#GTKCAULDRONNEXTARGCALLBACK"
>GtkCauldronNextArgCallback</A
> next_arg,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *parent);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7400"
></A
><H2
>Description</H2
><P
>The following simple example shows basic usage of <A
HREF="gnomeui-gtkcauldron.html#GTK-DIALOG-CAULDRON"
>gtk_dialog_cauldron</A
>()
for those writing dialogs for GUI applications:</P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN7404"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>    gtk_dialog_cauldron ("Search", 0,
        " ( (Enter search string:) | <TT
CLASS="LITERAL"
>Eod</TT
> ) / ( <TT
CLASS="LITERAL"
>Bqrxfp</TT
> || <TT
CLASS="LITERAL"
>Bqxfp</TT
> ) ", 
            &amp;search_string, "Ok", "Cancel");
  </PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><P
>The <SPAN
CLASS="TYPE"
>format</SPAN
> string consists of a list of frames or widgets which
are packed consecutively into the top-level window. Each frame is
specified with an opening and closing frame token (a bracket). Each
widget specifier consists of a % followed by one or more capital letters
indicating the widget type, followed by zero or more small letters
indicating various packing, behaviour and/or data options.</P
><P
>A list of frames or widgets are seperated by one of several
<SPAN
CLASS="TYPE"
>seperator-tokens</SPAN
>. Their meanings are:</P
><P
></P
><UL
><LI
><P
><I
CLASS="EMPHASIS"
>|</I
> Pack side by side.
   </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
>||</I
> Pack side by side with
     homogenous spacing - that is, the widget or frames to the left or
     right will always have the same size.  </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
>/</I
> Pack on top of each other.
   </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
>//</I
> Pack on top of each other
     with homogenous spacing. </P
></LI
></UL
><P
>If no seperator is specified, then a <I
CLASS="EMPHASIS"
>|</I
>
seperator is implied.  Frames can be nested infinitely within each
other. Only one type of seperator can be used within a single
frame. If more than one kind of seperator is used within a single
frame, then each seperator within that frame will revert to the type
of the first seperator within that frame.</P
><P
>In the above example, the <I
CLASS="EMPHASIS"
>E</I
> stands for
Entry-widget and the <I
CLASS="EMPHASIS"
>B</I
> stands for
Button-widget. Each of these widgets incurs one format conversion: in
the case of the entry widget, a <SPAN
CLASS="TYPE"
>char **</SPAN
> must be passed,
while in that case of the button widget, a <SPAN
CLASS="TYPE"
>char *</SPAN
> must be
passed. The entry widget will store its result into
<I
CLASS="EMPHASIS"
>search_string</I
> if the dialog is not cancelled and
hence <I
CLASS="EMPHASIS"
>search_string</I
> must be writable. The entry
widget also derives its default text from this variable.</P
><P
>The dialog consists of two frames placed above each other,
(defined by the two pairs of brackets). The buttons are of the same
size, while the label and entry widgets are spaced as they
require.</P
><DIV
CLASS="REFSECT2"
><A
NAME="AEN7436"
></A
><H3
>Reference</H3
><P
>The following is a complete list of
       the widgets. Each widget can take additional options which are
       described in options section below.</P
><P
></P
><UL
><LI
><P
><I
CLASS="EMPHASIS"
><TT
CLASS="LITERAL"
>L</TT
></I
> Label. Causes one
         va_arg conversion of type <SPAN
CLASS="TYPE"
>gchar *</SPAN
> dictating the
         label's text. This is identical to inline label given in the
         example above, however this allows for
         internationalisation.</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
><TT
CLASS="LITERAL"
>F</TT
>, <TT
CLASS="LITERAL"
>N</TT
>, <TT
CLASS="LITERAL"
>E</TT
>, <TT
CLASS="LITERAL"
>P</TT
></I
> Entry. This
         is one of a File, Number, plain text Entry or Password entry
         widget. Causes one va_arg conversion of type <SPAN
CLASS="TYPE"
>char
         **</SPAN
> which must contain the default text to be inserted
         into the entry widget, and must be writable to return the
         result. If the <I
CLASS="EMPHASIS"
>g</I
> option is present then
         entries are the gnome versions of those entries instead. In
         the case of <I
CLASS="EMPHASIS"
>F</I
> and
         <I
CLASS="EMPHASIS"
>N</I
>, two more <SPAN
CLASS="TYPE"
>gchar *</SPAN
> are
         converted - the history_id and the file browser or calculator
         window title respectively. In the case of <I
CLASS="EMPHASIS"
>E</I
>, only one
         more <SPAN
CLASS="TYPE"
>gchar *</SPAN
> is converted: the history_id.</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
><TT
CLASS="LITERAL"
>D</TT
></I
> Date edit widget. Causes
         two va_arg conversions of type <SPAN
CLASS="TYPE"
>gdouble *</SPAN
> and type
	 <SPAN
CLASS="TYPE"
>gint</SPAN
>. The first represents the time in seconds
	 since Jan 1 1970 and is used to initialise the widget as well
	 as to store the result - it is cast internally to
	 <SPAN
CLASS="TYPE"
>time_t</SPAN
>. The second is the options flag and is the
	 inclusive <I
CLASS="EMPHASIS"
>OR</I
> of one or more of
         <I
CLASS="EMPHASIS"
>GNOME_DATE_EDIT_SHOW_TIME</I
>, <I
CLASS="EMPHASIS"
>GNOME_DATE_EDIT_24_HR</I
>, and
         <I
CLASS="EMPHASIS"
>GNOME_DATE_EDIT_WEEK_STARTS_ON_MONDAY</I
>.
         </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
><TT
CLASS="LITERAL"
>B</TT
> </I
> Button with label. One
         va_arg conversion of type <SPAN
CLASS="TYPE"
>char *</SPAN
>, dictating the
         button label. If this is NULL, then gtk_button_new is called
         instead of gtk_button_new_with_label. If the
         <I
CLASS="EMPHASIS"
>g</I
> option is present then a Gnome stock
         button is drawn, in which case you can pass a Gnome stock
         pixmap macro instead of a string.</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
><TT
CLASS="LITERAL"
>C</TT
> </I
> Check box. Two va_arg
         conversions of type <SPAN
CLASS="TYPE"
>gchar *label</SPAN
> and <SPAN
CLASS="TYPE"
>gint
         *state</SPAN
>. If label is NULL the same applies as with
         <I
CLASS="EMPHASIS"
>B</I
>. result is stored in
         <I
CLASS="EMPHASIS"
>state</I
>. </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
><TT
CLASS="LITERAL"
>R</TT
> </I
> Radio button. Two
         va_arg conversions of type <SPAN
CLASS="TYPE"
>char *label</SPAN
> and
         <SPAN
CLASS="TYPE"
>gint *state</SPAN
>. Multiple radio buttons within the
         same frame are grouped together. If label is NULL then same
         applies as with <I
CLASS="EMPHASIS"
>B</I
>.</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
><TT
CLASS="LITERAL"
>S</TT
> </I
> Seperator. Vertical or
         horizontal automatically determined. </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
><TT
CLASS="LITERAL"
>SB</TT
> </I
> Spin button. Two
         va_arg conversions of type <SPAN
CLASS="TYPE"
>double climb_rate</SPAN
> and
         <SPAN
CLASS="TYPE"
>gint digits</SPAN
>. This is not particularly useful on its own
         and must be used with option \fIj\fP which causes conversion
         of an <I
CLASS="EMPHASIS"
>adjustment</I
> parameter set. </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
><TT
CLASS="LITERAL"
>T</TT
> </I
> Text. One va_arg
         conversion of the type <SPAN
CLASS="TYPE"
>gchar **text</SPAN
>. Must be writable
         if option <I
CLASS="EMPHASIS"
>e</I
> is used to indicate that the text is
         editable.</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
><TT
CLASS="LITERAL"
>X</TT
> </I
> User defined
         widget. This specifier causes two va_arg conversions: a
         function of type <I
CLASS="EMPHASIS"
>GtkWidget *(*func) (GtkWidget * widget,
         gpointer user_data)</I
> and <SPAN
CLASS="TYPE"
>gpointer user_data</SPAN
> to be
         passed to the function. The function takes two arguments: the
         toplevel window widget (which is just to fill in a first
         argument and needn't have any use), and the user data. The
         function must return a widget which will then be packed into
         its enclosing frame.  </P
></LI
></UL
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7514"
></A
><H3
>Frames</H3
><P
>Different kinds of brackets specify different kinds of
       frames. These may also take an option, although the option must
       be specified after the closing bracket and not after the
       opening bracket.</P
><P
></P
><UL
><LI
><P
><I
CLASS="EMPHASIS"
>[</I
>A visible frame encloses
         the widget specified between the brackets. </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
>%[</I
>A frame with a
         title. Results in one va_arg conversion of type <SPAN
CLASS="TYPE"
>char
         *title</SPAN
> </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
>(</I
>Invisible hbox or vbox, depending on the enclosed seperators.
       </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
>{</I
>Pane box (visible frame
         with adjustable seperator). Only two objects may be packed
         inside, further objects are ignored. It is best to pack only
         other containers into a pane.</P
><P
>The closing bracket may be followed by options. Eg</P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN7532"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="90%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>    [ <TT
CLASS="LITERAL"
>B</TT
> ]seo</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><P
>is a button inside an shadowed frame. The shadow is of type
         etched outer.</P
><P
>The closing <I
CLASS="EMPHASIS"
>) </I
> may be followed by
          the options <I
CLASS="EMPHASIS"
>v </I
> or <I
CLASS="EMPHASIS"
>h
          </I
>. This indicates that the box must be packed into
          a scrollable window. Hence <I
CLASS="EMPHASIS"
> ( <TT
CLASS="LITERAL"
>C</TT
> // <TT
CLASS="LITERAL"
>C</TT
> // <TT
CLASS="LITERAL"
>C</TT
> )v
          </I
> are checkboxes inside a scrollable window with a
          vertical scrollbar but an automatic horizontal bar
          (automatic means it appears only if necesary).</P
><P
>A very useful option is the \fIn\fP option. This
           creates a <I
CLASS="EMPHASIS"
>notebook page </I
> from the
           frame. Eg,</P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN7546"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="90%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>    ( <TT
CLASS="LITERAL"
>C</TT
> // <TT
CLASS="LITERAL"
>C</TT
> )n ( <TT
CLASS="LITERAL"
>L</TT
> / <TT
CLASS="LITERAL"
>E</TT
> )n ( <TT
CLASS="LITERAL"
>Te</TT
> )n</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><P
> This creates a three page notebook. The <I
CLASS="EMPHASIS"
>n
          </I
> causes one additional conversion of type
          <SPAN
CLASS="TYPE"
>char *</SPAN
>, which is the text to go onto the tag.
          If the <I
CLASS="EMPHASIS"
>v </I
> option is given in addition
          to the <I
CLASS="EMPHASIS"
>n </I
> option, then the notebook
          will have its tags placed to the left descending vertically,
          otherwise the tags are place in the conventional position
          above the notebook.</P
></LI
></UL
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7558"
></A
><H3
>Options</H3
><P
>Conversions caused by an option happen in the following
       order, regardless of the order in which the options are given:
       <I
CLASS="EMPHASIS"
>g</I
>, <I
CLASS="EMPHASIS"
>j</I
>,
       <I
CLASS="EMPHASIS"
>a</I
>, <I
CLASS="EMPHASIS"
>u</I
> then
       <I
CLASS="EMPHASIS"
>c</I
>.</P
><P
></P
><UL
><LI
><P
><I
CLASS="EMPHASIS"
> x </I
>expand, (see
       gtk_box_pack_start). </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> f </I
> fill, (see
       gtk_box_pack_start) </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> p </I
>padding, (see
         gtk_box_pack_start). This may be specified more than once for
         additional padding. Padding is in units of 3 pixels per
         <I
CLASS="EMPHASIS"
>p</I
> specified. This default can be
         changed, see global options below. </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> d </I
>default, causes default
         fill, expand, and padding of the widget into its parent
         box. This must not be used with <I
CLASS="EMPHASIS"
>x</I
>,
         <I
CLASS="EMPHASIS"
>f</I
>, or <I
CLASS="EMPHASIS"
>p</I
>. </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
>si</I
>,
         <I
CLASS="EMPHASIS"
>so</I
>, <I
CLASS="EMPHASIS"
>sei</I
>,
         <I
CLASS="EMPHASIS"
>seo</I
> Shadow, (see
         gtk_frame_set_shadow_type). This stands for one of
         <I
CLASS="EMPHASIS"
>i</I
>nner, <I
CLASS="EMPHASIS"
>o</I
>uter,
         <I
CLASS="EMPHASIS"
>e</I
>tched <I
CLASS="EMPHASIS"
>i</I
>nner and
         <I
CLASS="EMPHASIS"
>e</I
>tched <I
CLASS="EMPHASIS"
>o</I
>uter. The s
         option must follow the <I
CLASS="EMPHASIS"
>]</I
> and not the
         <I
CLASS="EMPHASIS"
>[</I
>. </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> c </I
> callback. Indicates
         that we want a callback function to be run after the widget
         is created and packed. It causes two va_arg conversions: a
         function of type <I
CLASS="EMPHASIS"
>*(*func) (GtkWidget * widget,
         gpointer user_data)</I
> and <I
CLASS="EMPHASIS"
>gpointer
         user_data</I
> to be passed to the function. The
         function takes two arguments: the widget itself, and
         <I
CLASS="EMPHASIS"
>user_data</I
>. This option may be used if
         their are additional things we want to do to the widget that
         are out of the scope of the options.</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> r </I
>results. For a button
          widget, causes clicking on the button to assign the current
          state of each widgets to any user pointers given. This may
          be given as an option to an `Apply' button, and will
          necesarily be given as an option to an `Ok' button. </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> q </I
> quit. For a button
       widget, causes the button to exit the dialog.</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> j </I
> adjustment. For the
         Spin Button widget, passes and adjustment object to the Spin
         Button. This causes 6 convertions: a <I
CLASS="EMPHASIS"
>double
         *</I
> where the initial value is obtained and where
         the result is stored, and five more
         <I
CLASS="EMPHASIS"
>double</I
> conversions containing: the lower
         bound, upper bound, step increment, page increment, and page
         size. (Note that page size must be more than the page
         increment).</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> e </I
> editable. For the text
         widget, set it to be editable. In this case, the result is
         assigned to the passed arg. By default the text widget only
         shows the text and does not allow modification.</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> e </I
> inactive. Use 
         <I
CLASS="EMPHASIS"
>gtk_widget_set_sensitive</I
> to disabled
	 (gray-out) the widget.</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> v </I
> vertical
         scrollbar. For the text widget and for the
         <I
CLASS="EMPHASIS"
>[</I
> <I
CLASS="EMPHASIS"
>]</I
> frame, this
         adds a vertical scrollbar.</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> h </I
> horizontal
         scrollbar. For the text widget and for the
         <I
CLASS="EMPHASIS"
>[</I
> <I
CLASS="EMPHASIS"
>]</I
> frame, this
         adds a horizontal scrollbar.</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> a </I
> accelerator. Causes
          <SPAN
CLASS="TYPE"
>gchar *signal</SPAN
>, <SPAN
CLASS="TYPE"
>gint
          key</SPAN
>, <SPAN
CLASS="TYPE"
>gint modifier</SPAN
> to be
          converted. This will add an accelerator in the obvious
          way. Note that for most widgets, an accelerator need not be
          added, because the appropriate accelerator is added
          automatically with the use of an ampersand,
          <I
CLASS="EMPHASIS"
>&#38;</I
>, before the accelerator hotkey in the
          label. (See accelerator ampersands below.)</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> u </I
> accelerator. This
         accelerator is used for dialogs that are to be
         internationalised and is similar to
         <I
CLASS="EMPHASIS"
>a</I
>. Causes <I
CLASS="EMPHASIS"
>gchar
         *signal</I
>, <I
CLASS="EMPHASIS"
>gchar *key</I
>,
         <I
CLASS="EMPHASIS"
>gint modifier</I
> to be converted. To the
         <I
CLASS="EMPHASIS"
>key</I
> argument is passed the same label
         that is used to label the widget. The widget will contain an
         underbar under the character following the &#38; symbol. For
         example "clicked", "&amp;Cancel", GDK_MOD1_MASK. Binds the widget
         to Alt-C and completely ignores the remaining characters. You
         can then use the same label for the actual contents of the
         cancel button to cause an underbar to be written under the
         `C'. Note that for most widgets, an accelerator need not be
         added, because the appropriate accelerator is added
         automatically with the use of an ampersand,
         <I
CLASS="EMPHASIS"
>&#38;</I
>, before the accelerator hotkey in the
         label. (See accelerator ampersands below.)</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> o </I
> focus. Sets the input
         focus to this widget. Only one widget must have this
         option. (Most dialogs have a default widget accepting
         keyboard input to avoid having to manually set focus with the
         mouse.)</P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> g </I
> gnome. Use the Gnome
         version of the widget. May cause additional conversions, see
         <I
CLASS="EMPHASIS"
><TT
CLASS="LITERAL"
>E</TT
></I
> above. </P
></LI
><LI
><P
><I
CLASS="EMPHASIS"
> n </I
> notebook. Cause a
         <I
CLASS="EMPHASIS"
>[</I
> <I
CLASS="EMPHASIS"
>]</I
> to be become a
         notebook page. See frames above.</P
></LI
></UL
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7660"
></A
><H3
>Accelerator ampersands</H3
><P
>Any widget's text having an <I
CLASS="EMPHASIS"
>&#38;</I
> sign in
    it will have an underbar placed below the letter after the
    <I
CLASS="EMPHASIS"
>&#38;</I
> sign. The <I
CLASS="EMPHASIS"
>&#38;</I
> will not
    be shown. To draw an actual &#38; sign, use a double ampersand:
    <I
CLASS="EMPHASIS"
>&#38;&#38;</I
></P
><P
>Buttons, check-boxes, and radio-buttonsP will also have an
     accelerator automatically added to them along with the
     underbar. It will be bound to the key Alt-X where X is the letter
     following the ampersand.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7668"
></A
><H3
>Examples</H3
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN7670"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>    gtk_dialog_cauldron ("Search", 0,
    " ( <TT
CLASS="LITERAL"
>Ld</TT
> | <TT
CLASS="LITERAL"
>Eod</TT
> ) / %[ ( <TT
CLASS="LITERAL"
>Cd</TT
> // <TT
CLASS="LITERAL"
>Cd</TT
> // <TT
CLASS="LITERAL"
>Cd</TT
> ) ]seo / ( <TT
CLASS="LITERAL"
>Bqrxfp</TT
> || <TT
CLASS="LITERAL"
>Bqxfp</TT
> ) ", 
/* <TT
CLASS="LITERAL"
>L</TT
> */		"Enter search string:",
/* <TT
CLASS="LITERAL"
>E</TT
> */		&amp;search_string,
/* %[ */		"Search options",
/* <TT
CLASS="LITERAL"
>C</TT
> */		"Case sensitive", &amp;case_sensitive,
/* <TT
CLASS="LITERAL"
>C</TT
> */		"Whole words only", &amp;whole_word,
/* <TT
CLASS="LITERAL"
>C</TT
> */		"Regular expression", &amp;regular_expression,
/* <TT
CLASS="LITERAL"
>B</TT
> */		"Ok",
/* <TT
CLASS="LITERAL"
>B</TT
> */		"Cancel");</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><P
>Interwidget spacing can be increased by inserting more space
characters between format specifiers, however only the first gab is
looked at. Eg, spreading out the check boxes can be done with:</P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN7687"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>&#13;    " ( <TT
CLASS="LITERAL"
>Ld</TT
> | <TT
CLASS="LITERAL"
>Ed</TT
> ) / %[ ( <TT
CLASS="LITERAL"
>Cd</TT
>           // <TT
CLASS="LITERAL"
>Cd</TT
> // <TT
CLASS="LITERAL"
>Cd</TT
> ) ]seo / 
( <TT
CLASS="LITERAL"
>Bqrefp</TT
> || <TT
CLASS="LITERAL"
>Bqefp</TT
> ) ", </PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><P
>The space between the widget and its parent box can be adjusted
by adding space after the bracket, eg:</P
><DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN7697"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>    " (          <TT
CLASS="LITERAL"
>Ld</TT
> | <TT
CLASS="LITERAL"
>Ed</TT
> ) / %[ ( <TT
CLASS="LITERAL"
>Cd</TT
> // <TT
CLASS="LITERAL"
>Cd</TT
> // <TT
CLASS="LITERAL"
>Cd</TT
> ) ]seo /
( <TT
CLASS="LITERAL"
>Bqrefp</TT
> || <TT
CLASS="LITERAL"
>Bqefp</TT
> ) ", </PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><P
>Each space character counts 3 pixels by default. This default can
be changed, see global options.</P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN7707"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN7709"
></A
><H3
><A
NAME="GTK-CAULDRON-TOPLEVEL-CAPS"
></A
>GTK_CAULDRON_TOPLEVEL</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_TOPLEVEL	(0x1L&lt;&lt;0)</PRE
></TD
></TR
></TABLE
><P
>This is translated to the top level window (<TT
CLASS="LITERAL"
>GTK_WINDOW_TOPLEVEL</TT
>)</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7715"
></A
><H3
><A
NAME="GTK-CAULDRON-DIALOG-CAPS"
></A
>GTK_CAULDRON_DIALOG</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_DIALOG		(0x1L&lt;&lt;1)</PRE
></TD
></TR
></TABLE
><P
>This is translated to the top level window (<TT
CLASS="LITERAL"
>GTK_WINDOW_TOPLEVEL</TT
>)</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7721"
></A
><H3
><A
NAME="GTK-CAULDRON-POPUP-CAPS"
></A
>GTK_CAULDRON_POPUP</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_POPUP		(0x1L&lt;&lt;2)</PRE
></TD
></TR
></TABLE
><P
>This is translated to the top level window (<TT
CLASS="LITERAL"
>GTK_WINDOW_TOPLEVEL</TT
>)</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7727"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE-SHIFT-CAPS"
></A
>GTK_CAULDRON_SPACE_SHIFT</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE_SHIFT	(3)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7732"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE-MASK-CAPS"
></A
>GTK_CAULDRON_SPACE_MASK</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE_MASK	(0xFL&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7737"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE1-CAPS"
></A
>GTK_CAULDRON_SPACE1</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE1		(0x1L&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>Specify a width of 1 pixels of each space or p
characters. </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7742"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE2-CAPS"
></A
>GTK_CAULDRON_SPACE2</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE2		(0x2L&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>Specify a width of 2 pixels of each space or p
characters. </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7747"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE3-CAPS"
></A
>GTK_CAULDRON_SPACE3</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE3		(0x3L&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>Specify a width of 3 pixels of each space or p
characters. </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7752"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE4-CAPS"
></A
>GTK_CAULDRON_SPACE4</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE4		(0x4L&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>Specify a width of 4 pixels of each space or p
characters. &#13;</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7757"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE5-CAPS"
></A
>GTK_CAULDRON_SPACE5</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE5		(0x5L&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>&#13;Specify a width of 5 pixels of each space or p
characters. </P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7762"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE6-CAPS"
></A
>GTK_CAULDRON_SPACE6</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE6		(0x6L&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>Specify a width of 6 pixels of each space or p
characters. &#13;</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7767"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE7-CAPS"
></A
>GTK_CAULDRON_SPACE7</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE7		(0x7L&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>Specify a width of 7 pixels of each space or p
characters. &#13;</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7772"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE8-CAPS"
></A
>GTK_CAULDRON_SPACE8</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE8		(0x8L&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>Specify a width of 8 pixels of each space or p
characters. &#13;</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7777"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE9-CAPS"
></A
>GTK_CAULDRON_SPACE9</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE9		(0x9L&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>Specify a width of 9 pixels of each space or p
characters. &#13;</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7782"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE10-CAPS"
></A
>GTK_CAULDRON_SPACE10</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE10		(0xAL&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>Specify a width of 10 pixels of each space or p
characters. &#13;</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7787"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE11-CAPS"
></A
>GTK_CAULDRON_SPACE11</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE11		(0xBL&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>Specify a width of 11 pixels of each space or p
characters. &#13;</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7792"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE12-CAPS"
></A
>GTK_CAULDRON_SPACE12</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE12		(0xCL&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>Specify a width of 12 pixels of each space or p
characters. &#13;</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7797"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE13-CAPS"
></A
>GTK_CAULDRON_SPACE13</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE13		(0xDL&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>Specify a width of 13 pixels of each space or p
characters. &#13;</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7802"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE14-CAPS"
></A
>GTK_CAULDRON_SPACE14</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE14		(0xEL&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>Specify a width of 14 pixels of each space or p
characters. &#13;</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7807"
></A
><H3
><A
NAME="GTK-CAULDRON-SPACE15-CAPS"
></A
>GTK_CAULDRON_SPACE15</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_SPACE15		(0xFL&lt;&lt;GTK_CAULDRON_SPACE_SHIFT)</PRE
></TD
></TR
></TABLE
><P
>Specify a width of 15 pixels of each space or p
characters. &#13;</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7812"
></A
><H3
><A
NAME="GTK-CAULDRON-IGNOREESCAPE-CAPS"
></A
>GTK_CAULDRON_IGNOREESCAPE</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_IGNOREESCAPE	(0x1L&lt;&lt;7)</PRE
></TD
></TR
></TABLE
><P
>Normalling, pressing the Escape key terminates the dialog. This prevents
this.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7817"
></A
><H3
><A
NAME="GTK-CAULDRON-IGNOREENTER-CAPS"
></A
>GTK_CAULDRON_IGNOREENTER</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_IGNOREENTER	(0x1L&lt;&lt;8)</PRE
></TD
></TR
></TABLE
><P
>Normalling, pressing the Enter/Return key assigns the values and
terminates. This prevents this.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7822"
></A
><H3
><A
NAME="GTK-CAULDRON-GRAB-CAPS"
></A
>GTK_CAULDRON_GRAB</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>#define GTK_CAULDRON_GRAB		(0x1L&lt;&lt;9)</PRE
></TD
></TR
></TABLE
><P
>Causes a grab on the dialog - that is, no other widgets in the
application will work until the dialog exits.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7827"
></A
><H3
><A
NAME="GTKCAULDRONNEXTARGCALLBACK"
></A
>GtkCauldronNextArgCallback ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        (*GtkCauldronNextArgCallback)   (<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> cauldron_type,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data,
                                             void *result);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7834"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>cauldron_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>result</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7851"
></A
><H3
><A
NAME="GTKCAULDRONCUSTOMCALLBACK"
></A
>GtkCauldronCustomCallback ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  (*GtkCauldronCustomCallback)    (<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7859"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7876"
></A
><H3
><A
NAME="GTK-DIALOG-CAULDRON"
></A
>gtk_dialog_cauldron ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gtk_dialog_cauldron             (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             <A
HREF=../glib/glib-basic-types.html#GLONG
>glong</A> options,
                                             ...);</PRE
></TD
></TR
></TABLE
><P
>This function parses a <TT
CLASS="PARAMETER"
><I
>format</I
></TT
> string with
a variable length list of arguments. The <TT
CLASS="PARAMETER"
><I
>format</I
></TT
> string describes a
dialog box and has intuitive tokens to represent different frames and
widgets. The dialog box is drawn whereupon <A
HREF="gnomeui-gtkcauldron.html#GTK-DIALOG-CAULDRON"
>gtk_dialog_cauldron</A
>()
blocks until closed or until an appropriate button is pushed. Results
from the widgets are then stored into appropriate variables passed in
the argument list in order to be retrieved by the caller.</P
><P
>Retuns NULL is returned if the dialog is
cancelled. GTK_CAULDRON_ENTERP is returned if the user pressed
enter (return-on-enter can be overridden - see global options
below), and GTK_CAULDRON_ESCAPEP is returned if the user
pressed escape. Otherwise the label of the widget that was used to
exit the dialog is returned.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7889"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> dialog title</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>options</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> dialog options, see the macro definitions</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>...</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN7910"
></A
><H3
><A
NAME="GTK-DIALOG-CAULDRON-PARSE"
></A
>gtk_dialog_cauldron_parse ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A>*      gtk_dialog_cauldron_parse       (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *title,
                                             <A
HREF=../glib/glib-basic-types.html#GLONG
>glong</A> options,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *format,
                                             <A
HREF="gnomeui-gtkcauldron.html#GTKCAULDRONNEXTARGCALLBACK"
>GtkCauldronNextArgCallback</A
> next_arg,
                                             <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *parent);</PRE
></TD
></TR
></TABLE
><P
>This function parses a format
string exactly like <A
HREF="gnomeui-gtkcauldron.html#GTK-DIALOG-CAULDRON"
>gtk_dialog_cauldron</A
>(), however it derives
arguments for the <TT
CLASS="PARAMETER"
><I
>format</I
></TT
> string from a user function <TT
CLASS="PARAMETER"
><I
>next_arg</I
></TT
>.
<A
HREF="gnomeui-gtkcauldron.html#GTK-DIALOG-CAULDRON-PARSE"
>gtk_dialog_cauldron_parse</A
>() is primarily used for creating
wrappers for interpreted languages.</P
><P
>Each subsequent call to <TT
CLASS="PARAMETER"
><I
>next_arg</I
></TT
> must assign to &lt;type&gt;*result&lt;/type&gt; a
pointer to data of the type specified by &lt;type&gt;cauldron_type&lt;/type&gt;. (An
example can be found in &lt;filename&gt;gtk_dialog_cauldron.c&lt;/filename&gt; and the
pygnome package.) The \fIcauldron_type\fP's are a small set of
types used for specifying and returning widget data. They are
enumerated as &lt;type&gt;GTK_CAULDRON_TYPE_*&lt;/type&gt; in the header file gtkcauldron.h.</P
><P
>NULL is returned if the dialog is
cancelled. GTK_CAULDRON_ENTER is returned if the user pressed
enter (return-on-enter can be overridden - see global options
below), and GTK_CAULDRON_ESCAPE is returned if the user
pressed escape. GTK_CAULDRON_ERROR is returned by 
<A
HREF="gnomeui-gtkcauldron.html#GTK-DIALOG-CAULDRON-PARSE"
>gtk_dialog_cauldron_parse</A
>() if an error
occurred (like a malformed format string). The error message can be
retrieved by gtk_dialog_cauldron_get_error().
Otherwise the label of the widget that was used to
exit the dialog is returned.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN7932"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> dialog title</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>options</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> dialog options, see the macro definitions</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>format</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> format string that describes the dialog</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>next_arg</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> user function.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> data to pass to user function</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-winhints.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="book1.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="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnome-objects.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
>gnome-winhints</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GNOME Widgets and Objects</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GtkClock</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeStock"
HREF="gnomestock.html"><LINK
REL="NEXT"
TITLE="GtkTed"
HREF="gtkted.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomestock.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gtkted.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GTKCLOCK"
>GtkClock</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN27690"
></A
><H2
>Name</H2
>GtkClock&nbsp;--&nbsp;A small text clock widget, capable of realtime, count-up and count-down modes</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN27693"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gtkclock.html#GTKCLOCK-STRUCT"
>GtkClock</A
>;
enum        <A
HREF="gtkclock.html#GTKCLOCKTYPE"
>GtkClockType</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gtkclock.html#GTK-CLOCK-NEW"
>gtk_clock_new</A
>                   (<A
HREF="gtkclock.html#GTKCLOCKTYPE"
>GtkClockType</A
> type);
void        <A
HREF="gtkclock.html#GTK-CLOCK-SET-FORMAT"
>gtk_clock_set_format</A
>            (<A
HREF="gtkclock.html"
>GtkClock</A
> *gclock,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *fmt);
void        <A
HREF="gtkclock.html#GTK-CLOCK-SET-SECONDS"
>gtk_clock_set_seconds</A
>           (<A
HREF="gtkclock.html"
>GtkClock</A
> *gclock,
                                             time_t seconds);
void        <A
HREF="gtkclock.html#GTK-CLOCK-SET-UPDATE-INTERVAL"
>gtk_clock_set_update_interval</A
>   (<A
HREF="gtkclock.html"
>GtkClock</A
> *gclock,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> seconds);
void        <A
HREF="gtkclock.html#GTK-CLOCK-START"
>gtk_clock_start</A
>                 (<A
HREF="gtkclock.html"
>GtkClock</A
> *gclock);
void        <A
HREF="gtkclock.html#GTK-CLOCK-STOP"
>gtk_clock_stop</A
>                  (<A
HREF="gtkclock.html"
>GtkClock</A
> *gclock);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN27714"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkmisc.html
>GtkMisc</A>
               +----<A
HREF=../gtk/gtklabel.html
>GtkLabel</A>
                     +----GtkClock</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN27721"
></A
><H2
>Description</H2
><P
>The <SPAN
CLASS="TYPE"
>GtkClock</SPAN
> widget provides an easy way of providing a textual clock in your application. It supports realtime display, as well as count up and count down modes. The clock widget could conceivably be used in such applications as an application's status bar, or as the basis for a panel applet, etc.</P
><P
>Three modes of operation are supported. These are realtime - which displays the current time, count-up/increasing - which counts up from an initial value (like a stopwatch), and count-down/decreasing - which counts down from an initial value.</P
><P
>Note, however, that the accuracy of the gtkclock widget is limited to 1 second.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN27727"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN27729"
></A
><H3
><A
NAME="GTKCLOCK-STRUCT"
></A
>struct GtkClock</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GtkClock;</PRE
></TD
></TR
></TABLE
><P
>You should not access the members of the GtkClock struct directly, instead,
access them through the gtk_clock_* functions.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27734"
></A
><H3
><A
NAME="GTKCLOCKTYPE"
></A
>enum GtkClockType</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
	GTK_CLOCK_INCREASING,
	GTK_CLOCK_DECREASING,
	GTK_CLOCK_REALTIME
} GtkClockType;</PRE
></TD
></TR
></TABLE
><P
>Three modes are supported - realtime (GTK_CLOCK_REALTIME), count-up (GTK_CLOCK_INCREASING) and count-down (GTK_CLOCK_DECREASING). In realtime mode, the widget displays the current local machine time. In count-up mode, the widget counts up either from an initial value (as specified with gtk_clock_set_seconds) or from the default of 0 seconds. In count-down mode, the widget counts down from a specified value or 0 seconds. Note that negative times are possible, and that the clock does not stop at 0 seconds in count down mode.</P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27739"
></A
><H3
><A
NAME="GTK-CLOCK-NEW"
></A
>gtk_clock_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gtk_clock_new                   (<A
HREF="gtkclock.html#GTKCLOCKTYPE"
>GtkClockType</A
> type);</PRE
></TD
></TR
></TABLE
><P
>Creates a new <SPAN
CLASS="TYPE"
>GtkClock</SPAN
> widget.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27747"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A GtkClockType value, specifying what mode this widget is to display in. There are three options: GTK_CLOCK_INCREASING, GTK_CLOCK_DECREASING, GTK_CLOCK_REALTIME. These options are described above.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>GtkWidget * on success, NULL on failure.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27760"
></A
><H3
><A
NAME="GTK-CLOCK-SET-FORMAT"
></A
>gtk_clock_set_format ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_clock_set_format            (<A
HREF="gtkclock.html"
>GtkClock</A
> *gclock,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *fmt);</PRE
></TD
></TR
></TABLE
><P
>Set the format of a <SPAN
CLASS="TYPE"
>GtkClock</SPAN
> widget. The syntax of the format string is identical to that of the function strftime(3). Further information about time format strings can be found on this man page. The widget defaults to a format string of "%<TT
CLASS="LITERAL"
>H</TT
>:%<TT
CLASS="LITERAL"
>M</TT
>" in realtime mode, or "%<TT
CLASS="LITERAL"
>H</TT
>:%<TT
CLASS="LITERAL"
>M</TT
>:%<TT
CLASS="LITERAL"
>S</TT
>" in count-up or count-down modes.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27773"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gclock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a GtkClock widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fmt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A time format string, as described by the man page strftime(3).
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27786"
></A
><H3
><A
NAME="GTK-CLOCK-SET-SECONDS"
></A
>gtk_clock_set_seconds ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_clock_set_seconds           (<A
HREF="gtkclock.html"
>GtkClock</A
> *gclock,
                                             time_t seconds);</PRE
></TD
></TR
></TABLE
><P
>Set the current time as displayed by the clock in count-up and count-down modes. This function has no effect in realtime mode, as the clock time is determined by the system clock in realtime mode.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27793"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gclock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a GtkClock widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>seconds</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The time to display on the clock, measured in seconds.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27806"
></A
><H3
><A
NAME="GTK-CLOCK-SET-UPDATE-INTERVAL"
></A
>gtk_clock_set_update_interval ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_clock_set_update_interval   (<A
HREF="gtkclock.html"
>GtkClock</A
> *gclock,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> seconds);</PRE
></TD
></TR
></TABLE
><P
>Set the interval at which the <SPAN
CLASS="TYPE"
>GtkClock</SPAN
> widget is updated. The seconds parameter is used to determine how often the time shown on the widget is updated. The default value is to update every second, but you may wish to increase this value. If you set the update interval to 0, the clock is never updated.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27814"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gclock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a GtkClock widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>seconds</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>The interval at which to update the clock widget, measured in seconds.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27827"
></A
><H3
><A
NAME="GTK-CLOCK-START"
></A
>gtk_clock_start ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_clock_start                 (<A
HREF="gtkclock.html"
>GtkClock</A
> *gclock);</PRE
></TD
></TR
></TABLE
><P
>Start the clock counting in count-up or count-down modes. The clock will begin counting up or down from the time when this function is called, until gtk_clock_stop is called. This function has no effect in the realtime mode (you can't start and stop real time! :-).</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27833"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gclock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a GtkClock widget.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27842"
></A
><H3
><A
NAME="GTK-CLOCK-STOP"
></A
>gtk_clock_stop ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_clock_stop                  (<A
HREF="gtkclock.html"
>GtkClock</A
> *gclock);</PRE
></TD
></TR
></TABLE
><P
>Stop the clock counting in count-up or count-down modes. The clock ceases counting up or down, and the last time reached remains on the display. This function has no effect in the realtime mode (you can't start and stop real time! :-).</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27848"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gclock</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>A pointer to a GtkClock widget.&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomestock.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gtkted.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
>GnomeStock</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GtkTed</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GtkDial</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GtkTed"
HREF="gtkted.html"><LINK
REL="NEXT"
TITLE="GtkPixmapMenuItem"
HREF="gtkpixmapmenuitem.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gtkted.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gtkpixmapmenuitem.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GTKDIAL"
>GtkDial</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN28011"
></A
><H2
>Name</H2
>GtkDial&nbsp;--&nbsp;Analog dial widget for number selection.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN28014"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gtkdial.html#GTKDIAL-STRUCT"
>GtkDial</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gtkdial.html#GTK-DIAL-NEW"
>gtk_dial_new</A
>                    (<A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> *adjustment);
<A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A>* <A
HREF="gtkdial.html#GTK-DIAL-GET-ADJUSTMENT"
>gtk_dial_get_adjustment</A
>      (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial);
void        <A
HREF="gtkdial.html#GTK-DIAL-SET-UPDATE-POLICY"
>gtk_dial_set_update_policy</A
>      (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKUPDATETYPE
>GtkUpdateType</A> policy);
void        <A
HREF="gtkdial.html#GTK-DIAL-SET-ADJUSTMENT"
>gtk_dial_set_adjustment</A
>         (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial,
                                             <A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> *adjustment);
<A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      <A
HREF="gtkdial.html#GTK-DIAL-SET-PERCENTAGE"
>gtk_dial_set_percentage</A
>         (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial,
                                             <A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A> percent);
<A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      <A
HREF="gtkdial.html#GTK-DIAL-GET-PERCENTAGE"
>gtk_dial_get_percentage</A
>         (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial);
<A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      <A
HREF="gtkdial.html#GTK-DIAL-SET-VALUE"
>gtk_dial_set_value</A
>              (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial,
                                             <A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A> value);
<A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      <A
HREF="gtkdial.html#GTK-DIAL-GET-VALUE"
>gtk_dial_get_value</A
>              (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial);
void        <A
HREF="gtkdial.html#GTK-DIAL-SET-VIEW-ONLY"
>gtk_dial_set_view_only</A
>          (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> view_only);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28047"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----GtkDial</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28052"
></A
><H2
>Description</H2
><P
>This widget provides an analog dial widget, similar to, for example, a
physical volume control on a stereo. Dial values can be changable or
read-only for value reporting.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28055"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN28057"
></A
><H3
><A
NAME="GTKDIAL-STRUCT"
></A
>struct GtkDial</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GtkDial;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28062"
></A
><H3
><A
NAME="GTK-DIAL-NEW"
></A
>gtk_dial_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gtk_dial_new                    (<A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> *adjustment);</PRE
></TD
></TR
></TABLE
><P
>This function creates a new GtkDial widget, and ties it to a
specified GtkAdjustment. When the dial is moved, the adjustment is
updated, and vice-versa.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28070"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>adjustment</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GtkAdjustment object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to new GtkDial widget.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28083"
></A
><H3
><A
NAME="GTK-DIAL-GET-ADJUSTMENT"
></A
>gtk_dial_get_adjustment ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A>* gtk_dial_get_adjustment      (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial);</PRE
></TD
></TR
></TABLE
><P
>Retrieves the GtkAdjustment associated with the
GtkDial <TT
CLASS="PARAMETER"
><I
>dial</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28092"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dial</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GtkDial widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GtkAdjustment object.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28105"
></A
><H3
><A
NAME="GTK-DIAL-SET-UPDATE-POLICY"
></A
>gtk_dial_set_update_policy ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_dial_set_update_policy      (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial,
                                             <A
HREF=../gtk/gtk-standard-enumerations.html#GTKUPDATETYPE
>GtkUpdateType</A> policy);</PRE
></TD
></TR
></TABLE
><P
>Sets the update policy of the GtkDial <TT
CLASS="PARAMETER"
><I
>dial</I
></TT
> to one of either
<TT
CLASS="LITERAL"
>GTK_UPDATE_CONTINUOUS</TT
>, <TT
CLASS="LITERAL"
>GTK_UPDATE_DISCONTINUOUS</TT
>, or
<TT
CLASS="LITERAL"
>GTK_UPDATE_DELAYED</TT
>. Please see Gtk+ documentation for an
explanation of these values.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28117"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dial</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GtkDial widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>policy</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New policy type</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28130"
></A
><H3
><A
NAME="GTK-DIAL-SET-ADJUSTMENT"
></A
>gtk_dial_set_adjustment ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_dial_set_adjustment         (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial,
                                             <A
HREF=../gtk/gtkadjustment.html
>GtkAdjustment</A> *adjustment);</PRE
></TD
></TR
></TABLE
><P
>Associates a new GtkAdjustment with GtkDial <TT
CLASS="PARAMETER"
><I
>dial</I
></TT
>
widget. The old adjustment is removed and replaced with the new.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28139"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dial</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GtkDial widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>adjustment</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GtkAdjustment object</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28152"
></A
><H3
><A
NAME="GTK-DIAL-SET-PERCENTAGE"
></A
>gtk_dial_set_percentage ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      gtk_dial_set_percentage         (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial,
                                             <A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A> percent);</PRE
></TD
></TR
></TABLE
><P
>Sets the GtkDial's value to <TT
CLASS="PARAMETER"
><I
>percent</I
></TT
> of
<TT
CLASS="PARAMETER"
><I
>dial</I
></TT
>-&gt;adjustment-&gt;upper. The upper value is set when the
GtkAdjustment is created.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28163"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dial</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GtkDial widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>percent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New percentage</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New value of adjustment.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28180"
></A
><H3
><A
NAME="GTK-DIAL-GET-PERCENTAGE"
></A
>gtk_dial_get_percentage ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      gtk_dial_get_percentage         (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial);</PRE
></TD
></TR
></TABLE
><P
>Retrieves the current percentage held in the dial widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28188"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dial</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GtkDial widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Current percentage.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28201"
></A
><H3
><A
NAME="GTK-DIAL-SET-VALUE"
></A
>gtk_dial_set_value ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      gtk_dial_set_value              (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial,
                                             <A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A> value);</PRE
></TD
></TR
></TABLE
><P
>Sets the current value held in the GtkDial's
adjustment object to <TT
CLASS="PARAMETER"
><I
>value</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28211"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dial</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GtkDial widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>value</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New value</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> New percentage of value to the adjustment's upper limit.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28228"
></A
><H3
><A
NAME="GTK-DIAL-GET-VALUE"
></A
>gtk_dial_get_value ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GFLOAT
>gfloat</A>      gtk_dial_get_value              (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial);</PRE
></TD
></TR
></TABLE
><P
>Retrieves the current value helt in the dial widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28236"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dial</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GtkDial widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Current value</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28249"
></A
><H3
><A
NAME="GTK-DIAL-SET-VIEW-ONLY"
></A
>gtk_dial_set_view_only ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_dial_set_view_only          (<A
HREF="gtkdial.html"
>GtkDial</A
> *dial,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> view_only);</PRE
></TD
></TR
></TABLE
><P
>Specifies whether or not the user is to be able to
edit the value represented by the dial widget. If <TT
CLASS="PARAMETER"
><I
>view_only</I
></TT
> is
TRUE, the dial will be set to view-only mode, and the user will not 
be able to edit it. If <TT
CLASS="PARAMETER"
><I
>view_only</I
></TT
> is FALSE, the user will be able
to change the value represented.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28259"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dial</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GtkDial widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>view_only</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> TRUE to set dial to read-only, FALSE to edit.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28272"
></A
><H2
>See Also</H2
><P
><A
HREF="gnomenumberentry.html"
>GnomeNumberEntry</A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gtkted.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gtkpixmapmenuitem.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
>GtkTed</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GtkPixmapMenuItem</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GtkPixmapMenuItem</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GtkDial"
HREF="gtkdial.html"><LINK
REL="NEXT"
TITLE="GnomeSpell"
HREF="gnomespell.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gtkdial.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomespell.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GTKPIXMAPMENUITEM"
>GtkPixmapMenuItem</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN28281"
></A
><H2
>Name</H2
>GtkPixmapMenuItem&nbsp;--&nbsp;A special widget for GNOME menus.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN28284"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gtkpixmapmenuitem.html#GTKPIXMAPMENUITEM-STRUCT"
>GtkPixmapMenuItem</A
>;
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gtkpixmapmenuitem.html#GTK-PIXMAP-MENU-ITEM-NEW"
>gtk_pixmap_menu_item_new</A
>        (void);
void        <A
HREF="gtkpixmapmenuitem.html#GTK-PIXMAP-MENU-ITEM-SET-PIXMAP"
>gtk_pixmap_menu_item_set_pixmap</A
> (<A
HREF="gtkpixmapmenuitem.html"
>GtkPixmapMenuItem</A
> *menu_item,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *pixmap);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28293"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtkbin.html
>GtkBin</A>
                     +----<A
HREF=../gtk/gtkitem.html
>GtkItem</A>
                           +----<A
HREF=../gtk/gtkmenuitem.html
>GtkMenuItem</A>
                                 +----GtkPixmapMenuItem</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28302"
></A
><H2
>Description</H2
><P
>GtkPixmapMenuItem works like a normal GTK menu item, but you can insert a
arbitrary widget (most often a pixmap widget), which is displayed 
at the left side. The advantage is that indentation is handled the 
same way as GTK does (i.e if you create a menu with a gtk_check_menu_item, 
all normal menu items are automatically indented by GTK - so if you 
use a normal menu item to display pixmaps at the left side, the pixmaps 
will be indented, which is not what you want. This widget solves 
the problem).</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28305"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN28307"
></A
><H3
><A
NAME="GTKPIXMAPMENUITEM-STRUCT"
></A
>struct GtkPixmapMenuItem</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GtkPixmapMenuItem;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28312"
></A
><H3
><A
NAME="GTK-PIXMAP-MENU-ITEM-NEW"
></A
>gtk_pixmap_menu_item_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gtk_pixmap_menu_item_new        (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a new pixmap menu item. Use <A
HREF="gtkpixmapmenuitem.html#GTK-PIXMAP-MENU-ITEM-SET-PIXMAP"
>gtk_pixmap_menu_item_set_pixmap</A
>() 
to set the pixmap wich is displayed at the left side.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28320"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&amp;GtkWidget pointer to new menu item</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN28329"
></A
><H3
><A
NAME="GTK-PIXMAP-MENU-ITEM-SET-PIXMAP"
></A
>gtk_pixmap_menu_item_set_pixmap ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_pixmap_menu_item_set_pixmap (<A
HREF="gtkpixmapmenuitem.html"
>GtkPixmapMenuItem</A
> *menu_item,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *pixmap);</PRE
></TD
></TR
></TABLE
><P
>Set the pixmap of the menu item.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN28337"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>menu_item</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to the pixmap menu item</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to a pixmap widget</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gtkdial.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomespell.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
>GtkDial</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeSpell</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>GtkTed</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GtkClock"
HREF="gtkclock.html"><LINK
REL="NEXT"
TITLE="GtkDial"
HREF="gtkdial.html"></HEAD
><BODY
CLASS="REFENTRY"
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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gtkclock.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gtkdial.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GTKTED"
>GtkTed</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN27862"
></A
><H2
>Name</H2
>GtkTed&nbsp;--&nbsp;Deprecated.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN27865"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gtkted.html#GTKTED-STRUCT"
>GtkTed</A
>;
void        <A
HREF="gtkted.html#GTK-TED-SET-APP-NAME"
>gtk_ted_set_app_name</A
>            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *str);
void        <A
HREF="gtkted.html#GTK-TED-PREPARE"
>gtk_ted_prepare</A
>                 (<A
HREF="gtkted.html"
>GtkTed</A
> *ted);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gtkted.html#GTK-TED-NEW"
>gtk_ted_new</A
>                     (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *dialog_name);
<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  <A
HREF="gtkted.html#GTK-TED-NEW-LAYOUT"
>gtk_ted_new_layout</A
>              (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *dialog_name,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *layout);
void        <A
HREF="gtkted.html#GTK-TED-ADD"
>gtk_ted_add</A
>                     (<A
HREF="gtkted.html"
>GtkTed</A
> *ted,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN27884"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <A
HREF=../gtk/gtkobject.html
>GtkObject</A>
   +----<A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>
         +----<A
HREF=../gtk/gtkcontainer.html
>GtkContainer</A>
               +----<A
HREF=../gtk/gtktable.html
>GtkTable</A>
                     +----GtkTed</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN27891"
></A
><H2
>Description</H2
><P
>    The routines in this module are deprecated and are only kept as
    compatibility with old code that used these.
  </P
><P
>    This used to be a way for an application to leave the layout
    policies for a dialog until runtime and provide a GUI editor if no
    layout information was available.
  </P
><P
>    Dialog layout should now be done with Glade and libglade.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN27896"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN27898"
></A
><H3
><A
NAME="GTKTED-STRUCT"
></A
>struct GtkTed</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GtkTed;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27903"
></A
><H3
><A
NAME="GTK-TED-SET-APP-NAME"
></A
>gtk_ted_set_app_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_ted_set_app_name            (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *str);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27909"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>str</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27918"
></A
><H3
><A
NAME="GTK-TED-PREPARE"
></A
>gtk_ted_prepare ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_ted_prepare                 (<A
HREF="gtkted.html"
>GtkTed</A
> *ted);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27924"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ted</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27933"
></A
><H3
><A
NAME="GTK-TED-NEW"
></A
>gtk_ted_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gtk_ted_new                     (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *dialog_name);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27940"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog_name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27953"
></A
><H3
><A
NAME="GTK-TED-NEW-LAYOUT"
></A
>gtk_ted_new_layout ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gtk/gtkwidget.html
>GtkWidget</A>*  gtk_ted_new_layout              (const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *dialog_name,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *layout);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27961"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dialog_name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>layout</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN27978"
></A
><H3
><A
NAME="GTK-TED-ADD"
></A
>gtk_ted_add ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_ted_add                     (<A
HREF="gtkted.html"
>GtkTed</A
> *ted,
                                             <A
HREF=../gtk/gtkwidget.html
>GtkWidget</A> *widget,
                                             const <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *name);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN27986"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ted</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>widget</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN28003"
></A
><H2
>See Also</H2
><P
>libglade(3), Glade.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gtkclock.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="book1.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="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gtkdial.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
>GtkClock</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GtkDial</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
><HTML
><HEAD
><TITLE
>Gnome User Interface Library</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.61
"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="PREVIOUS"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="NEXT"
TITLE="gnome-app-helper"
HREF="gnomeui-gnome-app-helper.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"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="book1.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="book1.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="gnomeui-gnome-app-helper.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="LIBGNOMEUI"
>Gnome User Interface Library</A
></H1
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="gnomeui-gnome-app-helper.html"
>gnome-app-helper</A
> &#8212; Simplified menu and toolbar creation.</DT
><DT
><A
HREF="gnomeui-gnome-app-util.html"
>gnome-app-util</A
> &#8212; Utility functions for manipulating GnomeApp container widgets.</DT
><DT
><A
HREF="gnomeui-gnome-canvas-util.html"
>gnome-canvas-util</A
> &#8212; Auxiliary canvas functions.</DT
><DT
><A
HREF="gnomeui-gnome-dialog-util.html"
>gnome-dialog-util</A
> &#8212; Convenience functions for making dialogs.</DT
><DT
><A
HREF="gnomeui-gnome-dns.html"
>gnome-dns</A
> &#8212; Non-blocking name resolver interface.</DT
><DT
><A
HREF="gnomeui-gnome-geometry.html"
>gnome-geometry</A
> &#8212; Window geometry utility functions.</DT
><DT
><A
HREF="gnomeui-gnome-ice.html"
>gnome-ice</A
> &#8212; Integrates the ICE library with the GTK+ event loop</DT
><DT
><A
HREF="gnomeui-gnome-icon-text.html"
>gnome-icon-text</A
> &#8212; Text wrapping functions for icon captions.</DT
><DT
><A
HREF="gnomeui-gnome-init.html"
>gnome-init</A
> &#8212; Initialize GNOME libraries.</DT
><DT
><A
HREF="gnomeui-gnome-mdi-session.html"
>gnome-mdi-session</A
> &#8212; Routines providing <SPAN
CLASS="TYPE"
>GnomeMDI</SPAN
> state saving and restoration</DT
><DT
><A
HREF="gnomeui-gnome-popup-help.html"
>gnome-popup-help</A
> &#8212;   A popup-help system for GtkWidgets.</DT
><DT
><A
HREF="gnomeui-gnome-popup-menu.html"
>gnome-popup-menu</A
> &#8212; Routines for attaching popup menus to widgets.</DT
><DT
><A
HREF="gnomeui-gnome-preferences.html"
>gnome-preferences</A
> &#8212; Fetching and setting GNOME preferences</DT
><DT
><A
HREF="gnomeui-gnome-properties.html"
>gnome-properties</A
> &#8212; deprecated/experimental/unfinished</DT
><DT
><A
HREF="gnomeui-gnome-property-entries.html"
>gnome-property-entries</A
> &#8212; deprecated/experimental/unfinished</DT
><DT
><A
HREF="gnomeui-gnome-startup.html"
>gnome-startup</A
> &#8212; Internal routines for session management.</DT
><DT
><A
HREF="gnomeui-gnome-types.html"
>gnome-types</A
> &#8212; Some global types used by the GNOME libraries.</DT
><DT
><A
HREF="gnomeui-gnome-uidefs.html"
>gnome-uidefs</A
> &#8212; Useful GNOME macros</DT
><DT
><A
HREF="gnomeui-gnome-window-icon.html"
>gnome-window-icon</A
> &#8212; Convenience functions for window mini-icons</DT
><DT
><A
HREF="gnomeui-gnome-winhints.html"
>gnome-winhints</A
> &#8212; Manipulate GNOME-specific window manager hints.</DT
><DT
><A
HREF="gnomeui-gtkcauldron.html"
>gtkcauldron</A
> &#8212; Produce gtk/gnome dialog boxes from format strings.</DT
></DL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="book1.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="book1.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="gnomeui-gnome-app-helper.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
>Gnome User Interface Library Reference Manual</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-app-helper</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>