]> git.saurik.com Git - wxWidgets.git/blame - include/wx/msw/window.h
function HasValue() added
[wxWidgets.git] / include / wx / msw / window.h
CommitLineData
2bda0e17
KB
1/////////////////////////////////////////////////////////////////////////////
2// Name: window.h
3// Purpose: wxWindow class
4// Author: Julian Smart
5// Modified by:
6// Created: 01/02/97
7// RCS-ID: $Id$
8// Copyright: (c) Julian Smart and Markus Holzem
9// Licence: wxWindows licence
10/////////////////////////////////////////////////////////////////////////////
11
12#ifndef __WINDOWH__
13#define __WINDOWH__
14
15#ifdef __GNUG__
16#pragma interface "window.h"
17#endif
18
19#include "wx/gdicmn.h"
20#include "wx/icon.h"
21#include "wx/cursor.h"
22#include "wx/pen.h"
23#include "wx/font.h"
24#include "wx/validate.h"
25#include "wx/event.h"
26#include "wx/string.h"
27#include "wx/list.h"
28
29#define wxKEY_SHIFT 1
30#define wxKEY_CTRL 2
31
32/*
33 * Base class for frame, panel, canvas, panel items, dialog box.
34 *
35 */
36
37/*
38 * Event handler: windows have themselves as their event handlers
39 * by default, but their event handlers could be set to another
40 * object entirely. This separation can reduce the amount of
41 * derivation required, and allow alteration of a window's functionality
42 * (e.g. by a resource editor that temporarily switches event handlers).
43 */
44
45class WXDLLEXPORT wxWindow;
46class WXDLLEXPORT wxEvent;
47class WXDLLEXPORT wxCommandEvent;
48class WXDLLEXPORT wxKeyEvent;
49class WXDLLEXPORT wxControl;
50class WXDLLEXPORT wxCursor;
51class WXDLLEXPORT wxColourMap;
52class WXDLLEXPORT wxFont;
53class WXDLLEXPORT wxMenu;
54class WXDLLEXPORT wxRectangle;
55class WXDLLEXPORT wxBitmap;
56class WXDLLEXPORT wxSizer;
57class WXDLLEXPORT wxList;
58class WXDLLEXPORT wxLayoutConstraints;
59class WXDLLEXPORT wxMouseEvent;
60class WXDLLEXPORT wxButton;
61class WXDLLEXPORT wxColour;
62class WXDLLEXPORT wxBrush;
63class WXDLLEXPORT wxPen;
64class WXDLLEXPORT wxIcon;
65class WXDLLEXPORT wxDC;
66class WXDLLEXPORT wxValidator;
67
68#if USE_DRAG_AND_DROP
69class wxDropTarget;
70#endif
71
72#if USE_WX_RESOURCES
73class WXDLLEXPORT wxResourceTable;
74class WXDLLEXPORT wxItemResource;
75#endif
76
77WXDLLEXPORT_DATA(extern const char*) wxPanelNameStr;
78
79WXDLLEXPORT_DATA(extern const wxSize) wxDefaultSize;
80WXDLLEXPORT_DATA(extern const wxPoint) wxDefaultPosition;
81
82class WXDLLEXPORT wxWindow: public wxEvtHandler
83{
84 DECLARE_ABSTRACT_CLASS(wxWindow)
85
86 friend class wxUpdateIterator;
87 friend class wxDC;
88 friend class wxPaintDC;
89
90public:
91 wxWindow(void);
92 inline wxWindow(wxWindow *parent, const wxWindowID id,
93 const wxPoint& pos = wxDefaultPosition,
94 const wxSize& size = wxDefaultSize,
95 const long style = 0,
96 const wxString& name = wxPanelNameStr)
97 {
98 m_children = new wxList;
99 Create(parent, id, pos, size, style, name);
100 }
101
102 virtual ~wxWindow(void);
103
104 bool Create(wxWindow *parent, const wxWindowID id,
105 const wxPoint& pos = wxDefaultPosition,
106 const wxSize& size = wxDefaultSize,
107 const long style = 0,
108 const wxString& name = wxPanelNameStr);
109
110 // Fit the window around the items
111 virtual void Fit(void);
112
113 // Show or hide the window
114 virtual bool Show(const bool show);
115
116 // Is the window shown?
117 virtual bool IsShown(void) const;
118
119 // Raise the window to the top of the Z order
120 virtual void Raise(void);
121
122 // Lower the window to the bottom of the Z order
123 virtual void Lower(void);
124
125 // Is the window enabled?
126 virtual bool IsEnabled(void) const;
127
128 // For compatibility
129 inline bool Enabled(void) const { return IsEnabled(); }
130
131 // Dialog support: override these and call
132 // base class members to add functionality
133 // that can't be done using validators.
134
135 // Transfer values to controls. If returns FALSE,
136 // it's an application error (pops up a dialog)
137 virtual bool TransferDataToWindow(void);
138
139 // Transfer values from controls. If returns FALSE,
140 // transfer failed: don't quit
141 virtual bool TransferDataFromWindow(void);
142
143 // Validate controls. If returns FALSE,
144 // validation failed: don't quit
145 virtual bool Validate(void);
146
147 // Return code for dialogs
148 inline void SetReturnCode(int retCode);
149 inline int GetReturnCode(void);
150
151 // Set the cursor
152 virtual void SetCursor(const wxCursor& cursor);
153 inline virtual wxCursor *GetCursor(void) const { return (wxCursor *)& m_windowCursor; };
154
155 // Get the window with the focus
156 static wxWindow *FindFocus(void);
157
158 // Get character size
159 virtual int GetCharHeight(void) const;
160 virtual int GetCharWidth(void) const;
161
162 // Get overall window size
163 virtual void GetSize(int *width, int *height) const;
164
165 // Get window position, relative to parent (or screen if no parent)
166 virtual void GetPosition(int *x, int *y) const;
167
168 // Get client (application-useable) size
169 virtual void GetClientSize(int *width, int *height) const;
170
171 // Set overall size and position
172 virtual void SetSize(const int x, const int y, const int width, const int height, const int sizeFlags = wxSIZE_AUTO);
173 inline virtual void SetSize(const int width, const int height) { SetSize(-1, -1, width, height, wxSIZE_USE_EXISTING); }
174 inline virtual void Move(const int x, const int y) { SetSize(x, y, -1, -1, wxSIZE_USE_EXISTING); }
175
176 // Set client size
177 virtual void SetClientSize(const int width, const int size);
178
179 // Convert client to screen coordinates
180 virtual void ClientToScreen(int *x, int *y) const;
181
182 // Convert screen to client coordinates
183 virtual void ScreenToClient(int *x, int *y) const;
184
185 // Set the focus to this window
186 virtual void SetFocus(void);
187
188 // Capture/release mouse
189 virtual void CaptureMouse(void);
190 virtual void ReleaseMouse(void);
191
192 // Enable or disable the window
193 virtual void Enable(const bool enable);
194
195#if USE_DRAG_AND_DROP
196 // Associate a drop target with this window (if the window already had a drop
197 // target, it's deleted!) and return the current drop target (may be NULL).
198 void SetDropTarget(wxDropTarget *pDropTarget);
199 wxDropTarget *GetDropTarget() const { return m_pDropTarget; }
200#endif
201
202 // Accept files for dragging
203 virtual void DragAcceptFiles(const bool accept);
204
205 // Set/get the window title
206 virtual inline void SetTitle(const wxString& WXUNUSED(title)) {};
207 inline virtual wxString GetTitle(void) const { return wxString(""); };
208 // Most windows have the concept of a label; for frames, this is the
209 // title; for items, this is the label or button text.
210 inline virtual wxString GetLabel(void) const { return GetTitle(); }
211
212 // Set/get the window name (used for resource setting in X)
213 inline virtual wxString GetName(void) const;
214 inline virtual void SetName(const wxString& name);
215
216 // Centre the window
217 virtual void Centre(const int direction) ;
218 inline void Center(const int direction = wxHORIZONTAL) { Centre(direction); }
219
220 // Popup a menu
221 virtual bool PopupMenu(wxMenu *menu, const int x, const int y);
222
223 // Send the window a refresh event
224 virtual void Refresh(const bool eraseBack = TRUE, const wxRectangle *rect = NULL);
225
226#if WXWIN_COMPATIBILITY
227 // Set/get scroll attributes
228 virtual void SetScrollRange(const int orient, const int range, const bool refresh = TRUE);
229 virtual void SetScrollPage(const int orient, const int page, const bool refresh = TRUE);
230 virtual int OldGetScrollRange(const int orient) const;
231 virtual int GetScrollPage(const int orient) const;
232#endif
233
234 // New functions that will replace the above.
235 virtual void SetScrollbar(const int orient, const int pos, const int thumbVisible,
236 const int range, const bool refresh = TRUE);
237
238 virtual void SetScrollPos(const int orient, const int pos, const bool refresh = TRUE);
239 virtual int GetScrollPos(const int orient) const;
240 virtual int GetScrollRange(const int orient) const;
241 virtual int GetScrollThumb(const int orient) const;
242
243 virtual void ScrollWindow(const int dx, const int dy, const wxRectangle *rect = NULL);
244
245 // Caret manipulation
246 virtual void CreateCaret(const int w, const int h);
247 virtual void CreateCaret(const wxBitmap *bitmap);
248 virtual void DestroyCaret(void);
249 virtual void ShowCaret(const bool show);
250 virtual void SetCaretPos(const int x, const int y);
251 virtual void GetCaretPos(int *x, int *y) const;
252
253 // Tell window how much it can be sized
254 virtual void SetSizeHints(const int minW = -1, const int minH = -1, const int maxW = -1, const int maxH = -1, const int incW = -1, const int incH = -1);
255
256 // Set/get the window's identifier
257 inline int GetId() const;
258 inline void SetId(const int id);
259
260 // Make the window modal (all other windows unresponsive)
261 virtual void MakeModal(const bool modal);
262
263 // Get the private handle (platform-dependent)
264 inline void *GetHandle(void) const;
265
266 // Set/get the window's relatives
267 inline wxWindow *GetParent(void) const;
268 inline void SetParent(wxWindow *p) ;
269 inline wxWindow *GetGrandParent(void) const;
270 inline wxList *GetChildren() const;
271
272 // Set/get the window's font
273 virtual void SetFont(const wxFont& f);
274 inline virtual wxFont *GetFont(void) const;
275
276 // Set/get the window's validator
277 void SetValidator(const wxValidator& validator);
278 inline wxValidator *GetValidator(void) const;
279
280 // Set/get the window's style
281 inline void SetWindowStyleFlag(const long flag);
282 inline long GetWindowStyleFlag(void) const;
283
284 // Set/get double-clickability
285 // TODO: we probably wish to get rid of this, and
286 // always allow double clicks.
287 inline void SetDoubleClick(const bool flag);
288 inline bool GetDoubleClick(void) const;
289 inline void AllowDoubleClick(const bool value) { SetDoubleClick(value); }
290
291 // Old way to handle a control command
292 virtual void OnCommand(wxWindow& win, wxCommandEvent& event);
293
294 // Set/get event handler
295 inline void SetEventHandler(wxEvtHandler *handler);
296 inline wxEvtHandler *GetEventHandler(void) const;
297
298 // Push/pop event handler (i.e. allow a chain of event handlers
299 // be searched)
300 void PushEventHandler(wxEvtHandler *handler) ;
301 wxEvtHandler *PopEventHandler(bool deleteHandler = FALSE) ;
302
303 // Close the window by calling OnClose, posting a deletion
304 virtual bool Close(const bool force = FALSE);
305
306 // Destroy the window (delayed, if a managed window)
307 virtual bool Destroy(void) ;
308
309 // Mode for telling default OnSize members to
310 // call Layout(), if not using Sizers, just top-down constraints
311 inline void SetAutoLayout(const bool a);
312 inline bool GetAutoLayout(void) const;
313
314 // Set/get constraints
315 inline wxLayoutConstraints *GetConstraints(void) const;
316 void SetConstraints(wxLayoutConstraints *c);
317
318 // Set/get window background colour
319 inline virtual void SetBackgroundColour(const wxColour& col);
320 inline virtual wxColour GetBackgroundColour(void) const;
321
322 // Set/get window foreground colour
323 inline virtual void SetForegroundColour(const wxColour& col);
324 inline virtual wxColour GetForegroundColour(void) const;
325
326 // TODO: are these really necessary???
327 // Set/get window default background colour (for children to inherit)
328 inline virtual void SetDefaultBackgroundColour(const wxColour& col);
329 inline virtual wxColour GetDefaultBackgroundColour(void) const;
330
331 // Set/get window default foreground colour (for children to inherit)
332 inline virtual void SetDefaultForegroundColour(const wxColour& col);
333 inline virtual wxColour GetDefaultForegroundColour(void) const;
334
335 // For backward compatibility
336 inline virtual void SetButtonFont(const wxFont& font) { SetFont(font); }
337 inline virtual void SetLabelFont(const wxFont& font) { SetFont(font); }
338 inline virtual wxFont *GetLabelFont(void) const { return GetFont(); };
339 inline virtual wxFont *GetButtonFont(void) const { return GetFont(); };
340
341 // Get the default button, if there is one
342 inline virtual wxButton *GetDefaultItem(void) const;
343 inline virtual void SetDefaultItem(wxButton *but);
344
345 // Override to define new behaviour for default action (e.g. double clicking
346 // on a listbox)
347 virtual void OnDefaultAction(wxControl *initiatingItem);
348
349 // Resource loading
350#if USE_WX_RESOURCES
351 virtual bool LoadFromResource(wxWindow *parent, const wxString& resourceName, const wxResourceTable *table = NULL);
352 virtual wxControl *CreateItem(const wxItemResource *childResource, const wxResourceTable *table = NULL);
353#endif
354
355 // Native resource loading
356 virtual bool LoadNativeDialog(wxWindow* parent, const wxWindowID& id);
357 virtual bool LoadNativeDialog(wxWindow* parent, const wxString& name);
358 virtual wxWindow* GetWindowChild1(const wxWindowID& id);
359 virtual wxWindow* GetWindowChild(const wxWindowID& id);
360
361 virtual void GetTextExtent(const wxString& string, int *x, int *y,
362 int *descent = NULL,
363 int *externalLeading = NULL,
364 const wxFont *theFont = NULL, const bool use16 = FALSE) const;
365#if WXWIN_COMPATIBILITY
366 void GetTextExtent(const wxString& string, float *x, float *y,
367 float *descent = NULL,
368 float *externalLeading = NULL,
369 const wxFont *theFont = NULL, const bool use16 = FALSE) const;
370#endif
371
372 // Gets 'context' member
373 // OBSOLETE
374 // TODO: how to make backward compatible?
375// inline wxDC *GetDC(void) const;
376
377 // Is the window retained?
378 inline bool IsRetained(void) const;
379
380 // Set the window's colourmap/palette
381 // OBSOLETE
382// virtual void SetPalette(wxPalette *palette);
383
384 // Warp the pointer the given position
385 virtual void WarpPointer(const int x_pos, const int y_pos) ;
386
387 // Clear the window
388 virtual void Clear(void);
389
390 // Find a window by id or name
391 virtual wxWindow *FindWindow(const long id);
392 virtual wxWindow *FindWindow(const wxString& name);
393
394 // Constraint operations
395 bool Layout(void);
396 void SetSizer(wxSizer *sizer); // Adds sizer child to this window
397 inline wxSizer *GetSizer(void) const ;
398 inline wxWindow *GetSizerParent(void) const ;
399 inline void SetSizerParent(wxWindow *win);
400
401 // Do Update UI processing for controls
402 void UpdateWindowUI(void);
403
404 void OnSize(wxSizeEvent& event);
405 void OnEraseBackground(wxEraseEvent& event);
406 void OnChar(wxKeyEvent& event);
407 void OnPaint(wxPaintEvent& event);
408 void OnIdle(wxIdleEvent& event);
409
410// virtual void OnChangeFocus(wxControl *from, wxControl *to);
411// virtual bool OnFunctionKey(wxKeyEvent &event);
412
413#if WXWIN_COMPATIBILITY
414 virtual void OldOnMenuSelect(int WXUNUSED(cmd));
415 virtual void OldOnInitMenuPopup(int WXUNUSED(pos));
416 virtual void OldOnScroll(wxCommandEvent& WXUNUSED(event));
417 virtual void OldOnPaint(void); // Called when needs painting
418 virtual void OldOnSize(int width, int height); // Called on resize
419 virtual void OldOnMouseEvent(wxMouseEvent& event); // Called on mouse event
420 virtual void OldOnChar(wxKeyEvent& event); // Called on character event
421 virtual void OldOnMenuCommand(int cmd); // Dealt with properly in wxFrame
422 inline virtual void OldOnMove(int WXUNUSED(x), int WXUNUSED(y)); // Called on move
423 inline virtual void OldOnActivate(bool WXUNUSED(active)); // Called on window activation (MSW)
424 virtual void OldOnSetFocus(void); // Called on setting focus
425 virtual void OldOnKillFocus(void); // Called on killing focus
426#endif
427
428/* THIS IS NOW OBSOLETE - all positions are in device units
429 // Calculates the position of a point on the window
430 // taking into account the position of scrollbars.
431 // Windows doesn't automatically reflect the position of the
432 // scrollbars - (0, 0) is always the top left of the visible window,
433 // whereas in XView, (0, 0) moves according to scrollbar positions.
434 virtual void CalcScrolledPosition(const int x, const int y, int *xx, int *yy) const ;
435
436 // Calculate logical (scroll-bar/scaling aware) position from
437 // device (pixel) position
438 virtual void CalcUnscrolledPosition(const int x, const int y, float *xx, float *yy) const ;
439*/
440
441public:
442 ////////////////////////////////////////////////////////////////////////
443 //// IMPLEMENTATION
444
445 // Windows subclassing
446 void SubclassWin(WXHWND hWnd);
447 void UnsubclassWin(void);
448 virtual long Default(void);
449 virtual bool MSWCommand(const WXUINT param, const WXWORD id);
450 virtual bool MSWNotify(const WXWPARAM wParam, const WXLPARAM lParam);
451 virtual wxWindow *FindItem(const int id) const;
452 virtual wxWindow *FindItemByHWND(const WXHWND hWnd, bool controlOnly = FALSE) const ;
453 virtual void PreDelete(const WXHDC dc); // Allows system cleanup
454 // TO DO: how many of these need to be virtual?
455 virtual WXHWND GetHWND(void) const ;
456 virtual void SetHWND(WXHWND hWnd);
457
458 // Make a Windows extended style from the given wxWindows window style
459 virtual WXDWORD MakeExtendedStyle(long style, bool eliminateBorders = TRUE);
460 // Determine whether 3D effects are wanted
461 virtual WXDWORD Determine3DEffects(WXDWORD defaultBorderStyle, bool *want3D);
462
463 virtual void AddChild(wxWindow *child); // Adds reference to the child object
464 virtual void RemoveChild(wxWindow *child); // Removes reference to child
465 // (but doesn't delete the child object)
466 virtual void DestroyChildren(void); // Removes and destroys all children
467
468 inline bool IsBeingDeleted(void);
469
470 // MSW only: TRUE if this control is part of the main control
471 virtual bool ContainsHWND(WXHWND WXUNUSED(hWnd)) const { return FALSE; };
472
473 // Constraint implementation
474 void UnsetConstraints(wxLayoutConstraints *c);
475 inline wxList *GetConstraintsInvolvedIn(void) const ;
476 // Back-pointer to other windows we're involved with, so if we delete
477 // this window, we must delete any constraints we're involved with.
478 void AddConstraintReference(wxWindow *otherWin);
479 void RemoveConstraintReference(wxWindow *otherWin);
480 void DeleteRelatedConstraints(void);
481
482 virtual void ResetConstraints(void);
483 virtual void SetConstraintSizes(const bool recurse = TRUE);
484 virtual bool LayoutPhase1(int *noChanges);
485 virtual bool LayoutPhase2(int *noChanges);
486 virtual bool DoPhase(const int);
487 // Transforms from sizer coordinate space to actual
488 // parent coordinate space
489 virtual void TransformSizerToActual(int *x, int *y) const ;
490
491 // Set size with transformation to actual coordinates if nec.
492 virtual void SizerSetSize(const int x, const int y, const int w, const int h);
493 virtual void SizerMove(const int x, const int y);
494
495 // Only set/get the size/position of the constraint (if any)
496 virtual void SetSizeConstraint(const int x, const int y, const int w, const int h);
497 virtual void MoveConstraint(const int x, const int y);
498 virtual void GetSizeConstraint(int *w, int *h) const ;
499 virtual void GetClientSizeConstraint(int *w, int *h) const ;
500 virtual void GetPositionConstraint(int *x, int *y) const ;
501
502 wxObject *GetChild(const int number) const ;
503
504 void MSWCreate(const int id, wxWindow *parent, const char *wclass, wxWindow *wx_win, const char *title,
505 const int x, const int y, const int width, const int height,
506 const WXDWORD style, const char *dialog_template = NULL,
507 const WXDWORD exendedStyle = 0);
508
509 // Actually defined in wx_canvs.cc since requires wxCanvas declaration
510 virtual void MSWDeviceToLogical(float *x, float *y) const ;
511
512 // Create an appropriate wxWindow from a HWND
513 virtual wxWindow* CreateWindowFromHWND(wxWindow* parent, WXHWND hWnd);
514
515 // Make sure the window style reflects the HWND style (roughly)
516 virtual void AdoptAttributesFromHWND(void);
517
518 // Setup background and foreground colours correctly
519 virtual void SetupColours(void);
520
521 // Handlers
522 virtual void MSWOnCreate(WXLPCREATESTRUCT cs);
523 virtual bool MSWOnPaint(void);
524 virtual WXHICON MSWOnQueryDragIcon(void) { return 0; }
525 virtual void MSWOnSize(const int x, const int y, const WXUINT flag);
526 virtual void MSWOnWindowPosChanging(void *lpPos);
527 virtual void MSWOnHScroll(const WXWORD nSBCode, const WXWORD pos, const WXHWND control);
528 virtual void MSWOnVScroll(const WXWORD nSBCode, const WXWORD pos, const WXHWND control);
529 virtual bool MSWOnCommand(const WXWORD id, const WXWORD cmd, const WXHWND control);
530 virtual long MSWOnSysCommand(WXWPARAM wParam, WXLPARAM lParam);
531 virtual bool MSWOnNotify(const WXWPARAM wParam, const WXLPARAM lParam);
532 virtual WXHBRUSH MSWOnCtlColor(const WXHDC dc, const WXHWND pWnd, const WXUINT nCtlColor,
533 const WXUINT message, const WXWPARAM wParam, const WXLPARAM lParam);
534 virtual bool MSWOnColorChange(const WXHWND hWnd, const WXUINT message, const WXWPARAM wParam, const WXLPARAM lParam);
535 virtual bool MSWOnEraseBkgnd(const WXHDC pDC);
536 virtual void MSWOnMenuHighlight(const WXWORD item, const WXWORD flags, const WXHMENU sysmenu);
537 virtual void MSWOnInitMenuPopup(const WXHMENU menu, const int pos, const bool isSystem);
538 virtual bool MSWOnClose(void);
539 virtual bool MSWOnDestroy(void);
540 virtual bool MSWOnSetFocus(const WXHWND wnd);
541 virtual bool MSWOnKillFocus(const WXHWND wnd);
542 virtual void MSWOnDropFiles(const WXWPARAM wParam);
543 virtual bool MSWOnInitDialog(WXHWND hWndFocus);
544 virtual void MSWOnShow(bool show, int status);
545
546 // TODO: rationalise these functions into 1 or 2 which take the
547 // event type as argument.
548 virtual void MSWOnLButtonDown(const int x, const int y, const WXUINT flags);
549 virtual void MSWOnLButtonUp(const int x, const int y, const WXUINT flags);
550 virtual void MSWOnLButtonDClick(const int x, const int y, const WXUINT flags);
551
552 virtual void MSWOnMButtonDown(const int x, const int y, const WXUINT flags);
553 virtual void MSWOnMButtonUp(const int x, const int y, const WXUINT flags);
554 virtual void MSWOnMButtonDClick(const int x, const int y, const WXUINT flags);
555
556 virtual void MSWOnRButtonDown(const int x, const int y, const WXUINT flags);
557 virtual void MSWOnRButtonUp(const int x, const int y, const WXUINT flags);
558 virtual void MSWOnRButtonDClick(const int x, const int y, const WXUINT flags);
559
560 virtual void MSWOnMouseMove(const int x, const int y, const WXUINT flags);
561 virtual void MSWOnMouseEnter(const int x, const int y, const WXUINT flags);
562 virtual void MSWOnMouseLeave(const int x, const int y, const WXUINT flags);
563
564 virtual void MSWOnChar(const WXWORD wParam, const WXLPARAM lParam, const bool isASCII = FALSE);
565
566 virtual bool MSWOnActivate(const int flag, const bool minimized, const WXHWND activate);
567 virtual long MSWOnMDIActivate(const long flag, const WXHWND activate, const WXHWND deactivate);
568
569 virtual bool MSWOnDrawItem(const int id, WXDRAWITEMSTRUCT *item);
570 virtual bool MSWOnMeasureItem(const int id, WXMEASUREITEMSTRUCT *item);
571
572 virtual void MSWOnJoyDown(const int joystick, const int x, const int y, const WXUINT flags);
573 virtual void MSWOnJoyUp(const int joystick, const int x, const int y, const WXUINT flags);
574 virtual void MSWOnJoyMove(const int joystick, const int x, const int y, const WXUINT flags);
575 virtual void MSWOnJoyZMove(const int joystick, const int z, const WXUINT flags);
576
577 // Window procedure
578 virtual long MSWWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam);
579
580 // Calls an appropriate default window procedure
581 virtual long MSWDefWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam);
582 virtual bool MSWProcessMessage(WXMSG* pMsg);
583 virtual void MSWDestroyWindow(void);
584
585 // Detach "Window" menu from menu bar so it doesn't get deleted
586 void MSWDetachWindowMenu(void);
587
588 inline WXFARPROC MSWGetOldWndProc() const;
589 inline void MSWSetOldWndProc(const WXFARPROC proc);
590
591 // Define for each class of dialog and control
592 virtual WXHBRUSH OnCtlColor(const WXHDC pDC, const WXHWND pWnd, const WXUINT nCtlColor,
593 WXUINT message, WXWPARAM wParam, WXLPARAM lParam);
594
595 inline void SetShowing(const bool show);
596 inline bool IsUserEnabled(void) const;
597 inline bool GetUseCtl3D(void) const ;
598 inline bool GetTransparentBackground(void) const ;
599
600 // Responds to colour changes: passes event on to children.
601 void OnSysColourChanged(wxSysColourChangedEvent& event);
602
603 // Transfers data to any child controls
604 void OnInitDialog(wxInitDialogEvent& event);
605
606 // Sends an OnInitDialog event, which in turns transfers data to
607 // to the window via validators.
608 virtual void InitDialog(void);
609
610 ////////////////////////////////////////////////////////////////////////
611 //// PROTECTED DATA
612protected:
613 int m_windowId;
614 long m_windowStyle; // Store the window's style
615 wxEvtHandler * m_windowEventHandler; // Usually is 'this'
616 wxLayoutConstraints * m_constraints; // Constraints for this window
617 wxList * m_constraintsInvolvedIn; // List of constraints we're involved in
618 wxSizer * m_windowSizer; // Window's top-level sizer (if any)
619 wxWindow * m_sizerParent; // Window's parent sizer (if any)
620 bool m_autoLayout; // Whether to call Layout() in OnSize
621 wxWindow * m_windowParent; // Each window always knows its parent
622 wxValidator * m_windowValidator;
623 // Old window proc, for subclassed controls
624 WXFARPROC m_oldWndProc;
625 bool m_useCtl3D; // Using CTL3D for this control
626
627 bool m_inOnSize; // Protection against OnSize reentry
628#ifndef __WIN32__
629 // Pointer to global memory, for EDIT controls that need
630 // special treatment to reduce USER area consumption.
631 WXHGLOBAL m_globalHandle;
632#endif
633
634 bool m_winEnabled;
635 int m_minSizeX;
636 int m_minSizeY;
637 int m_maxSizeX;
638 int m_maxSizeY;
639
640 // Caret data
641 int m_caretWidth;
642 int m_caretHeight;
643 bool m_caretEnabled;
644 bool m_caretShown;
645
646 // Device context being stored whilst drawing is done
647// WXHDC m_tempHDC;
648 // Temporary device context stored during an OnPaint
649// WXHDC m_paintHDC;
650 wxFont m_windowFont; // Window's font
651 bool m_isShown;
652 bool m_doubleClickAllowed ;
653 wxCursor m_windowCursor; // Window's cursor
654 bool m_winCaptured;
655 wxString m_windowName; // Window name
656
657#if USE_EXTENDED_STATICS
658 wxList m_staticItems;
659#endif
660
661 wxButton * m_defaultItem;
662
663 wxColour m_backgroundColour ;
664 wxColour m_defaultBackgroundColour;
665
666 wxColour m_foregroundColour ;
667 wxColour m_defaultForegroundColour;
668
669 bool m_backgroundTransparent;
670
671// wxDC * m_windowDC; // The canvas's device context
672
673 int m_xThumbSize;
674 int m_yThumbSize;
675
676 float m_lastXPos;
677 float m_lastYPos;
678 int m_lastEvent;
679
680 bool m_mouseInWindow;
681
682#if USE_DRAG_AND_DROP
683 wxDropTarget *m_pDropTarget; // the current drop target or NULL
684#endif //USE_DRAG_AND_DROP
685
686public:
687 WXHWND m_hWnd; // MS Windows window handle
688 WXUINT m_lastMsg;
689 WXWPARAM m_lastWParam;
690 WXLPARAM m_lastLParam;
691 wxRectangle m_updateRect; // Bounding box for screen damage area
692#ifdef __WIN32__
693 WXHRGN m_updateRgn; // NT allows access to the rectangle list
694#endif
695 WXHANDLE m_acceleratorTable;
696 WXHMENU m_hMenu; // Menu, if any
697 wxList * m_children; // Window's children
698 int m_returnCode;
699 bool m_isBeingDeleted; // Fudge because can't access parent
700 // when being deleted
701
702DECLARE_EVENT_TABLE()
703};
704
705////////////////////////////////////////////////////////////////////////
706//// INLINES
707
708inline void *wxWindow::GetHandle(void) const { return (void *)GetHWND(); }
709inline int wxWindow::GetId() const { return m_windowId; }
710inline void wxWindow::SetId(const int id) { m_windowId = id; }
711inline wxWindow *wxWindow::GetParent(void) const { return m_windowParent; }
712inline void wxWindow::SetParent(wxWindow *p) { m_windowParent = p; }
713inline wxWindow *wxWindow::GetGrandParent(void) const { return (m_windowParent ? m_windowParent->m_windowParent : NULL); }
714inline wxList *wxWindow::GetChildren() const { return m_children; }
715inline wxFont *wxWindow::GetFont(void) const { return (wxFont *) & m_windowFont; }
716inline wxString wxWindow::GetName(void) const { return m_windowName; }
717inline void wxWindow::SetName(const wxString& name) { m_windowName = name; }
718inline long wxWindow::GetWindowStyleFlag(void) const { return m_windowStyle; }
719inline void wxWindow::SetWindowStyleFlag(const long flag) { m_windowStyle = flag; }
720inline void wxWindow::SetDoubleClick(const bool flag) { m_doubleClickAllowed = flag; }
721inline bool wxWindow::GetDoubleClick(void) const { return m_doubleClickAllowed; }
722inline void wxWindow::SetEventHandler(wxEvtHandler *handler) { m_windowEventHandler = handler; }
723inline wxEvtHandler *wxWindow::GetEventHandler(void) const { return m_windowEventHandler; }
724inline void wxWindow::SetAutoLayout(const bool a) { m_autoLayout = a; }
725inline bool wxWindow::GetAutoLayout(void) const { return m_autoLayout; }
726inline wxLayoutConstraints *wxWindow::GetConstraints(void) const { return m_constraints; }
727inline void wxWindow::SetBackgroundColour(const wxColour& col) { m_backgroundColour = col; };
728inline wxColour wxWindow::GetBackgroundColour(void) const { return m_backgroundColour; };
729inline void wxWindow::SetForegroundColour(const wxColour& col) { m_foregroundColour = col; };
730inline wxColour wxWindow::GetForegroundColour(void) const { return m_foregroundColour; };
731inline void wxWindow::SetDefaultForegroundColour(const wxColour& col) { m_defaultForegroundColour = col; };
732inline wxColour wxWindow::GetDefaultForegroundColour(void) const { return m_defaultForegroundColour; };
733inline void wxWindow::SetDefaultBackgroundColour(const wxColour& col) { m_defaultBackgroundColour = col; };
734inline wxColour wxWindow::GetDefaultBackgroundColour(void) const { return m_defaultBackgroundColour; };
735
736inline wxButton *wxWindow::GetDefaultItem(void) const { return m_defaultItem; }
737inline void wxWindow::SetDefaultItem(wxButton *but) { m_defaultItem = but; }
738// inline wxDC *wxWindow::GetDC(void) const { return m_windowDC; }
739inline bool wxWindow::IsRetained(void) const { return ((m_windowStyle & wxRETAINED) == wxRETAINED); }
740#if WXWIN_COMPATIBILITY
741inline void wxWindow::OldOnMenuSelect(int WXUNUSED(cmd)) { Default(); };
742inline void wxWindow::OldOnInitMenuPopup(int WXUNUSED(pos)) { Default(); };
743inline void wxWindow::OldOnScroll(wxCommandEvent& WXUNUSED(event)) { Default(); };
744inline void wxWindow::OldOnMenuCommand(int WXUNUSED(cmd)) { Default(); } // Dealt with properly in wxFrame
745inline void wxWindow::OldOnMove(int WXUNUSED(x), int WXUNUSED(y)) { Default(); }; // Called on move
746inline void wxWindow::OldOnActivate(bool WXUNUSED(active)) { Default(); }; // Called on window activation (MSW)
747#endif
748inline void wxWindow::SetShowing(const bool show) { m_isShown = show; }
749inline wxList *wxWindow::GetConstraintsInvolvedIn(void) const { return m_constraintsInvolvedIn; }
750inline wxSizer *wxWindow::GetSizer(void) const { return m_windowSizer; }
751inline wxWindow *wxWindow::GetSizerParent(void) const { return m_sizerParent; }
752inline void wxWindow::SetSizerParent(wxWindow *win) { m_sizerParent = win; }
753inline WXFARPROC wxWindow::MSWGetOldWndProc() const { return m_oldWndProc; }
754inline void wxWindow::MSWSetOldWndProc(const WXFARPROC proc) { m_oldWndProc = proc; }
755inline wxValidator *wxWindow::GetValidator(void) const { return m_windowValidator; }
756inline bool wxWindow::IsUserEnabled(void) const { return m_winEnabled; }
757inline bool wxWindow::GetUseCtl3D(void) const { return m_useCtl3D; }
758inline bool wxWindow::GetTransparentBackground(void) const { return m_backgroundTransparent; }
759inline void wxWindow::SetReturnCode(int retCode) { m_returnCode = retCode; }
760inline int wxWindow::GetReturnCode(void) { return m_returnCode; }
761inline bool wxWindow::IsBeingDeleted(void) { return m_isBeingDeleted; }
762
763// Window specific (so far)
764wxWindow* WXDLLEXPORT wxGetActiveWindow(void);
765
766// Allows iteration through damaged rectangles in OnPaint
767class WXDLLEXPORT wxUpdateIterator
768{
769 int rects; // How many rects in Update region
770 int current; // Current rectangle index
771 void *rp; // current rectangle
772#ifdef __WIN32__
773 WXRGNDATA *rlist; // Storage for regiondata
774#endif
775
776 public:
777 wxUpdateIterator(wxWindow* wnd);
778 ~wxUpdateIterator(void);
779
780 operator int (void);
781 wxUpdateIterator* operator ++(int);
782 void GetRect(wxRectangle *rect);
783 int GetX();
784 int GetY();
785 int GetW();
786 int GetH();
787};
788
789WXDLLEXPORT_DATA(extern wxList) wxTopLevelWindows;
790
791int WXDLLEXPORT wxCharCodeMSWToWX(int keySym);
792int WXDLLEXPORT wxCharCodeWXToMSW(int id, bool *IsVirtual);
793
794// Allocates control ids
795int WXDLLEXPORT NewControlId(void);
796
797#endif
798 // __WINDOWH__