| 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(NO_GCC_PRAGMA) |
| 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 ClearBackground(); |
| 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__ |