]> git.saurik.com Git - wxWidgets.git/blob - src/gtk/app.cpp
document On{Open,Save}Document()
[wxWidgets.git] / src / gtk / app.cpp
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/gtk/app.cpp
3 // Purpose:
4 // Author: Robert Roebling
5 // Id: $Id$
6 // Copyright: (c) 1998 Robert Roebling, Julian Smart
7 // Licence: wxWindows licence
8 /////////////////////////////////////////////////////////////////////////////
9
10 // For compilers that support precompilation, includes "wx.h".
11 #include "wx/wxprec.h"
12
13 #include "wx/app.h"
14
15 #ifndef WX_PRECOMP
16 #include "wx/intl.h"
17 #include "wx/log.h"
18 #include "wx/utils.h"
19 #include "wx/memory.h"
20 #include "wx/font.h"
21 #endif
22
23 #include "wx/thread.h"
24
25 #ifdef __WXGPE__
26 #include <gpe/init.h>
27 #endif
28
29 #include "wx/gtk/private.h"
30 #include "wx/apptrait.h"
31
32 #if wxUSE_LIBHILDON
33 #include <hildon-widgets/hildon-program.h>
34 #endif // wxUSE_LIBHILDON
35
36 #include <gdk/gdkx.h>
37
38 //-----------------------------------------------------------------------------
39 // link GnomeVFS
40 //-----------------------------------------------------------------------------
41
42 #if wxUSE_MIMETYPE && wxUSE_LIBGNOMEVFS
43 #include "wx/link.h"
44 wxFORCE_LINK_MODULE(gnome_vfs)
45 #endif
46
47 //-----------------------------------------------------------------------------
48 // global data
49 //-----------------------------------------------------------------------------
50
51 static GtkWidget *gs_RootWindow = (GtkWidget*) NULL;
52
53 //-----------------------------------------------------------------------------
54 // wxYield
55 //-----------------------------------------------------------------------------
56
57 // not static because used by textctrl.cpp
58 //
59 // MT-FIXME
60 bool wxIsInsideYield = false;
61
62 bool wxApp::Yield(bool onlyIfNeeded)
63 {
64 if ( wxIsInsideYield )
65 {
66 if ( !onlyIfNeeded )
67 {
68 wxFAIL_MSG( wxT("wxYield called recursively" ) );
69 }
70
71 return false;
72 }
73
74 #if wxUSE_THREADS
75 if ( !wxThread::IsMain() )
76 {
77 // can't call gtk_main_iteration() from other threads like this
78 return true;
79 }
80 #endif // wxUSE_THREADS
81
82 wxIsInsideYield = true;
83
84 #if wxUSE_LOG
85 // disable log flushing from here because a call to wxYield() shouldn't
86 // normally result in message boxes popping up &c
87 wxLog::Suspend();
88 #endif
89
90 while (EventsPending())
91 gtk_main_iteration();
92
93 // It's necessary to call ProcessIdle() to update the frames sizes which
94 // might have been changed (it also will update other things set from
95 // OnUpdateUI() which is a nice (and desired) side effect). But we
96 // call ProcessIdle() only once since this is not meant for longish
97 // background jobs (controlled by wxIdleEvent::RequestMore() and the
98 // return value of Processidle().
99 ProcessIdle();
100
101 #if wxUSE_LOG
102 // let the logs be flashed again
103 wxLog::Resume();
104 #endif
105
106 wxIsInsideYield = false;
107
108 return true;
109 }
110
111 //-----------------------------------------------------------------------------
112 // local functions
113 //-----------------------------------------------------------------------------
114
115 // One-shot signal emission hook, to install idle handler.
116 extern "C" {
117 static gboolean
118 wx_emission_hook(GSignalInvocationHint*, guint, const GValue*, gpointer data)
119 {
120 wxApp* app = wxTheApp;
121 if (app != NULL)
122 app->WakeUpIdle();
123 gulong* hook_id = (gulong*)data;
124 // record that hook is not installed
125 *hook_id = 0;
126 // remove hook
127 return false;
128 }
129 }
130
131 // Add signal emission hooks, to re-install idle handler when needed.
132 static void wx_add_idle_hooks()
133 {
134 // "event" hook
135 {
136 static gulong hook_id = 0;
137 if (hook_id == 0)
138 {
139 static guint sig_id = 0;
140 if (sig_id == 0)
141 sig_id = g_signal_lookup("event", GTK_TYPE_WIDGET);
142 hook_id = g_signal_add_emission_hook(
143 sig_id, 0, wx_emission_hook, &hook_id, NULL);
144 }
145 }
146 // "size_allocate" hook
147 // Needed to match the behavior of the old idle system,
148 // but probably not necessary.
149 {
150 static gulong hook_id = 0;
151 if (hook_id == 0)
152 {
153 static guint sig_id = 0;
154 if (sig_id == 0)
155 sig_id = g_signal_lookup("size_allocate", GTK_TYPE_WIDGET);
156 hook_id = g_signal_add_emission_hook(
157 sig_id, 0, wx_emission_hook, &hook_id, NULL);
158 }
159 }
160 }
161
162 extern "C" {
163 static gboolean wxapp_idle_callback(gpointer)
164 {
165 return wxTheApp->DoIdle();
166 }
167 }
168
169 bool wxApp::DoIdle()
170 {
171 guint id_save;
172 {
173 // Allow another idle source to be added while this one is busy.
174 // Needed if an idle event handler runs a new event loop,
175 // for example by showing a dialog.
176 #if wxUSE_THREADS
177 wxMutexLocker lock(*m_idleMutex);
178 #endif
179 id_save = m_idleSourceId;
180 m_idleSourceId = 0;
181 wx_add_idle_hooks();
182 #ifdef __WXDEBUG__
183 // don't generate the idle events while the assert modal dialog is shown,
184 // this matches the behavior of wxMSW
185 if (m_isInAssert)
186 return false;
187 #endif
188 }
189
190 gdk_threads_enter();
191 bool needMore;
192 do {
193 needMore = ProcessIdle();
194 } while (needMore && gtk_events_pending() == 0);
195 gdk_threads_leave();
196
197 #if wxUSE_THREADS
198 wxMutexLocker lock(*m_idleMutex);
199 #endif
200 // if a new idle source was added during ProcessIdle
201 if (m_idleSourceId != 0)
202 {
203 // remove it
204 g_source_remove(m_idleSourceId);
205 m_idleSourceId = 0;
206 }
207
208 // Pending events can be added asynchronously,
209 // need to keep idle source if any have appeared
210 needMore = needMore || HasPendingEvents();
211
212 // if more idle processing requested
213 if (needMore)
214 {
215 // keep this source installed
216 m_idleSourceId = id_save;
217 return true;
218 }
219 // add hooks and remove this source
220 wx_add_idle_hooks();
221 return false;
222 }
223
224 //-----------------------------------------------------------------------------
225 // Access to the root window global
226 //-----------------------------------------------------------------------------
227
228 GtkWidget* wxGetRootWindow()
229 {
230 if (gs_RootWindow == NULL)
231 {
232 gs_RootWindow = gtk_window_new( GTK_WINDOW_TOPLEVEL );
233 gtk_widget_realize( gs_RootWindow );
234 }
235 return gs_RootWindow;
236 }
237
238 //-----------------------------------------------------------------------------
239 // wxApp
240 //-----------------------------------------------------------------------------
241
242 IMPLEMENT_DYNAMIC_CLASS(wxApp,wxEvtHandler)
243
244 wxApp::wxApp()
245 {
246 #ifdef __WXDEBUG__
247 m_isInAssert = false;
248 #endif // __WXDEBUG__
249 #if wxUSE_THREADS
250 m_idleMutex = NULL;
251 #endif
252 m_idleSourceId = 0;
253 }
254
255 wxApp::~wxApp()
256 {
257 }
258
259 bool wxApp::SetNativeTheme(const wxString& theme)
260 {
261 wxString path;
262 path = gtk_rc_get_theme_dir();
263 path += "/";
264 path += theme.utf8_str();
265 path += "/gtk-2.0/gtkrc";
266
267 if ( wxFileExists(path.utf8_str()) )
268 gtk_rc_add_default_file(path.utf8_str());
269 else if ( wxFileExists(theme.utf8_str()) )
270 gtk_rc_add_default_file(theme.utf8_str());
271 else
272 {
273 wxLogWarning("Theme \"%s\" not available.", theme);
274
275 return false;
276 }
277
278 gtk_rc_reparse_all_for_settings(gtk_settings_get_default(), TRUE);
279
280 return true;
281 }
282
283 bool wxApp::OnInitGui()
284 {
285 if ( !wxAppBase::OnInitGui() )
286 return false;
287
288 // if this is a wxGLApp (derived from wxApp), and we've already
289 // chosen a specific visual, then derive the GdkVisual from that
290 if ( GetXVisualInfo() )
291 {
292 GdkVisual* vis = gtk_widget_get_default_visual();
293
294 GdkColormap *colormap = gdk_colormap_new( vis, FALSE );
295 gtk_widget_set_default_colormap( colormap );
296 }
297 else
298 {
299 // On some machines, the default visual is just 256 colours, so
300 // we make sure we get the best. This can sometimes be wasteful.
301 if (m_useBestVisual)
302 {
303 if (m_forceTrueColour)
304 {
305 GdkVisual* visual = gdk_visual_get_best_with_both( 24, GDK_VISUAL_TRUE_COLOR );
306 if (!visual)
307 {
308 wxLogError(wxT("Unable to initialize TrueColor visual."));
309 return false;
310 }
311 GdkColormap *colormap = gdk_colormap_new( visual, FALSE );
312 gtk_widget_set_default_colormap( colormap );
313 }
314 else
315 {
316 if (gdk_visual_get_best() != gdk_visual_get_system())
317 {
318 GdkVisual* visual = gdk_visual_get_best();
319 GdkColormap *colormap = gdk_colormap_new( visual, FALSE );
320 gtk_widget_set_default_colormap( colormap );
321 }
322 }
323 }
324 }
325
326 #if wxUSE_LIBHILDON
327 m_hildonProgram = hildon_program_get_instance();
328 if ( !m_hildonProgram )
329 {
330 wxLogError(_("Unable to initialize Hildon program"));
331 return false;
332 }
333 #endif // wxUSE_LIBHILDON
334
335 return true;
336 }
337
338 GdkVisual *wxApp::GetGdkVisual()
339 {
340 GdkVisual *visual = NULL;
341
342 XVisualInfo *xvi = (XVisualInfo *)GetXVisualInfo();
343 if ( xvi )
344 visual = gdkx_visual_get( xvi->visualid );
345 else
346 visual = gdk_drawable_get_visual( wxGetRootWindow()->window );
347
348 wxASSERT( visual );
349
350 return visual;
351 }
352
353 // use unusual names for the parameters to avoid conflict with wxApp::arg[cv]
354 bool wxApp::Initialize(int& argc_, wxChar **argv_)
355 {
356 if ( !wxAppBase::Initialize(argc_, argv_) )
357 return false;
358
359 #if wxUSE_THREADS
360 if (!g_thread_supported())
361 {
362 g_thread_init(NULL);
363 gdk_threads_init();
364 }
365 #endif // wxUSE_THREADS
366
367 // We should have the wxUSE_WCHAR_T test on the _outside_
368 #if wxUSE_WCHAR_T
369 // gtk+ 2.0 supports Unicode through UTF-8 strings
370 wxConvCurrent = &wxConvUTF8;
371 #else // !wxUSE_WCHAR_T
372 if (!wxOKlibc())
373 wxConvCurrent = (wxMBConv*) NULL;
374 #endif // wxUSE_WCHAR_T/!wxUSE_WCHAR_T
375
376 // decide which conversion to use for the file names
377
378 // (1) this variable exists for the sole purpose of specifying the encoding
379 // of the filenames for GTK+ programs, so use it if it is set
380 wxString encName(wxGetenv(_T("G_FILENAME_ENCODING")));
381 encName = encName.BeforeFirst(_T(','));
382 if (encName.CmpNoCase(_T("@locale")) == 0)
383 encName.clear();
384 encName.MakeUpper();
385 #if wxUSE_INTL
386 if (encName.empty())
387 {
388 // (2) if a non default locale is set, assume that the user wants his
389 // filenames in this locale too
390 encName = wxLocale::GetSystemEncodingName().Upper();
391 // (3) finally use UTF-8 by default
392 if (encName.empty() || encName == _T("US-ASCII"))
393 encName = _T("UTF-8");
394 wxSetEnv(_T("G_FILENAME_ENCODING"), encName);
395 }
396 #else
397 if (encName.empty())
398 encName = _T("UTF-8");
399
400 // if wxUSE_INTL==0 it probably indicates that only "C" locale is supported
401 // by the program anyhow so prevent GTK+ from calling setlocale(LC_ALL, "")
402 // from gtk_init_check() as it does by default
403 gtk_disable_setlocale();
404
405 #endif // wxUSE_INTL
406 static wxConvBrokenFileNames fileconv(encName);
407 wxConvFileName = &fileconv;
408
409
410 bool init_result;
411 int i;
412
413 #if wxUSE_UNICODE
414 // gtk_init() wants UTF-8, not wchar_t, so convert
415 char **argvGTK = new char *[argc_ + 1];
416 for ( i = 0; i < argc_; i++ )
417 {
418 argvGTK[i] = wxStrdupA(wxConvUTF8.cWX2MB(argv_[i]));
419 }
420
421 argvGTK[argc_] = NULL;
422
423 int argcGTK = argc_;
424
425 #ifdef __WXGPE__
426 init_result = true; // is there a _check() version of this?
427 gpe_application_init( &argcGTK, &argvGTK );
428 #else
429 init_result = gtk_init_check( &argcGTK, &argvGTK );
430 #endif
431 wxUpdateLocaleIsUtf8();
432
433 if ( argcGTK != argc_ )
434 {
435 // we have to drop the parameters which were consumed by GTK+
436 for ( i = 0; i < argcGTK; i++ )
437 {
438 while ( strcmp(wxConvUTF8.cWX2MB(argv_[i]), argvGTK[i]) != 0 )
439 {
440 memmove(argv_ + i, argv_ + i + 1, (argc_ - i)*sizeof(*argv_));
441 }
442 }
443
444 argc_ = argcGTK;
445 argv_[argc_] = NULL;
446 }
447 //else: gtk_init() didn't modify our parameters
448
449 // free our copy
450 for ( i = 0; i < argcGTK; i++ )
451 {
452 free(argvGTK[i]);
453 }
454
455 delete [] argvGTK;
456 #else // !wxUSE_UNICODE
457 // gtk_init() shouldn't actually change argv_ itself (just its contents) so
458 // it's ok to pass pointer to it
459 init_result = gtk_init_check( &argc_, &argv_ );
460 #endif // wxUSE_UNICODE/!wxUSE_UNICODE
461
462 // update internal arg[cv] as GTK+ may have removed processed options:
463 this->argc = argc_;
464 this->argv = argv_;
465
466 if ( m_traits )
467 {
468 // if there are still GTK+ standard options unparsed in the command
469 // line, it means that they were not syntactically correct and GTK+
470 // already printed a warning on the command line and we should now
471 // exit:
472 wxArrayString opt, desc;
473 m_traits->GetStandardCmdLineOptions(opt, desc);
474
475 for ( i = 0; i < argc_; i++ )
476 {
477 // leave just the names of the options with values
478 const wxString str = wxString(argv_[i]).BeforeFirst('=');
479
480 for ( size_t j = 0; j < opt.size(); j++ )
481 {
482 // remove the leading spaces from the option string as it does
483 // have them
484 if ( opt[j].Trim(false).BeforeFirst('=') == str )
485 {
486 // a GTK+ option can be left on the command line only if
487 // there was an error in (or before, in another standard
488 // options) it, so abort, just as we do if incorrect
489 // program option is given
490 wxLogError(_("Invalid GTK+ command line option, use \"%s --help\""),
491 argv_[0]);
492 return false;
493 }
494 }
495 }
496 }
497
498 if ( !init_result )
499 {
500 wxLogError(_("Unable to initialize GTK+, is DISPLAY set properly?"));
501 return false;
502 }
503
504 // we can not enter threads before gtk_init is done
505 gdk_threads_enter();
506
507 wxSetDetectableAutoRepeat( true );
508
509 #if wxUSE_INTL
510 wxFont::SetDefaultEncoding(wxLocale::GetSystemEncoding());
511 #endif
512
513 #if wxUSE_THREADS
514 m_idleMutex = new wxMutex;
515 #endif
516 // make sure GtkWidget type is loaded, idle hooks need it
517 g_type_class_ref(GTK_TYPE_WIDGET);
518 WakeUpIdle();
519
520 return true;
521 }
522
523 void wxApp::CleanUp()
524 {
525 if (m_idleSourceId != 0)
526 g_source_remove(m_idleSourceId);
527
528 // release reference acquired by Initialize()
529 g_type_class_unref(g_type_class_peek(GTK_TYPE_WIDGET));
530
531 gdk_threads_leave();
532
533 wxAppBase::CleanUp();
534
535 // delete this mutex as late as possible as it's used from WakeUpIdle(), in
536 // particular do it after calling the base class CleanUp() which can result
537 // in it being called
538 #if wxUSE_THREADS
539 delete m_idleMutex;
540 m_idleMutex = NULL;
541 #endif
542 }
543
544 void wxApp::WakeUpIdle()
545 {
546 #if wxUSE_THREADS
547 wxMutexLocker lock(*m_idleMutex);
548 #endif
549 if (m_idleSourceId == 0)
550 m_idleSourceId = g_idle_add_full(G_PRIORITY_LOW, wxapp_idle_callback, NULL, NULL);
551 }
552
553 // Checking for pending events requires first removing our idle source,
554 // otherwise it will cause the check to always return true.
555 bool wxApp::EventsPending()
556 {
557 #if wxUSE_THREADS
558 wxMutexLocker lock(*m_idleMutex);
559 #endif
560 if (m_idleSourceId != 0)
561 {
562 g_source_remove(m_idleSourceId);
563 m_idleSourceId = 0;
564 wx_add_idle_hooks();
565 }
566 return gtk_events_pending() != 0;
567 }
568
569 #ifdef __WXDEBUG__
570
571 void wxApp::OnAssertFailure(const wxChar *file,
572 int line,
573 const wxChar* func,
574 const wxChar* cond,
575 const wxChar *msg)
576 {
577
578 // block wx idle events while assert dialog is showing
579 m_isInAssert = true;
580
581 wxAppBase::OnAssertFailure(file, line, func, cond, msg);
582
583 m_isInAssert = false;
584 }
585
586 #endif // __WXDEBUG__
587
588 #if wxUSE_THREADS
589 void wxGUIAppTraits::MutexGuiEnter()
590 {
591 gdk_threads_enter();
592 }
593
594 void wxGUIAppTraits::MutexGuiLeave()
595 {
596 gdk_threads_leave();
597 }
598 #endif // wxUSE_THREADS