<HTML
><HEAD
><TITLE
>GnomeAppBar</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><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
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="AEN9407"
></A
><H2
>Name</H2
>GnomeAppBar&nbsp;--&nbsp;Statusbar/Progress/Minibuffer widget</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN9410"
></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"
>GNOME_APPBAR_HAS_STATUS</A
>         (appbar)
#define     <A
HREF="gnomeappbar.html#GNOME-APPBAR-HAS-PROGRESS"
>GNOME_APPBAR_HAS_PROGRESS</A
>       (appbar)
struct      <A
HREF="gnomeappbar.html#GNOMEAPPBARMSG"
>GnomeAppBarMsg</A
>;
#define     <A
HREF="gnomeappbar.html#GNOME-APPBAR-INTERACTIVE"
>GNOME_APPBAR_INTERACTIVE</A
>        (ab)
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeappbar.html#GNOME-APPBAR-NEW"
>gnome_appbar_new</A
>                (<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> has_progress,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> 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 <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *status);
void        <A
HREF="gnomeappbar.html#GNOME-APPBAR-SET-DEFAULT"
>gnome_appbar_set_default</A
>        (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *default_status);
void        <A
HREF="gnomeappbar.html#GNOME-APPBAR-PUSH"
>gnome_appbar_push</A
>               (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *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,
                                             <GTKDOCLINK
HREF="GFLOAT"
>gfloat</GTKDOCLINK
> percentage);
<GTKDOCLINK
HREF="GTKPROGRESS"
>GtkProgress</GTKDOCLINK
>* <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 <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *prompt,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> modal);
void        <A
HREF="gnomeappbar.html#GNOME-APPBAR-CLEAR-PROMPT"
>gnome_appbar_clear_prompt</A
>       (<A
HREF="gnomeappbar.html"
>GnomeAppBar</A
> *appbar);
<GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>*      <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,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> has_progress,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> has_status,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEPREFERENCESTYPE"
>GnomePreferencesType</A
> interactivity);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9458"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <GTKDOCLINK
HREF="GTKOBJECT"
>GtkObject</GTKDOCLINK
>
   +----<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>
         +----<GTKDOCLINK
HREF="GTKCONTAINER"
>GtkContainer</GTKDOCLINK
>
               +----<GTKDOCLINK
HREF="GTKBOX"
>GtkBox</GTKDOCLINK
>
                     +----<GTKDOCLINK
HREF="GTKHBOX"
>GtkHBox</GTKDOCLINK
>
                           +----GnomeAppBar</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9466"
></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="AEN9469"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN9471"
></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="AEN9476"
></A
><H3
><A
NAME="GNOME-APPBAR-HAS-STATUS"
></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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9490"
></A
><H3
><A
NAME="GNOME-APPBAR-HAS-PROGRESS"
></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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9504"
></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="AEN9508"
></A
><H3
><A
NAME="GNOME-APPBAR-INTERACTIVE"
></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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9522"
></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"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_appbar_new                (<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> has_progress,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> 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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9567"
></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 <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9588"
></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 <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *default_status);</PRE
></TD
></TR
></TABLE
><P
>What to show when showing nothing else; defaults to nothing.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9609"
></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 <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9630"
></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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9646"
></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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9662"
></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,
                                             <GTKDOCLINK
HREF="GFLOAT"
>gfloat</GTKDOCLINK
> 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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9683"
></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"
><GTKDOCLINK
HREF="GTKPROGRESS"
>GtkProgress</GTKDOCLINK
>* 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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9704"
></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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9720"
></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 <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *prompt,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> 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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9747"
></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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9763"
></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"
><GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>*      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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN9784"
></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,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> has_progress,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> 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"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><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
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN9818"
></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
>