gtkapplication.h 7.1 KB
Newer Older
1 2
/*
 * Copyright © 2010 Codethink Limited
Matthias Clasen's avatar
Matthias Clasen committed
3 4 5 6
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
7
 * version 2 of the licence, or (at your option) any later version.
Matthias Clasen's avatar
Matthias Clasen committed
8 9 10
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Matthias Clasen's avatar
Matthias Clasen committed
12 13 14
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
Javier Jardón's avatar
Javier Jardón committed
15
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
Matthias Clasen's avatar
Matthias Clasen committed
16
 *
17
 * Author: Ryan Lortie <desrt@desrt.ca>
Matthias Clasen's avatar
Matthias Clasen committed
18 19
 */

20 21 22
#ifndef __GTK_APPLICATION_H__
#define __GTK_APPLICATION_H__

Matthias Clasen's avatar
Matthias Clasen committed
23
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
Matthias Clasen's avatar
Matthias Clasen committed
24 25 26
#error "Only <gtk/gtk.h> can be included directly."
#endif

27 28
#include <gtk/gtkwidget.h>
#include <gio/gio.h>
Matthias Clasen's avatar
Matthias Clasen committed
29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50

G_BEGIN_DECLS

#define GTK_TYPE_APPLICATION            (gtk_application_get_type ())
#define GTK_APPLICATION(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_APPLICATION, GtkApplication))
#define GTK_APPLICATION_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_APPLICATION, GtkApplicationClass))
#define GTK_IS_APPLICATION(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_APPLICATION))
#define GTK_IS_APPLICATION_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_APPLICATION))
#define GTK_APPLICATION_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_APPLICATION, GtkApplicationClass))

typedef struct _GtkApplication        GtkApplication;
typedef struct _GtkApplicationClass   GtkApplicationClass;
typedef struct _GtkApplicationPrivate GtkApplicationPrivate;

struct _GtkApplication
{
  GApplication parent;

  /*< private >*/
  GtkApplicationPrivate *priv;
};

51 52 53 54 55 56 57 58 59
/**
 * GtkApplicationClass:
 * @parent_class: The parent class.
 * @window_added: Signal emitted when a #GtkWindow is added to
 *    application through gtk_application_add_window().
 * @window_removed: Signal emitted when a #GtkWindow is removed from
 *    application, either as a side-effect of being destroyed or
 *    explicitly through gtk_application_remove_window().
 */
Matthias Clasen's avatar
Matthias Clasen committed
60 61 62 63
struct _GtkApplicationClass
{
  GApplicationClass parent_class;

64 65
  /*< public >*/

66 67 68 69 70
  void (*window_added)   (GtkApplication *application,
                          GtkWindow      *window);
  void (*window_removed) (GtkApplication *application,
                          GtkWindow      *window);

71
  /*< private >*/
72
  gpointer padding[12];
Matthias Clasen's avatar
Matthias Clasen committed
73 74
};

75
GDK_AVAILABLE_IN_ALL
Matthias Clasen's avatar
Matthias Clasen committed
76
GType            gtk_application_get_type      (void) G_GNUC_CONST;
77

78
GDK_AVAILABLE_IN_ALL
Matthias Clasen's avatar
Matthias Clasen committed
79 80
GtkApplication * gtk_application_new           (const gchar       *application_id,
                                                GApplicationFlags  flags);
Matthias Clasen's avatar
Matthias Clasen committed
81

82
GDK_AVAILABLE_IN_ALL
Matthias Clasen's avatar
Matthias Clasen committed
83 84
void             gtk_application_add_window    (GtkApplication    *application,
                                                GtkWindow         *window);
85

86
GDK_AVAILABLE_IN_ALL
Matthias Clasen's avatar
Matthias Clasen committed
87 88
void             gtk_application_remove_window (GtkApplication    *application,
                                                GtkWindow         *window);
89
GDK_AVAILABLE_IN_ALL
Matthias Clasen's avatar
Matthias Clasen committed
90
GList *          gtk_application_get_windows   (GtkApplication    *application);
91

