1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/gtk/utilsgtk.cpp
4 // Author: Robert Roebling
6 // Copyright: (c) 1998 Robert Roebling
7 // Licence: wxWindows licence
8 /////////////////////////////////////////////////////////////////////////////
10 // For compilers that support precompilation, includes "wx.h".
11 #include "wx/wxprec.h"
16 #include "wx/string.h"
21 #include "wx/apptrait.h"
22 #include "wx/process.h"
23 #include "wx/sysopt.h"
24 #include "wx/unix/execute.h"
26 #include "wx/gtk/private/timer.h"
27 #include "wx/evtloop.h"
30 #include "wx/gtk/assertdlg_gtk.h"
32 #include "wx/stackwalk.h"
33 #endif // wxUSE_STACKWALKER
39 #include <sys/types.h>
40 #include <sys/wait.h> // for WNOHANG
48 #ifdef HAVE_X11_XKBLIB_H
49 /* under HP-UX and Solaris 2.6, at least, XKBlib.h defines structures with
50 * field named "explicit" - which is, of course, an error for a C++
51 * compiler. To be on the safe side, just redefine it everywhere. */
52 #define explicit __wx_explicit
54 #include "X11/XKBlib.h"
57 #endif // HAVE_X11_XKBLIB_H
62 #include "X11/SM/SMlib.h"
65 //-----------------------------------------------------------------------------
67 //-----------------------------------------------------------------------------
69 extern GtkWidget
*wxGetRootWindow();
71 //----------------------------------------------------------------------------
73 //----------------------------------------------------------------------------
75 // on OS/2, we use the wxBell from wxBase library
83 /* Don't synthesize KeyUp events holding down a key and producing
84 KeyDown events with autorepeat. */
85 #ifdef HAVE_X11_XKBLIB_H
86 bool wxSetDetectableAutoRepeat( bool flag
)
89 XkbSetDetectableAutoRepeat( GDK_DISPLAY(), flag
, &result
);
90 return result
; /* true if keyboard hardware supports this mode */
93 bool wxSetDetectableAutoRepeat( bool WXUNUSED(flag
) )
99 // ----------------------------------------------------------------------------
100 // display characterstics
101 // ----------------------------------------------------------------------------
105 return GDK_DISPLAY();
108 void wxDisplaySize( int *width
, int *height
)
110 if (width
) *width
= gdk_screen_width();
111 if (height
) *height
= gdk_screen_height();
114 void wxDisplaySizeMM( int *width
, int *height
)
116 if (width
) *width
= gdk_screen_width_mm();
117 if (height
) *height
= gdk_screen_height_mm();
120 void wxGetMousePosition( int* x
, int* y
)
122 gdk_window_get_pointer( (GdkWindow
*) NULL
, x
, y
, (GdkModifierType
*) NULL
);
125 bool wxColourDisplay()
132 return gdk_drawable_get_visual( wxGetRootWindow()->window
)->depth
;
135 wxWindow
* wxFindWindowAtPoint(const wxPoint
& pt
)
137 return wxGenericFindWindowAtPoint(pt
);
142 WXDLLIMPEXP_CORE wxCharBuffer
143 wxConvertToGTK(const wxString
& s
, wxFontEncoding enc
)
146 if ( enc
== wxFONTENCODING_SYSTEM
|| enc
== wxFONTENCODING_DEFAULT
)
148 wbuf
= wxConvUI
->cMB2WC(s
.c_str());
150 else // another encoding, use generic conversion class
152 wbuf
= wxCSConv(enc
).cMB2WC(s
.c_str());
155 if ( !wbuf
&& !s
.empty() )
157 // conversion failed, but we still want to show something to the user
158 // even if it's going to be wrong it is better than nothing
160 // we choose ISO8859-1 here arbitrarily, it's just the most common
161 // encoding probably and, also importantly here, conversion from it
162 // never fails as it's done internally by wxCSConv
163 wbuf
= wxCSConv(wxFONTENCODING_ISO8859_1
).cMB2WC(s
.c_str());
166 return wxConvUTF8
.cWC2MB(wbuf
);
169 WXDLLIMPEXP_CORE wxCharBuffer
170 wxConvertFromGTK(const wxString
& s
, wxFontEncoding enc
)
172 // this conversion should never fail as GTK+ always uses UTF-8 internally
173 // so there are no complications here
174 const wxWCharBuffer
wbuf(wxConvUTF8
.cMB2WC(s
.c_str()));
175 if ( enc
== wxFONTENCODING_SYSTEM
)
176 return wxConvUI
->cWC2MB(wbuf
);
178 return wxCSConv(enc
).cWC2MB(wbuf
);
181 #endif // !wxUSE_UNICODE
183 // Returns NULL if version is certainly greater or equal than major.minor.micro
184 // Returns string describing the error if version is lower than
185 // major.minor.micro OR it cannot be determined and one should not rely on the
186 // availability of pango version major.minor.micro, nor the non-availability
187 const gchar
*wx_pango_version_check (int major
, int minor
, int micro
)
189 #ifdef PANGO_VERSION_MAJOR
190 if (!gtk_check_version (2,11,0))
192 // GTK+ 2.11 requires Pango >= 1.15.3 and pango_version_check
193 // was added in Pango 1.15.2 thus we know for sure the pango lib we're
194 // using has the pango_version_check function:
195 return pango_version_check (major
, minor
, micro
);
198 return "can't check";
199 #else // !PANGO_VERSION_MAJOR
204 return "too old headers";
209 // ----------------------------------------------------------------------------
210 // subprocess routines
211 // ----------------------------------------------------------------------------
215 void GTK_EndProcessDetector(gpointer data
, gint source
,
216 GdkInputCondition
WXUNUSED(condition
) )
218 wxEndProcessData
*proc_data
= (wxEndProcessData
*)data
;
220 // has the process really terminated? unfortunately GDK (or GLib) seem to
221 // generate G_IO_HUP notification even when it simply tries to read from a
222 // closed fd and hasn't terminated at all
223 int pid
= (proc_data
->pid
> 0) ? proc_data
->pid
: -(proc_data
->pid
);
225 int rc
= waitpid(pid
, &status
, WNOHANG
);
229 // This can only happen if the child application closes our dummy
230 // pipe that is used to monitor its lifetime; in that case, our
231 // best bet is to pretend the process did terminate, because
232 // otherwise wxExecute() would hang indefinitely
233 // (OnExceptionWaiting() won't be called again, the descriptor
235 wxLogDebug("Child process (PID %i) still alive, even though notification was received that it terminated.", pid
);
239 // As above, if waitpid() fails, the best we can do is to log the
240 // error and pretend the child terminated:
241 wxLogSysError(_("Failed to check child process' status"));
244 // set exit code to -1 if something bad happened
245 proc_data
->exitcode
= (rc
> 0 && WIFEXITED(status
))
246 ? WEXITSTATUS(status
)
249 // child exited, end waiting
252 // don't call us again!
253 gdk_input_remove(proc_data
->tag
);
255 wxHandleProcessTermination(proc_data
);
259 int wxGUIAppTraits::AddProcessCallback(wxEndProcessData
*proc_data
, int fd
)
261 int tag
= gdk_input_add(fd
,
263 GTK_EndProcessDetector
,
264 (gpointer
)proc_data
);
271 // ----------------------------------------------------------------------------
272 // wxPlatformInfo-related
273 // ----------------------------------------------------------------------------
275 wxPortId
wxGUIAppTraits::GetToolkitVersion(int *verMaj
, int *verMin
) const
278 *verMaj
= gtk_major_version
;
280 *verMin
= gtk_minor_version
;
287 wxTimerImpl
*wxGUIAppTraits::CreateTimerImpl(wxTimer
*timer
)
289 return new wxGTKTimerImpl(timer
);
292 #endif // wxUSE_TIMER
295 static wxString
GetSM()
300 Dpy() { m_dpy
= XOpenDisplay(NULL
); }
301 ~Dpy() { if ( m_dpy
) XCloseDisplay(m_dpy
); }
303 operator Display
*() const { return m_dpy
; }
309 return wxEmptyString
;
313 SmcConn smc_conn
= SmcOpenConnection(NULL
, NULL
,
315 0 /* mask */, NULL
/* callbacks */,
317 WXSIZEOF(smerr
), smerr
);
321 wxLogWarning(_("Failed to connect to session manager: %s"), smerr
);
322 return wxEmptyString
;
325 char *vendor
= SmcVendor(smc_conn
);
326 wxString ret
= wxString::FromAscii( vendor
);
329 SmcCloseConnection(smc_conn
, 0, NULL
);
334 #endif // wxUSE_DETECT_SM
337 //-----------------------------------------------------------------------------
339 //-----------------------------------------------------------------------------
341 wxEventLoopBase
*wxGUIAppTraits::CreateEventLoop()
343 return new wxEventLoop();
348 void wxGUIAppTraits::SetLocale()
351 wxUpdateLocaleIsUtf8();
357 #if wxUSE_STACKWALKER
359 // private helper class
360 class StackDump
: public wxStackWalker
363 StackDump(GtkAssertDialog
*dlg
) { m_dlg
=dlg
; }
366 virtual void OnStackFrame(const wxStackFrame
& frame
)
368 wxString fncname
= frame
.GetName();
369 wxString fncargs
= fncname
;
371 size_t n
= fncname
.find(wxT('('));
372 if (n
!= wxString::npos
)
374 // remove arguments from function name
377 // remove function name and brackets from arguments
378 fncargs
= fncargs
.substr(n
+1, fncargs
.length()-n
-2);
381 fncargs
= wxEmptyString
;
383 // append this stack frame's info in the dialog
384 if (!frame
.GetFileName().empty() || !fncname
.empty())
385 gtk_assert_dialog_append_stack_frame(m_dlg
,
388 frame
.GetFileName().mb_str(),
393 GtkAssertDialog
*m_dlg
;
396 // the callback functions must be extern "C" to comply with GTK+ declarations
399 void get_stackframe_callback(StackDump
*dump
)
401 // skip over frames up to including wxOnAssert()
402 dump
->ProcessFrames(3);
406 #endif // wxUSE_STACKWALKER
408 bool wxGUIAppTraits::ShowAssertDialog(const wxString
& msg
)
410 // under GTK2 we prefer to use a dialog widget written using directly GTK+;
411 // in fact we cannot use a dialog written using wxWidgets: it would need
412 // the wxWidgets idle processing to work correctly!
413 GtkWidget
*dialog
= gtk_assert_dialog_new();
414 gtk_assert_dialog_set_message(GTK_ASSERT_DIALOG(dialog
), msg
.mb_str());
416 #if wxUSE_STACKWALKER
417 // don't show more than maxLines or we could get a dialog too tall to be
418 // shown on screen: 20 should be ok everywhere as even with 15 pixel high
419 // characters it is still only 300 pixels...
420 static const int maxLines
= 20;
422 // save current stack frame...
423 StackDump
dump(GTK_ASSERT_DIALOG(dialog
));
424 dump
.SaveStack(maxLines
);
426 // ...but process it only if the user needs it
427 gtk_assert_dialog_set_backtrace_callback(GTK_ASSERT_DIALOG(dialog
),
428 (GtkAssertDialogStackFrameCallback
)get_stackframe_callback
,
430 #endif // wxUSE_STACKWALKER
432 gint result
= gtk_dialog_run(GTK_DIALOG (dialog
));
433 bool returnCode
= false;
436 case GTK_ASSERT_DIALOG_STOP
:
439 case GTK_ASSERT_DIALOG_CONTINUE
:
442 case GTK_ASSERT_DIALOG_CONTINUE_SUPPRESSING
:
448 wxFAIL_MSG( _T("unexpected return code from GtkAssertDialog") );
451 gtk_widget_destroy(dialog
);
455 #endif // __WXDEBUG__
457 wxString
wxGUIAppTraits::GetDesktopEnvironment() const
459 wxString de
= wxSystemOptions::GetOption(_T("gtk.desktop"));
463 static const wxString s_SM
= GetSM();
465 if (s_SM
== wxT("GnomeSM"))
467 else if (s_SM
== wxT("KDE"))
470 #endif // wxUSE_DETECT_SM
477 // see the hack below in wxCmdLineParser::GetUsageString().
478 // TODO: replace this hack with a g_option_group_get_entries()
479 // call as soon as such function exists
484 gchar
*help_description
;
486 GDestroyNotify destroy_notify
;
489 GTranslateFunc translate_func
;
490 GDestroyNotify translate_notify
;
491 gpointer translate_data
;
493 GOptionEntry
*entries
;
496 GOptionParseFunc pre_parse_func
;
497 GOptionParseFunc post_parse_func
;
498 GOptionErrorFunc error_func
;
501 wxString
wxGetNameFromGtkOptionEntry(const GOptionEntry
*opt
)
506 ret
<< _T("-") << opt
->short_name
;
511 ret
<< _T("--") << opt
->long_name
;
513 if (opt
->arg_description
)
514 ret
<< _T("=") << opt
->arg_description
;
517 return _T(" ") + ret
;
520 #endif // __WXGTK26__
523 wxGUIAppTraits::GetStandardCmdLineOptions(wxArrayString
& names
,
524 wxArrayString
& desc
) const
529 // check whether GTK version is greater than 2.6 but also lower than 2.12
530 // because, as we use the undocumented _GOptionGroup struct, we don't want
531 // to run this code with future versions which might change it (2.11 is the
532 // latest one at the time of this writing)
533 if (!gtk_check_version(2,6,0) &&
534 gtk_check_version(2,12,0))
536 usage
<< _("The following standard GTK+ options are also supported:\n");
538 // passing true here means that the function can open the default
539 // display while parsing (not really used here anyhow)
540 GOptionGroup
*gtkOpts
= gtk_get_option_group(true);
542 // WARNING: here we access the internals of GOptionGroup:
543 GOptionEntry
*entries
= ((_GOptionGroup
*)gtkOpts
)->entries
;
544 unsigned int n_entries
= ((_GOptionGroup
*)gtkOpts
)->n_entries
;
545 wxArrayString namesOptions
, descOptions
;
547 for ( size_t n
= 0; n
< n_entries
; n
++ )
549 if ( entries
[n
].flags
& G_OPTION_FLAG_HIDDEN
)
552 names
.push_back(wxGetNameFromGtkOptionEntry(&entries
[n
]));
554 const gchar
* const entryDesc
= entries
[n
].description
;
555 desc
.push_back(wxString(entryDesc
));
558 g_option_group_free (gtkOpts
);
563 #endif // __WXGTK26__