]> git.saurik.com Git - wxWidgets.git/blame - include/wx/gtk/window.h
Include gdk/gdkkeysyms-compat.h.
[wxWidgets.git] / include / wx / gtk / window.h
CommitLineData
c801d85f 1/////////////////////////////////////////////////////////////////////////////
1e6feb95 2// Name: wx/gtk/window.h
c801d85f
KB
3// Purpose:
4// Author: Robert Roebling
58614078
RR
5// Id: $Id$
6// Copyright: (c) 1998 Robert Roebling
65571936 7// Licence: wxWindows licence
c801d85f
KB
8/////////////////////////////////////////////////////////////////////////////
9
ef5c70f9
VZ
10#ifndef _WX_GTK_WINDOW_H_
11#define _WX_GTK_WINDOW_H_
12
13#include "wx/dynarray.h"
c801d85f 14
a3c15d89
VS
15// helper structure that holds class that holds GtkIMContext object and
16// some additional data needed for key events processing
17struct wxGtkIMData;
18
ef5c70f9
VZ
19WX_DEFINE_EXPORTED_ARRAY_PTR(GdkWindow *, wxArrayGdkWindows);
20
c801d85f 21//-----------------------------------------------------------------------------
1e6feb95 22// wxWindowGTK
c801d85f
KB
23//-----------------------------------------------------------------------------
24
20123d49 25class WXDLLIMPEXP_CORE wxWindowGTK : public wxWindowBase
c801d85f 26{
aed8df38 27public:
bfc6fde4
VZ
28 // creating the window
29 // -------------------
1e6feb95
VZ
30 wxWindowGTK();
31 wxWindowGTK(wxWindow *parent,
32 wxWindowID id,
33 const wxPoint& pos = wxDefaultPosition,
34 const wxSize& size = wxDefaultSize,
35 long style = 0,
36 const wxString& name = wxPanelNameStr);
f03fc89f
VZ
37 bool Create(wxWindow *parent,
38 wxWindowID id,
39 const wxPoint& pos = wxDefaultPosition,
40 const wxSize& size = wxDefaultSize,
41 long style = 0,
42 const wxString& name = wxPanelNameStr);
1e6feb95 43 virtual ~wxWindowGTK();
cd0183ca 44
f03fc89f
VZ
45 // implement base class (pure) virtual methods
46 // -------------------------------------------
a264ece2 47
bfc6fde4 48 virtual bool Destroy();
bfc6fde4 49
f03fc89f
VZ
50 virtual void Raise();
51 virtual void Lower();
ff8bfdbb 52
5bc3865f 53 virtual bool Show( bool show = true );
ff8bfdbb 54
015dca24
MR
55 virtual void SetWindowStyleFlag( long style );
56
f03fc89f 57 virtual bool IsRetained() const;
2f2aa628 58
bfc6fde4 59 virtual void SetFocus();
cca410b3 60
00ff24c8 61 // hint from wx to native GTK+ tab traversal code
80332672 62 virtual void SetCanFocus(bool canFocus);
ff8bfdbb 63
fdb7dadb 64 virtual bool Reparent( wxWindowBase *newParent );
ff8bfdbb 65
f03fc89f 66 virtual void WarpPointer(int x, int y);
b1170810 67
5bc3865f 68 virtual void Refresh( bool eraseBackground = true,
f03fc89f 69 const wxRect *rect = (const wxRect *) NULL );
beab25bd 70 virtual void Update();
596f1d11 71 virtual void ClearBackground();
bfc6fde4 72
f03fc89f
VZ
73 virtual bool SetBackgroundColour( const wxColour &colour );
74 virtual bool SetForegroundColour( const wxColour &colour );
75 virtual bool SetCursor( const wxCursor &cursor );
76 virtual bool SetFont( const wxFont &font );
cd0183ca 77
c7382f91 78 virtual bool SetBackgroundStyle(wxBackgroundStyle style) ;
f26623c8 79
bfc6fde4
VZ
80 virtual int GetCharHeight() const;
81 virtual int GetCharWidth() const;
aed8df38 82
f03fc89f 83 virtual void SetScrollbar( int orient, int pos, int thumbVisible,
5bc3865f
WS
84 int range, bool refresh = true );
85 virtual void SetScrollPos( int orient, int pos, bool refresh = true );
f03fc89f
VZ
86 virtual int GetScrollPos( int orient ) const;
87 virtual int GetScrollThumb( int orient ) const;
88 virtual int GetScrollRange( int orient ) const;
89 virtual void ScrollWindow( int dx, int dy,
d3b9f782 90 const wxRect* rect = NULL );
0c131a5a
VZ
91 virtual bool ScrollLines(int lines);
92 virtual bool ScrollPages(int pages);
8bbe427f 93
f03fc89f
VZ
94#if wxUSE_DRAG_AND_DROP
95 virtual void SetDropTarget( wxDropTarget *dropTarget );
96#endif // wxUSE_DRAG_AND_DROP
f26623c8 97
a589495e
VS
98 virtual void AddChild( wxWindowBase *child );
99 virtual void RemoveChild( wxWindowBase *child );
8bbe427f 100
978af864
VZ
101 virtual void SetLayoutDirection(wxLayoutDirection dir);
102 virtual wxLayoutDirection GetLayoutDirection() const;
fe92a9d6
RR
103 virtual wxCoord AdjustForLayoutDirection(wxCoord x,
104 wxCoord width,
105 wxCoord widthTotal) const;
978af864 106
657b4fd4
RD
107 virtual bool DoIsExposed( int x, int y ) const;
108 virtual bool DoIsExposed( int x, int y, int w, int h ) const;
847dfdb4 109
8e1a5bf9
VZ
110 // currently wxGTK2-only
111 void SetDoubleBuffered(bool on);
2e992e06 112 virtual bool IsDoubleBuffered() const;
8e1a5bf9 113
c9248ddb
RR
114 // SetLabel(), which does nothing in wxWindow
115 virtual void SetLabel(const wxString& label) { m_gtkLabel = label; }
116 virtual wxString GetLabel() const { return m_gtkLabel; }
117
f03fc89f
VZ
118 // implementation
119 // --------------
c801d85f 120
d7c24517
VZ
121 virtual WXWidget GetHandle() const { return m_widget; }
122
ef5c70f9
VZ
123 // many important things are done here, this function must be called
124 // regularly
bfc6fde4 125 virtual void OnInternalIdle();
ff8bfdbb 126
beab25bd
RR
127 // For compatibility across platforms (not in event table)
128 void OnIdle(wxIdleEvent& WXUNUSED(event)) {}
20e85460 129
beab25bd 130 // Used by all window classes in the widget creation process.
1e6feb95 131 bool PreCreation( wxWindowGTK *parent, const wxPoint &pos, const wxSize &size );
bfc6fde4 132 void PostCreation();
ff8bfdbb 133
48200154 134 // Internal addition of child windows
1e6feb95 135 void DoAddChild(wxWindowGTK *child);
f26623c8 136
beab25bd
RR
137 // This methods sends wxPaintEvents to the window. It reads the
138 // update region, breaks it up into rects and sends an event
139 // for each rect. It is also responsible for background erase
140 // events and NC paint events. It is called from "draw" and
141 // "expose" handlers as well as from ::Update()
142 void GtkSendPaintEvents();
143
144 // The methods below are required because many native widgets
145 // are composed of several subwidgets and setting a style for
146 // the widget means setting it for all subwidgets as well.
90e572f1 147 // also, it is not clear which native widget is the top
beab25bd
RR
148 // widget where (most of) the input goes. even tooltips have
149 // to be applied to all subwidgets.
bfc6fde4 150 virtual GtkWidget* GetConnectWidget();
bfc6fde4 151 void ConnectWidget( GtkWidget *widget );
8bbe427f 152
5478f221
VZ
153 // Called from several event handlers, if it returns true or false, the
154 // same value should be immediately returned by the handler without doing
155 // anything else. If it returns -1, the handler should continue as usual
156 int GTKCallbackCommonPrologue(struct _GdkEventAny *event) const;
ef5c70f9 157
02bad830
VZ
158 // Simplified form of GTKCallbackCommonPrologue() which can be used from
159 // GTK callbacks without return value to check if the event should be
160 // ignored: if this returns true, the event shouldn't be handled
161 bool GTKShouldIgnoreEvent() const;
162
163
97687291
VZ
164 // override this if some events should never be consumed by wxWidgets but
165 // but have to be left for the native control
166 //
004867db 167 // base version just calls HandleWindowEvent()
97687291
VZ
168 virtual bool GTKProcessEvent(wxEvent& event) const;
169
978af864
VZ
170 // Map GTK widget direction of the given widget to/from wxLayoutDirection
171 static wxLayoutDirection GTKGetLayout(GtkWidget *widget);
172 static void GTKSetLayout(GtkWidget *widget, wxLayoutDirection dir);
173
e8375af8
VZ
174 // return true if this window must have a non-NULL parent, false if it can
175 // be created without parent (normally only top level windows but in wxGTK
176 // there is also the exception of wxMenuBar)
177 virtual bool GTKNeedsParent() const { return !IsTopLevel(); }
178
004867db 179 // This is called when capture is taken from the window. It will
7738af59
VZ
180 // fire off capture lost events.
181 void GTKReleaseMouseAndNotify();
182
08f53168
PC
183 GdkWindow* GTKGetDrawingWindow() const;
184
bd2e08d0
VS
185 bool GTKHandleFocusIn();
186 bool GTKHandleFocusOut();
187 void GTKHandleFocusOutNoDeferring();
188 static void GTKHandleDeferredFocusOut();
189
cb3db090 190protected:
bd2e08d0
VS
191 // for controls composed of multiple GTK widgets, return true to eliminate
192 // spurious focus events if the focus changes between GTK+ children within
193 // the same wxWindow
194 virtual bool GTKNeedsToFilterSameWindowFocus() const { return false; }
195
2e1f5012 196 // Override GTKWidgetNeedsMnemonic and return true if your
28e88942 197 // needs to set its mnemonic widget, such as for a
2e1f5012
VZ
198 // GtkLabel for wxStaticText, then do the actual
199 // setting of the widget inside GTKWidgetDoSetMnemonic
200 virtual bool GTKWidgetNeedsMnemonic() const;
201 virtual void GTKWidgetDoSetMnemonic(GtkWidget* w);
202
ef5c70f9
VZ
203 // Get the GdkWindows making part of this window: usually there will be
204 // only one of them in which case it should be returned directly by this
205 // function. If there is more than one GdkWindow (can be the case for
206 // composite widgets), return NULL and fill in the provided array
207 //
208 // This is not pure virtual for backwards compatibility but almost
209 // certainly must be overridden in any wxControl-derived class!
210 virtual GdkWindow *GTKGetWindow(wxArrayGdkWindows& windows) const;
211
212 // Check if the given window makes part of this widget
213 bool GTKIsOwnWindow(GdkWindow *window) const;
214
cb3db090 215public:
2b5f62a0 216 // Returns the default context which usually is anti-aliased
496e7ec6 217 PangoContext *GTKGetPangoDefaultContext();
2b5f62a0 218
ff8bfdbb 219#if wxUSE_TOOLTIPS
6e5f6c7c 220 // applies tooltip to the widget (tip must be UTF-8 encoded)
7fc8b9a4 221 virtual void GTKApplyToolTip( GtkTooltips *tips, const gchar *tip );
ff8bfdbb 222#endif // wxUSE_TOOLTIPS
301cd871 223
f46ad98f 224 // Called when a window should delay showing itself
71ead4bf
RR
225 // until idle time used in Reparent().
226 void GTKShowOnIdle() { m_showOnIdle = true; }
28e88942 227
7317857d 228 // This is called from the various OnInternalIdle methods
71ead4bf 229 bool GTKShowFromOnIdle();
3ae4c570 230
d1f2ac45 231 // is this window transparent for the mouse events (as wxStaticBox is)?
71ead4bf 232 virtual bool GTKIsTransparentForMouse() const { return false; }
d1f2ac45 233
add7cadd 234 // Common scroll event handling code for wxWindow and wxScrollBar
71ead4bf 235 wxEventType GTKGetScrollEventType(GtkRange* range);
add7cadd 236
f03fc89f
VZ
237 // position and size of the window
238 int m_x, m_y;
239 int m_width, m_height;
5b8a521e 240 int m_oldClientWidth,m_oldClientHeight;
bcf1fa6b 241
76fcf0f2
RR
242 // see the docs in src/gtk/window.cpp
243 GtkWidget *m_widget; // mostly the widget seen by the rest of GTK
77ffb593 244 GtkWidget *m_wxwindow; // mostly the client area as per wxWidgets
ce00f59b 245
c9248ddb
RR
246 // label for use with GetLabelSetLabel
247 wxString m_gtkLabel;
ce00f59b 248
da1bd25f
RR
249 // return true if the window is of a standard (i.e. not wxWidgets') class
250 bool IsOfStandardClass() const { return m_wxwindow == NULL; }
cca410b3 251
76fcf0f2
RR
252 // this widget will be queried for GTK's focus events
253 GtkWidget *m_focusWidget;
004867db 254
36a845fe
RR
255 void GTKDisableFocusOutEvent();
256 void GTKEnableFocusOutEvent();
f03fc89f 257
a3c15d89 258 wxGtkIMData *m_imData;
3bcc8d15 259
22c9b211
VZ
260
261 // indices for the arrays below
262 enum ScrollDir { ScrollDir_Horz, ScrollDir_Vert, ScrollDir_Max };
263
add7cadd 264 // horizontal/vertical scroll bar
22c9b211
VZ
265 GtkRange* m_scrollBar[ScrollDir_Max];
266
add7cadd 267 // horizontal/vertical scroll position
22c9b211
VZ
268 double m_scrollPos[ScrollDir_Max];
269
22c9b211
VZ
270 // return the scroll direction index corresponding to the given orientation
271 // (which is wxVERTICAL or wxHORIZONTAL)
272 static ScrollDir ScrollDirFromOrient(int orient)
273 {
274 return orient == wxVERTICAL ? ScrollDir_Vert : ScrollDir_Horz;
275 }
276
277 // return the orientation for the given scrolling direction
278 static int OrientFromScrollDir(ScrollDir dir)
279 {
280 return dir == ScrollDir_Horz ? wxHORIZONTAL : wxVERTICAL;
281 }
282
283 // find the direction of the given scrollbar (must be one of ours)
284 ScrollDir ScrollDirFromRange(GtkRange *range) const;
285
c2246a38
RR
286 // set the current cursor for all GdkWindows making part of this widget
287 // (see GTKGetWindow)
288 void GTKUpdateCursor(bool update_self = true, bool recurse = true);
289
f03fc89f 290 // extra (wxGTK-specific) flags
76fcf0f2
RR
291 bool m_noExpose:1; // wxGLCanvas has its own redrawing
292 bool m_nativeSizeEvent:1; // wxGLCanvas sends wxSizeEvent upon "alloc_size"
02bad830 293 bool m_hasVMT:1; // set after PostCreation() is called
6cad4f1b 294 bool m_isScrolling:1; // dragging scrollbar thumb?
5bc3865f 295 bool m_clipPaintRegion:1; // true after ScrollWindow()
bcb614b3 296 wxRegion m_nativeUpdateRegion; // not transformed for RTL
a589495e
VS
297 bool m_dirtyTabOrder:1; // tab order changed, GTK focus
298 // chain needs update
c7382f91
JS
299 bool m_needsStyleChange:1; // May not be able to change
300 // background style until OnIdle
add7cadd 301 bool m_mouseButtonDown:1;
28e88942 302
f46ad98f 303 bool m_showOnIdle:1; // postpone showing the window until idle
7af6f327 304
c821db16 305protected:
f03fc89f 306 // implement the base class pure virtuals
6de70470
VZ
307 virtual void DoGetTextExtent(const wxString& string,
308 int *x, int *y,
309 int *descent = NULL,
310 int *externalLeading = NULL,
311 const wxFont *font = NULL) const;
dabc0cd5
VZ
312 virtual void DoClientToScreen( int *x, int *y ) const;
313 virtual void DoScreenToClient( int *x, int *y ) const;
f03fc89f
VZ
314 virtual void DoGetPosition( int *x, int *y ) const;
315 virtual void DoGetSize( int *width, int *height ) const;
316 virtual void DoGetClientSize( int *width, int *height ) const;
bfc6fde4
VZ
317 virtual void DoSetSize(int x, int y,
318 int width, int height,
319 int sizeFlags = wxSIZE_AUTO);
bfc6fde4 320 virtual void DoSetClientSize(int width, int height);
b3554952 321 virtual wxSize DoGetBorderSize() const;
9d9b7755 322 virtual void DoMoveWindow(int x, int y, int width, int height);
c821db16 323 virtual void DoEnable(bool enable);
aed8df38 324
6f02a879
VZ
325#if wxUSE_MENUS_NATIVE
326 virtual bool DoPopupMenu( wxMenu *menu, int x, int y );
327#endif // wxUSE_MENUS_NATIVE
328
94633ad9
VZ
329 virtual void DoCaptureMouse();
330 virtual void DoReleaseMouse();
f26623c8 331
5f346ddc
VS
332 virtual void DoFreeze();
333 virtual void DoThaw();
334
f089940f
PC
335 void GTKFreezeWidget(GtkWidget *w);
336 void GTKThawWidget(GtkWidget *w);
5f346ddc 337
f03fc89f
VZ
338#if wxUSE_TOOLTIPS
339 virtual void DoSetToolTip( wxToolTip *tip );
340#endif // wxUSE_TOOLTIPS
341
3ae4c570 342 // common part of all ctors (not virtual because called from ctor)
f03fc89f 343 void Init();
f26623c8 344
915bd4e4 345 virtual void DoMoveInTabOrder(wxWindow *win, WindowOrder move);
5644933f
VZ
346 virtual bool DoNavigateIn(int flags);
347
a589495e
VS
348
349 // Copies m_children tab order to GTK focus chain:
350 void RealizeTabOrder();
f26623c8 351
f40fdaa3
VS
352 // Called by ApplyWidgetStyle (which is called by SetFont() and
353 // SetXXXColour etc to apply style changed to native widgets) to create
5edef14e
VS
354 // modified GTK style with non-standard attributes. If forceStyle=true,
355 // creates empty GtkRcStyle if there are no modifications, otherwise
356 // returns NULL in such case.
496e7ec6 357 GtkRcStyle *GTKCreateWidgetStyle(bool forceStyle = false);
f40fdaa3
VS
358
359 // Overridden in many GTK widgets who have to handle subwidgets
496e7ec6 360 virtual void GTKApplyWidgetStyle(bool forceStyle = false);
f26623c8 361
5bc3865f 362 // helper function to ease native widgets wrapping, called by
7074ce35
VS
363 // ApplyWidgetStyle -- override this, not ApplyWidgetStyle
364 virtual void DoApplyWidgetStyle(GtkRcStyle *style);
f03fc89f 365
6493aaca 366 // sets the border of a given GtkScrolledWindow from a wx style
496e7ec6 367 static void GTKScrolledWindowSetBorder(GtkWidget* w, int style);
6493aaca 368
a0c8bb73
VZ
369 // Connect the given function to the specified signal on m_widget.
370 //
371 // This is just a wrapper for g_signal_connect() and returns the handler id
372 // just as it does.
373 gulong GTKConnectWidget(const char *signal, void (*callback)());
374
92153555
VZ
375 // Return true from here if PostCreation() should connect to size_request
376 // signal: this is done by default but doesn't work for some native
377 // controls which override this function to return false
378 virtual bool GTKShouldConnectSizeRequest() const { return !IsTopLevel(); }
379
82008f15
PC
380 void ConstrainSize();
381
68dda785 382private:
22c9b211
VZ
383 enum ScrollUnit { ScrollUnit_Line, ScrollUnit_Page, ScrollUnit_Max };
384
385 // common part of ScrollLines() and ScrollPages() and could be used, in the
386 // future, for horizontal scrolling as well
387 //
388 // return true if we scrolled, false otherwise (on error or simply if we
389 // are already at the end)
390 bool DoScrollByUnits(ScrollDir dir, ScrollUnit unit, int units);
48200154 391 virtual void AddChildGTK(wxWindowGTK* child);
22c9b211
VZ
392
393
1e6feb95 394 DECLARE_DYNAMIC_CLASS(wxWindowGTK)
c0c133e1 395 wxDECLARE_NO_COPY_CLASS(wxWindowGTK);
c801d85f
KB
396};
397
ef5c70f9 398#endif // _WX_GTK_WINDOW_H_