92
GDK_AVAILABLE_IN_3_4
93
GMenuModel *     gtk_application_get_app_menu  (GtkApplication    *application);
94
GDK_AVAILABLE_IN_3_4
95
void             gtk_application_set_app_menu  (GtkApplication    *application,
96
                                                GMenuModel        *app_menu);
97

98
GDK_AVAILABLE_IN_3_4
99
GMenuModel *     gtk_application_get_menubar   (GtkApplication    *application);
100
GDK_AVAILABLE_IN_3_4
101
void             gtk_application_set_menubar   (GtkApplication    *application,
102
                                                GMenuModel        *menubar);
103

104
GDK_DEPRECATED_IN_3_14_FOR(gtk_application_set_accels_for_action)
105 106 107 108
void             gtk_application_add_accelerator    (GtkApplication  *application,
                                                     const gchar     *accelerator,
                                                     const gchar     *action_name,
                                                     GVariant        *parameter);
109 110

GDK_DEPRECATED_IN_3_14_FOR(gtk_application_set_accels_for_action)
111 112 113
void             gtk_application_remove_accelerator (GtkApplication *application,
                                                     const gchar    *action_name,
                                                     GVariant       *parameter);
114

115 116 117 118 119 120 121 122
typedef enum
{
  GTK_APPLICATION_INHIBIT_LOGOUT  = (1 << 0),
  GTK_APPLICATION_INHIBIT_SWITCH  = (1 << 1),
  GTK_APPLICATION_INHIBIT_SUSPEND = (1 << 2),
  GTK_APPLICATION_INHIBIT_IDLE    = (1 << 3)
} GtkApplicationInhibitFlags;

123
GDK_AVAILABLE_IN_3_4
124 125 126 127
guint            gtk_application_inhibit            (GtkApplication             *application,
                                                     GtkWindow                  *window,
                                                     GtkApplicationInhibitFlags  flags,
                                                     const gchar                *reason);
128
GDK_AVAILABLE_IN_3_4
129 130
void             gtk_application_uninhibit          (GtkApplication             *application,
                                                     guint                       cookie);
131
GDK_AVAILABLE_IN_3_4
132 133 134
gboolean         gtk_application_is_inhibited       (GtkApplication             *application,
                                                     GtkApplicationInhibitFlags  flags);

135 136 137 138
GDK_AVAILABLE_IN_3_6
GtkWindow *      gtk_application_get_window_by_id   (GtkApplication             *application,
                                                     guint                       id);

139 140 141
GDK_AVAILABLE_IN_3_6
GtkWindow *      gtk_application_get_active_window  (GtkApplication             *application);

Matthias Clasen's avatar
Matthias Clasen committed
142
GDK_AVAILABLE_IN_3_12
143 144
gchar **         gtk_application_list_action_descriptions        (GtkApplication       *application);

Matthias Clasen's avatar
Matthias Clasen committed
145
GDK_AVAILABLE_IN_3_12
146 147
gchar **         gtk_application_get_accels_for_action           (GtkApplication       *application,
                                                                  const gchar          *detailed_action_name);
148 149 150 151
GDK_AVAILABLE_IN_3_14
gchar **         gtk_application_get_actions_for_accel           (GtkApplication       *application,
                                                                  const gchar          *accel);

152

Matthias Clasen's avatar
Matthias Clasen committed
153
GDK_AVAILABLE_IN_3_12
154 155 156 157
void             gtk_application_set_accels_for_action           (GtkApplication       *application,
                                                                  const gchar          *detailed_action_name,
                                                                  const gchar * const  *accels);

158 159 160
GDK_AVAILABLE_IN_3_14
gboolean         gtk_application_prefers_app_menu                (GtkApplication       *application);

161 162 163 164
GDK_AVAILABLE_IN_3_14
GMenu *          gtk_application_get_menu_by_id                  (GtkApplication       *application,
                                                                  const gchar          *id);

Matthias Clasen's avatar
Matthias Clasen committed
165 166 167
G_END_DECLS

#endif /* __GTK_APPLICATION_H__ */