aboutsummaryrefslogtreecommitdiff
path: root/src/include/gnunetgtk_common.h
blob: 4f139f5991255fb77e637ed7997d1989fc4ab35e (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
/*
     This file is part of GNUnet
     (C) 2005, 2006 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 GTKUI_HELPER_H
#define GTKUI_HELPER_H

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

#define DEBUG_GTK 0

#if DEBUG_GTK
#define DEBUG_BEGIN() fprintf(stderr, "BEGIN of %s\n", __FUNCTION__)
#define DEBUG_MARK() fprintf(stderr, "AT %s:%d\n", __FILE__, __LINE__)
#define DEBUG_END() fprintf(stderr, "END of %s\n", __FUNCTION__)
#else
#define DEBUG_BEGIN()
#define DEBUG_MARK()
#define DEBUG_END()
#endif

void initGNUnetGTKCommon(struct GE_Context * ectx,
			 struct GC_Configuration * cfg,
			 void * callback);

void shutdownPlugins(void);

void doneGNUnetGTKCommon(void);

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

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

/**
 * Appends a message to the info window
 * @param doPopup if YES, the info window will
 *   be opened
 */
void infoMessage(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 addLogEntry(const char * txt, ...);
	
/**
 * 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 * gtkSaveCall(PThreadMain 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 * run_with_save_calls(PThreadMain cb,
			   void * arg);

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

#define NOTIFY_LOW 0
#define NOTIFY_NORMAL 1
#define NOTIFY_CRITICAL 2

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

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

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

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

void gnunet_gtk_main_quit();

/**
* Start gnunet-setup, asking for a password if needed
* @param run_wizard TRUE to run the wizard, FALSE to run the complete tool
* @returns FALSE if gnunet-setup was run, TRUE else
*/
gboolean startGNUnetSetup (gboolean run_wizard);

#endif