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
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
|
/*
This file is part of GNUnet.
(C) 2011 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/gnunet_gtk.h
* @brief Helper library for Gtk user interfaces to GNUnet
* @author Christian Grothoff
*/
#ifndef GNUNET_GTK_H
#define GNUNET_GTK_H
#ifndef HAVE_USED_CONFIG_H
#define HAVE_USED_CONFIG_H
#if HAVE_CONFIG_H
#include "gnunet_gtk_config.h"
#endif
#endif
#include <gnunet/platform.h>
#include <gnunet/gnunet_util_lib.h>
#include <gnunet/gnunet_fs_service.h>
#include <extractor.h>
#include <gtk/gtk.h>
#include <gladeui/glade.h>
#include <gdk/gdkkeysyms.h>
#ifndef GDK_KEY_Return
#define GDK_KEY_Return GDK_Return
#endif
/* ****************** Initialization *************** */
/**
* Initialize natural language support.
*/
void
GNUNET_GTK_setup_nls (void);
/**
* Initialize GTK search path for icons.
*/
void
GNUNET_GTK_set_icon_search_path (void);
/**
* Get the name of the directory where all of our package
* data is stored ($PREFIX/share/)
*
* @return name of the data directory
*/
const char *
GNUNET_GTK_get_data_dir (void);
/**
* @brief get the path to a specific GNUnet installation directory or,
* with GNUNET_IPK_SELF_PREFIX, the current running apps installation directory
* @author Milan
* @return a pointer to the dir path (to be freed by the caller)
*/
char *
GNUNET_GTK_installation_get_path (enum GNUNET_OS_InstallationPathKind dirkind);
/* **************** Glade/Gtk helpers *************** */
/**
* Create an initialize a new builder based on the GNUnet-GTK glade
* file.
*
* @param filename name of the resource file to load
* @param user_data user_data to pass to signal handlers,
* use "NULL" to pass the GtkBuilder itself.
* @return NULL on error
*/
GtkBuilder *
GNUNET_GTK_get_new_builder (const char *filename,
void *user_data);
/**
* This displays an about dialog.
*
* @param dialogfile name of the glade file containing the dialog
*/
void
GNUNET_GTK_display_about (const char *dialogfile);
/**
* Obtain a string from a GtkTreeView's model.
*
* @param treeview treeview to inspect
* @param treepath path that identifies the item
* @param column number of the column with the string
* @param value where to store the string
* @return TRUE on success, FALSE on errors
*/
gboolean
GNUNET_GTK_get_tree_string (GtkTreeView *treeview,
GtkTreePath *treepath,
guint column, gchar ** value);
/**
* Create our tray icon.
*
* @param main handle to the main window (show or hide)
* @param icon_name name of the tray icon file
* @param tooltip tooltip for the tray icon
*/
void
GNUNET_GTK_tray_icon_create (GtkWindow * main, const char *icon_name,
const char *tooltip);
/**
* Destroy the tray icon.
*/
void
GNUNET_GTK_tray_icon_destroy (void);
/**
* Convert a string from the current locale to UTF-8.
*
* @param str_loc string in current locale
* @return string in UTF-8, NULL if str_loc was NULL
*/
char *
GNUNET_GTK_from_loc_to_utf8 (const char * str_loc);
/**
* Returns filename form filechooser, encoded in UTF-8.
*
* @param fc file chooser to inspect
* @return selected filename as UTF-8, NULL on errors
*/
char *
GNUNET_GTK_filechooser_get_filename_utf8 (GtkFileChooser * fc);
/* ******************* main loop ***************** */
/**
* Handle for our main loop.
*/
struct GNUNET_GTK_MainLoop;
/**
* Initialize the main loop.
*
* @param binary_name binary name
* @param binary_help help text for the binary
* @param argc number of command line options
* @param argv command line options
* @param options allowed command line options
* @param main_window_file glade file for the main window
* @param main_task first task to run, closure will be set to the 'struct GNUNET_GTK_MainLoop'
* @return GNUNET_OK on success, GNUNET_SYSERR on error (i.e. bad command-line options, etc)
*/
int
GNUNET_GTK_main_loop_start (const char *binary_name, const char *binary_help,
int argc, char *const *argv,
struct GNUNET_GETOPT_CommandLineOption *options,
const char *main_window_file,
GNUNET_SCHEDULER_Task main_task);
/**
* Get an object from the main window.
*
* @param ml handle to the main loop
* @param name name of the object
* @return NULL on error, otherwise the object
*/
GObject *
GNUNET_GTK_main_loop_get_object (struct GNUNET_GTK_MainLoop *ml,
const char *name);
/**
* Obtain the name of the configuration file that is being used.
*
* @param ml handle to the main loop
* @return name of configuration file
*/
const char *
GNUNET_GTK_main_loop_get_configuration_file (struct GNUNET_GTK_MainLoop *ml);
/**
* Get the configuration.
*
* @param ml handle to the main loop
* @return handle to the configuration, never NULL
*/
const struct GNUNET_CONFIGURATION_Handle *
GNUNET_GTK_main_loop_get_configuration (struct GNUNET_GTK_MainLoop *ml);
/**
* Trigger shutdown of the GUI and exit the main loop.
*
* @param ml handle to the main loop
*/
void
GNUNET_GTK_main_loop_quit (struct GNUNET_GTK_MainLoop *ml);
#endif
/* end of gnunet_gtk.h */
|
