1 ///////////////////////////////////////////////////////////////////////////////
2 // Name: wx/gtk/private.h
3 // Purpose: wxGTK private macros, functions &c
4 // Author: Vadim Zeitlin
8 // Copyright: (c) 2002 Vadim Zeitlin <vadim@wxwidgets.org>
9 // Licence: wxWindows licence
10 ///////////////////////////////////////////////////////////////////////////////
12 #ifndef _WX_GTK_PRIVATE_H_
13 #define _WX_GTK_PRIVATE_H_
19 // fail all version tests if the GTK+ version is so ancient that it doesn't
20 // even have GTK_CHECK_VERSION
21 #ifndef GTK_CHECK_VERSION
22 #define GTK_CHECK_VERSION(a, b, c) 0
26 #define wxGTK_CONV(s) wxConvUTF8.cWX2MB(s)
27 #define wxGTK_CONV_SYS(s) wxGTK_CONV(s)
28 #define wxGTK_CONV_BACK(s) wxConvUTF8.cMB2WX(s)
30 // convert the text in given encoding to UTF-8 used by wxGTK
32 wxConvertToGTK(const wxString
& s
,
33 wxFontEncoding enc
= wxFONTENCODING_SYSTEM
);
35 // helper: use the encoding of the given font if it's valid
36 inline wxCharBuffer
wxConvertToGTK(const wxString
& s
, const wxFont
& font
)
38 return wxConvertToGTK(s
, font
.Ok() ? font
.GetEncoding()
39 : wxFONTENCODING_SYSTEM
);
42 #define wxGTK_CONV(s) wxConvertToGTK((s), m_font)
43 #define wxGTK_CONV_SYS(s) wxConvertToGTK(s)
44 #define wxGTK_CONV_BACK(s) wxConvLocal.cWC2WX( wxConvUTF8.cMB2WC((s)) )
47 // Some deprecated GTK+ prototypes we still use often
48 // FIXME: Don't use them if possible.
51 // Should use gtk_image_new, but the mask seems to be handled different,
52 // and we need to migrate
53 GtkWidget
* gtk_pixmap_new (GdkPixmap
*pixmap
,
56 // Deprecated since GTK+-1.3.7:
57 // Trivial wrapper around gtk_window_move, with some side effects we seem to rely on
58 void gtk_widget_set_uposition (GtkWidget
*widget
,
62 // We rely on the allow_shrink parameter in one place
63 void gtk_window_set_policy (GtkWindow
*window
,
70 //-----------------------------------------------------------------------------
72 //-----------------------------------------------------------------------------
74 extern void wxapp_install_idle_handler();
77 //-----------------------------------------------------------------------------
78 // Convenience class for g_freeing a gchar* on scope exit automatically
79 //-----------------------------------------------------------------------------
84 explicit wxGtkString(gchar
*s
) : m_str(s
) { }
85 ~wxGtkString() { g_free(m_str
); }
87 const gchar
*c_str() const { return m_str
; }
89 operator gchar
*() const { return m_str
; }
94 DECLARE_NO_COPY_CLASS(wxGtkString
)
97 //-----------------------------------------------------------------------------
98 // GTK+ scroll types -> wxEventType
99 //-----------------------------------------------------------------------------
101 // translate a GTK+ scroll type to a wxEventType
102 inline wxEventType
GtkScrollTypeToWx(guint scrollType
)
105 switch ( scrollType
)
107 case GTK_SCROLL_STEP_BACKWARD
:
108 command
= wxEVT_SCROLL_LINEUP
;
111 case GTK_SCROLL_STEP_FORWARD
:
112 command
= wxEVT_SCROLL_LINEDOWN
;
115 case GTK_SCROLL_PAGE_BACKWARD
:
116 command
= wxEVT_SCROLL_PAGEUP
;
119 case GTK_SCROLL_PAGE_FORWARD
:
120 command
= wxEVT_SCROLL_PAGEDOWN
;
124 command
= wxEVT_SCROLL_THUMBTRACK
;
130 inline wxEventType
GtkScrollWinTypeToWx(guint scrollType
)
132 // GtkScrollTypeToWx() returns SCROLL_XXX, not SCROLLWIN_XXX as we need
133 return GtkScrollTypeToWx(scrollType
) +
134 wxEVT_SCROLLWIN_TOP
- wxEVT_SCROLL_TOP
;
138 //-----------------------------------------------------------------------------
140 //-----------------------------------------------------------------------------
142 // Needed for implementing e.g. combobox on wxGTK within a modal dialog.
143 void wxAddGrab(wxWindow
* window
);
144 void wxRemoveGrab(wxWindow
* window
);
146 // Escapes string so that it is valid Pango markup XML string:
147 WXDLLIMPEXP_CORE wxString
wxEscapeStringForPangoMarkup(const wxString
& str
);
149 // The declaration for gtk_icon_size_lookup was accidentally ifdefed out in
150 // GTK+ 2.1.0 which Sun seem to have shipped with some versions of JDS
151 // for Solaris 9 x86.
152 #ifdef NEED_GTK_ICON_SIZE_LOOKUP
153 extern "C" gboolean
gtk_icon_size_lookup (GtkIconSize size
,
158 #endif // _WX_GTK_PRIVATE_H_