]>
Commit | Line | Data |
---|---|---|
1 | ///////////////////////////////////////////////////////////////////////////// | |
2 | // Name: wx/gtk/window.h | |
3 | // Purpose: | |
4 | // Author: Robert Roebling | |
5 | // Id: $Id$ | |
6 | // Copyright: (c) 1998 Robert Roebling | |
7 | // Licence: wxWindows licence | |
8 | ///////////////////////////////////////////////////////////////////////////// | |
9 | ||
10 | ||
11 | #ifndef __GTKWINDOWH__ | |
12 | #define __GTKWINDOWH__ | |
13 | ||
14 | #if defined(__GNUG__) && !defined(__APPLE__) | |
15 | #pragma interface | |
16 | #endif | |
17 | ||
18 | //----------------------------------------------------------------------------- | |
19 | // callback definition for inserting a window (internal) | |
20 | //----------------------------------------------------------------------------- | |
21 | ||
22 | class wxWindowGTK; | |
23 | typedef void (*wxInsertChildFunction)( wxWindowGTK*, wxWindowGTK* ); | |
24 | ||
25 | //----------------------------------------------------------------------------- | |
26 | // wxWindowGTK | |
27 | //----------------------------------------------------------------------------- | |
28 | ||
29 | class wxWindowGTK : public wxWindowBase | |
30 | { | |
31 | public: | |
32 | // creating the window | |
33 | // ------------------- | |
34 | wxWindowGTK(); | |
35 | wxWindowGTK(wxWindow *parent, | |
36 | wxWindowID id, | |
37 | const wxPoint& pos = wxDefaultPosition, | |
38 | const wxSize& size = wxDefaultSize, | |
39 | long style = 0, | |
40 | const wxString& name = wxPanelNameStr); | |
41 | bool Create(wxWindow *parent, | |
42 | wxWindowID id, | |
43 | const wxPoint& pos = wxDefaultPosition, | |
44 | const wxSize& size = wxDefaultSize, | |
45 | long style = 0, | |
46 | const wxString& name = wxPanelNameStr); | |
47 | virtual ~wxWindowGTK(); | |
48 | ||
49 | // implement base class (pure) virtual methods | |
50 | // ------------------------------------------- | |
51 | ||
52 | virtual bool Destroy(); | |
53 | ||
54 | virtual void Raise(); | |
55 | virtual void Lower(); | |
56 | ||
57 | virtual bool Show( bool show = TRUE ); | |
58 | virtual bool Enable( bool enable = TRUE ); | |
59 | ||
60 | virtual bool IsRetained() const; | |
61 | ||
62 | virtual void SetFocus(); | |
63 | virtual bool AcceptsFocus() const; | |
64 | ||
65 | virtual bool Reparent( wxWindowBase *newParent ); | |
66 | ||
67 | virtual void WarpPointer(int x, int y); | |
68 | ||
69 | virtual void Refresh( bool eraseBackground = TRUE, | |
70 | const wxRect *rect = (const wxRect *) NULL ); | |
71 | virtual void Update(); | |
72 | virtual void Clear(); | |
73 | ||
74 | virtual bool SetBackgroundColour( const wxColour &colour ); | |
75 | virtual bool SetForegroundColour( const wxColour &colour ); | |
76 | virtual bool SetCursor( const wxCursor &cursor ); | |
77 | virtual bool SetFont( const wxFont &font ); | |
78 | ||
79 | virtual int GetCharHeight() const; | |
80 | virtual int GetCharWidth() const; | |
81 | virtual void GetTextExtent(const wxString& string, | |
82 | int *x, int *y, | |
83 | int *descent = (int *) NULL, | |
84 | int *externalLeading = (int *) NULL, | |
85 | const wxFont *theFont = (const wxFont *) NULL) | |
86 | const; | |
87 | ||
88 | #if wxUSE_MENUS_NATIVE | |
89 | virtual bool DoPopupMenu( wxMenu *menu, int x, int y ); | |
90 | #endif // wxUSE_MENUS_NATIVE | |
91 | ||
92 | virtual void SetScrollbar( int orient, int pos, int thumbVisible, | |
93 | int range, bool refresh = TRUE ); | |
94 | virtual void SetScrollPos( int orient, int pos, bool refresh = TRUE ); | |
95 | virtual int GetScrollPos( int orient ) const; | |
96 | virtual int GetScrollThumb( int orient ) const; | |
97 | virtual int GetScrollRange( int orient ) const; | |
98 | virtual void ScrollWindow( int dx, int dy, | |
99 | const wxRect* rect = (wxRect *) NULL ); | |
100 | ||
101 | #if wxUSE_DRAG_AND_DROP | |
102 | virtual void SetDropTarget( wxDropTarget *dropTarget ); | |
103 | #endif // wxUSE_DRAG_AND_DROP | |
104 | ||
105 | // implementation | |
106 | // -------------- | |
107 | ||
108 | virtual WXWidget GetHandle() const { return m_widget; } | |
109 | ||
110 | // I don't want users to override what's done in idle so everything that | |
111 | // has to be done in idle time in order for wxGTK to work is done in | |
112 | // OnInternalIdle | |
113 | virtual void OnInternalIdle(); | |
114 | ||
115 | // Internal represention of Update() | |
116 | void GtkUpdate(); | |
117 | ||
118 | // For delayed background | |
119 | void GtkSetBackgroundColour( const wxColour &colour ); | |
120 | void GtkSetForegroundColour( const wxColour &colour ); | |
121 | ||
122 | // For compatibility across platforms (not in event table) | |
123 | void OnIdle(wxIdleEvent& WXUNUSED(event)) {} | |
124 | ||
125 | // wxGTK-specific: called recursively by Enable, | |
126 | // to give widgets an oppprtunity to correct their colours after they | |
127 | // have been changed by Enable | |
128 | virtual void OnParentEnable( bool WXUNUSED(enable) ) {} | |
129 | ||
130 | // Used by all window classes in the widget creation process. | |
131 | bool PreCreation( wxWindowGTK *parent, const wxPoint &pos, const wxSize &size ); | |
132 | void PostCreation(); | |
133 | ||
134 | // Internal addition of child windows. differs from class | |
135 | // to class not by using virtual functions but by using | |
136 | // the m_insertCallback. | |
137 | void DoAddChild(wxWindowGTK *child); | |
138 | ||
139 | // This methods sends wxPaintEvents to the window. It reads the | |
140 | // update region, breaks it up into rects and sends an event | |
141 | // for each rect. It is also responsible for background erase | |
142 | // events and NC paint events. It is called from "draw" and | |
143 | // "expose" handlers as well as from ::Update() | |
144 | void GtkSendPaintEvents(); | |
145 | ||
146 | // The methods below are required because many native widgets | |
147 | // are composed of several subwidgets and setting a style for | |
148 | // the widget means setting it for all subwidgets as well. | |
149 | // also, it is nor clear, which native widget is the top | |
150 | // widget where (most of) the input goes. even tooltips have | |
151 | // to be applied to all subwidgets. | |
152 | virtual GtkWidget* GetConnectWidget(); | |
153 | virtual bool IsOwnGtkWindow( GdkWindow *window ); | |
154 | void ConnectWidget( GtkWidget *widget ); | |
155 | ||
156 | // Creates a new widget style if none is there | |
157 | // and sets m_widgetStyle to this value. | |
158 | GtkStyle *GetWidgetStyle(); | |
159 | ||
160 | #ifdef __WXGTK20__ | |
161 | // Returns the default context which usually is anti-aliased | |
162 | PangoContext *GtkGetPangoDefaultContext(); | |
163 | ||
164 | // Returns the X11 context which renders on the X11 client | |
165 | // side (which can be remote) and which usually is not | |
166 | // anti-aliased and is thus faster | |
167 | PangoContext *GtkGetPangoX11Context(); | |
168 | PangoContext *m_x11Context; | |
169 | #endif | |
170 | ||
171 | // Called by SetFont() and SetXXXColour etc | |
172 | void SetWidgetStyle(); | |
173 | ||
174 | // Overridden in many GTK widgets who have to handle subwidgets | |
175 | virtual void ApplyWidgetStyle(); | |
176 | ||
177 | #if wxUSE_TOOLTIPS | |
178 | virtual void ApplyToolTip( GtkTooltips *tips, const wxChar *tip ); | |
179 | #endif // wxUSE_TOOLTIPS | |
180 | ||
181 | // Called from GTK signales handlers. it indicates that | |
182 | // the layouting functions have to be called later on | |
183 | // (i.e. in idle time, implemented in OnInternalIdle() ). | |
184 | void GtkUpdateSize() { m_sizeSet = FALSE; } | |
185 | ||
186 | // fix up the mouse event coords, used by wxListBox only so far | |
187 | virtual void FixUpMouseEvent(GtkWidget * WXUNUSED(widget), | |
188 | wxCoord& WXUNUSED(x), | |
189 | wxCoord& WXUNUSED(y)) { } | |
190 | ||
191 | // is this window transparent for the mouse events (as wxStaticBox is)? | |
192 | virtual bool IsTransparentForMouse() const { return FALSE; } | |
193 | ||
194 | // is this a radiobutton (used by radiobutton code itself only)? | |
195 | virtual bool IsRadioButton() const { return FALSE; } | |
196 | ||
197 | // position and size of the window | |
198 | int m_x, m_y; | |
199 | int m_width, m_height; | |
200 | int m_oldClientWidth,m_oldClientHeight; | |
201 | ||
202 | // see the docs in src/gtk/window.cpp | |
203 | GtkWidget *m_widget; // mostly the widget seen by the rest of GTK | |
204 | GtkWidget *m_wxwindow; // mostly the client area as per wxWindows | |
205 | ||
206 | // this widget will be queried for GTK's focus events | |
207 | GtkWidget *m_focusWidget; | |
208 | ||
209 | #ifdef __WXGTK20__ | |
210 | GtkIMMulticontext *m_imContext; | |
211 | #else | |
212 | #if HAVE_XIM | |
213 | // XIM support for wxWindows | |
214 | GdkIC *m_ic; | |
215 | GdkICAttr *m_icattr; | |
216 | #endif | |
217 | #endif | |
218 | ||
219 | #ifndef __WXGTK20__ | |
220 | // The area to be cleared (and not just refreshed) | |
221 | // We cannot make this distinction under GTK 2.0. | |
222 | wxRegion m_clearRegion; | |
223 | #endif | |
224 | ||
225 | // scrolling stuff | |
226 | GtkAdjustment *m_hAdjust,*m_vAdjust; | |
227 | float m_oldHorizontalPos; | |
228 | float m_oldVerticalPos; | |
229 | ||
230 | // extra (wxGTK-specific) flags | |
231 | bool m_needParent:1; // ! wxFrame, wxDialog, wxNotebookPage ? | |
232 | bool m_noExpose:1; // wxGLCanvas has its own redrawing | |
233 | bool m_nativeSizeEvent:1; // wxGLCanvas sends wxSizeEvent upon "alloc_size" | |
234 | bool m_hasScrolling:1; | |
235 | bool m_hasVMT:1; | |
236 | bool m_sizeSet:1; | |
237 | bool m_resizing:1; | |
238 | bool m_acceptsFocus:1; // true if not static | |
239 | bool m_hasFocus:1; // true if == FindFocus() | |
240 | bool m_isScrolling:1; // dragging scrollbar thumb? | |
241 | bool m_clipPaintRegion:1; // TRUE after ScrollWindow() | |
242 | bool m_queuedFullRedraw:1; // TRUE after DoMoveWindow | |
243 | ||
244 | // These are true if the style were set before the widget was realized | |
245 | // (typcally in the constructor) but the actual GTK style must not be set | |
246 | // before the widget has been "realized" | |
247 | bool m_delayedForegroundColour:1; | |
248 | bool m_delayedBackgroundColour:1; | |
249 | ||
250 | // Contains GTK's widgets internal information about non-default widget | |
251 | // font and colours. we create one for each widget that gets any | |
252 | // non-default attribute set via SetFont() or SetForegroundColour() / | |
253 | // SetBackgroundColour(). | |
254 | GtkStyle *m_widgetStyle; | |
255 | ||
256 | // C++ has no virtual methods in the constrcutor of any class but we need | |
257 | // different methods of inserting a child window into a wxFrame, | |
258 | // wxMDIFrame, wxNotebook etc. this is the callback that will get used. | |
259 | wxInsertChildFunction m_insertCallback; | |
260 | ||
261 | // implement the base class pure virtuals | |
262 | virtual void DoClientToScreen( int *x, int *y ) const; | |
263 | virtual void DoScreenToClient( int *x, int *y ) const; | |
264 | virtual void DoGetPosition( int *x, int *y ) const; | |
265 | virtual void DoGetSize( int *width, int *height ) const; | |
266 | virtual void DoGetClientSize( int *width, int *height ) const; | |
267 | virtual void DoSetSize(int x, int y, | |
268 | int width, int height, | |
269 | int sizeFlags = wxSIZE_AUTO); | |
270 | virtual void DoSetClientSize(int width, int height); | |
271 | virtual void DoMoveWindow(int x, int y, int width, int height); | |
272 | ||
273 | virtual void DoCaptureMouse(); | |
274 | virtual void DoReleaseMouse(); | |
275 | ||
276 | #if wxUSE_TOOLTIPS | |
277 | virtual void DoSetToolTip( wxToolTip *tip ); | |
278 | #endif // wxUSE_TOOLTIPS | |
279 | ||
280 | protected: | |
281 | // common part of all ctors (not virtual because called from ctor) | |
282 | void Init(); | |
283 | ||
284 | private: | |
285 | DECLARE_DYNAMIC_CLASS(wxWindowGTK) | |
286 | DECLARE_NO_COPY_CLASS(wxWindowGTK) | |
287 | }; | |
288 | ||
289 | extern wxWindow *wxFindFocusedChild(wxWindowGTK *win); | |
290 | ||
291 | #endif // __GTKWINDOWH__ |