X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/e3e65dac0c4e7ad19e3c270caa1e0eea138e5d8d..c96d7bec67801a380d029990ad1df5e2c9fc207b:/src/gtk/utilsgtk.cpp diff --git a/src/gtk/utilsgtk.cpp b/src/gtk/utilsgtk.cpp index d829d20532..66bc5b31f1 100644 --- a/src/gtk/utilsgtk.cpp +++ b/src/gtk/utilsgtk.cpp @@ -1,450 +1,590 @@ ///////////////////////////////////////////////////////////////////////////// -// Name: utils.cpp +// Name: src/gtk/utilsgtk.cpp // Purpose: // Author: Robert Roebling -// Created: 01/02/97 -// Id: -// Copyright: (c) 1998 Robert Roebling, Julian Smart and Markus Holzem -// Licence: wxWindows licence +// Id: $Id$ +// Copyright: (c) 1998 Robert Roebling +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// - -//#ifdef __GNUG__ -//#pragma implementation "utils.h" -//#endif +// For compilers that support precompilation, includes "wx.h". +#include "wx/wxprec.h" #include "wx/utils.h" -#include "wx/string.h" + +#ifndef WX_PRECOMP + #include "wx/string.h" + #include "wx/intl.h" + #include "wx/log.h" +#endif + +#include "wx/apptrait.h" +#include "wx/process.h" +#include "wx/sysopt.h" +#include "wx/unix/execute.h" + +#include "wx/gtk/private/timer.h" +#include "wx/evtloop.h" + +#ifdef __WXDEBUG__ + #include "wx/gtk/assertdlg_gtk.h" + #if wxUSE_STACKWALKER + #include "wx/stackwalk.h" + #endif // wxUSE_STACKWALKER +#endif // __WXDEBUG__ #include -#include #include #include #include +#include // for WNOHANG #include -#include -#include -#include -#include -#include - -#ifdef __SVR4__ -#include + +#include "glib.h" +#include "gdk/gdk.h" +#include "gtk/gtk.h" +#include "gdk/gdkx.h" + +#ifdef HAVE_X11_XKBLIB_H + /* under HP-UX and Solaris 2.6, at least, XKBlib.h defines structures with + * field named "explicit" - which is, of course, an error for a C++ + * compiler. To be on the safe side, just redefine it everywhere. */ + #define explicit __wx_explicit + + #include "X11/XKBlib.h" + + #undef explicit +#endif // HAVE_X11_XKBLIB_H + + +#if wxUSE_DETECT_SM + #include "X11/Xlib.h" + #include "X11/SM/SMlib.h" #endif -//------------------------------------------------------------------------ +//----------------------------------------------------------------------------- +// data +//----------------------------------------------------------------------------- + +extern GtkWidget *wxGetRootWindow(); + +//---------------------------------------------------------------------------- // misc. -//------------------------------------------------------------------------ +//---------------------------------------------------------------------------- +#ifndef __EMX__ +// on OS/2, we use the wxBell from wxBase library -void wxBell(void) +void wxBell() { - gdk_beep(); -}; + gdk_beep(); +} +#endif -void wxSleep(int nSecs) +/* Don't synthesize KeyUp events holding down a key and producing + KeyDown events with autorepeat. */ +#ifdef HAVE_X11_XKBLIB_H +bool wxSetDetectableAutoRepeat( bool flag ) { - sleep(nSecs); -}; + Bool result; + XkbSetDetectableAutoRepeat( GDK_DISPLAY(), flag, &result ); + return result; /* true if keyboard hardware supports this mode */ +} +#else +bool wxSetDetectableAutoRepeat( bool WXUNUSED(flag) ) +{ + return false; +} +#endif -int wxKill(long pid, int sig) +// Escapes string so that it is valid Pango markup XML string: +wxString wxEscapeStringForPangoMarkup(const wxString& str) { - return kill(pid, sig); -}; + size_t len = str.length(); + wxString out; + out.Alloc(len); + for (size_t i = 0; i < len; i++) + { + wxChar c = str[i]; + switch (c) + { + case _T('&'): + out << _T("&"); + break; + case _T('<'): + out << _T("<"); + break; + case _T('>'): + out << _T(">"); + break; + case _T('\''): + out << _T("'"); + break; + case _T('"'): + out << _T("""); + break; + default: + out << c; + break; + } + } + return out; +} + + +// ---------------------------------------------------------------------------- +// display characterstics +// ---------------------------------------------------------------------------- + +void *wxGetDisplay() +{ + return GDK_DISPLAY(); +} void wxDisplaySize( int *width, int *height ) { - if (width) *width = gdk_screen_width(); - if (height) *height = gdk_screen_height(); + if (width) *width = gdk_screen_width(); + if (height) *height = gdk_screen_height(); } -//------------------------------------------------------------------------ -// user and home routines -//------------------------------------------------------------------------ +void wxDisplaySizeMM( int *width, int *height ) +{ + if (width) *width = gdk_screen_width_mm(); + if (height) *height = gdk_screen_height_mm(); +} -char* wxGetHomeDir( char *dest ) +void wxGetMousePosition( int* x, int* y ) { - wxString tmp = wxGetUserHome( wxString() ); - if (tmp.IsNull()) - strcpy( wxBuffer, "/" ); - else - strcpy( wxBuffer, tmp ); - if (dest) strcpy( dest, WXSTRINGCAST tmp ); - return wxBuffer; -}; + gdk_window_get_pointer( (GdkWindow*) NULL, x, y, (GdkModifierType*) NULL ); +} -char *wxGetUserHome( const wxString &user ) +bool wxColourDisplay() { - struct passwd *who = NULL; - - if (user.IsNull() || (user== "")) - { - register char *ptr; - - if ((ptr = getenv("HOME")) != NULL) - return ptr; - if ((ptr = getenv("USER")) != NULL - || (ptr = getenv("LOGNAME")) != NULL) { - who = getpwnam(ptr); - } - // We now make sure the the user exists! - if (who == NULL) - who = getpwuid(getuid()); - } - else - who = getpwnam (user); - - return who ? who->pw_dir : (char*)NULL; -}; + return true; +} -//------------------------------------------------------------------------ -// id routines -//------------------------------------------------------------------------ +int wxDisplayDepth() +{ + return gdk_drawable_get_visual( wxGetRootWindow()->window )->depth; +} -bool wxGetHostName(char *buf, int sz) +wxWindow* wxFindWindowAtPoint(const wxPoint& pt) { - *buf = '\0'; -#if defined(__SVR4__) && !defined(__sgi) - return (sysinfo(SI_HOSTNAME, buf, sz) != -1); -#else /* BSD Sockets */ - char name[255]; - struct hostent *h; - // Get hostname - if (gethostname(name, sizeof(name)/sizeof(char)-1) == -1) - return FALSE; - // Get official full name of host - strncpy(buf, (h=gethostbyname(name))!=NULL ? h->h_name : name, sz-1); - return TRUE; -#endif + return wxGenericFindWindowAtPoint(pt); } -bool wxGetUserId(char *buf, int sz) +#if !wxUSE_UNICODE + +WXDLLIMPEXP_CORE wxCharBuffer +wxConvertToGTK(const wxString& s, wxFontEncoding enc) { - struct passwd *who; + wxWCharBuffer wbuf; + if ( enc == wxFONTENCODING_SYSTEM || enc == wxFONTENCODING_DEFAULT ) + { + wbuf = wxConvUI->cMB2WC(s.c_str()); + } + else // another encoding, use generic conversion class + { + wbuf = wxCSConv(enc).cMB2WC(s.c_str()); + } - *buf = '\0'; - if ((who = getpwuid(getuid ())) != NULL) { - strncpy (buf, who->pw_name, sz-1); - return TRUE; + if ( !wbuf && !s.empty() ) + { + // conversion failed, but we still want to show something to the user + // even if it's going to be wrong it is better than nothing + // + // we choose ISO8859-1 here arbitrarily, it's just the most common + // encoding probably and, also importantly here, conversion from it + // never fails as it's done internally by wxCSConv + wbuf = wxCSConv(wxFONTENCODING_ISO8859_1).cMB2WC(s.c_str()); } - return FALSE; + + return wxConvUTF8.cWC2MB(wbuf); } -bool wxGetUserName(char *buf, int sz) +WXDLLIMPEXP_CORE wxCharBuffer +wxConvertFromGTK(const wxString& s, wxFontEncoding enc) { - struct passwd *who; + // this conversion should never fail as GTK+ always uses UTF-8 internally + // so there are no complications here + const wxWCharBuffer wbuf(wxConvUTF8.cMB2WC(s.c_str())); + if ( enc == wxFONTENCODING_SYSTEM ) + return wxConvUI->cWC2MB(wbuf); - *buf = '\0'; - if ((who = getpwuid (getuid ())) != NULL) { - strncpy (buf, who->pw_gecos, sz - 1); - return TRUE; - } - return FALSE; + return wxCSConv(enc).cWC2MB(wbuf); } -//------------------------------------------------------------------------ -// error and debug output routines -//------------------------------------------------------------------------ +#endif // !wxUSE_UNICODE -void wxDebugMsg( const char *format, ... ) +// Returns false if version is certainly greater or equal than major.minor.micro +// Returns true if version is lower than major.minor.micro OR it cannot be +// determined and one should not rely on the availability of pango version +// major.minor.micro, nor the non-availability +const gchar *wx_pango_version_check (int major, int minor, int micro) { - va_list ap; - va_start( ap, format ); - vfprintf( stderr, format, ap ); - fflush( stderr ); - va_end(ap); -}; +#ifdef PANGO_VERSION_MAJOR + if (!gtk_check_version (2,11,0)) + { + // GTK+ 2.11 requires Pango >= 1.15.3 and pango_version_check + // was added in Pango 1.15.2 thus we know for sure the pango lib we're + // using has the pango_version_check function: + return pango_version_check (major, minor, micro); + } + + return "can't check"; +#else // !PANGO_VERSION_MAJOR + wxUnusedVar(major); + wxUnusedVar(minor); + wxUnusedVar(micro); + + return "too old headers"; +#endif +} + + +// ---------------------------------------------------------------------------- +// subprocess routines +// ---------------------------------------------------------------------------- -void wxError( const wxString &msg, const wxString &title ) +extern "C" { +static +void GTK_EndProcessDetector(gpointer data, gint source, + GdkInputCondition WXUNUSED(condition) ) { - fprintf( stderr, "Error " ); - if (!title.IsNull()) fprintf( stderr, "%s ", WXSTRINGCAST(title) ); - if (!msg.IsNull()) fprintf( stderr, ": %s", WXSTRINGCAST(msg) ); - fprintf( stderr, ".\n" ); -}; + wxEndProcessData *proc_data = (wxEndProcessData *)data; + + // has the process really terminated? unfortunately GDK (or GLib) seem to + // generate G_IO_HUP notification even when it simply tries to read from a + // closed fd and hasn't terminated at all + int pid = (proc_data->pid > 0) ? proc_data->pid : -(proc_data->pid); + int status = 0; + int rc = waitpid(pid, &status, WNOHANG); + + if ( rc == 0 ) + { + // no, it didn't exit yet, continue waiting + return; + } -void wxFatalError( const wxString &msg, const wxString &title ) + // set exit code to -1 if something bad happened + proc_data->exitcode = rc != -1 && WIFEXITED(status) ? WEXITSTATUS(status) + : -1; + + // child exited, end waiting + close(source); + + // don't call us again! + gdk_input_remove(proc_data->tag); + + wxHandleProcessTermination(proc_data); +} +} + +int wxAddProcessCallback(wxEndProcessData *proc_data, int fd) { - fprintf( stderr, "Error " ); - if (!title.IsNull()) fprintf( stderr, "%s ", WXSTRINGCAST(title) ); - if (!msg.IsNull()) fprintf( stderr, ": %s", WXSTRINGCAST(msg) ); - fprintf( stderr, ".\n" ); - exit(1); -}; + int tag = gdk_input_add(fd, + GDK_INPUT_READ, + GTK_EndProcessDetector, + (gpointer)proc_data); -//------------------------------------------------------------------------ -// directory routines -//------------------------------------------------------------------------ + return tag; +} -bool wxDirExists( const wxString& dir ) + + +// ---------------------------------------------------------------------------- +// wxPlatformInfo-related +// ---------------------------------------------------------------------------- + +wxPortId wxGUIAppTraits::GetToolkitVersion(int *verMaj, int *verMin) const { - char buf[500]; - strcpy( buf, WXSTRINGCAST(dir) ); - struct stat sbuf; - return ((stat(buf, &sbuf) != -1) && S_ISDIR(sbuf.st_mode) ? TRUE : FALSE); -}; + if ( verMaj ) + *verMaj = gtk_major_version; + if ( verMin ) + *verMin = gtk_minor_version; -//------------------------------------------------------------------------ -// wild character routines -//------------------------------------------------------------------------ + return wxPORT_GTK; +} + +#if wxUSE_TIMER -bool wxIsWild( const wxString& pattern ) +wxTimerImpl *wxGUIAppTraits::CreateTimerImpl(wxTimer *timer) { - wxString tmp = pattern; - char *pat = WXSTRINGCAST(tmp); - while (*pat) { - switch (*pat++) { - case '?': case '*': case '[': case '{': - return TRUE; - case '\\': - if (!*pat++) - return FALSE; - } - } - return FALSE; -}; + return new wxGTKTimerImpl(timer); +} +#endif // wxUSE_TIMER -bool wxMatchWild( const wxString& pat, const wxString& text, bool dot_special ) +#if wxUSE_DETECT_SM +static wxString GetSM() { - wxString tmp1 = pat; - char *pattern = WXSTRINGCAST(tmp1); - wxString tmp2 = text; - char *str = WXSTRINGCAST(tmp2); - char c; - char *cp; - bool done = FALSE, ret_code, ok; - // Below is for vi fans - const char OB = '{', CB = '}'; - - // dot_special means '.' only matches '.' - if (dot_special && *str == '.' && *pattern != *str) - return FALSE; - - while ((*pattern != '\0') && (!done) - && (((*str=='\0')&&((*pattern==OB)||(*pattern=='*')))||(*str!='\0'))) { - switch (*pattern) { - case '\\': - pattern++; - if (*pattern != '\0') - pattern++; - break; - case '*': - pattern++; - ret_code = FALSE; - while ((*str!='\0') - && (!(ret_code=wxMatchWild(pattern, str++, FALSE)))) - /*loop*/; - if (ret_code) { - while (*str != '\0') - str++; - while (*pattern != '\0') - pattern++; - } - break; - case '[': - pattern++; - repeat: - if ((*pattern == '\0') || (*pattern == ']')) { - done = TRUE; - break; - } - if (*pattern == '\\') { - pattern++; - if (*pattern == '\0') { - done = TRUE; - break; - } - } - if (*(pattern + 1) == '-') { - c = *pattern; - pattern += 2; - if (*pattern == ']') { - done = TRUE; - break; - } - if (*pattern == '\\') { - pattern++; - if (*pattern == '\0') { - done = TRUE; - break; - } - } - if ((*str < c) || (*str > *pattern)) { - pattern++; - goto repeat; - } - } else if (*pattern != *str) { - pattern++; - goto repeat; - } - pattern++; - while ((*pattern != ']') && (*pattern != '\0')) { - if ((*pattern == '\\') && (*(pattern + 1) != '\0')) - pattern++; - pattern++; - } - if (*pattern != '\0') { - pattern++, str++; - } - break; - case '?': - pattern++; - str++; - break; - case OB: - pattern++; - while ((*pattern != CB) && (*pattern != '\0')) { - cp = str; - ok = TRUE; - while (ok && (*cp != '\0') && (*pattern != '\0') - && (*pattern != ',') && (*pattern != CB)) { - if (*pattern == '\\') - pattern++; - ok = (*pattern++ == *cp++); - } - if (*pattern == '\0') { - ok = FALSE; - done = TRUE; - break; - } else if (ok) { - str = cp; - while ((*pattern != CB) && (*pattern != '\0')) { - if (*++pattern == '\\') { - if (*++pattern == CB) - pattern++; - } - } - } else { - while (*pattern!=CB && *pattern!=',' && *pattern!='\0') { - if (*++pattern == '\\') { - if (*++pattern == CB || *pattern == ',') - pattern++; - } - } - } - if (*pattern != '\0') - pattern++; - } - break; - default: - if (*str == *pattern) { - str++, pattern++; - } else { - done = TRUE; - } - } + class Dpy + { + public: + Dpy() { m_dpy = XOpenDisplay(NULL); } + ~Dpy() { if ( m_dpy ) XCloseDisplay(m_dpy); } + + operator Display *() const { return m_dpy; } + private: + Display *m_dpy; + } dpy; + + if ( !dpy ) + return wxEmptyString; + + char smerr[256]; + char *client_id; + SmcConn smc_conn = SmcOpenConnection(NULL, NULL, + 999, 999, + 0 /* mask */, NULL /* callbacks */, + NULL, &client_id, + WXSIZEOF(smerr), smerr); + + if ( !smc_conn ) + { + wxLogWarning(_("Failed to connect to session manager: %s"), smerr); + return wxEmptyString; } - while (*pattern == '*') - pattern++; - return ((*str == '\0') && (*pattern == '\0')); -}; -//------------------------------------------------------------------------ -// subprocess routines -//------------------------------------------------------------------------ + char *vendor = SmcVendor(smc_conn); + wxString ret = wxString::FromAscii( vendor ); + free(vendor); + + SmcCloseConnection(smc_conn, 0, NULL); + free(client_id); + + return ret; +} +#endif // wxUSE_DETECT_SM -typedef struct { - gint pid, tag; - wxProcess *process; -} wxEndProcessData; -static void GTK_EndProcessDetector(gpointer data, gint source, - GdkInputCondition WXUNUSED(condition) ) +//----------------------------------------------------------------------------- +// wxGUIAppTraits +//----------------------------------------------------------------------------- + +wxEventLoopBase *wxGUIAppTraits::CreateEventLoop() { - wxEndProcessData *proc_data = (wxEndProcessData *)data; - int pid; + return new wxEventLoop(); +} - pid = (proc_data->pid > 0) ? proc_data->pid : -(proc_data->pid); - wait4(proc_data->pid, NULL, 0, NULL); +#if wxUSE_INTL +void wxGUIAppTraits::SetLocale() +{ + gtk_set_locale(); + wxUpdateLocaleIsUtf8(); +} +#endif - close(source); - gdk_input_remove(proc_data->tag); +#ifdef __WXDEBUG__ - if (proc_data->process) - proc_data->process->OnTerminate(proc_data->pid); +#if wxUSE_STACKWALKER - if (proc_data->pid > 0) - delete proc_data; - else - proc_data->pid = 0; +// private helper class +class StackDump : public wxStackWalker +{ +public: + StackDump(GtkAssertDialog *dlg) { m_dlg=dlg; } + +protected: + virtual void OnStackFrame(const wxStackFrame& frame) + { + wxString fncname = frame.GetName(); + wxString fncargs = fncname; + + size_t n = fncname.find(wxT('(')); + if (n != wxString::npos) + { + // remove arguments from function name + fncname.erase(n); + + // remove function name and brackets from arguments + fncargs = fncargs.substr(n+1, fncargs.length()-n-2); + } + else + fncargs = wxEmptyString; + + // append this stack frame's info in the dialog + if (!frame.GetFileName().empty() || !fncname.empty()) + gtk_assert_dialog_append_stack_frame(m_dlg, + fncname.mb_str(), + fncargs.mb_str(), + frame.GetFileName().mb_str(), + frame.GetLine()); + } + +private: + GtkAssertDialog *m_dlg; }; -long wxExecute( char **argv, bool sync, wxProcess *process ) +// the callback functions must be extern "C" to comply with GTK+ declarations +extern "C" { - wxEndProcessData *data = new wxEndProcessData; - int end_proc_detect[2]; + void get_stackframe_callback(StackDump *dump) + { + // skip over frames up to including wxOnAssert() + dump->ProcessFrames(3); + } +} - if (*argv == NULL) - return 0; +#endif // wxUSE_STACKWALKER - /* Create pipes */ - if (pipe(end_proc_detect) == -1) { - perror("pipe failed"); - return 0; +bool wxGUIAppTraits::ShowAssertDialog(const wxString& msg) +{ + // under GTK2 we prefer to use a dialog widget written using directly GTK+; + // in fact we cannot use a dialog written using wxWidgets: it would need + // the wxWidgets idle processing to work correctly! + GtkWidget *dialog = gtk_assert_dialog_new(); + gtk_assert_dialog_set_message(GTK_ASSERT_DIALOG(dialog), msg.mb_str()); + +#if wxUSE_STACKWALKER + // don't show more than maxLines or we could get a dialog too tall to be + // shown on screen: 20 should be ok everywhere as even with 15 pixel high + // characters it is still only 300 pixels... + static const int maxLines = 20; + + // save current stack frame... + StackDump dump(GTK_ASSERT_DIALOG(dialog)); + dump.SaveStack(maxLines); + + // ...but process it only if the user needs it + gtk_assert_dialog_set_backtrace_callback(GTK_ASSERT_DIALOG(dialog), + (GtkAssertDialogStackFrameCallback)get_stackframe_callback, + &dump); +#endif // wxUSE_STACKWALKER + + gint result = gtk_dialog_run(GTK_DIALOG (dialog)); + bool returnCode = false; + switch (result) + { + case GTK_ASSERT_DIALOG_STOP: + wxTrap(); + break; + case GTK_ASSERT_DIALOG_CONTINUE: + // nothing to do + break; + case GTK_ASSERT_DIALOG_CONTINUE_SUPPRESSING: + // no more asserts + returnCode = true; + break; + + default: + wxFAIL_MSG( _T("unexpected return code from GtkAssertDialog") ); } - /* fork the process */ -#if defined(sun) || defined(__ultrix) || defined(__bsdi__) - pid_t pid = vfork(); -#else - pid_t pid = fork(); -#endif - if (pid == -1) { - perror ("fork failed"); - return 0; - } else if (pid == 0) { - /* Close fd not useful */ - close(end_proc_detect[0]); // close reading side - - /* child */ -#ifdef _AIX - execvp ((const char *)*argv, (const char **)argv); -#else - execvp (*argv, argv); -#endif - if (errno == ENOENT) - wxError("command not found", *argv); - else - perror (*argv); - wxError("could not execute", *argv); - _exit (-1); + gtk_widget_destroy(dialog); + return returnCode; +} + +#endif // __WXDEBUG__ + +wxString wxGUIAppTraits::GetDesktopEnvironment() const +{ + wxString de = wxSystemOptions::GetOption(_T("gtk.desktop")); +#if wxUSE_DETECT_SM + if ( de.empty() ) + { + static const wxString s_SM = GetSM(); + + if (s_SM == wxT("GnomeSM")) + de = wxT("GNOME"); + else if (s_SM == wxT("KDE")) + de = wxT("KDE"); } +#endif // wxUSE_DETECT_SM - close(end_proc_detect[1]); // close writing side - data->tag = gdk_input_add(end_proc_detect[0], GDK_INPUT_READ, - GTK_EndProcessDetector, (gpointer)data); - data->pid = pid; - if (!sync) { - data->process = process; - } else { - data->process = NULL; - data->pid = -(data->pid); + return de; +} - while (data->pid != 0) - wxYield(); +#ifdef __WXGTK26__ - delete data; - } +// see the hack below in wxCmdLineParser::GetUsageString(). +// TODO: replace this hack with a g_option_group_get_entries() +// call as soon as such function exists +struct _GOptionGroup +{ + gchar *name; + gchar *description; + gchar *help_description; + + GDestroyNotify destroy_notify; + gpointer user_data; + + GTranslateFunc translate_func; + GDestroyNotify translate_notify; + gpointer translate_data; + + GOptionEntry *entries; + gint n_entries; - return pid; + GOptionParseFunc pre_parse_func; + GOptionParseFunc post_parse_func; + GOptionErrorFunc error_func; }; -long wxExecute( const wxString& command, bool sync, wxProcess *process ) +wxString wxGetNameFromGtkOptionEntry(const GOptionEntry *opt) { - if (command.IsNull() || command == "") return FALSE; - - int argc = 0; - char *argv[127]; - char tmp[1024]; - const char *IFS = " \t\n"; - - strncpy (tmp, command, sizeof(tmp) / sizeof(char) - 1); - tmp[sizeof (tmp) / sizeof (char) - 1] = '\0'; - argv[argc++] = strtok (tmp, IFS); - while ((argv[argc++] = strtok(NULL, IFS)) != NULL) - /* loop */ ; - return wxExecute(argv, sync, process); -}; + wxString ret; + + if (opt->short_name) + ret << _T("-") << opt->short_name; + if (opt->long_name) + { + if (!ret.empty()) + ret << _T(", "); + ret << _T("--") << opt->long_name; + + if (opt->arg_description) + ret << _T("=") << opt->arg_description; + } + + return _T(" ") + ret; +} + +#endif // __WXGTK26__ +wxString +wxGUIAppTraits::GetStandardCmdLineOptions(wxArrayString& names, + wxArrayString& desc) const +{ + wxString usage; + +#ifdef __WXGTK26__ + // check whether GTK version is greater than 2.6 but also lower than 2.12 + // because, as we use the undocumented _GOptionGroup struct, we don't want + // to run this code with future versions which might change it (2.11 is the + // latest one at the time of this writing) + if (!gtk_check_version(2,6,0) && + gtk_check_version(2,12,0)) + { + usage << _("The following standard GTK+ options are also supported:\n"); + + // passing true here means that the function can open the default + // display while parsing (not really used here anyhow) + GOptionGroup *gtkOpts = gtk_get_option_group(true); + + // WARNING: here we access the internals of GOptionGroup: + GOptionEntry *entries = ((_GOptionGroup*)gtkOpts)->entries; + unsigned int n_entries = ((_GOptionGroup*)gtkOpts)->n_entries; + wxArrayString namesOptions, descOptions; + + for ( size_t n = 0; n < n_entries; n++ ) + { + if ( entries[n].flags & G_OPTION_FLAG_HIDDEN ) + continue; // skip + + names.push_back(wxGetNameFromGtkOptionEntry(&entries[n])); + + const gchar * const entryDesc = entries[n].description; + desc.push_back(entryDesc ? wxString(entryDesc) : _T("")); + } + + g_option_group_free (gtkOpts); + } +#else + wxUnusedVar(names); + wxUnusedVar(desc); +#endif // __WXGTK26__ + + return usage; +}