Pileus Git - ~andy/gtk/blob - gtk/gtkstatusbar.h

   1 /* GTK - The GIMP Toolkit
   2  * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
   3  * GtkStatusbar Copyright (C) 1998 Shawn T. Amundson
   4  *
   5  * This library is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Lesser General Public
   7  * License as published by the Free Software Foundation; either
   8  * version 2 of the License, or (at your option) any later version.
   9  *
  10  * This library is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Lesser General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Lesser General Public
  16  * License along with this library; if not, write to the
  17  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18  * Boston, MA 02111-1307, USA.
  19  */
  20
  21 /*
  22  * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
  23  * file for a list of people on the GTK+ Team.  See the ChangeLog
  24  * files for a list of changes.  These files are distributed with
  25  * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
  26  */
  27
  28 #ifndef __GTK_STATUSBAR_H__
  29 #define __GTK_STATUSBAR_H__
  30
  31 #include <gtk/gtkhbox.h>
  32
  33 #ifdef __cplusplus
  34 extern "C" {
  35 #endif /* __cplusplus */
  36
  37
  38 #define GTK_TYPE_STATUSBAR            (gtk_statusbar_get_type ())
  39 #define GTK_STATUSBAR(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_STATUSBAR, GtkStatusbar))
  40 #define GTK_STATUSBAR_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_STATUSBAR, GtkStatusbarClass))
  41 #define GTK_IS_STATUSBAR(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_STATUSBAR))
  42 #define GTK_IS_STATUSBAR_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_STATUSBAR))
  43 #define GTK_STATUSBAR_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_STATUSBAR, GtkStatusbarClass))
  44
  45
  46 typedef struct _GtkStatusbar      GtkStatusbar;
  47 typedef struct _GtkStatusbarClass GtkStatusbarClass;
  48
  49 struct _GtkStatusbar
  50 {
  51   GtkHBox parent_widget;
  52
  53   GtkWidget *frame;
  54   GtkWidget *label;
  55
  56   GSList *messages;
  57   GSList *keys;
  58
  59   guint seq_context_id;
  60   guint seq_message_id;
  61
  62   GdkWindow *grip_window;
  63
  64   guint has_resize_grip : 1;
  65 };
  66
  67 struct _GtkStatusbarClass
  68 {
  69   GtkHBoxClass parent_class;
  70
  71   GMemChunk *messages_mem_chunk;
  72
  73   void  (*text_pushed)  (GtkStatusbar   *statusbar,
  74                          guint           context_id,
  75                          const gchar    *text);
  76   void  (*text_popped)  (GtkStatusbar   *statusbar,
  77                          guint           context_id,
  78                          const gchar    *text);
  79
  80   /* Padding for future expansion */
  81   void (*_gtk_reserved1) (void);
  82   void (*_gtk_reserved2) (void);
  83   void (*_gtk_reserved3) (void);
  84   void (*_gtk_reserved4) (void);
  85 };
  86
  87
  88 GType      gtk_statusbar_get_type       (void) G_GNUC_CONST;
  89 GtkWidget* gtk_statusbar_new            (void);
  90 /* If you don't want to use contexts, 0 is a predefined global
  91  * context_id you can pass to push/pop/remove
  92  */
  93 guint      gtk_statusbar_get_context_id (GtkStatusbar *statusbar,
  94                                          const gchar  *context_description);
  95 /* Returns message_id used for gtk_statusbar_remove */
  96 guint      gtk_statusbar_push           (GtkStatusbar *statusbar,
  97                                          guint         context_id,
  98                                          const gchar  *text);
  99 void       gtk_statusbar_pop            (GtkStatusbar *statusbar,
 100                                          guint         context_id);
 101 void       gtk_statusbar_remove         (GtkStatusbar *statusbar,
 102                                          guint         context_id,
 103                                          guint         message_id);
 104
 105 void     gtk_statusbar_set_has_resize_grip (GtkStatusbar *statusbar,
 106                                             gboolean      setting);
 107 gboolean gtk_statusbar_get_has_resize_grip (GtkStatusbar *statusbar);
 108
 109 #ifdef __cplusplus
 110 }
 111 #endif /* __cplusplus */
 112 #endif /* __GTK_STATUSBAR_H__ */