]> git.saurik.com Git - wxWidgets.git/blame_incremental - include/wx/univ/window.h
Compilation fixes for Nano-X
[wxWidgets.git] / include / wx / univ / window.h
... / ...
CommitLineData
1///////////////////////////////////////////////////////////////////////////////
2// Name: wx/univ/window.h
3// Purpose: wxWindow class which is the base class for all
4// wxUniv port controls, it supports the customization of the
5// window drawing and input processing.
6// Author: Vadim Zeitlin
7// Modified by:
8// Created: 06.08.00
9// RCS-ID: $Id$
10// Copyright: (c) 2000 SciTech Software, Inc. (www.scitechsoft.com)
11// Licence: wxWindows license
12///////////////////////////////////////////////////////////////////////////////
13
14#ifndef _WX_UNIV_WINDOW_H_
15#define _WX_UNIV_WINDOW_H_
16
17#ifdef __GNUG__
18 #pragma interface "univwindow.h"
19#endif
20
21#include "wx/bitmap.h" // for m_bitmapBg
22
23class WXDLLEXPORT wxControlRenderer;
24class WXDLLEXPORT wxEventLoop;
25class WXDLLEXPORT wxMenu;
26class WXDLLEXPORT wxMenuBar;
27class WXDLLEXPORT wxRenderer;
28class WXDLLEXPORT wxScrollBar;
29
30// ----------------------------------------------------------------------------
31// constants
32// ----------------------------------------------------------------------------
33
34// control state flags used in wxRenderer and wxColourScheme
35enum
36{
37 wxCONTROL_DISABLED = 0x00000001, // control is disabled
38 wxCONTROL_FOCUSED = 0x00000002, // currently has keyboard focus
39 wxCONTROL_PRESSED = 0x00000004, // (button) is pressed
40 wxCONTROL_ISDEFAULT = 0x00000008, // only applies to the buttons
41 wxCONTROL_ISSUBMENU = wxCONTROL_ISDEFAULT, // only for menu items
42 wxCONTROL_CURRENT = 0x00000010, // mouse is currently over the control
43 wxCONTROL_SELECTED = 0x00000020, // selected item in e.g. listbox
44 wxCONTROL_CHECKED = 0x00000040, // (check/radio button) is checked
45 wxCONTROL_CHECKABLE = 0x00000080, // (menu) item can be checked
46
47 wxCONTROL_FLAGS_MASK = 0x000000ff,
48
49 // this is a pseudo flag not used directly by wxRenderer but rather by some
50 // controls internally
51 wxCONTROL_DIRTY = 0x80000000
52};
53
54// ----------------------------------------------------------------------------
55// wxWindow
56// ----------------------------------------------------------------------------
57
58#if defined(__WXMSW__)
59#define wxWindowNative wxWindowMSW
60#elif defined(__WXGTK__)
61#define wxWindowNative wxWindowGTK
62#elif defined(__WXMGL__)
63#define wxWindowNative wxWindowMGL
64#elif defined(__WXX11__)
65#define wxWindowNative wxWindowX11
66#elif defined(__WXMAC__)
67#define wxWindowNative wxWindowMac
68#endif
69
70class WXDLLEXPORT wxWindow : public wxWindowNative
71{
72public:
73 // ctors and create functions
74 // ---------------------------
75
76 wxWindow() { Init(); }
77
78 wxWindow(wxWindow *parent,
79 wxWindowID id,
80 const wxPoint& pos = wxDefaultPosition,
81 const wxSize& size = wxDefaultSize,
82 long style = 0,
83 const wxString& name = wxPanelNameStr)
84 : wxWindowNative(parent, id, pos, size, style | wxCLIP_CHILDREN, name)
85 { Init(); }
86
87 bool Create(wxWindow *parent,
88 wxWindowID id,
89 const wxPoint& pos = wxDefaultPosition,
90 const wxSize& size = wxDefaultSize,
91 long style = 0,
92 const wxString& name = wxPanelNameStr);
93
94 // background pixmap support
95 // -------------------------
96
97 virtual void SetBackground(const wxBitmap& bitmap,
98 int alignment = wxALIGN_CENTRE,
99 wxStretch stretch = wxSTRETCH_NOT);
100
101 const wxBitmap& GetBackgroundBitmap(int *alignment = NULL,
102 wxStretch *stretch = NULL) const;
103
104 // scrollbars: we (re)implement it ourselves using our own scrollbars
105 // instead of the native ones
106 // ------------------------------------------------------------------
107
108 virtual void SetScrollbar(int orient,
109 int pos,
110 int page,
111 int range,
112 bool refresh = TRUE );
113 virtual void SetScrollPos(int orient, int pos, bool refresh = TRUE);
114 virtual int GetScrollPos(int orient) const;
115 virtual int GetScrollThumb(int orient) const;
116 virtual int GetScrollRange(int orient) const;
117 virtual void ScrollWindow(int dx, int dy,
118 const wxRect* rect = (wxRect *) NULL);
119
120 // take into account the borders here
121 virtual wxPoint GetClientAreaOrigin() const;
122
123 // popup menu support
124 // ------------------
125
126 // NB: all menu related functions are implemented in menu.cpp
127
128#if wxUSE_MENUS
129 virtual bool DoPopupMenu(wxMenu *menu, int x, int y);
130
131 // this is wxUniv-specific private method to be used only by wxMenu
132 void DismissPopupMenu();
133#endif // wxUSE_MENUS
134
135 // miscellaneous other methods
136 // ---------------------------
137
138 // get the state information
139 virtual bool IsFocused() const;
140 virtual bool IsCurrent() const;
141 virtual bool IsPressed() const;
142 virtual bool IsDefault() const;
143
144 // return all state flags at once (combination of wxCONTROL_XXX values)
145 int GetStateFlags() const;
146
147 // set the "highlighted" flag and return TRUE if it changed
148 virtual bool SetCurrent(bool doit = TRUE);
149
150 // get the scrollbar (may be NULL) for the given orientation
151 wxScrollBar *GetScrollbar(int orient) const
152 {
153 return orient & wxVERTICAL ? m_scrollbarVert : m_scrollbarHorz;
154 }
155
156 // methods used by wxColourScheme to choose the colours for this window
157 // --------------------------------------------------------------------
158
159 // return TRUE if this is a panel/canvas window which contains other
160 // controls only
161 virtual bool IsCanvasWindow() const { return FALSE; }
162
163 // return TRUE if this a container window which contains the other items:
164 // e.g, a listbox, listctrl, treectrl, ... and FALSE if it is a monolithic
165 // control (e.g. a button, checkbox, ...)
166 virtual bool IsContainerWindow() const { return FALSE; }
167
168 // return TRUE if this control can be highlighted when the mouse is over
169 // it (the theme decides itself whether it is really highlighted or not)
170 virtual bool CanBeHighlighted() const { return FALSE; }
171
172 // return TRUE if we should use the colours/fonts returned by the
173 // corresponding GetXXX() methods instead of the default ones
174 bool UseBgCol() const { return m_hasBgCol; }
175 bool UseFgCol() const { return m_hasFgCol; }
176 bool UseFont() const { return m_hasFont; }
177
178 // return TRUE if this window serves as a container for the other windows
179 // only and doesn't get any input itself
180 virtual bool IsStaticBox() const { return FALSE; }
181
182 // returns the (low level) renderer to use for drawing the control by
183 // querying the current theme
184 wxRenderer *GetRenderer() const { return m_renderer; }
185
186 // scrolling helper: like ScrollWindow() except that it doesn't refresh the
187 // uncovered window areas but returns the rectangle to update (don't call
188 // this with both dx and dy non zero)
189 wxRect ScrollNoRefresh(int dx, int dy, const wxRect *rect = NULL);
190
191 // after scrollbars are added or removed they must be refreshed by calling
192 // this function
193 void RefreshScrollbars();
194
195 // erase part of the control
196 virtual void EraseBackground(wxDC& dc, const wxRect& rect);
197
198 // overridden base class methods
199 // -----------------------------
200
201 // the rect coordinates are, for us, in client coords, but if no rect is
202 // specified, the entire window is refreshed
203 virtual void Refresh(bool eraseBackground = TRUE,
204 const wxRect *rect = (const wxRect *) NULL);
205
206 // we refresh the window when it is dis/enabled
207 virtual bool Enable(bool enable = TRUE);
208
209protected:
210 // common part of all ctors
211 void Init();
212
213 // overridden base class virtuals
214
215 // we deal with the scrollbars in these functions
216 virtual void DoSetClientSize(int width, int height);
217 virtual void DoGetClientSize(int *width, int *height) const;
218 virtual wxHitTest DoHitTest(wxCoord x, wxCoord y) const;
219
220 // event handlers
221 void OnSize(wxSizeEvent& event);
222 void OnNcPaint(wxPaintEvent& event);
223 void OnPaint(wxPaintEvent& event);
224 void OnErase(wxEraseEvent& event);
225
226#if wxUSE_ACCEL || wxUSE_MENUS
227 void OnKeyDown(wxKeyEvent& event);
228#endif // wxUSE_ACCEL
229
230#if wxUSE_MENUS
231 void OnChar(wxKeyEvent& event);
232 void OnKeyUp(wxKeyEvent& event);
233#endif // wxUSE_MENUS
234
235 // draw the control background, return TRUE if done
236 virtual bool DoDrawBackground(wxDC& dc);
237
238 // draw the controls border
239 virtual void DoDrawBorder(wxDC& dc, const wxRect& rect);
240
241 // draw the controls contents
242 virtual void DoDraw(wxControlRenderer *renderer);
243
244 // calculate the best size for the client area of the window: default
245 // implementation of DoGetBestSize() uses this method and adds the border
246 // width to the result
247 virtual wxSize DoGetBestClientSize() const;
248 virtual wxSize DoGetBestSize() const;
249
250 // adjust the size of the window to take into account its borders
251 wxSize AdjustSize(const wxSize& size) const;
252
253 // put the scrollbars along the edges of the window
254 void PositionScrollbars();
255
256#if wxUSE_MENUS
257 // return the menubar of the parent frame or NULL
258 wxMenuBar *GetParentFrameMenuBar() const;
259#endif // wxUSE_MENUS
260
261 // the renderer we use
262 wxRenderer *m_renderer;
263
264 // background bitmap info
265 wxBitmap m_bitmapBg;
266 int m_alignBgBitmap;
267 wxStretch m_stretchBgBitmap;
268
269 // is the mouse currently inside the window?
270 bool m_isCurrent:1;
271
272#ifdef __WXMSW__
273 // override MSWWindowProc() to process WM_NCHITTEST
274 long MSWWindowProc(WXUINT message, WXWPARAM wParam, WXLPARAM lParam);
275#endif // __WXMSW__
276
277private:
278 // the window scrollbars
279 wxScrollBar *m_scrollbarHorz,
280 *m_scrollbarVert;
281
282#if wxUSE_MENUS
283 // the current modal event loop for the popup menu we show or NULL
284 static wxEventLoop *ms_evtLoopPopup;
285
286 // the last window over which Alt was pressed (used by OnKeyUp)
287 static wxWindow *ms_winLastAltPress;
288#endif // wxUSE_MENUS
289
290 DECLARE_DYNAMIC_CLASS(wxWindow)
291 DECLARE_EVENT_TABLE()
292};
293
294#endif // _WX_UNIV_WINDOW_H_
295