1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/gtk/window.h
4 // Author: Robert Roebling
6 // Copyright: (c) 1998 Robert Roebling
7 // Licence: wxWindows licence
8 /////////////////////////////////////////////////////////////////////////////
10 #ifndef _WX_GTK_WINDOW_H_
11 #define _WX_GTK_WINDOW_H_
13 #include "wx/dynarray.h"
15 // helper structure that holds class that holds GtkIMContext object and
16 // some additional data needed for key events processing
19 WX_DEFINE_EXPORTED_ARRAY_PTR(GdkWindow
*, wxArrayGdkWindows
);
21 //-----------------------------------------------------------------------------
22 // callback definition for inserting a window (internal)
23 //-----------------------------------------------------------------------------
25 class WXDLLIMPEXP_CORE wxWindowGTK
;
26 typedef void (*wxInsertChildFunction
)( wxWindowGTK
*, wxWindowGTK
* );
28 //-----------------------------------------------------------------------------
30 //-----------------------------------------------------------------------------
32 class WXDLLIMPEXP_CORE wxWindowGTK
: public wxWindowBase
35 // creating the window
36 // -------------------
38 wxWindowGTK(wxWindow
*parent
,
40 const wxPoint
& pos
= wxDefaultPosition
,
41 const wxSize
& size
= wxDefaultSize
,
43 const wxString
& name
= wxPanelNameStr
);
44 bool Create(wxWindow
*parent
,
46 const wxPoint
& pos
= wxDefaultPosition
,
47 const wxSize
& size
= wxDefaultSize
,
49 const wxString
& name
= wxPanelNameStr
);
50 virtual ~wxWindowGTK();
52 // implement base class (pure) virtual methods
53 // -------------------------------------------
55 virtual void SetLabel(const wxString
& WXUNUSED(label
)) { }
56 virtual wxString
GetLabel() const { return wxEmptyString
; }
58 virtual bool Destroy();
63 virtual bool Show( bool show
= true );
64 virtual bool Enable( bool enable
= true );
66 virtual void SetWindowStyleFlag( long style
);
68 virtual bool IsRetained() const;
70 virtual void SetFocus();
71 virtual bool AcceptsFocus() const;
73 virtual bool Reparent( wxWindowBase
*newParent
);
75 virtual void WarpPointer(int x
, int y
);
77 virtual void Refresh( bool eraseBackground
= true,
78 const wxRect
*rect
= (const wxRect
*) NULL
);
79 virtual void Update();
80 virtual void ClearBackground();
82 virtual bool SetBackgroundColour( const wxColour
&colour
);
83 virtual bool SetForegroundColour( const wxColour
&colour
);
84 virtual bool SetCursor( const wxCursor
&cursor
);
85 virtual bool SetFont( const wxFont
&font
);
87 virtual bool SetBackgroundStyle(wxBackgroundStyle style
) ;
89 virtual int GetCharHeight() const;
90 virtual int GetCharWidth() const;
91 virtual void GetTextExtent(const wxString
& string
,
93 int *descent
= (int *) NULL
,
94 int *externalLeading
= (int *) NULL
,
95 const wxFont
*theFont
= (const wxFont
*) NULL
)
98 virtual void SetScrollbar( int orient
, int pos
, int thumbVisible
,
99 int range
, bool refresh
= true );
100 virtual void SetScrollPos( int orient
, int pos
, bool refresh
= true );
101 virtual int GetScrollPos( int orient
) const;
102 virtual int GetScrollThumb( int orient
) const;
103 virtual int GetScrollRange( int orient
) const;
104 virtual void ScrollWindow( int dx
, int dy
,
105 const wxRect
* rect
= (wxRect
*) NULL
);
106 virtual bool ScrollLines(int lines
);
107 virtual bool ScrollPages(int pages
);
109 #if wxUSE_DRAG_AND_DROP
110 virtual void SetDropTarget( wxDropTarget
*dropTarget
);
111 #endif // wxUSE_DRAG_AND_DROP
113 virtual void AddChild( wxWindowBase
*child
);
114 virtual void RemoveChild( wxWindowBase
*child
);
116 // currently wxGTK2-only
117 void SetDoubleBuffered(bool on
);
122 virtual WXWidget
GetHandle() const { return m_widget
; }
124 // many important things are done here, this function must be called
126 virtual void OnInternalIdle();
128 // Internal represention of Update()
131 // For compatibility across platforms (not in event table)
132 void OnIdle(wxIdleEvent
& WXUNUSED(event
)) {}
134 // wxGTK-specific: called recursively by Enable,
135 // to give widgets an opportunity to correct their colours after they
136 // have been changed by Enable
137 virtual void OnParentEnable( bool WXUNUSED(enable
) ) {}
139 // Used by all window classes in the widget creation process.
140 bool PreCreation( wxWindowGTK
*parent
, const wxPoint
&pos
, const wxSize
&size
);
143 // Internal addition of child windows. differs from class
144 // to class not by using virtual functions but by using
145 // the m_insertCallback.
146 void DoAddChild(wxWindowGTK
*child
);
148 // This methods sends wxPaintEvents to the window. It reads the
149 // update region, breaks it up into rects and sends an event
150 // for each rect. It is also responsible for background erase
151 // events and NC paint events. It is called from "draw" and
152 // "expose" handlers as well as from ::Update()
153 void GtkSendPaintEvents();
155 // The methods below are required because many native widgets
156 // are composed of several subwidgets and setting a style for
157 // the widget means setting it for all subwidgets as well.
158 // also, it is not clear which native widget is the top
159 // widget where (most of) the input goes. even tooltips have
160 // to be applied to all subwidgets.
161 virtual GtkWidget
* GetConnectWidget();
162 void ConnectWidget( GtkWidget
*widget
);
164 // Called from several event handlers
165 bool GTKCallbackCommonPrologue(struct _GdkEventAny
*event
) const;
168 // Override GTKWidgetNeedsMnemonic and return true if your
169 // needs to set its mnemonic widget, such as for a
170 // GtkLabel for wxStaticText, then do the actual
171 // setting of the widget inside GTKWidgetDoSetMnemonic
172 virtual bool GTKWidgetNeedsMnemonic() const;
173 virtual void GTKWidgetDoSetMnemonic(GtkWidget
* w
);
175 // Get the GdkWindows making part of this window: usually there will be
176 // only one of them in which case it should be returned directly by this
177 // function. If there is more than one GdkWindow (can be the case for
178 // composite widgets), return NULL and fill in the provided array
180 // This is not pure virtual for backwards compatibility but almost
181 // certainly must be overridden in any wxControl-derived class!
182 virtual GdkWindow
*GTKGetWindow(wxArrayGdkWindows
& windows
) const;
184 // Check if the given window makes part of this widget
185 bool GTKIsOwnWindow(GdkWindow
*window
) const;
187 // Set the focus to this window if its setting was delayed because the
188 // widget hadn't been realized when SetFocus() was called
190 // Return true if focus was set to us, false if nothing was done
191 bool GTKSetDelayedFocusIfNeeded();
194 // Returns the default context which usually is anti-aliased
195 PangoContext
*GtkGetPangoDefaultContext();
198 virtual void ApplyToolTip( GtkTooltips
*tips
, const wxChar
*tip
);
199 #endif // wxUSE_TOOLTIPS
201 // Called from GTK signal handlers. it indicates that
202 // the layouting functions have to be called later on
203 // (i.e. in idle time, implemented in OnInternalIdle() ).
204 void GtkUpdateSize() { m_sizeSet
= false; }
207 // Called when a window should delay showing itself
208 // until idle time. This partly mimmicks defered
210 void GtkShowOnIdle() { m_showOnIdle
= true; }
212 // This is called from the various OnInternalIdle methods
213 bool GtkShowFromOnIdle();
215 // fix up the mouse event coords, used by wxListBox only so far
216 virtual void FixUpMouseEvent(GtkWidget
* WXUNUSED(widget
),
217 wxCoord
& WXUNUSED(x
),
218 wxCoord
& WXUNUSED(y
)) { }
220 // is this window transparent for the mouse events (as wxStaticBox is)?
221 virtual bool IsTransparentForMouse() const { return false; }
223 // is this a radiobutton (used by radiobutton code itself only)?
224 virtual bool IsRadioButton() const { return false; }
226 // Common scroll event handling code for wxWindow and wxScrollBar
227 wxEventType
GetScrollEventType(GtkRange
* range
);
229 void BlockScrollEvent();
230 void UnblockScrollEvent();
232 // position and size of the window
234 int m_width
, m_height
;
235 int m_oldClientWidth
,m_oldClientHeight
;
237 // see the docs in src/gtk/window.cpp
238 GtkWidget
*m_widget
; // mostly the widget seen by the rest of GTK
239 GtkWidget
*m_wxwindow
; // mostly the client area as per wxWidgets
241 // this widget will be queried for GTK's focus events
242 GtkWidget
*m_focusWidget
;
244 wxGtkIMData
*m_imData
;
247 // indices for the arrays below
248 enum ScrollDir
{ ScrollDir_Horz
, ScrollDir_Vert
, ScrollDir_Max
};
250 // horizontal/vertical scroll bar
251 GtkRange
* m_scrollBar
[ScrollDir_Max
];
253 // horizontal/vertical scroll position
254 double m_scrollPos
[ScrollDir_Max
];
256 // if true, don't notify about adjustment change (without resetting the
257 // flag, so this has to be done manually)
258 bool m_blockValueChanged
[ScrollDir_Max
];
260 // return the scroll direction index corresponding to the given orientation
261 // (which is wxVERTICAL or wxHORIZONTAL)
262 static ScrollDir
ScrollDirFromOrient(int orient
)
264 return orient
== wxVERTICAL ? ScrollDir_Vert
: ScrollDir_Horz
;
267 // return the orientation for the given scrolling direction
268 static int OrientFromScrollDir(ScrollDir dir
)
270 return dir
== ScrollDir_Horz ? wxHORIZONTAL
: wxVERTICAL
;
273 // find the direction of the given scrollbar (must be one of ours)
274 ScrollDir
ScrollDirFromRange(GtkRange
*range
) const;
277 // extra (wxGTK-specific) flags
278 bool m_needParent
:1; // ! wxFrame, wxDialog, wxNotebookPage ?
279 bool m_noExpose
:1; // wxGLCanvas has its own redrawing
280 bool m_nativeSizeEvent
:1; // wxGLCanvas sends wxSizeEvent upon "alloc_size"
281 bool m_hasScrolling
:1;
285 bool m_acceptsFocus
:1; // true if not static
286 bool m_hasFocus
:1; // true if == FindFocus()
287 bool m_isScrolling
:1; // dragging scrollbar thumb?
288 bool m_clipPaintRegion
:1; // true after ScrollWindow()
289 bool m_dirtyTabOrder
:1; // tab order changed, GTK focus
290 // chain needs update
291 bool m_needsStyleChange
:1; // May not be able to change
292 // background style until OnIdle
293 bool m_mouseButtonDown
:1;
294 bool m_blockScrollEvent
:1;
296 bool m_showOnIdle
:1; // postpone showing the window until idle
298 // C++ has no virtual methods in the constrcutor of any class but we need
299 // different methods of inserting a child window into a wxFrame,
300 // wxMDIFrame, wxNotebook etc. this is the callback that will get used.
301 wxInsertChildFunction m_insertCallback
;
304 // implement the base class pure virtuals
305 virtual void DoClientToScreen( int *x
, int *y
) const;
306 virtual void DoScreenToClient( int *x
, int *y
) const;
307 virtual void DoGetPosition( int *x
, int *y
) const;
308 virtual void DoGetSize( int *width
, int *height
) const;
309 virtual void DoGetClientSize( int *width
, int *height
) const;
310 virtual void DoSetSize(int x
, int y
,
311 int width
, int height
,
312 int sizeFlags
= wxSIZE_AUTO
);
313 virtual void DoSetClientSize(int width
, int height
);
314 virtual void DoMoveWindow(int x
, int y
, int width
, int height
);
316 #if wxUSE_MENUS_NATIVE
317 virtual bool DoPopupMenu( wxMenu
*menu
, int x
, int y
);
318 #endif // wxUSE_MENUS_NATIVE
320 virtual void DoCaptureMouse();
321 virtual void DoReleaseMouse();
324 virtual void DoSetToolTip( wxToolTip
*tip
);
325 #endif // wxUSE_TOOLTIPS
327 // common part of all ctors (not virtual because called from ctor)
330 virtual void DoMoveInTabOrder(wxWindow
*win
, MoveKind move
);
332 // Copies m_children tab order to GTK focus chain:
333 void RealizeTabOrder();
335 // Called by ApplyWidgetStyle (which is called by SetFont() and
336 // SetXXXColour etc to apply style changed to native widgets) to create
337 // modified GTK style with non-standard attributes. If forceStyle=true,
338 // creates empty GtkRcStyle if there are no modifications, otherwise
339 // returns NULL in such case.
340 GtkRcStyle
*CreateWidgetStyle(bool forceStyle
= false);
342 // Overridden in many GTK widgets who have to handle subwidgets
343 virtual void ApplyWidgetStyle(bool forceStyle
= false);
345 // helper function to ease native widgets wrapping, called by
346 // ApplyWidgetStyle -- override this, not ApplyWidgetStyle
347 virtual void DoApplyWidgetStyle(GtkRcStyle
*style
);
349 // sets the border of a given GtkScrolledWindow from a wx style
350 static void GtkScrolledWindowSetBorder(GtkWidget
* w
, int style
);
352 // set the current cursor for all GdkWindows making part of this widget
353 // (see GTKGetWindow)
355 // should be called from OnInternalIdle() if it's overridden
356 void GTKUpdateCursor();
359 enum ScrollUnit
{ ScrollUnit_Line
, ScrollUnit_Page
, ScrollUnit_Max
};
361 // common part of ScrollLines() and ScrollPages() and could be used, in the
362 // future, for horizontal scrolling as well
364 // return true if we scrolled, false otherwise (on error or simply if we
365 // are already at the end)
366 bool DoScrollByUnits(ScrollDir dir
, ScrollUnit unit
, int units
);
369 DECLARE_DYNAMIC_CLASS(wxWindowGTK
)
370 DECLARE_NO_COPY_CLASS(wxWindowGTK
)
373 extern WXDLLIMPEXP_CORE wxWindow
*wxFindFocusedChild(wxWindowGTK
*win
);
375 #endif // _WX_GTK_WINDOW_H_