]> git.saurik.com Git - wxWidgets.git/blame - include/wx/motif/window.h
fixing xti problems
[wxWidgets.git] / include / wx / motif / window.h
CommitLineData
9b6dbb09
JS
1/////////////////////////////////////////////////////////////////////////////
2// Name: window.h
3// Purpose: wxWindow class
4// Author: Julian Smart
5// Modified by:
6// Created: 17/09/98
7// RCS-ID: $Id$
8// Copyright: (c) Julian Smart
34636400 9// Licence: wxWindows licence
9b6dbb09
JS
10/////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_WINDOW_H_
13#define _WX_WINDOW_H_
14
3399051e 15#if defined(__GNUG__) && !defined(__APPLE__)
83df96d6 16#pragma interface "window.h"
9b6dbb09
JS
17#endif
18
25f47127 19#include "wx/region.h"
af0bb3b1 20
34636400
VZ
21// ----------------------------------------------------------------------------
22// wxWindow class for Motif - see also wxWindowBase
23// ----------------------------------------------------------------------------
9b6dbb09 24
34636400 25class wxWindow : public wxWindowBase
9b6dbb09 26{
83df96d6
JS
27 friend class WXDLLEXPORT wxDC;
28 friend class WXDLLEXPORT wxWindowDC;
29
9b6dbb09 30public:
34636400 31 wxWindow() { Init(); }
83df96d6 32
34636400 33 wxWindow(wxWindow *parent,
83df96d6
JS
34 wxWindowID id,
35 const wxPoint& pos = wxDefaultPosition,
36 const wxSize& size = wxDefaultSize,
37 long style = 0,
38 const wxString& name = wxPanelNameStr)
bfc6fde4 39 {
34636400 40 Init();
bfc6fde4
VZ
41 Create(parent, id, pos, size, style, name);
42 }
83df96d6 43
bfc6fde4 44 virtual ~wxWindow();
83df96d6 45
34636400 46 bool Create(wxWindow *parent,
83df96d6
JS
47 wxWindowID id,
48 const wxPoint& pos = wxDefaultPosition,
49 const wxSize& size = wxDefaultSize,
50 long style = 0,
51 const wxString& name = wxPanelNameStr);
52
34636400
VZ
53 // implement base class pure virtuals
54 virtual void SetTitle( const wxString& title);
55 virtual wxString GetTitle() const;
83df96d6 56
bfc6fde4 57 virtual void Raise();
bfc6fde4 58 virtual void Lower();
83df96d6 59
34636400
VZ
60 virtual bool Show( bool show = TRUE );
61 virtual bool Enable( bool enable = TRUE );
83df96d6 62
34636400 63 virtual void SetFocus();
83df96d6 64
34636400 65 virtual void WarpPointer(int x, int y);
83df96d6 66
34636400 67 virtual void Refresh( bool eraseBackground = TRUE,
83df96d6 68 const wxRect *rect = (const wxRect *) NULL );
34636400 69 virtual void Clear();
83df96d6 70
af0bb3b1
VZ
71 virtual bool SetBackgroundColour( const wxColour &colour );
72 virtual bool SetForegroundColour( const wxColour &colour );
83df96d6 73
34636400
VZ
74 virtual bool SetCursor( const wxCursor &cursor );
75 virtual bool SetFont( const wxFont &font );
83df96d6 76
bfc6fde4
VZ
77 virtual int GetCharHeight() const;
78 virtual int GetCharWidth() const;
34636400 79 virtual void GetTextExtent(const wxString& string,
83df96d6
JS
80 int *x, int *y,
81 int *descent = (int *) NULL,
82 int *externalLeading = (int *) NULL,
83 const wxFont *theFont = (const wxFont *) NULL)
84 const;
85
34636400 86 virtual void SetScrollbar( int orient, int pos, int thumbVisible,
83df96d6 87 int range, bool refresh = TRUE );
34636400
VZ
88 virtual void SetScrollPos( int orient, int pos, bool refresh = TRUE );
89 virtual int GetScrollPos( int orient ) const;
90 virtual int GetScrollThumb( int orient ) const;
91 virtual int GetScrollRange( int orient ) const;
92 virtual void ScrollWindow( int dx, int dy,
83df96d6
JS
93 const wxRect* rect = (wxRect *) NULL );
94
47d67540 95#if wxUSE_DRAG_AND_DROP
34636400
VZ
96 virtual void SetDropTarget( wxDropTarget *dropTarget );
97#endif // wxUSE_DRAG_AND_DROP
83df96d6 98
bfc6fde4
VZ
99 // Accept files for dragging
100 virtual void DragAcceptFiles(bool accept);
83df96d6 101
af0bb3b1
VZ
102 // Get the unique identifier of a window
103 virtual WXWidget GetHandle() const { return GetMainWidget(); }
83df96d6 104
af0bb3b1
VZ
105 // implementation from now on
106 // --------------------------
83df96d6 107
af0bb3b1
VZ
108 // accessors
109 // ---------
83df96d6 110
af0bb3b1
VZ
111 // Get main widget for this window, e.g. a text widget
112 virtual WXWidget GetMainWidget() const;
a8680e3e
MB
113 // Get the widget that corresponds to the label (for font setting,
114 // label setting etc.)
af0bb3b1
VZ
115 virtual WXWidget GetLabelWidget() const;
116 // Get the client widget for this window (something we can create other
117 // windows on)
118 virtual WXWidget GetClientWidget() const;
119 // Get the top widget for this window, e.g. the scrolled widget parent of a
120 // multi-line text widget. Top means, top in the window hierarchy that
121 // implements this window.
122 virtual WXWidget GetTopWidget() const;
83df96d6 123
af0bb3b1 124 // Get the underlying X window and display
1807c27d 125 WXWindow GetClientXWindow() const;
af0bb3b1
VZ
126 WXWindow GetXWindow() const;
127 WXDisplay *GetXDisplay() const;
83df96d6 128
af0bb3b1 129 void SetLastClick(int button, long timestamp)
83df96d6
JS
130 { m_lastButton = button; m_lastTS = timestamp; }
131
af0bb3b1
VZ
132 int GetLastClickedButton() const { return m_lastButton; }
133 long GetLastClickTime() const { return m_lastTS; }
83df96d6 134
a8680e3e
MB
135 // Gives window a chance to do something in response to a size message,
136 // e.g. arrange status bar, toolbar etc.
af0bb3b1 137 virtual bool PreResize();
83df96d6 138
af0bb3b1
VZ
139 // Generates a paint event
140 virtual void DoPaint();
83df96d6 141
af0bb3b1
VZ
142 // update rectangle/region manipulation
143 // (for wxWindowDC and Motif callbacks only)
144 // -----------------------------------------
83df96d6 145
af0bb3b1 146 // Adds a recangle to the updates list
148b44a1 147 void AddUpdateRect(int x, int y, int w, int h);
83df96d6 148
af0bb3b1
VZ
149 void ClearUpdateRegion() { m_updateRegion.Clear(); }
150 void SetUpdateRegion(const wxRegion& region) { m_updateRegion = region; }
83df96d6 151
bfc6fde4
VZ
152 // For implementation purposes - sometimes decorations make the client area
153 // smaller
154 virtual wxPoint GetClientAreaOrigin() const;
e39af974
JS
155
156 // Process idle (send update events)
157 void OnInternalIdle();
83df96d6 158
d6eaea28 159protected:
bfc6fde4
VZ
160 // Responds to colour changes: passes event on to children.
161 void OnSysColourChanged(wxSysColourChangedEvent& event);
83df96d6 162
34636400 163 // Motif-specific
83df96d6 164
34636400 165 void SetMainWidget(WXWidget w) { m_mainWidget = w; }
83df96d6 166
37c997b4
MB
167 // See src/motif/window.cpp, near the top, for an explanation
168 // why this is necessary
169 void CanvasSetSizeIntr(int x, int y, int width, int height,
170 int sizeFlags, bool fromCtor);
171 void DoSetSizeIntr(int x, int y,
172 int width, int height,
173 int sizeFlags, bool fromCtor);
fc7ca9b3
MB
174
175 // for DoMoveWindowIntr flags
176 enum
177 {
178 wxMOVE_X = 1,
179 wxMOVE_Y = 2,
180 wxMOVE_WIDTH = 4,
181 wxMOVE_HEIGHT = 8
182 };
183
184 void DoMoveWindowIntr(int x, int y, int width, int height,
185 int flags);
148b44a1
MB
186
187 // helper function, to remove duplicate code, used in wxScrollBar
188 WXWidget DoCreateScrollBar(WXWidget parent, wxOrientation orientation,
189 void (*callback)());
9806a47c 190public:
34636400 191 WXPixmap GetBackingPixmap() const { return m_backingPixmap; }
9806a47c 192 void SetBackingPixmap(WXPixmap pixmap) { m_backingPixmap = pixmap; }
bfc6fde4
VZ
193 int GetPixmapWidth() const { return m_pixmapWidth; }
194 int GetPixmapHeight() const { return m_pixmapHeight; }
9806a47c
JS
195 void SetPixmapWidth(int w) { m_pixmapWidth = w; }
196 void SetPixmapHeight(int h) { m_pixmapHeight = h; }
83df96d6 197
bfc6fde4 198 // Change properties
a8680e3e
MB
199 // Change to the current font (often overridden)
200 virtual void ChangeFont(bool keepOriginalSize = TRUE);
83df96d6 201
34636400
VZ
202 // Change background and foreground colour using current background colour
203 // setting (Motif generates foreground based on background)
204 virtual void ChangeBackgroundColour();
205 // Change foreground colour using current foreground colour setting
206 virtual void ChangeForegroundColour();
83df96d6 207
da175b2c 208protected:
bfc6fde4 209 // Adds the widget to the hash table and adds event handlers.
34636400 210 bool AttachWidget(wxWindow* parent, WXWidget mainWidget,
83df96d6 211 WXWidget formWidget, int x, int y, int width, int height);
bfc6fde4 212 bool DetachWidget(WXWidget widget);
83df96d6 213
34636400
VZ
214 // How to implement accelerators. If we find a key event, translate to
215 // wxWindows wxKeyEvent form. Find a widget for the window. Now find a
216 // wxWindow for the widget. If there isn't one, go up the widget hierarchy
bfc6fde4
VZ
217 // trying to find one. Once one is found, call ProcessAccelerator for the
218 // window. If it returns TRUE (processed the event), skip the X event,
34636400
VZ
219 // otherwise carry on up the wxWindows window hierarchy calling
220 // ProcessAccelerator. If all return FALSE, process the X event as normal.
221 // Eventually we can implement OnCharHook the same way, but concentrate on
222 // accelerators for now. ProcessAccelerator must look at the current
223 // accelerator table, and try to find what menu id or window (beneath it)
224 // has this ID. Then construct an appropriate command
bfc6fde4 225 // event and send it.
d75638f8 226public:
bfc6fde4 227 virtual bool ProcessAccelerator(wxKeyEvent& event);
d75638f8
RR
228
229protected:
34636400
VZ
230 // unmanage and destroy an X widget f it's !NULL (passing NULL is ok)
231 void UnmanageAndDestroy(WXWidget widget);
83df96d6 232
a8680e3e
MB
233 // map or unmap an X widget (passing NULL is ok),
234 // returns TRUE if widget was mapped/unmapped
34636400 235 bool MapOrUnmap(WXWidget widget, bool map);
83df96d6 236
af0bb3b1
VZ
237 // scrolling stuff
238 // ---------------
83df96d6 239
af0bb3b1
VZ
240 // create/destroy window scrollbars
241 void CreateScrollbar(wxOrientation orientation);
242 void DestroyScrollbar(wxOrientation orientation);
83df96d6 243
34636400
VZ
244 // get either hor or vert scrollbar widget
245 WXWidget GetScrollbar(wxOrientation orient) const
83df96d6
JS
246 { return orient == wxHORIZONTAL ? m_hScrollBar : m_vScrollBar; }
247
34636400
VZ
248 // set the scroll pos
249 void SetInternalScrollPos(wxOrientation orient, int pos)
250 {
251 if ( orient == wxHORIZONTAL )
252 m_scrollPosX = pos;
253 else
254 m_scrollPosY = pos;
255 }
83df96d6 256
34636400 257 // Motif-specific flags
af0bb3b1 258 // --------------------
83df96d6 259
34636400 260 bool m_needsRefresh:1; // repaint backing store?
83df96d6 261
bfc6fde4 262 // For double-click detection
a8680e3e
MB
263 long m_lastTS; // last timestamp
264 unsigned m_lastButton:2; // last pressed button
83df96d6 265
9b6dbb09 266protected:
bfc6fde4
VZ
267 WXWidget m_mainWidget;
268 WXWidget m_hScrollBar;
269 WXWidget m_vScrollBar;
270 WXWidget m_borderWidget;
271 WXWidget m_scrolledWindow;
272 WXWidget m_drawingArea;
a8680e3e 273 bool m_winCaptured:1;
bfc6fde4
VZ
274 WXPixmap m_backingPixmap;
275 int m_pixmapWidth;
276 int m_pixmapHeight;
277 int m_pixmapOffsetX;
278 int m_pixmapOffsetY;
83df96d6 279
a8680e3e
MB
280 // Store the last scroll pos, since in wxWin the pos isn't set
281 // automatically by system
34636400
VZ
282 int m_scrollPosX;
283 int m_scrollPosY;
83df96d6 284
34636400
VZ
285 // implement the base class pure virtuals
286 virtual void DoClientToScreen( int *x, int *y ) const;
287 virtual void DoScreenToClient( int *x, int *y ) const;
288 virtual void DoGetPosition( int *x, int *y ) const;
289 virtual void DoGetSize( int *width, int *height ) const;
290 virtual void DoGetClientSize( int *width, int *height ) const;
bfc6fde4 291 virtual void DoSetSize(int x, int y,
83df96d6
JS
292 int width, int height,
293 int sizeFlags = wxSIZE_AUTO);
bfc6fde4 294 virtual void DoSetClientSize(int width, int height);
9d9b7755 295 virtual void DoMoveWindow(int x, int y, int width, int height);
ee31c392 296 virtual bool DoPopupMenu(wxMenu *menu, int x, int y);
4116c221
VZ
297 virtual void DoCaptureMouse();
298 virtual void DoReleaseMouse();
83df96d6 299
34636400
VZ
300#if wxUSE_TOOLTIPS
301 virtual void DoSetToolTip( wxToolTip *tip );
302#endif // wxUSE_TOOLTIPS
83df96d6 303
bfc6fde4 304private:
34636400
VZ
305 // common part of all ctors
306 void Init();
83df96d6 307
c4ea2971
GD
308 DECLARE_DYNAMIC_CLASS(wxWindow)
309 DECLARE_NO_COPY_CLASS(wxWindow)
bfc6fde4 310 DECLARE_EVENT_TABLE()
9b6dbb09
JS
311};
312
34636400 313// ----------------------------------------------------------------------------
af0bb3b1
VZ
314// A little class to switch off `size optimization' while an instance of the
315// object exists: this may be useful to temporarily disable the optimisation
316// which consists to do nothing when the new size is equal to the old size -
317// although quite useful usually to avoid flicker, sometimes it leads to
318// undesired effects.
34636400 319//
af0bb3b1 320// Usage: create an instance of this class on the stack to disable the size
a8680e3e
MB
321// optimisation, it will be reenabled as soon as the object goes out
322// from scope.
34636400 323// ----------------------------------------------------------------------------
af0bb3b1
VZ
324
325class WXDLLEXPORT wxNoOptimize
88150e60
JS
326{
327public:
83df96d6
JS
328 wxNoOptimize() { ms_count++; }
329 ~wxNoOptimize() { ms_count--; }
330
331 static bool CanOptimize() { return ms_count == 0; }
332
88150e60 333protected:
83df96d6 334 static int ms_count;
88150e60
JS
335};
336
9b6dbb09 337#endif
83df96d6 338// _WX_WINDOW_H_