Description
  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
Details
GNOME_APPBAR_HAS_STATUS()
| #define GNOME_APPBAR_HAS_STATUS(appbar) (GNOME_APPBAR(appbar)->status != NULL) | 
Returns whether the appbar contains a statusbar widget. For internal use. Don't use.
GNOME_APPBAR_HAS_PROGRESS()
| #define GNOME_APPBAR_HAS_PROGRESS(appbar) (GNOME_APPBAR(appbar)->progress != NULL) | 
Returns whether the appbar has a progress widget. For internal use. Don't use.
GNOME_APPBAR_INTERACTIVE()
| #define GNOME_APPBAR_INTERACTIVE(ab) ((ab) ? (ab)->interactive : FALSE) | 
Returns whether the appbar has a minibuffer-style interactive status display.
For internal use. Don't use.
gnome_appbar_new ()
| GtkWidget*  gnome_appbar_new                (gboolean has_progress,
                                             gboolean has_status,
                                             GnomePreferencesType interactivity); | 
Create a new GNOME application status bar.  If has_progress is
TRUE, a small progress bar widget will be created, and placed on the
left side of the appbar.  If has_status is TRUE, a status bar,
possibly an editable one, is created.
interactivity determines whether the appbar is an interactive
"minibuffer" or just a status bar.  If it is set to
GNOME_PREFERENCES_NEVER, it is never interactive.  If it is set to
GNOME_PREFERENCES_USER we respect user preferences from
ui-properties. If it's GNOME_PREFERENCES_ALWAYS 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
GNOME_PREFERENCES_USER. 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.
gnome_appbar_set_status ()
| void        gnome_appbar_set_status         (GnomeAppBar *appbar,
                                             const gchar *status); | 
Sets the status label without changing widget state; next set or push
will destroy this permanently.
gnome_appbar_set_default ()
| void        gnome_appbar_set_default        (GnomeAppBar *appbar,
                                             const gchar *default_status); | 
What to show when showing nothing else; defaults to nothing.
gnome_appbar_push ()
| void        gnome_appbar_push               (GnomeAppBar *appbar,
                                             const gchar *status); | 
Push a new status message onto the status bar stack, and
display it.
gnome_appbar_pop ()
Remove current status message, and display previous status
message, if any.  It is OK to call this with an empty stack.
gnome_appbar_clear_stack ()
Remove all status messages from appbar, and display default status
message (if present).
gnome_appbar_set_progress ()
| void        gnome_appbar_set_progress       (GnomeAppBar *appbar,
                                             gfloat percentage); | 
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.
gnome_appbar_get_progress ()
| GtkProgress* gnome_appbar_get_progress      (GnomeAppBar *appbar); | 
Returns &GtkProgress widget pointer, so that the progress bar may be
manipulated further.
gnome_appbar_refresh ()
Reflect the current state of stack/default. Useful to force a
set_status to disappear.
gnome_appbar_set_prompt ()
| void        gnome_appbar_set_prompt         (GnomeAppBar *appbar,
                                             const gchar *prompt,
                                             gboolean modal); | 
Put a prompt in the appbar and wait for a response. When the
user responds or cancels, a user_response signal is emitted.
gnome_appbar_clear_prompt ()
Remove any prompt.
gnome_appbar_get_response ()
| gchar*      gnome_appbar_get_response       (GnomeAppBar *appbar); | 
Get the response to the prompt, if any. Result must be g_free'd.
gnome_appbar_construct ()
For use to bindings in languages other than C. Don't use.