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

   1 /*
   2  * gtkappchooserbutton.h: an app-chooser combobox
   3  *
   4  * Copyright (C) 2010 Red Hat, Inc.
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Library General Public License as
   8  * published by the Free Software Foundation; either version 2 of the
   9  * License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Library General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Library General Public
  17  * License along with the Gnome Library; see the file COPYING.LIB.  If not,
  18  * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  19  * Boston, MA 02111-1307, USA.
  20  *
  21  * Authors: Cosimo Cecchi <ccecchi@redhat.com>
  22  */
  23
  24 #if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
  25 #error "Only <gtk/gtk.h> can be included directly."
  26 #endif
  27
  28 #ifndef __GTK_APP_CHOOSER_BUTTON_H__
  29 #define __GTK_APP_CHOOSER_BUTTON_H__
  30
  31 #include <gtk/gtkcombobox.h>
  32 #include <gio/gio.h>
  33
  34 G_BEGIN_DECLS
  35
  36 #define GTK_TYPE_APP_CHOOSER_BUTTON            (gtk_app_chooser_button_get_type ())
  37 #define GTK_APP_CHOOSER_BUTTON(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_APP_CHOOSER_BUTTON, GtkAppChooserButton))
  38 #define GTK_APP_CHOOSER_BUTTON_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_APP_CHOOSER_BUTTON, GtkAppChooserButtonClass))
  39 #define GTK_IS_APP_CHOOSER_BUTTON(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_APP_CHOOSER_BUTTON))
  40 #define GTK_IS_APP_CHOOSER_BUTTON_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_APP_CHOOSER_BUTTON))
  41 #define GTK_APP_CHOOSER_BUTTON_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_APP_CHOOSER_BUTTON, GtkAppChooserButtonClass))
  42
  43 typedef struct _GtkAppChooserButton        GtkAppChooserButton;
  44 typedef struct _GtkAppChooserButtonClass   GtkAppChooserButtonClass;
  45 typedef struct _GtkAppChooserButtonPrivate GtkAppChooserButtonPrivate;
  46
  47 struct _GtkAppChooserButton {
  48   GtkComboBox parent;
  49
  50   /*< private >*/
  51   GtkAppChooserButtonPrivate *priv;
  52 };
  53
  54 struct _GtkAppChooserButtonClass {
  55   GtkComboBoxClass parent_class;
  56
  57   void (* custom_item_activated) (GtkAppChooserButton *self,
  58                                   const gchar *item_name);
  59
  60   /* padding for future class expansion */
  61   gpointer padding[16];
  62 };
  63
  64 GType       gtk_app_chooser_button_get_type           (void) G_GNUC_CONST;
  65
  66 GtkWidget * gtk_app_chooser_button_new                (const gchar         *content_type);
  67
  68 void        gtk_app_chooser_button_append_separator   (GtkAppChooserButton *self);
  69 void        gtk_app_chooser_button_append_custom_item (GtkAppChooserButton *self,
  70                                                        const gchar         *name,
  71                                                        const gchar         *label,
  72                                                        GIcon               *icon);
  73 void     gtk_app_chooser_button_set_active_custom_item (GtkAppChooserButton *self,
  74                                                         const gchar         *name);
  75
  76 void     gtk_app_chooser_button_set_show_dialog_item  (GtkAppChooserButton *self,
  77                                                        gboolean             setting);
  78 gboolean gtk_app_chooser_button_get_show_dialog_item  (GtkAppChooserButton *self);
  79 void     gtk_app_chooser_button_set_heading           (GtkAppChooserButton *self,
  80                                                        const gchar         *heading);
  81 const gchar *
  82          gtk_app_chooser_button_get_heading           (GtkAppChooserButton *self);
  83 GDK_AVAILABLE_IN_3_2
  84 void     gtk_app_chooser_button_set_show_default_item (GtkAppChooserButton *self,
  85                                                        gboolean             setting);
  86 GDK_AVAILABLE_IN_3_2
  87 gboolean gtk_app_chooser_button_get_show_default_item (GtkAppChooserButton *self);
  88
  89 G_END_DECLS
  90
  91 #endif /* __GTK_APP_CHOOSER_BUTTON_H__ */