<HTML ><HEAD ><TITLE >GnomeAppBar</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.74b"><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 ><<< 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 >>></B ></FONT ></A ></TD ></TR ></TABLE ></DIV ><H1 ><A NAME="GNOMEAPPBAR" >GnomeAppBar</A ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN9411" ></A ><H2 >Name</H2 >GnomeAppBar -- Statusbar/Progress/Minibuffer widget</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN9414" ></A ><H2 >Synopsis</H2 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="SYNOPSIS" > #include <gnome.h> 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) <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); </PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN9462" ></A ><H2 >Object Hierarchy</H2 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="SYNOPSIS" > <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="AEN9470" ></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="AEN9473" ></A ><H2 >Details</H2 ><DIV CLASS="REFSECT2" ><A NAME="AEN9475" ></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="AEN9480" ></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)->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="AEN9485" ></A ><P ></P ><TABLE BORDER="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 > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >appbar to check </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN9494" ></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)->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="AEN9499" ></A ><P ></P ><TABLE BORDER="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 > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >appbar to check </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN9508" ></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="AEN9512" ></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)->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="AEN9517" ></A ><P ></P ><TABLE BORDER="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 > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >appbar to check </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN9526" ></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" ><A NAME="AEN9546" ></A ><P ></P ><TABLE BORDER="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 > :</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 > :</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 > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Level of user activity required</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</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="AEN9571" ></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" ><A NAME="AEN9579" ></A ><P ></P ><TABLE BORDER="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 > :</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 > :</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="AEN9592" ></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" ><A NAME="AEN9600" ></A ><P ></P ><TABLE BORDER="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 > :</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 > :</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="AEN9613" ></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" ><A NAME="AEN9621" ></A ><P ></P ><TABLE BORDER="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 > :</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 > :</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="AEN9634" ></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="AEN9641" ></A ><P ></P ><TABLE BORDER="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 > :</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="AEN9650" ></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="AEN9657" ></A ><P ></P ><TABLE BORDER="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 > :</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="AEN9666" ></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" ><A NAME="AEN9674" ></A ><P ></P ><TABLE BORDER="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 > :</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 > :</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="AEN9687" ></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 &GtkProgress widget pointer, so that the progress bar may be manipulated further.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN9695" ></A ><P ></P ><TABLE BORDER="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 > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Pointer to GNOME appbar object</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</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="AEN9708" ></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="AEN9715" ></A ><P ></P ><TABLE BORDER="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 > :</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="AEN9724" ></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" ><A NAME="AEN9733" ></A ><P ></P ><TABLE BORDER="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 > :</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 > :</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 > :</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="AEN9751" ></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="AEN9758" ></A ><P ></P ><TABLE BORDER="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 > :</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="AEN9767" ></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" ><A NAME="AEN9775" ></A ><P ></P ><TABLE BORDER="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 > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > Pointer to GNOME appbar object</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</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="AEN9788" ></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" ><A NAME="AEN9798" ></A ><P ></P ><TABLE BORDER="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 > :</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 > :</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 > :</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 > :</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="AEN9822" ></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 ><<< 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 >>></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 >