1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: wxWindow class
4 // Author: Julian Smart
8 // Copyright: (c) Julian Smart and Markus Holzem
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
16 #pragma interface "window.h"
19 #include "wx/gdicmn.h"
21 #include "wx/cursor.h"
24 #include "wx/validate.h"
26 #include "wx/string.h"
28 #include "wx/region.h"
29 #include "wx/msw/accel.h"
35 * Base class for frame, panel, canvas, panel items, dialog box.
40 * Event handler: windows have themselves as their event handlers
41 * by default, but their event handlers could be set to another
42 * object entirely. This separation can reduce the amount of
43 * derivation required, and allow alteration of a window's functionality
44 * (e.g. by a resource editor that temporarily switches event handlers).
47 class WXDLLEXPORT wxWindow
;
48 class WXDLLEXPORT wxEvent
;
49 class WXDLLEXPORT wxCommandEvent
;
50 class WXDLLEXPORT wxKeyEvent
;
51 class WXDLLEXPORT wxControl
;
52 class WXDLLEXPORT wxCursor
;
53 class WXDLLEXPORT wxColourMap
;
54 class WXDLLEXPORT wxFont
;
55 class WXDLLEXPORT wxMenu
;
56 class WXDLLEXPORT wxRect
;
57 class WXDLLEXPORT wxBitmap
;
58 class WXDLLEXPORT wxSizer
;
59 class WXDLLEXPORT wxList
;
60 class WXDLLEXPORT wxLayoutConstraints
;
61 class WXDLLEXPORT wxMouseEvent
;
62 class WXDLLEXPORT wxButton
;
63 class WXDLLEXPORT wxColour
;
64 class WXDLLEXPORT wxBrush
;
65 class WXDLLEXPORT wxPen
;
66 class WXDLLEXPORT wxIcon
;
67 class WXDLLEXPORT wxDC
;
68 class WXDLLEXPORT wxValidator
;
69 class WXDLLEXPORT wxToolTip
;
71 #if wxUSE_DRAG_AND_DROP
72 class WXDLLEXPORT wxDropTarget
;
75 #if wxUSE_WX_RESOURCES
76 class WXDLLEXPORT wxResourceTable
;
77 class WXDLLEXPORT wxItemResource
;
80 WXDLLEXPORT_DATA(extern const char*) wxPanelNameStr
;
82 WXDLLEXPORT_DATA(extern const wxSize
) wxDefaultSize
;
83 WXDLLEXPORT_DATA(extern const wxPoint
) wxDefaultPosition
;
85 //-----------------------------------------------------------------------------
87 //-----------------------------------------------------------------------------
93 virtual ~wxClientData() { }
96 //-----------------------------------------------------------------------------
98 //-----------------------------------------------------------------------------
100 class wxStringClientData
: public wxClientData
103 wxStringClientData() { }
104 wxStringClientData( wxString
&data
) { m_data
= data
; }
105 void SetData( wxString
&data
) { m_data
= data
; }
106 wxString
GetData() const { return m_data
; }
112 // Clash with Windows headers
121 class WXDLLEXPORT wxWindow
: public wxEvtHandler
123 DECLARE_ABSTRACT_CLASS(wxWindow
)
126 friend class wxPaintDC
;
130 wxWindow(wxWindow
*parent
, wxWindowID id
,
131 const wxPoint
& pos
= wxDefaultPosition
,
132 const wxSize
& size
= wxDefaultSize
,
134 const wxString
& name
= wxPanelNameStr
)
137 Create(parent
, id
, pos
, size
, style
, name
);
142 bool Create(wxWindow
*parent
, wxWindowID id
,
143 const wxPoint
& pos
= wxDefaultPosition
,
144 const wxSize
& size
= wxDefaultSize
,
146 const wxString
& name
= wxPanelNameStr
);
148 // Fit the window around the items
151 // Show or hide the window
152 virtual bool Show(bool show
);
154 // Is the window shown?
155 virtual bool IsShown() const;
157 // Raise the window to the top of the Z order
158 virtual void Raise();
160 // Lower the window to the bottom of the Z order
161 virtual void Lower();
163 // Is the window enabled?
164 virtual bool IsEnabled() const;
167 inline bool Enabled() const { return IsEnabled(); }
169 // Dialog support: override these and call
170 // base class members to add functionality
171 // that can't be done using validators.
173 // Transfer values to controls. If returns FALSE,
174 // it's an application error (pops up a dialog)
175 virtual bool TransferDataToWindow();
177 // Transfer values from controls. If returns FALSE,
178 // transfer failed: don't quit
179 virtual bool TransferDataFromWindow();
181 // Validate controls. If returns FALSE,
182 // validation failed: don't quit
183 virtual bool Validate();
185 // Return code for dialogs
186 inline void SetReturnCode(int retCode
);
187 inline int GetReturnCode();
190 virtual void SetCursor(const wxCursor
& cursor
);
191 inline virtual wxCursor
& GetCursor() const { return (wxCursor
& ) m_windowCursor
; };
193 // Get the window with the focus
194 static wxWindow
*FindFocus();
196 // Get character size
197 virtual int GetCharHeight() const;
198 virtual int GetCharWidth() const;
200 // Get overall window size
201 virtual void GetSize(int *width
, int *height
) const;
202 wxSize
GetSize() const { int w
, h
; GetSize(& w
, & h
); return wxSize(w
, h
); }
204 // Get window position, relative to parent (or screen if no parent)
205 virtual void GetPosition(int *x
, int *y
) const;
206 wxPoint
GetPosition() const
207 { int x
, y
; GetPosition(&x
, &y
); return wxPoint(x
, y
); }
209 // Get size and position
210 wxRect
GetRect() const
211 { int x
, y
, w
, h
; GetPosition(& x
, & y
); GetSize(& w
, & h
); return wxRect(x
, y
, w
, h
); }
213 // Get client (application-useable) size
214 virtual void GetClientSize(int *width
, int *height
) const;
215 wxSize
GetClientSize() const { int w
, h
; GetClientSize(& w
, & h
); return wxSize(w
, h
); }
217 // Set overall size and position
218 // generic function, may be overriden in derived classes
219 virtual void SetSize(int x
, int y
, int width
, int height
, int sizeFlags
= wxSIZE_AUTO
);
221 void SetSize(const wxRect
& rect
, int sizeFlags
= wxSIZE_AUTO
)
222 { SetSize(rect
.x
, rect
.y
, rect
.width
, rect
.height
, sizeFlags
); }
225 void SetSize(int width
, int height
)
226 { SetSize(-1, -1, width
, height
, wxSIZE_USE_EXISTING
); }
227 void SetSize(const wxSize
& size
)
228 { SetSize(-1, -1, size
.x
, size
.y
, wxSIZE_USE_EXISTING
); }
231 virtual void Move(int x
, int y
) { SetSize(x
, y
, -1, -1, wxSIZE_USE_EXISTING
); }
232 void Move(const wxPoint
& pt
) { SetSize(pt
.x
, pt
.y
, -1, -1, wxSIZE_USE_EXISTING
); }
235 virtual void SetClientSize(int width
, int height
);
236 void SetClientSize(const wxSize
& sz
) { SetClientSize(sz
.x
, sz
.y
); }
238 // Convert client to screen coordinates
239 virtual void ClientToScreen(int *x
, int *y
) const;
240 wxPoint
ClientToScreen(const wxPoint
& pt
) const
241 { int x
= pt
.x
; int y
= pt
.y
; ClientToScreen(& x
, & y
); return wxPoint(x
, y
); }
243 // Convert screen to client coordinates
244 virtual void ScreenToClient(int *x
, int *y
) const;
245 wxPoint
ScreenToClient(const wxPoint
& pt
) const
246 { int x
= pt
.x
; int y
= pt
.y
; ScreenToClient(& x
, & y
); return wxPoint(x
, y
); }
248 // Set the focus to this window
249 virtual void SetFocus();
251 // Capture/release mouse
252 virtual void CaptureMouse();
253 virtual void ReleaseMouse();
255 // Enable or disable the window
256 virtual void Enable(bool enable
);
258 #if wxUSE_DRAG_AND_DROP
259 // Associate a drop target with this window (if the window already had a drop
260 // target, it's deleted!) and return the current drop target (may be NULL).
261 void SetDropTarget(wxDropTarget
*pDropTarget
);
262 wxDropTarget
*GetDropTarget() const { return m_pDropTarget
; }
267 // create a tooltip with this text
268 void SetToolTip(const wxString
&tip
);
269 // pointer may be NULL to remove the tooltip
270 void SetToolTip(wxToolTip
*tooltip
);
271 // get the current tooltip (may return NULL if none)
272 wxToolTip
* GetToolTip() const { return m_tooltip
; }
273 #endif // wxUSE_TOOLTIPS
275 // Accept files for dragging
276 virtual void DragAcceptFiles(bool accept
);
278 // Update region access
279 virtual wxRegion
GetUpdateRegion() const;
280 virtual bool IsExposed(int x
, int y
, int w
, int h
) const;
281 virtual bool IsExposed(const wxPoint
& pt
) const;
282 virtual bool IsExposed(const wxRect
& rect
) const;
284 // Set/get the window title
285 virtual inline void SetTitle(const wxString
& WXUNUSED(title
)) {};
286 inline virtual wxString
GetTitle() const { return wxString(""); };
287 // Most windows have the concept of a label; for frames, this is the
288 // title; for items, this is the label or button text.
289 inline virtual wxString
GetLabel() const { return GetTitle(); }
291 // Set/get the window name (used for resource setting in X)
292 inline virtual wxString
GetName() const;
293 inline virtual void SetName(const wxString
& name
);
296 virtual void Centre(int direction
) ;
297 inline void Center(int direction
= wxHORIZONTAL
) { Centre(direction
); }
300 virtual bool PopupMenu(wxMenu
*menu
, int x
, int y
);
302 // Send the window a refresh event
303 virtual void Refresh(bool eraseBack
= TRUE
, const wxRect
*rect
= NULL
);
305 #if WXWIN_COMPATIBILITY
306 // Set/get scroll attributes
307 virtual void SetScrollRange(int orient
, int range
, bool refresh
= TRUE
);
308 virtual void SetScrollPage(int orient
, int page
, bool refresh
= TRUE
);
309 virtual int OldGetScrollRange(int orient
) const;
310 virtual int GetScrollPage(int orient
) const;
313 // New functions that will replace the above.
314 virtual void SetScrollbar(int orient
, int pos
, int thumbVisible
,
315 int range
, bool refresh
= TRUE
);
317 virtual void SetScrollPos(int orient
, int pos
, bool refresh
= TRUE
);
318 virtual int GetScrollPos(int orient
) const;
319 virtual int GetScrollRange(int orient
) const;
320 virtual int GetScrollThumb(int orient
) const;
322 virtual void ScrollWindow(int dx
, int dy
, const wxRect
*rect
= NULL
);
324 // Caret manipulation
325 virtual void CreateCaret(int w
, int h
);
326 virtual void CreateCaret(const wxBitmap
*bitmap
);
327 virtual void DestroyCaret();
328 virtual void ShowCaret(bool show
);
329 virtual void SetCaretPos(int x
, int y
);
330 virtual void GetCaretPos(int *x
, int *y
) const;
332 // Tell window how much it can be sized
333 virtual void SetSizeHints(int minW
= -1, int minH
= -1, int maxW
= -1, int maxH
= -1, int incW
= -1, int incH
= -1);
335 // Set/get the window's identifier
336 inline int GetId() const;
337 inline void SetId(int id
);
339 // Make the window modal (all other windows unresponsive)
340 virtual void MakeModal(bool modal
);
342 // Get the private handle (platform-dependent)
343 inline void *GetHandle() const;
345 // Set/get the window's relatives
346 inline wxWindow
*GetParent() const;
347 inline void SetParent(wxWindow
*p
) ;
348 inline wxWindow
*GetGrandParent() const;
349 inline wxList
& GetChildren() const;
350 // Set this window to be the child of 'parent'.
351 // Returns FALSE it's not possible (some systems
353 virtual bool Reparent(wxWindow
*parent
);
355 // Set/get the window's font
356 virtual void SetFont(const wxFont
& f
);
357 inline virtual wxFont
& GetFont() const;
359 // Set/get the window's validator
360 void SetValidator(const wxValidator
& validator
);
361 inline wxValidator
*GetValidator() const;
363 // Set/get the window's style
364 inline void SetWindowStyleFlag(long flag
);
365 inline long GetWindowStyleFlag() const;
367 // Set/get double-clickability
368 // TODO: we probably wish to get rid of this, and
369 // always allow double clicks.
370 inline void SetDoubleClick(bool flag
);
371 inline bool GetDoubleClick() const;
372 inline void AllowDoubleClick(bool value
) { SetDoubleClick(value
); }
374 // Handle a control command
375 virtual void OnCommand(wxWindow
& win
, wxCommandEvent
& event
);
377 // Set/get event handler
378 inline void SetEventHandler(wxEvtHandler
*handler
);
379 inline wxEvtHandler
*GetEventHandler() const;
381 // Push/pop event handler (i.e. allow a chain of event handlers
383 void PushEventHandler(wxEvtHandler
*handler
) ;
384 wxEvtHandler
*PopEventHandler(bool deleteHandler
= FALSE
) ;
386 // Close the window by calling OnClose, posting a deletion
387 virtual bool Close(bool force
= FALSE
);
389 // Destroy the window (delayed, if a managed window)
390 virtual bool Destroy() ;
392 // Mode for telling default OnSize members to
393 // call Layout(), if not using Sizers, just top-down constraints
394 inline void SetAutoLayout(bool a
);
395 inline bool GetAutoLayout() const;
397 // Set/get constraints
398 inline wxLayoutConstraints
*GetConstraints() const;
399 void SetConstraints(wxLayoutConstraints
*c
);
401 // Set/get window background colour
402 inline virtual void SetBackgroundColour(const wxColour
& col
);
403 inline virtual wxColour
GetBackgroundColour() const;
405 // Set/get window foreground colour
406 inline virtual void SetForegroundColour(const wxColour
& col
);
407 inline virtual wxColour
GetForegroundColour() const;
409 // For backward compatibility
410 inline virtual void SetButtonFont(const wxFont
& font
) { SetFont(font
); }
411 inline virtual void SetLabelFont(const wxFont
& font
) { SetFont(font
); }
412 inline virtual wxFont
& GetLabelFont() const { return GetFont(); };
413 inline virtual wxFont
& GetButtonFont() const { return GetFont(); };
415 // Get the default button, if there is one
416 inline virtual wxButton
*GetDefaultItem() const;
417 inline virtual void SetDefaultItem(wxButton
*but
);
419 virtual void SetAcceleratorTable(const wxAcceleratorTable
& accel
);
420 inline virtual wxAcceleratorTable
& GetAcceleratorTable() const { return (wxAcceleratorTable
&) m_acceleratorTable
; }
422 // Override to define new behaviour for default action (e.g. double clicking
424 virtual void OnDefaultAction(wxControl
*initiatingItem
);
427 #if wxUSE_WX_RESOURCES
428 virtual bool LoadFromResource(wxWindow
*parent
, const wxString
& resourceName
, const wxResourceTable
*table
= NULL
);
429 virtual wxControl
*CreateItem(const wxItemResource
* childResource
, const wxItemResource
* parentResource
, const wxResourceTable
*table
= NULL
);
432 // Native resource loading
433 virtual bool LoadNativeDialog(wxWindow
* parent
, wxWindowID
& id
);
434 virtual bool LoadNativeDialog(wxWindow
* parent
, const wxString
& name
);
435 virtual wxWindow
* GetWindowChild1(wxWindowID
& id
);
436 virtual wxWindow
* GetWindowChild(wxWindowID
& id
);
438 virtual void GetTextExtent(const wxString
& string
, int *x
, int *y
,
440 int *externalLeading
= NULL
,
441 const wxFont
*theFont
= NULL
, bool use16
= FALSE
) const;
443 // Is the window retained?
444 inline bool IsRetained() const;
446 // Warp the pointer the given position
447 virtual void WarpPointer(int x_pos
, int y_pos
) ;
450 virtual void Clear();
452 // Find a window by id or name
453 virtual wxWindow
*FindWindow(long id
);
454 virtual wxWindow
*FindWindow(const wxString
& name
);
456 // Constraint operations
458 void SetSizer(wxSizer
*sizer
); // Adds sizer child to this window
459 inline wxSizer
*GetSizer() const ;
460 inline wxWindow
*GetSizerParent() const ;
461 inline void SetSizerParent(wxWindow
*win
);
463 // Do Update UI processing for controls
464 void UpdateWindowUI();
466 void OnEraseBackground(wxEraseEvent
& event
);
467 void OnChar(wxKeyEvent
& event
);
468 void OnIdle(wxIdleEvent
& event
);
470 // Does this window want to accept keyboard focus?
471 virtual bool AcceptsFocus() const;
473 virtual void PrepareDC( wxDC
& WXUNUSED(dc
) ) {};
475 ////////////////////////////////////////////////////////////////////////
478 // For implementation purposes - sometimes decorations make the client area
480 virtual wxPoint
GetClientAreaOrigin() const;
482 // Makes an adjustment to the window position (for example, a frame that has
483 // a toolbar that it manages itself).
484 virtual void AdjustForParentClientOrigin(int& x
, int& y
, int sizeFlags
);
486 // Windows subclassing
487 void SubclassWin(WXHWND hWnd
);
488 void UnsubclassWin();
489 virtual long Default();
490 virtual bool MSWCommand(WXUINT param
, WXWORD id
);
492 // returns TRUE if the event was processed
493 virtual bool MSWNotify(WXWPARAM wParam
, WXLPARAM lParam
, WXLPARAM
*result
);
495 virtual wxWindow
*FindItem(int id
) const;
496 virtual wxWindow
*FindItemByHWND(WXHWND hWnd
, bool controlOnly
= FALSE
) const ;
497 virtual void PreDelete(WXHDC dc
); // Allows system cleanup
498 // TO DO: how many of these need to be virtual?
499 virtual WXHWND
GetHWND() const ;
500 virtual void SetHWND(WXHWND hWnd
);
502 // Make a Windows extended style from the given wxWindows window style
503 virtual WXDWORD
MakeExtendedStyle(long style
, bool eliminateBorders
= TRUE
);
504 // Determine whether 3D effects are wanted
505 virtual WXDWORD
Determine3DEffects(WXDWORD defaultBorderStyle
, bool *want3D
);
507 virtual void AddChild(wxWindow
*child
); // Adds reference to the child object
508 virtual void RemoveChild(wxWindow
*child
); // Removes reference to child
509 // (but doesn't delete the child object)
510 virtual void DestroyChildren(); // Removes and destroys all children
512 inline bool IsBeingDeleted();
514 // MSW only: TRUE if this control is part of the main control
515 virtual bool ContainsHWND(WXHWND
WXUNUSED(hWnd
)) const { return FALSE
; };
517 // Constraint implementation
518 void UnsetConstraints(wxLayoutConstraints
*c
);
519 inline wxList
*GetConstraintsInvolvedIn() const ;
520 // Back-pointer to other windows we're involved with, so if we delete
521 // this window, we must delete any constraints we're involved with.
522 void AddConstraintReference(wxWindow
*otherWin
);
523 void RemoveConstraintReference(wxWindow
*otherWin
);
524 void DeleteRelatedConstraints();
526 virtual void ResetConstraints();
527 virtual void SetConstraintSizes(bool recurse
= TRUE
);
528 virtual bool LayoutPhase1(int *noChanges
);
529 virtual bool LayoutPhase2(int *noChanges
);
530 virtual bool DoPhase(int);
531 // Transforms from sizer coordinate space to actual
532 // parent coordinate space
533 virtual void TransformSizerToActual(int *x
, int *y
) const ;
535 // Set size with transformation to actual coordinates if nec.
536 virtual void SizerSetSize(int x
, int y
, int w
, int h
);
537 virtual void SizerMove(int x
, int y
);
539 // Only set/get the size/position of the constraint (if any)
540 virtual void SetSizeConstraint(int x
, int y
, int w
, int h
);
541 virtual void MoveConstraint(int x
, int y
);
542 virtual void GetSizeConstraint(int *w
, int *h
) const ;
543 virtual void GetClientSizeConstraint(int *w
, int *h
) const ;
544 virtual void GetPositionConstraint(int *x
, int *y
) const ;
546 // Dialog units translations. Implemented in wincmn.cpp.
547 wxPoint
ConvertPixelsToDialog(const wxPoint
& pt
) ;
548 wxPoint
ConvertDialogToPixels(const wxPoint
& pt
) ;
549 inline wxSize
ConvertPixelsToDialog(const wxSize
& sz
)
550 { wxPoint
pt(ConvertPixelsToDialog(wxPoint(sz
.x
, sz
.y
))); return wxSize(pt
.x
, pt
.y
); }
551 inline wxSize
ConvertDialogToPixels(const wxSize
& sz
)
552 { wxPoint
pt(ConvertDialogToPixels(wxPoint(sz
.x
, sz
.y
))); return wxSize(pt
.x
, pt
.y
); }
554 wxObject
*GetChild(int number
) const ;
556 void MSWCreate(int id
, wxWindow
*parent
, const char *wclass
, wxWindow
*wx_win
, const char *title
,
557 int x
, int y
, int width
, int height
,
558 WXDWORD style
, const char *dialog_template
= NULL
,
559 WXDWORD exendedStyle
= 0);
561 // Actually defined in wx_canvs.cc since requires wxCanvas declaration
562 virtual void MSWDeviceToLogical(float *x
, float *y
) const ;
564 // Create an appropriate wxWindow from a HWND
565 virtual wxWindow
* CreateWindowFromHWND(wxWindow
* parent
, WXHWND hWnd
);
567 // Make sure the window style reflects the HWND style (roughly)
568 virtual void AdoptAttributesFromHWND();
570 // Setup background and foreground colours correctly
571 virtual void SetupColours();
573 // Saves the last message information before calling base version
574 virtual bool ProcessEvent(wxEvent
& event
);
577 virtual void MSWOnCreate(WXLPCREATESTRUCT cs
);
578 virtual bool MSWOnPaint();
579 virtual WXHICON
MSWOnQueryDragIcon() { return 0; }
580 virtual void MSWOnSize(int x
, int y
, WXUINT flag
);
581 virtual void MSWOnWindowPosChanging(void *lpPos
);
582 virtual void MSWOnHScroll(WXWORD nSBCode
, WXWORD pos
, WXHWND control
);
583 virtual void MSWOnVScroll(WXWORD nSBCode
, WXWORD pos
, WXHWND control
);
584 virtual bool MSWOnCommand(WXWORD id
, WXWORD cmd
, WXHWND control
);
585 virtual long MSWOnSysCommand(WXWPARAM wParam
, WXLPARAM lParam
);
586 virtual long MSWOnNotify(WXWPARAM wParam
, WXLPARAM lParam
);
587 virtual WXHBRUSH
MSWOnCtlColor(WXHDC dc
, WXHWND pWnd
, WXUINT nCtlColor
,
588 WXUINT message
, WXWPARAM wParam
, WXLPARAM lParam
);
589 virtual bool MSWOnColorChange(WXHWND hWnd
, WXUINT message
, WXWPARAM wParam
, WXLPARAM lParam
);
590 virtual long MSWOnPaletteChanged(WXHWND hWndPalChange
);
591 virtual long MSWOnQueryNewPalette();
592 virtual bool MSWOnEraseBkgnd(WXHDC pDC
);
593 virtual void MSWOnMenuHighlight(WXWORD item
, WXWORD flags
, WXHMENU sysmenu
);
594 virtual void MSWOnInitMenuPopup(WXHMENU menu
, int pos
, bool isSystem
);
595 virtual bool MSWOnClose();
596 // Return TRUE to end session, FALSE to veto end session.
597 virtual bool MSWOnQueryEndSession(long logOff
);
598 virtual bool MSWOnEndSession(bool endSession
, long logOff
);
599 virtual bool MSWOnDestroy();
600 virtual bool MSWOnSetFocus(WXHWND wnd
);
601 virtual bool MSWOnKillFocus(WXHWND wnd
);
602 virtual void MSWOnDropFiles(WXWPARAM wParam
);
603 virtual bool MSWOnInitDialog(WXHWND hWndFocus
);
604 virtual void MSWOnShow(bool show
, int status
);
606 // TODO: rationalise these functions into 1 or 2 which take the
607 // event type as argument.
608 virtual void MSWOnLButtonDown(int x
, int y
, WXUINT flags
);
609 virtual void MSWOnLButtonUp(int x
, int y
, WXUINT flags
);
610 virtual void MSWOnLButtonDClick(int x
, int y
, WXUINT flags
);
612 virtual void MSWOnMButtonDown(int x
, int y
, WXUINT flags
);
613 virtual void MSWOnMButtonUp(int x
, int y
, WXUINT flags
);
614 virtual void MSWOnMButtonDClick(int x
, int y
, WXUINT flags
);
616 virtual void MSWOnRButtonDown(int x
, int y
, WXUINT flags
);
617 virtual void MSWOnRButtonUp(int x
, int y
, WXUINT flags
);
618 virtual void MSWOnRButtonDClick(int x
, int y
, WXUINT flags
);
620 virtual void MSWOnMouseMove(int x
, int y
, WXUINT flags
);
621 virtual void MSWOnMouseEnter(int x
, int y
, WXUINT flags
);
622 virtual void MSWOnMouseLeave(int x
, int y
, WXUINT flags
);
624 virtual void MSWOnChar(WXWORD wParam
, WXLPARAM lParam
, bool isASCII
= FALSE
);
625 virtual void MSWOnKeyDown(WXWORD wParam
, WXLPARAM lParam
, bool isASCII
= FALSE
);
626 virtual void MSWOnKeyUp(WXWORD wParam
, WXLPARAM lParam
, bool isASCII
= FALSE
);
628 virtual bool MSWOnActivate(int flag
, bool minimized
, WXHWND activate
);
629 virtual long MSWOnMDIActivate(long flag
, WXHWND activate
, WXHWND deactivate
);
631 virtual bool MSWOnDrawItem(int id
, WXDRAWITEMSTRUCT
*item
);
632 virtual bool MSWOnMeasureItem(int id
, WXMEASUREITEMSTRUCT
*item
);
634 virtual void MSWOnJoyDown(int joystick
, int x
, int y
, WXUINT flags
);
635 virtual void MSWOnJoyUp(int joystick
, int x
, int y
, WXUINT flags
);
636 virtual void MSWOnJoyMove(int joystick
, int x
, int y
, WXUINT flags
);
637 virtual void MSWOnJoyZMove(int joystick
, int z
, WXUINT flags
);
639 virtual long MSWGetDlgCode();
642 virtual long MSWWindowProc(WXUINT nMsg
, WXWPARAM wParam
, WXLPARAM lParam
);
644 // Calls an appropriate default window procedure
645 virtual long MSWDefWindowProc(WXUINT nMsg
, WXWPARAM wParam
, WXLPARAM lParam
);
646 virtual bool MSWProcessMessage(WXMSG
* pMsg
);
647 virtual bool MSWTranslateMessage(WXMSG
* pMsg
);
648 virtual void MSWDestroyWindow();
650 // Detach "Window" menu from menu bar so it doesn't get deleted
651 void MSWDetachWindowMenu();
653 inline WXFARPROC
MSWGetOldWndProc() const;
654 inline void MSWSetOldWndProc(WXFARPROC proc
);
656 // Define for each class of dialog and control
657 virtual WXHBRUSH
OnCtlColor(WXHDC pDC
, WXHWND pWnd
, WXUINT nCtlColor
,
658 WXUINT message
, WXWPARAM wParam
, WXLPARAM lParam
);
660 inline void SetShowing(bool show
);
661 inline bool IsUserEnabled() const;
662 inline bool GetUseCtl3D() const ;
663 inline bool GetTransparentBackground() const ;
665 // Responds to colour changes: passes event on to children.
666 void OnSysColourChanged(wxSysColourChangedEvent
& event
);
668 // Transfers data to any child controls
669 void OnInitDialog(wxInitDialogEvent
& event
);
671 // Sends an OnInitDialog event, which in turns transfers data to
672 // to the window via validators.
673 virtual void InitDialog();
675 ////////////////////////////////////////////////////////////////////////
678 wxAcceleratorTable m_acceleratorTable
;
680 long m_windowStyle
; // Store the window's style
681 wxEvtHandler
* m_windowEventHandler
; // Usually is 'this'
682 wxLayoutConstraints
* m_constraints
; // Constraints for this window
683 wxList
* m_constraintsInvolvedIn
; // List of constraints we're involved in
684 wxSizer
* m_windowSizer
; // Window's top-level sizer (if any)
685 wxWindow
* m_sizerParent
; // Window's parent sizer (if any)
686 bool m_autoLayout
; // Whether to call Layout() in OnSize
687 wxWindow
* m_windowParent
; // Each window always knows its parent
688 wxValidator
* m_windowValidator
;
689 // Old window proc, for subclassed controls
690 WXFARPROC m_oldWndProc
;
691 bool m_useCtl3D
; // Using CTL3D for this control
693 bool m_inOnSize
; // Protection against OnSize reentry
695 // Pointer to global memory, for EDIT controls that need
696 // special treatment to reduce USER area consumption.
697 WXHGLOBAL m_globalHandle
;
711 wxFont m_windowFont
; // Window's font
713 bool m_doubleClickAllowed
;
714 wxCursor m_windowCursor
; // Window's cursor
716 wxString m_windowName
; // Window name
718 #if wxUSE_EXTENDED_STATICS
719 wxList m_staticItems
;
722 wxButton
* m_defaultItem
;
723 wxColour m_backgroundColour
;
724 wxColour m_foregroundColour
;
725 bool m_backgroundTransparent
;
734 bool m_mouseInWindow
;
736 #if wxUSE_DRAG_AND_DROP
737 wxDropTarget
*m_pDropTarget
; // the current drop target or NULL
738 #endif //USE_DRAG_AND_DROP
741 WXHWND m_hWnd
; // MS Windows window handle
743 WXWPARAM m_lastWParam
;
744 WXLPARAM m_lastLParam
;
746 wxRegion m_updateRegion
;
748 wxRect m_updateRect; // Bounding box for screen damage area
750 WXHRGN m_updateRgn; // NT allows access to the rectangle list
754 // WXHANDLE m_acceleratorTable;
755 WXHMENU m_hMenu
; // Menu, if any
756 wxList
* m_children
; // Window's children
758 bool m_isBeingDeleted
; // Fudge because can't access parent
759 // when being deleted
762 // common part of all ctors
765 // the associated tooltip (may be NULL if none)
767 wxToolTip
*m_tooltip
;
770 DECLARE_EVENT_TABLE()
773 ////////////////////////////////////////////////////////////////////////
776 inline void *wxWindow::GetHandle() const { return (void *)GetHWND(); }
777 inline int wxWindow::GetId() const { return m_windowId
; }
778 inline void wxWindow::SetId(int id
) { m_windowId
= id
; }
779 inline wxWindow
*wxWindow::GetParent() const { return m_windowParent
; }
780 inline void wxWindow::SetParent(wxWindow
*p
) { m_windowParent
= p
; }
781 inline wxWindow
*wxWindow::GetGrandParent() const { return (m_windowParent
? m_windowParent
->m_windowParent
: (wxWindow
*) NULL
); }
782 inline wxList
& wxWindow::GetChildren() const { return (wxList
&) *m_children
; }
783 inline wxFont
& wxWindow::GetFont() const { return (wxFont
&) m_windowFont
; }
784 inline wxString
wxWindow::GetName() const { return m_windowName
; }
785 inline void wxWindow::SetName(const wxString
& name
) { m_windowName
= name
; }
786 inline long wxWindow::GetWindowStyleFlag() const { return m_windowStyle
; }
787 inline void wxWindow::SetWindowStyleFlag(long flag
) { m_windowStyle
= flag
; }
788 inline void wxWindow::SetDoubleClick(bool flag
) { m_doubleClickAllowed
= flag
; }
789 inline bool wxWindow::GetDoubleClick() const { return m_doubleClickAllowed
; }
790 inline void wxWindow::SetEventHandler(wxEvtHandler
*handler
) { m_windowEventHandler
= handler
; }
791 inline wxEvtHandler
*wxWindow::GetEventHandler() const { return m_windowEventHandler
; }
792 inline void wxWindow::SetAutoLayout(bool a
) { m_autoLayout
= a
; }
793 inline bool wxWindow::GetAutoLayout() const { return m_autoLayout
; }
794 inline wxLayoutConstraints
*wxWindow::GetConstraints() const { return m_constraints
; }
795 inline void wxWindow::SetBackgroundColour(const wxColour
& col
) { m_backgroundColour
= col
; };
796 inline wxColour
wxWindow::GetBackgroundColour() const { return m_backgroundColour
; };
797 inline void wxWindow::SetForegroundColour(const wxColour
& col
) { m_foregroundColour
= col
; };
798 inline wxColour
wxWindow::GetForegroundColour() const { return m_foregroundColour
; };
800 inline wxButton
*wxWindow::GetDefaultItem() const { return m_defaultItem
; }
801 inline void wxWindow::SetDefaultItem(wxButton
*but
) { m_defaultItem
= but
; }
802 inline bool wxWindow::IsRetained() const { return ((m_windowStyle
& wxRETAINED
) == wxRETAINED
); }
804 inline void wxWindow::SetShowing(bool show
) { m_isShown
= show
; }
805 inline wxList
*wxWindow::GetConstraintsInvolvedIn() const { return m_constraintsInvolvedIn
; }
806 inline wxSizer
*wxWindow::GetSizer() const { return m_windowSizer
; }
807 inline wxWindow
*wxWindow::GetSizerParent() const { return m_sizerParent
; }
808 inline void wxWindow::SetSizerParent(wxWindow
*win
) { m_sizerParent
= win
; }
809 inline WXFARPROC
wxWindow::MSWGetOldWndProc() const { return m_oldWndProc
; }
810 inline void wxWindow::MSWSetOldWndProc(WXFARPROC proc
) { m_oldWndProc
= proc
; }
811 inline wxValidator
*wxWindow::GetValidator() const { return m_windowValidator
; }
812 inline bool wxWindow::IsUserEnabled() const { return m_winEnabled
; }
813 inline bool wxWindow::GetUseCtl3D() const { return m_useCtl3D
; }
814 inline bool wxWindow::GetTransparentBackground() const { return m_backgroundTransparent
; }
815 inline void wxWindow::SetReturnCode(int retCode
) { m_returnCode
= retCode
; }
816 inline int wxWindow::GetReturnCode() { return m_returnCode
; }
817 inline bool wxWindow::IsBeingDeleted() { return m_isBeingDeleted
; }
819 // Window specific (so far)
820 WXDLLEXPORT wxWindow
* wxGetActiveWindow();
822 WXDLLEXPORT_DATA(extern wxList
) wxTopLevelWindows
;
824 WXDLLEXPORT
int wxCharCodeMSWToWX(int keySym
);
825 WXDLLEXPORT
int wxCharCodeWXToMSW(int id
, bool *IsVirtual
);
827 // Allocates control ids
828 WXDLLEXPORT
int NewControlId();