aboutsummaryrefslogtreecommitdiff
path: root/src/include/gnunetgtk_common.h
blob: 3b01403b5cc299fe445a2b197288e402e6af4745 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
/*
     This file is part of GNUnet
     (C) 2005, 2006, 2007 Christian Grothoff (and other contributing authors)

     GNUnet is free software; you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published
     by the Free Software Foundation; either version 2, or (at your
     option) any later version.

     GNUnet is distributed in the hope that it will be useful, but
     WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     General Public License for more details.

     You should have received a copy of the GNU General Public License
     along with GNUnet; see the file COPYING.  If not, write to the
     Free Software Foundation, Inc., 59 Temple Place - Suite 330,
     Boston, MA 02111-1307, USA.
*/

/**
 * @file src/include/gnunetgtk_common.h
 * @author Igor Wronsky
 * @author Christian Grothoff
 */

#ifndef GNUNET_GTK_COMMON_H
#define GNUNET_GTK_COMMON_H

#include <gtk/gtk.h>
#include <gtk/gtktext.h>
#include <glade/glade.h>

#define GNUNET_GTK_DEBUG_GTK 0

#if GNUNET_GTK_DEBUG_GTK
#define GNUNET_GTK_DEBUG_BEGIN() fprintf(stderr, "BEGIN of %s\n", __FUNCTION__)
#define GNUNET_GTK_DEBUG_MARK() fprintf(stderr, "AT %s:%d\n", __FILE__, __LINE__)
#define GNUNET_GTK_DEBUG_END() fprintf(stderr, "END of %s\n", __FUNCTION__)
#else
#define GNUNET_GTK_DEBUG_BEGIN()
#define GNUNET_GTK_DEBUG_MARK()
#define GNUNET_GTK_DEBUG_END()
#endif


void GNUNET_GTK_initialize_common_library (struct GNUNET_GE_Context *ectx,
                                           struct GNUNET_GC_Configuration
                                           *cfg, void *callback);

void GNUNET_GTK_shutdown_plugins (void);

void GNUNET_GTK_shutdown_common_library (void);

/**
 * Get the name of the main glade file for gnunet-gtk.
 */
const char *GNUNET_GTK_get_glade_filename (void);

/**
 * Get the GladeXML for the main window of gnunet-gtk.
 */
GladeXML *GNUNET_GTK_get_main_glade_XML (void);

/**
 * Get the GtkStatusIcon for the tray icon (if GTK >= 2.10)
 */
#if GTK_CHECK_VERSION(2,10,0)
GtkStatusIcon *
GNUNET_GTK_get_trayIcon (void);
#endif

/**
 * Appends a message to the info window
 * @param doPopup if GNUNET_YES, the info window will
 *   be opened
 */
void GNUNET_GTK_show_info_message (int doPopup, const char *format, ...);

/**
 * Appends a log entry to the info window
 * and update the statusbar to show this
 * message (until the next call).
 *
 * @param txt the log entry
 */
void GNUNET_GTK_add_log_entry (const char *txt, ...);

struct GNUNET_GE_Context *GNUNET_GTK_create_gtk_logger (GNUNET_GE_KIND mask);

#define GNUNET_GTK_NOTIFY_LEVEL_LOW 0
#define GNUNET_GTK_NOTIFY_LEVEL_NORMAL 1
#define GNUNET_GTK_NOTIFY_LEVEL_CRITICAL 2

/**
 * Sends a message to libnotify
 */
void GNUNET_GTK_notify (int type, const char *message, ...);

/**
 * Call a callback function from the mainloop/main thread ("SaveCall").
 * Since GTK doesn't work with multi-threaded applications under Windows,
 * all GTK operations have to be done in the main thread
 */
void *GNUNET_GTK_save_call (GNUNET_ThreadMainFunction func, void *arg);

/**
 * Run the given "cb" function and save calls
 * in parallel (used within the event loop to
 * keep save calls going while something else
 * happens).
 */
void *GNUNET_GTK_run_with_save_calls (GNUNET_ThreadMainFunction cb,
                                      void *arg);

/**
 * Bind handlers defined by the various
 * plugins to the signals defined by the
 * Glade XML.
 */
void GNUNET_GTK_connect_glade_with_plugins (GladeXML * xml);

/**
 * Validate that a string is a Utf-8 string.
 * If validation fails, msg is freed and a valid
 * Utf-8 string is returned.
 */
char *GNUNET_GTK_validate_utf8 (char *msg);

/**
 * Gtk callback to save the main window state (tray icon use)
 */
void GNUNET_GTK_save_main_window_state (GtkWidget * main_window,
                                        GdkEventWindowState * event,
                                        gpointer user_data);

/**
 * Get the last main window state when restoring (tray icon use)
 */
GdkWindowState GNUNET_GTK_get_main_window_state (void);

void GNUNET_GTK_main_quit (void);

/**
* Start gnunet-setup, asking for a password if needed
* @param conffile path to the gnunetd configuration file
* @param run_wizard TRUE to run the wizard, FALSE to run the complete tool
* @returns FALSE if gnunet-setup was run, TRUE else
*/
gboolean GNUNET_GTK_run_gnunet_setup (char *conffile, gboolean run_wizard);

/**
 * Identical to "gtk_tree_selection_selected_foreach",
 * except that modifications of the underlying model
 * during the iteration are tolerated.
 */
void GNUNET_GTK_tree_selection_selected_foreach (GtkTreeSelection * selection,
                                                 GtkTreeSelectionForeachFunc
                                                 func, gpointer data);

/**
 * Identical to "gtk_tree_model_foreach",
 * except that modifications of the underlying model
 * during the iteration are tolerated.
 */
void GNUNET_GTK_tree_model_foreach (GtkTreeModel * model,
                                    GtkTreeSelectionForeachFunc func,
                                    gpointer data);


struct GNUNET_CronManager *GNUNET_GTK_get_cron_manager (void);

#endif