]>
Commit | Line | Data |
---|---|---|
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 | |
17 | struct wxGtkIMData; | |
18 | ||
ef5c70f9 VZ |
19 | WX_DEFINE_EXPORTED_ARRAY_PTR(GdkWindow *, wxArrayGdkWindows); |
20 | ||
c801d85f | 21 | //----------------------------------------------------------------------------- |
1e6feb95 | 22 | // wxWindowGTK |
c801d85f KB |
23 | //----------------------------------------------------------------------------- |
24 | ||
20123d49 | 25 | class WXDLLIMPEXP_CORE wxWindowGTK : public wxWindowBase |
c801d85f | 26 | { |
aed8df38 | 27 | public: |
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 | 190 | protected: |
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 | 215 | public: |
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 | 305 | protected: |
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 | 382 | private: |
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_ |