]> git.saurik.com Git - wxWidgets.git/blame - src/common/wincmn.cpp
generic GetFromWindow() implementation for non-MSW platforms
[wxWidgets.git] / src / common / wincmn.cpp
CommitLineData
7ec1983b 1/////////////////////////////////////////////////////////////////////////////
7ec69821 2// Name: src/common/window.cpp
7ec1983b
VZ
3// Purpose: common (to all ports) wxWindow functions
4// Author: Julian Smart, Vadim Zeitlin
5// Modified by:
6// Created: 13/07/98
7// RCS-ID: $Id$
77ffb593 8// Copyright: (c) wxWidgets team
65571936 9// Licence: wxWindows licence
7ec1983b
VZ
10/////////////////////////////////////////////////////////////////////////////
11
f03fc89f
VZ
12// ============================================================================
13// declarations
14// ============================================================================
15
16// ----------------------------------------------------------------------------
17// headers
18// ----------------------------------------------------------------------------
f701d7ab 19
341287bf
JS
20// For compilers that support precompilation, includes "wx.h".
21#include "wx/wxprec.h"
22
f701d7ab 23#ifdef __BORLANDC__
f03fc89f 24 #pragma hdrstop
f701d7ab
JS
25#endif
26
f03fc89f
VZ
27#ifndef WX_PRECOMP
28 #include "wx/string.h"
29 #include "wx/log.h"
30 #include "wx/intl.h"
31 #include "wx/frame.h"
32 #include "wx/defs.h"
33 #include "wx/window.h"
1e6feb95 34 #include "wx/control.h"
f03fc89f
VZ
35 #include "wx/checkbox.h"
36 #include "wx/radiobut.h"
106844da 37 #include "wx/statbox.h"
26bf1ce0 38 #include "wx/textctrl.h"
f03fc89f
VZ
39 #include "wx/settings.h"
40 #include "wx/dialog.h"
a02dc3e3 41 #include "wx/msgdlg.h"
a37a5a73 42 #include "wx/statusbr.h"
e0cf3745 43 #include "wx/toolbar.h"
ed39ff57 44 #include "wx/dcclient.h"
f03fc89f
VZ
45#endif //WX_PRECOMP
46
7d59475e
JS
47#if defined(__WXMAC__) && wxUSE_SCROLLBAR
48 #include "wx/scrolbar.h"
49#endif
50
f03fc89f
VZ
51#if wxUSE_CONSTRAINTS
52 #include "wx/layout.h"
53#endif // wxUSE_CONSTRAINTS
54
461e93f9
JS
55#include "wx/sizer.h"
56
f03fc89f
VZ
57#if wxUSE_DRAG_AND_DROP
58 #include "wx/dnd.h"
59#endif // wxUSE_DRAG_AND_DROP
60
ed5317e5 61#if wxUSE_ACCESSIBILITY
7de59551 62 #include "wx/access.h"
ed5317e5
JS
63#endif
64
bd83cb56
VZ
65#if wxUSE_HELP
66 #include "wx/cshelp.h"
67#endif // wxUSE_HELP
68
f03fc89f
VZ
69#if wxUSE_TOOLTIPS
70 #include "wx/tooltip.h"
71#endif // wxUSE_TOOLTIPS
72
789295bf
VZ
73#if wxUSE_CARET
74 #include "wx/caret.h"
75#endif // wxUSE_CARET
76
ff9f7a12 77#if wxUSE_SYSTEM_OPTIONS
cab1a605 78 #include "wx/sysopt.h"
ff9f7a12
SC
79#endif
80
0118b60b 81// For reporting compile- and runtime version of GTK+ in the ctrl+alt+mclick dialog.
c1da5058 82// The gtk includes don't pull any other headers in, at least not on my system - MR
0118b60b
MR
83#ifdef __WXGTK__
84 #ifdef __WXGTK20__
85 #include <gtk/gtkversion.h>
86 #else
87 #include <gtk/gtkfeatures.h>
88 #endif
89 extern const unsigned int gtk_major_version;
90 extern const unsigned int gtk_minor_version;
91 extern const unsigned int gtk_micro_version;
92#endif
93
f03fc89f
VZ
94// ----------------------------------------------------------------------------
95// static data
96// ----------------------------------------------------------------------------
97
ba889513 98#if defined(__WXPALMOS__)
a152561c 99int wxWindowBase::ms_lastControlId = 32767;
ba889513 100#elif defined(__WXPM__)
edd802c6
DW
101int wxWindowBase::ms_lastControlId = 2000;
102#else
42e69d6b 103int wxWindowBase::ms_lastControlId = -200;
edd802c6 104#endif
f03fc89f
VZ
105
106IMPLEMENT_ABSTRACT_CLASS(wxWindowBase, wxEvtHandler)
107
108// ----------------------------------------------------------------------------
109// event table
110// ----------------------------------------------------------------------------
111
112BEGIN_EVENT_TABLE(wxWindowBase, wxEvtHandler)
113 EVT_SYS_COLOUR_CHANGED(wxWindowBase::OnSysColourChanged)
114 EVT_INIT_DIALOG(wxWindowBase::OnInitDialog)
a02dc3e3 115 EVT_MIDDLE_DOWN(wxWindowBase::OnMiddleClick)
bd83cb56
VZ
116
117#if wxUSE_HELP
e11f4636 118 EVT_HELP(wxID_ANY, wxWindowBase::OnHelp)
bd83cb56
VZ
119#endif // wxUSE_HELP
120
f03fc89f
VZ
121END_EVENT_TABLE()
122
123// ============================================================================
124// implementation of the common functionality of the wxWindow class
125// ============================================================================
126
127// ----------------------------------------------------------------------------
128// initialization
129// ----------------------------------------------------------------------------
130
131// the default initialization
72795335 132wxWindowBase::wxWindowBase()
f03fc89f
VZ
133{
134 // no window yet, no parent nor children
f03fc89f 135 m_parent = (wxWindow *)NULL;
e11f4636 136 m_windowId = wxID_ANY;
f03fc89f
VZ
137
138 // no constraints on the minimal window size
139 m_minWidth =
422d0ff0 140 m_maxWidth = wxDefaultCoord;
f03fc89f 141 m_minHeight =
422d0ff0 142 m_maxHeight = wxDefaultCoord;
f03fc89f 143
9f884528
RD
144 // invalidiated cache value
145 m_bestSizeCache = wxDefaultSize;
146
eefe6d4b
VZ
147 // window are created enabled and visible by default
148 m_isShown =
e11f4636 149 m_isEnabled = true;
f03fc89f 150
f03fc89f
VZ
151 // the default event handler is just this window
152 m_eventHandler = this;
153
88ac883a 154#if wxUSE_VALIDATORS
f03fc89f
VZ
155 // no validator
156 m_windowValidator = (wxValidator *) NULL;
88ac883a 157#endif // wxUSE_VALIDATORS
f03fc89f 158
1b69c815
VZ
159 // the colours/fonts are default for now, so leave m_font,
160 // m_backgroundColour and m_foregroundColour uninitialized and set those
08df3e44
VZ
161 m_hasBgCol =
162 m_hasFgCol =
e11f4636 163 m_hasFont = false;
f8ff87ed
VS
164 m_inheritBgCol =
165 m_inheritFgCol =
166 m_inheritFont = false;
e11f4636 167
f03fc89f 168 // no style bits
d80cd92a 169 m_exStyle =
f03fc89f 170 m_windowStyle = 0;
cab1a605 171
50c53860 172 m_backgroundStyle = wxBG_STYLE_SYSTEM;
f03fc89f 173
f03fc89f
VZ
174#if wxUSE_CONSTRAINTS
175 // no constraints whatsoever
176 m_constraints = (wxLayoutConstraints *) NULL;
177 m_constraintsInvolvedIn = (wxWindowList *) NULL;
461e93f9
JS
178#endif // wxUSE_CONSTRAINTS
179
f03fc89f 180 m_windowSizer = (wxSizer *) NULL;
be90c029 181 m_containingSizer = (wxSizer *) NULL;
e11f4636 182 m_autoLayout = false;
f03fc89f
VZ
183
184#if wxUSE_DRAG_AND_DROP
185 m_dropTarget = (wxDropTarget *)NULL;
186#endif // wxUSE_DRAG_AND_DROP
187
188#if wxUSE_TOOLTIPS
189 m_tooltip = (wxToolTip *)NULL;
190#endif // wxUSE_TOOLTIPS
789295bf
VZ
191
192#if wxUSE_CARET
193 m_caret = (wxCaret *)NULL;
194#endif // wxUSE_CARET
a2d93e73 195
574c939e 196#if wxUSE_PALETTE
e11f4636 197 m_hasCustomPalette = false;
574c939e
KB
198#endif // wxUSE_PALETTE
199
ed5317e5
JS
200#if wxUSE_ACCESSIBILITY
201 m_accessible = NULL;
202#endif
203
566d84a7 204 m_virtualSize = wxDefaultSize;
1b69c815 205
1e2a653b 206 m_minVirtualWidth =
422d0ff0 207 m_maxVirtualWidth = wxDefaultCoord;
1e2a653b 208 m_minVirtualHeight =
422d0ff0 209 m_maxVirtualHeight = wxDefaultCoord;
566d84a7 210
1b69c815 211 m_windowVariant = wxWINDOW_VARIANT_NORMAL;
ff9f7a12
SC
212#if wxUSE_SYSTEM_OPTIONS
213 if ( wxSystemOptions::HasOption(wxWINDOW_DEFAULT_VARIANT) )
214 {
215 m_windowVariant = (wxWindowVariant) wxSystemOptions::GetOptionInt( wxWINDOW_DEFAULT_VARIANT ) ;
216 }
217#endif
69d90995 218
a2d93e73 219 // Whether we're using the current theme for this window (wxGTK only for now)
e11f4636 220 m_themeEnabled = false;
1b69c815
VZ
221
222 // VZ: this one shouldn't exist...
223 m_isBeingDeleted = false;
847379b0 224
48710795
RR
225 // Reserved for future use
226 m_windowReserved = NULL;
f03fc89f
VZ
227}
228
229// common part of window creation process
230bool wxWindowBase::CreateBase(wxWindowBase *parent,
231 wxWindowID id,
74e3313b 232 const wxPoint& WXUNUSED(pos),
400a9e41 233 const wxSize& WXUNUSED(size),
f03fc89f 234 long style,
ac8d0c11 235 const wxValidator& wxVALIDATOR_PARAM(validator),
f03fc89f
VZ
236 const wxString& name)
237{
106844da
VZ
238#if wxUSE_STATBOX
239 // wxGTK doesn't allow to create controls with static box as the parent so
240 // this will result in a crash when the program is ported to wxGTK so warn
241 // the user about it
242
243 // if you get this assert, the correct solution is to create the controls
244 // as siblings of the static box
245 wxASSERT_MSG( !parent || !wxDynamicCast(parent, wxStaticBox),
246 _T("wxStaticBox can't be used as a window parent!") );
247#endif // wxUSE_STATBOX
248
925f154d
VZ
249 // ids are limited to 16 bits under MSW so if you care about portability,
250 // it's not a good idea to use ids out of this range (and negative ids are
77ffb593 251 // reserved for wxWidgets own usage)
925f154d
VZ
252 wxASSERT_MSG( id == wxID_ANY || (id >= 0 && id < 32767),
253 _T("invalid id value") );
254
f03fc89f 255 // generate a new id if the user doesn't care about it
925f154d 256 m_windowId = id == wxID_ANY ? NewControlId() : id;
f03fc89f
VZ
257
258 SetName(name);
259 SetWindowStyleFlag(style);
260 SetParent(parent);
674ac8b9
VZ
261
262#if wxUSE_VALIDATORS
8d99be5f 263 SetValidator(validator);
674ac8b9 264#endif // wxUSE_VALIDATORS
f03fc89f 265
8ae6ce07
VZ
266 // if the parent window has wxWS_EX_VALIDATE_RECURSIVELY set, we want to
267 // have it too - like this it's possible to set it only in the top level
268 // dialog/frame and all children will inherit it by defult
269 if ( parent && (parent->GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY) )
270 {
9cb98d89 271 SetExtraStyle(GetExtraStyle() | wxWS_EX_VALIDATE_RECURSIVELY);
8ae6ce07
VZ
272 }
273
e11f4636 274 return true;
f03fc89f
VZ
275}
276
277// ----------------------------------------------------------------------------
278// destruction
279// ----------------------------------------------------------------------------
280
281// common clean up
282wxWindowBase::~wxWindowBase()
283{
349d1942
VS
284 wxASSERT_MSG( GetCapture() != this, wxT("attempt to destroy window with mouse capture") );
285
f03fc89f
VZ
286 // FIXME if these 2 cases result from programming errors in the user code
287 // we should probably assert here instead of silently fixing them
288
289 // Just in case the window has been Closed, but we're then deleting
290 // immediately: don't leave dangling pointers.
291 wxPendingDelete.DeleteObject(this);
292
293 // Just in case we've loaded a top-level window via LoadNativeDialog but
294 // we weren't a dialog class
222ed1d6 295 wxTopLevelWindows.DeleteObject((wxWindow*)this);
a23fd0e1 296
223d09f6 297 wxASSERT_MSG( GetChildren().GetCount() == 0, wxT("children not destroyed") );
f03fc89f 298
8e35ab96
VZ
299 // reset the dangling pointer our parent window may keep to us
300 if ( m_parent )
301 {
302 if ( m_parent->GetDefaultItem() == this )
303 {
304 m_parent->SetDefaultItem(NULL);
305 }
306
307 m_parent->RemoveChild(this);
308 }
309
789295bf 310#if wxUSE_CARET
a2b436fb 311 delete m_caret;
789295bf
VZ
312#endif // wxUSE_CARET
313
88ac883a 314#if wxUSE_VALIDATORS
a2b436fb 315 delete m_windowValidator;
88ac883a 316#endif // wxUSE_VALIDATORS
f03fc89f 317
f03fc89f
VZ
318#if wxUSE_CONSTRAINTS
319 // Have to delete constraints/sizer FIRST otherwise sizers may try to look
320 // at deleted windows as they delete themselves.
321 DeleteRelatedConstraints();
322
323 if ( m_constraints )
324 {
325 // This removes any dangling pointers to this window in other windows'
326 // constraintsInvolvedIn lists.
327 UnsetConstraints(m_constraints);
328 delete m_constraints;
329 m_constraints = NULL;
330 }
461e93f9
JS
331#endif // wxUSE_CONSTRAINTS
332
be90c029 333 if ( m_containingSizer )
12a3f227 334 m_containingSizer->Detach( (wxWindow*)this );
be90c029 335
a2b436fb 336 delete m_windowSizer;
f03fc89f 337
f03fc89f 338#if wxUSE_DRAG_AND_DROP
a2b436fb 339 delete m_dropTarget;
f03fc89f
VZ
340#endif // wxUSE_DRAG_AND_DROP
341
342#if wxUSE_TOOLTIPS
a2b436fb 343 delete m_tooltip;
f03fc89f 344#endif // wxUSE_TOOLTIPS
b0ee47ff 345
ed5317e5 346#if wxUSE_ACCESSIBILITY
a2b436fb 347 delete m_accessible;
ed5317e5 348#endif
f03fc89f
VZ
349}
350
351bool wxWindowBase::Destroy()
352{
353 delete this;
354
e11f4636 355 return true;
f03fc89f
VZ
356}
357
358bool wxWindowBase::Close(bool force)
359{
360 wxCloseEvent event(wxEVT_CLOSE_WINDOW, m_windowId);
361 event.SetEventObject(this);
f03fc89f
VZ
362 event.SetCanVeto(!force);
363
e11f4636 364 // return false if window wasn't closed because the application vetoed the
f03fc89f
VZ
365 // close event
366 return GetEventHandler()->ProcessEvent(event) && !event.GetVeto();
367}
368
369bool wxWindowBase::DestroyChildren()
370{
222ed1d6 371 wxWindowList::compatibility_iterator node;
a23fd0e1 372 for ( ;; )
f03fc89f 373 {
a23fd0e1
VZ
374 // we iterate until the list becomes empty
375 node = GetChildren().GetFirst();
376 if ( !node )
377 break;
378
f03fc89f 379 wxWindow *child = node->GetData();
a23fd0e1 380
f303564d
VZ
381 // note that we really want to call delete and not ->Destroy() here
382 // because we want to delete the child immediately, before we are
383 // deleted, and delayed deletion would result in problems as our (top
384 // level) child could outlive its parent
385 delete child;
a23fd0e1
VZ
386
387 wxASSERT_MSG( !GetChildren().Find(child),
223d09f6 388 wxT("child didn't remove itself using RemoveChild()") );
f03fc89f
VZ
389 }
390
e11f4636 391 return true;
f03fc89f
VZ
392}
393
394// ----------------------------------------------------------------------------
f68586e5 395// size/position related methods
f03fc89f
VZ
396// ----------------------------------------------------------------------------
397
398// centre the window with respect to its parent in either (or both) directions
1f464296 399void wxWindowBase::DoCentre(int dir)
f03fc89f 400{
1f464296
VZ
401 wxCHECK_RET( !(dir & wxCENTRE_ON_SCREEN) && GetParent(),
402 _T("this method only implements centering child windows") );
ef397583 403
1f464296 404 SetSize(GetRect().CentreIn(GetParent()->GetClientSize(), dir));
7631a292
RD
405}
406
f03fc89f
VZ
407// fits the window around the children
408void wxWindowBase::Fit()
409{
74205969 410 if ( !GetChildren().empty() )
f68586e5 411 {
74205969 412 SetClientSize(GetBestSize());
f68586e5
VZ
413 }
414 //else: do nothing if we have no children
415}
f03fc89f 416
2b5f62a0
VZ
417// fits virtual size (ie. scrolled area etc.) around children
418void wxWindowBase::FitInside()
419{
420 if ( GetChildren().GetCount() > 0 )
421 {
422 SetVirtualSize( GetBestVirtualSize() );
423 }
424}
425
7d59475e
JS
426// On Mac, scrollbars are explicitly children.
427#ifdef __WXMAC__
428static bool wxHasRealChildren(const wxWindowBase* win)
429{
430 int realChildCount = 0;
cab1a605 431
7d59475e
JS
432 for ( wxWindowList::compatibility_iterator node = win->GetChildren().GetFirst();
433 node;
434 node = node->GetNext() )
435 {
436 wxWindow *win = node->GetData();
437 if ( !win->IsTopLevel() && win->IsShown() && !win->IsKindOf(CLASSINFO(wxScrollBar)))
438 realChildCount ++;
439 }
440 return (realChildCount > 0);
441}
442#endif
ba889513 443
992b2ec4
VS
444void wxWindowBase::InvalidateBestSize()
445{
446 m_bestSizeCache = wxDefaultSize;
447
448 // parent's best size calculation may depend on its children's
449 // best sizes, so let's invalidate it as well to be safe:
450 if (m_parent)
451 m_parent->InvalidateBestSize();
452}
7d59475e 453
f68586e5
VZ
454// return the size best suited for the current window
455wxSize wxWindowBase::DoGetBestSize() const
456{
08a19f64 457 wxSize best;
2997ca30 458
ec5bb70d
VZ
459 if ( m_windowSizer )
460 {
ee146bca 461 best = GetWindowSizeForVirtualSize(m_windowSizer->GetMinSize());
ec5bb70d
VZ
462 }
463#if wxUSE_CONSTRAINTS
464 else if ( m_constraints )
465 {
466 wxConstCast(this, wxWindowBase)->SatisfyConstraints();
467
468 // our minimal acceptable size is such that all our windows fit inside
469 int maxX = 0,
470 maxY = 0;
471
222ed1d6 472 for ( wxWindowList::compatibility_iterator node = GetChildren().GetFirst();
ec5bb70d
VZ
473 node;
474 node = node->GetNext() )
475 {
476 wxLayoutConstraints *c = node->GetData()->GetConstraints();
477 if ( !c )
478 {
479 // it's not normal that we have an unconstrained child, but
480 // what can we do about it?
481 continue;
482 }
483
484 int x = c->right.GetValue(),
485 y = c->bottom.GetValue();
486
487 if ( x > maxX )
488 maxX = x;
489
490 if ( y > maxY )
491 maxY = y;
492
493 // TODO: we must calculate the overlaps somehow, otherwise we
494 // will never return a size bigger than the current one :-(
495 }
496
08a19f64 497 best = wxSize(maxX, maxY);
ec5bb70d
VZ
498 }
499#endif // wxUSE_CONSTRAINTS
7d59475e
JS
500 else if ( !GetChildren().empty()
501#ifdef __WXMAC__
502 && wxHasRealChildren(this)
503#endif
504 )
f03fc89f 505 {
1ebfafde 506 // our minimal acceptable size is such that all our visible child windows fit inside
f68586e5
VZ
507 int maxX = 0,
508 maxY = 0;
509
222ed1d6 510 for ( wxWindowList::compatibility_iterator node = GetChildren().GetFirst();
f68586e5
VZ
511 node;
512 node = node->GetNext() )
42e69d6b 513 {
f68586e5 514 wxWindow *win = node->GetData();
1ebfafde 515 if ( win->IsTopLevel() || ( ! win->IsShown() )
1e6feb95
VZ
516#if wxUSE_STATUSBAR
517 || wxDynamicCast(win, wxStatusBar)
518#endif // wxUSE_STATUSBAR
519 )
f68586e5
VZ
520 {
521 // dialogs and frames lie in different top level windows -
7d9fd004
VZ
522 // don't deal with them here; as for the status bars, they
523 // don't lie in the client area at all
f68586e5
VZ
524 continue;
525 }
526
527 int wx, wy, ww, wh;
528 win->GetPosition(&wx, &wy);
3f5513f5
VZ
529
530 // if the window hadn't been positioned yet, assume that it is in
531 // the origin
422d0ff0 532 if ( wx == wxDefaultCoord )
3f5513f5 533 wx = 0;
422d0ff0 534 if ( wy == wxDefaultCoord )
3f5513f5
VZ
535 wy = 0;
536
f68586e5
VZ
537 win->GetSize(&ww, &wh);
538 if ( wx + ww > maxX )
539 maxX = wx + ww;
540 if ( wy + wh > maxY )
541 maxY = wy + wh;
42e69d6b
VZ
542 }
543
ec5bb70d
VZ
544 // for compatibility with the old versions and because it really looks
545 // slightly more pretty like this, add a pad
546 maxX += 7;
547 maxY += 14;
548
08a19f64 549 best = wxSize(maxX, maxY);
f68586e5 550 }
997c7280 551 else // ! has children
f68586e5 552 {
c0bb586f
VZ
553 // for a generic window there is no natural best size so, if the
554 // minimal size is not set, use the current size but take care to
555 // remember it as minimal size for the next time because our best size
556 // should be constant: otherwise we could get into a situation when the
557 // window is initially at some size, then expanded to a larger size and
558 // then, when the containing window is shrunk back (because our initial
559 // best size had been used for computing the parent min size), we can't
560 // be shrunk back any more because our best size is now bigger
9240613a
VZ
561 wxSize size = GetMinSize();
562 if ( !size.IsFullySpecified() )
563 {
564 size.SetDefaults(GetSize());
565 wxConstCast(this, wxWindowBase)->SetMinSize(size);
566 }
c0bb586f
VZ
567
568 // return as-is, unadjusted by the client size difference.
9240613a 569 return size;
f03fc89f 570 }
08a19f64
RD
571
572 // Add any difference between size and client size
573 wxSize diff = GetSize() - GetClientSize();
574 best.x += wxMax(0, diff.x);
575 best.y += wxMax(0, diff.y);
576
577 return best;
f03fc89f
VZ
578}
579
9f884528
RD
580
581wxSize wxWindowBase::GetBestFittingSize() const
400a9e41 582{
9f884528
RD
583 // merge the best size with the min size, giving priority to the min size
584 wxSize min = GetMinSize();
585 if (min.x == wxDefaultCoord || min.y == wxDefaultCoord)
400a9e41 586 {
9f884528
RD
587 wxSize best = GetBestSize();
588 if (min.x == wxDefaultCoord) min.x = best.x;
589 if (min.y == wxDefaultCoord) min.y = best.y;
17c48da8 590 }
9f884528
RD
591 return min;
592}
17c48da8 593
42cfa184 594
9f884528
RD
595void wxWindowBase::SetBestFittingSize(const wxSize& size)
596{
597 // Set the min size to the size passed in. This will usually either be
598 // wxDefaultSize or the size passed to this window's ctor/Create function.
599 SetMinSize(size);
600
601 // Merge the size with the best size if needed
602 wxSize best = GetBestFittingSize();
cab1a605 603
9f884528
RD
604 // If the current size doesn't match then change it
605 if (GetSize() != best)
606 SetSize(best);
400a9e41
VZ
607}
608
9f884528 609
1e6feb95
VZ
610// by default the origin is not shifted
611wxPoint wxWindowBase::GetClientAreaOrigin() const
612{
c47addef 613 return wxPoint(0,0);
1e6feb95
VZ
614}
615
f03fc89f 616// set the min/max size of the window
024f89f9
VS
617void wxWindowBase::DoSetSizeHints(int minW, int minH,
618 int maxW, int maxH,
619 int WXUNUSED(incW), int WXUNUSED(incH))
f03fc89f 620{
e587e144
VZ
621 // setting min width greater than max width leads to infinite loops under
622 // X11 and generally doesn't make any sense, so don't allow it
422d0ff0
WS
623 wxCHECK_RET( (minW == wxDefaultCoord || maxW == wxDefaultCoord || minW <= maxW) &&
624 (minH == wxDefaultCoord || maxH == wxDefaultCoord || minH <= maxH),
e587e144
VZ
625 _T("min width/height must be less than max width/height!") );
626
f03fc89f
VZ
627 m_minWidth = minW;
628 m_maxWidth = maxW;
629 m_minHeight = minH;
630 m_maxHeight = maxH;
631}
632
69d90995
SC
633void wxWindowBase::SetWindowVariant( wxWindowVariant variant )
634{
1b69c815
VZ
635 if ( m_windowVariant != variant )
636 {
637 m_windowVariant = variant;
69d90995 638
1b69c815
VZ
639 DoSetWindowVariant(variant);
640 }
69d90995
SC
641}
642
643void wxWindowBase::DoSetWindowVariant( wxWindowVariant variant )
644{
1b69c815
VZ
645 // adjust the font height to correspond to our new variant (notice that
646 // we're only called if something really changed)
647 wxFont font = GetFont();
648 int size = font.GetPointSize();
69d90995
SC
649 switch ( variant )
650 {
1b69c815
VZ
651 case wxWINDOW_VARIANT_NORMAL:
652 break;
653
654 case wxWINDOW_VARIANT_SMALL:
655 size *= 3;
656 size /= 4;
657 break;
658
659 case wxWINDOW_VARIANT_MINI:
660 size *= 2;
661 size /= 3;
662 break;
663
664 case wxWINDOW_VARIANT_LARGE:
665 size *= 5;
666 size /= 4;
667 break;
668
69d90995
SC
669 default:
670 wxFAIL_MSG(_T("unexpected window variant"));
1b69c815 671 break;
69d90995 672 }
1b69c815
VZ
673
674 font.SetPointSize(size);
675 SetFont(font);
69d90995
SC
676}
677
566d84a7
RL
678void wxWindowBase::SetVirtualSizeHints( int minW, int minH,
679 int maxW, int maxH )
680{
681 m_minVirtualWidth = minW;
682 m_maxVirtualWidth = maxW;
683 m_minVirtualHeight = minH;
684 m_maxVirtualHeight = maxH;
566d84a7
RL
685}
686
687void wxWindowBase::DoSetVirtualSize( int x, int y )
688{
422d0ff0 689 if ( m_minVirtualWidth != wxDefaultCoord && m_minVirtualWidth > x )
1e2a653b 690 x = m_minVirtualWidth;
422d0ff0 691 if ( m_maxVirtualWidth != wxDefaultCoord && m_maxVirtualWidth < x )
1e2a653b 692 x = m_maxVirtualWidth;
422d0ff0 693 if ( m_minVirtualHeight != wxDefaultCoord && m_minVirtualHeight > y )
1e2a653b 694 y = m_minVirtualHeight;
422d0ff0 695 if ( m_maxVirtualHeight != wxDefaultCoord && m_maxVirtualHeight < y )
1e2a653b
VZ
696 y = m_maxVirtualHeight;
697
698 m_virtualSize = wxSize(x, y);
566d84a7
RL
699}
700
701wxSize wxWindowBase::DoGetVirtualSize() const
702{
143e2719
VZ
703 // we should use the entire client area so if it is greater than our
704 // virtual size, expand it to fit (otherwise if the window is big enough we
705 // wouldn't be using parts of it)
c20ab85b 706 wxSize size = GetClientSize();
143e2719 707 if ( m_virtualSize.x > size.x )
c20ab85b
VZ
708 size.x = m_virtualSize.x;
709
143e2719 710 if ( m_virtualSize.y >= size.y )
c20ab85b
VZ
711 size.y = m_virtualSize.y;
712
713 return size;
566d84a7
RL
714}
715
f03fc89f
VZ
716// ----------------------------------------------------------------------------
717// show/hide/enable/disable the window
718// ----------------------------------------------------------------------------
719
720bool wxWindowBase::Show(bool show)
721{
722 if ( show != m_isShown )
723 {
724 m_isShown = show;
725
e11f4636 726 return true;
f03fc89f
VZ
727 }
728 else
729 {
e11f4636 730 return false;
f03fc89f
VZ
731 }
732}
733
734bool wxWindowBase::Enable(bool enable)
735{
736 if ( enable != m_isEnabled )
737 {
738 m_isEnabled = enable;
739
e11f4636 740 return true;
f03fc89f
VZ
741 }
742 else
743 {
e11f4636 744 return false;
f03fc89f
VZ
745 }
746}
34636400
VZ
747// ----------------------------------------------------------------------------
748// RTTI
749// ----------------------------------------------------------------------------
750
751bool wxWindowBase::IsTopLevel() const
752{
e11f4636 753 return false;
34636400 754}
f03fc89f
VZ
755
756// ----------------------------------------------------------------------------
757// reparenting the window
758// ----------------------------------------------------------------------------
759
760void wxWindowBase::AddChild(wxWindowBase *child)
761{
223d09f6 762 wxCHECK_RET( child, wxT("can't add a NULL child") );
f03fc89f 763
f6bcfd97
BP
764 // this should never happen and it will lead to a crash later if it does
765 // because RemoveChild() will remove only one node from the children list
766 // and the other(s) one(s) will be left with dangling pointers in them
222ed1d6 767 wxASSERT_MSG( !GetChildren().Find((wxWindow*)child), _T("AddChild() called twice") );
f6bcfd97 768
222ed1d6 769 GetChildren().Append((wxWindow*)child);
f03fc89f
VZ
770 child->SetParent(this);
771}
772
773void wxWindowBase::RemoveChild(wxWindowBase *child)
774{
223d09f6 775 wxCHECK_RET( child, wxT("can't remove a NULL child") );
f03fc89f 776
222ed1d6
MB
777 GetChildren().DeleteObject((wxWindow *)child);
778 child->SetParent(NULL);
f03fc89f 779}
439b3bf1 780
f03fc89f
VZ
781bool wxWindowBase::Reparent(wxWindowBase *newParent)
782{
783 wxWindow *oldParent = GetParent();
784 if ( newParent == oldParent )
785 {
786 // nothing done
e11f4636 787 return false;
f03fc89f
VZ
788 }
789
790 // unlink this window from the existing parent.
791 if ( oldParent )
792 {
793 oldParent->RemoveChild(this);
794 }
795 else
796 {
222ed1d6 797 wxTopLevelWindows.DeleteObject((wxWindow *)this);
f03fc89f
VZ
798 }
799
800 // add it to the new one
801 if ( newParent )
802 {
803 newParent->AddChild(this);
804 }
805 else
806 {
222ed1d6 807 wxTopLevelWindows.Append((wxWindow *)this);
f03fc89f
VZ
808 }
809
e11f4636 810 return true;
f03fc89f
VZ
811}
812
813// ----------------------------------------------------------------------------
814// event handler stuff
815// ----------------------------------------------------------------------------
816
817void wxWindowBase::PushEventHandler(wxEvtHandler *handler)
818{
3a074ba8
VZ
819 wxEvtHandler *handlerOld = GetEventHandler();
820
821 handler->SetNextHandler(handlerOld);
822
823 if ( handlerOld )
824 GetEventHandler()->SetPreviousHandler(handler);
825
f03fc89f
VZ
826 SetEventHandler(handler);
827}
828
829wxEvtHandler *wxWindowBase::PopEventHandler(bool deleteHandler)
830{
831 wxEvtHandler *handlerA = GetEventHandler();
832 if ( handlerA )
833 {
834 wxEvtHandler *handlerB = handlerA->GetNextHandler();
835 handlerA->SetNextHandler((wxEvtHandler *)NULL);
3a074ba8
VZ
836
837 if ( handlerB )
838 handlerB->SetPreviousHandler((wxEvtHandler *)NULL);
f03fc89f 839 SetEventHandler(handlerB);
3a074ba8 840
f03fc89f
VZ
841 if ( deleteHandler )
842 {
843 delete handlerA;
844 handlerA = (wxEvtHandler *)NULL;
845 }
846 }
847
848 return handlerA;
849}
850
2e36d5cf
VZ
851bool wxWindowBase::RemoveEventHandler(wxEvtHandler *handler)
852{
e11f4636 853 wxCHECK_MSG( handler, false, _T("RemoveEventHandler(NULL) called") );
2e36d5cf
VZ
854
855 wxEvtHandler *handlerPrev = NULL,
856 *handlerCur = GetEventHandler();
857 while ( handlerCur )
858 {
859 wxEvtHandler *handlerNext = handlerCur->GetNextHandler();
860
861 if ( handlerCur == handler )
862 {
863 if ( handlerPrev )
864 {
865 handlerPrev->SetNextHandler(handlerNext);
866 }
867 else
868 {
869 SetEventHandler(handlerNext);
870 }
871
7a9c8d74
JS
872 if ( handlerNext )
873 {
874 handlerNext->SetPreviousHandler ( handlerPrev );
875 }
489bbac9 876
2e36d5cf 877 handler->SetNextHandler(NULL);
489bbac9 878 handler->SetPreviousHandler(NULL);
2e36d5cf 879
e11f4636 880 return true;
2e36d5cf
VZ
881 }
882
883 handlerPrev = handlerCur;
884 handlerCur = handlerNext;
885 }
886
887 wxFAIL_MSG( _T("where has the event handler gone?") );
888
e11f4636 889 return false;
2e36d5cf
VZ
890}
891
f03fc89f 892// ----------------------------------------------------------------------------
1b69c815 893// colours, fonts &c
f03fc89f
VZ
894// ----------------------------------------------------------------------------
895
b8e7b673
VZ
896void wxWindowBase::InheritAttributes()
897{
8afef133 898 const wxWindowBase * const parent = GetParent();
b8e7b673
VZ
899 if ( !parent )
900 return;
901
902 // we only inherit attributes which had been explicitly set for the parent
903 // which ensures that this only happens if the user really wants it and
904 // not by default which wouldn't make any sense in modern GUIs where the
905 // controls don't all use the same fonts (nor colours)
f8ff87ed 906 if ( parent->m_inheritFont && !m_hasFont )
b8e7b673
VZ
907 SetFont(parent->GetFont());
908
909 // in addition, there is a possibility to explicitly forbid inheriting
910 // colours at each class level by overriding ShouldInheritColours()
911 if ( ShouldInheritColours() )
912 {
f8ff87ed 913 if ( parent->m_inheritFgCol && !m_hasFgCol )
b8e7b673
VZ
914 SetForegroundColour(parent->GetForegroundColour());
915
eb96212b
VZ
916 // inheriting (solid) background colour is wrong as it totally breaks
917 // any kind of themed backgrounds
918 //
919 // instead, the controls should use the same background as their parent
920 // (ideally by not drawing it at all)
921#if 0
f8ff87ed 922 if ( parent->m_inheritBgCol && !m_hasBgCol )
b8e7b673 923 SetBackgroundColour(parent->GetBackgroundColour());
eb96212b 924#endif // 0
b8e7b673
VZ
925 }
926}
927
1b69c815
VZ
928/* static */ wxVisualAttributes
929wxWindowBase::GetClassDefaultAttributes(wxWindowVariant WXUNUSED(variant))
930{
931 // it is important to return valid values for all attributes from here,
932 // GetXXX() below rely on this
933 wxVisualAttributes attrs;
934 attrs.font = wxSystemSettings::GetFont(wxSYS_DEFAULT_GUI_FONT);
935 attrs.colFg = wxSystemSettings::GetColour(wxSYS_COLOUR_WINDOWTEXT);
1b69c815 936
0477a857
JS
937 // On Smartphone/PocketPC, wxSYS_COLOUR_WINDOW is a better reflection of
938 // the usual background colour than wxSYS_COLOUR_BTNFACE.
939 // It's a pity that wxSYS_COLOUR_WINDOW isn't always a suitable background
940 // colour on other platforms.
941
942#if defined(__WXWINCE__) && (defined(__SMARTPHONE__) || defined(__POCKETPC__))
943 attrs.colBg = wxSystemSettings::GetColour(wxSYS_COLOUR_WINDOW);
944#else
945 attrs.colBg = wxSystemSettings::GetColour(wxSYS_COLOUR_BTNFACE);
946#endif
1b69c815
VZ
947 return attrs;
948}
949
950wxColour wxWindowBase::GetBackgroundColour() const
951{
952 if ( !m_backgroundColour.Ok() )
953 {
954 wxASSERT_MSG( !m_hasBgCol, _T("we have invalid explicit bg colour?") );
955
956 // get our default background colour
957 wxColour colBg = GetDefaultAttributes().colBg;
958
959 // we must return some valid colour to avoid redoing this every time
960 // and also to avoid surprizing the applications written for older
77ffb593 961 // wxWidgets versions where GetBackgroundColour() always returned
1b69c815
VZ
962 // something -- so give them something even if it doesn't make sense
963 // for this window (e.g. it has a themed background)
964 if ( !colBg.Ok() )
965 colBg = GetClassDefaultAttributes().colBg;
966
f604c658 967 return colBg;
1b69c815 968 }
f604c658
VS
969 else
970 return m_backgroundColour;
1b69c815
VZ
971}
972
973wxColour wxWindowBase::GetForegroundColour() const
974{
975 // logic is the same as above
976 if ( !m_hasFgCol && !m_foregroundColour.Ok() )
977 {
978 wxASSERT_MSG( !m_hasFgCol, _T("we have invalid explicit fg colour?") );
979
980 wxColour colFg = GetDefaultAttributes().colFg;
981
982 if ( !colFg.Ok() )
983 colFg = GetClassDefaultAttributes().colFg;
984
f604c658 985 return colFg;
1b69c815 986 }
f604c658
VS
987 else
988 return m_foregroundColour;
1b69c815
VZ
989}
990
f03fc89f
VZ
991bool wxWindowBase::SetBackgroundColour( const wxColour &colour )
992{
cab1a605 993 if ( colour == m_backgroundColour )
e11f4636 994 return false;
f03fc89f 995
44dfb5ce 996 m_hasBgCol = colour.Ok();
17bcd9a6
VZ
997 if ( m_backgroundStyle != wxBG_STYLE_CUSTOM )
998 m_backgroundStyle = m_hasBgCol ? wxBG_STYLE_COLOUR : wxBG_STYLE_SYSTEM;
999
f8ff87ed 1000 m_inheritBgCol = m_hasBgCol;
f03fc89f 1001 m_backgroundColour = colour;
44dfb5ce 1002 SetThemeEnabled( !m_hasBgCol && !m_foregroundColour.Ok() );
e11f4636 1003 return true;
f03fc89f
VZ
1004}
1005
1006bool wxWindowBase::SetForegroundColour( const wxColour &colour )
1007{
44dfb5ce 1008 if (colour == m_foregroundColour )
e11f4636 1009 return false;
f03fc89f 1010
44dfb5ce 1011 m_hasFgCol = colour.Ok();
f8ff87ed 1012 m_inheritFgCol = m_hasFgCol;
f03fc89f 1013 m_foregroundColour = colour;
44dfb5ce 1014 SetThemeEnabled( !m_hasFgCol && !m_backgroundColour.Ok() );
e11f4636 1015 return true;
f03fc89f
VZ
1016}
1017
1018bool wxWindowBase::SetCursor(const wxCursor& cursor)
1019{
8a9c2246
VZ
1020 // setting an invalid cursor is ok, it means that we don't have any special
1021 // cursor
13588544 1022 if ( m_cursor == cursor )
f03fc89f
VZ
1023 {
1024 // no change
e11f4636 1025 return false;
f03fc89f
VZ
1026 }
1027
8a9c2246 1028 m_cursor = cursor;
f03fc89f 1029
e11f4636 1030 return true;
f03fc89f
VZ
1031}
1032
f604c658 1033wxFont wxWindowBase::GetFont() const
1b69c815
VZ
1034{
1035 // logic is the same as in GetBackgroundColour()
1036 if ( !m_font.Ok() )
1037 {
1038 wxASSERT_MSG( !m_hasFont, _T("we have invalid explicit font?") );
1039
1040 wxFont font = GetDefaultAttributes().font;
1041 if ( !font.Ok() )
1042 font = GetClassDefaultAttributes().font;
1043
f604c658 1044 return font;
1b69c815 1045 }
f604c658
VS
1046 else
1047 return m_font;
1b69c815
VZ
1048}
1049
f03fc89f
VZ
1050bool wxWindowBase::SetFont(const wxFont& font)
1051{
1b69c815 1052 if ( font == m_font )
f03fc89f
VZ
1053 {
1054 // no change
e11f4636 1055 return false;
f03fc89f
VZ
1056 }
1057
1b69c815 1058 m_font = font;
72bbf76a 1059 m_hasFont = font.Ok();
f8ff87ed 1060 m_inheritFont = m_hasFont;
23895080 1061
583d7e55
VS
1062 InvalidateBestSize();
1063
e11f4636 1064 return true;
f03fc89f
VZ
1065}
1066
b95edd47
VZ
1067#if wxUSE_PALETTE
1068
1069void wxWindowBase::SetPalette(const wxPalette& pal)
1070{
e11f4636 1071 m_hasCustomPalette = true;
b95edd47
VZ
1072 m_palette = pal;
1073
1074 // VZ: can anyone explain me what do we do here?
1075 wxWindowDC d((wxWindow *) this);
1076 d.SetPalette(pal);
1077}
1078
1079wxWindow *wxWindowBase::GetAncestorWithCustomPalette() const
1080{
1081 wxWindow *win = (wxWindow *)this;
1082 while ( win && !win->HasCustomPalette() )
1083 {
1084 win = win->GetParent();
1085 }
1086
1087 return win;
1088}
1089
1090#endif // wxUSE_PALETTE
1091
789295bf
VZ
1092#if wxUSE_CARET
1093void wxWindowBase::SetCaret(wxCaret *caret)
1094{
1095 if ( m_caret )
1096 {
1097 delete m_caret;
1098 }
1099
1100 m_caret = caret;
1101
1102 if ( m_caret )
1103 {
1104 wxASSERT_MSG( m_caret->GetWindow() == this,
223d09f6 1105 wxT("caret should be created associated to this window") );
789295bf
VZ
1106 }
1107}
1108#endif // wxUSE_CARET
1109
88ac883a 1110#if wxUSE_VALIDATORS
f03fc89f
VZ
1111// ----------------------------------------------------------------------------
1112// validators
1113// ----------------------------------------------------------------------------
1114
1115void wxWindowBase::SetValidator(const wxValidator& validator)
1116{
1117 if ( m_windowValidator )
1118 delete m_windowValidator;
1119
1120 m_windowValidator = (wxValidator *)validator.Clone();
1121
1122 if ( m_windowValidator )
1b69c815 1123 m_windowValidator->SetWindow(this);
f03fc89f 1124}
88ac883a 1125#endif // wxUSE_VALIDATORS
f03fc89f
VZ
1126
1127// ----------------------------------------------------------------------------
1e6feb95 1128// update region stuff
f03fc89f
VZ
1129// ----------------------------------------------------------------------------
1130
1e6feb95
VZ
1131wxRect wxWindowBase::GetUpdateClientRect() const
1132{
1133 wxRegion rgnUpdate = GetUpdateRegion();
1134 rgnUpdate.Intersect(GetClientRect());
1135 wxRect rectUpdate = rgnUpdate.GetBox();
1136 wxPoint ptOrigin = GetClientAreaOrigin();
1137 rectUpdate.x -= ptOrigin.x;
1138 rectUpdate.y -= ptOrigin.y;
1139
1140 return rectUpdate;
1141}
1142
f03fc89f
VZ
1143bool wxWindowBase::IsExposed(int x, int y) const
1144{
1145 return m_updateRegion.Contains(x, y) != wxOutRegion;
1146}
1147
1148bool wxWindowBase::IsExposed(int x, int y, int w, int h) const
1149{
1150 return m_updateRegion.Contains(x, y, w, h) != wxOutRegion;
1151}
1152
5da0803c
VZ
1153void wxWindowBase::ClearBackground()
1154{
1155 // wxGTK uses its own version, no need to add never used code
1156#ifndef __WXGTK__
1157 wxClientDC dc((wxWindow *)this);
1158 wxBrush brush(GetBackgroundColour(), wxSOLID);
1159 dc.SetBackground(brush);
1160 dc.Clear();
1161#endif // __WXGTK__
1162}
1163
f03fc89f 1164// ----------------------------------------------------------------------------
146ba0fe 1165// find child window by id or name
f03fc89f
VZ
1166// ----------------------------------------------------------------------------
1167
6b73af79 1168wxWindow *wxWindowBase::FindWindow(long id) const
f03fc89f
VZ
1169{
1170 if ( id == m_windowId )
1171 return (wxWindow *)this;
1172
1173 wxWindowBase *res = (wxWindow *)NULL;
222ed1d6 1174 wxWindowList::compatibility_iterator node;
f03fc89f
VZ
1175 for ( node = m_children.GetFirst(); node && !res; node = node->GetNext() )
1176 {
1177 wxWindowBase *child = node->GetData();
1178 res = child->FindWindow( id );
1179 }
1180
1181 return (wxWindow *)res;
1182}
1183
6b73af79 1184wxWindow *wxWindowBase::FindWindow(const wxString& name) const
f03fc89f
VZ
1185{
1186 if ( name == m_windowName )
1187 return (wxWindow *)this;
1188
1189 wxWindowBase *res = (wxWindow *)NULL;
222ed1d6 1190 wxWindowList::compatibility_iterator node;
f03fc89f
VZ
1191 for ( node = m_children.GetFirst(); node && !res; node = node->GetNext() )
1192 {
1193 wxWindow *child = node->GetData();
1194 res = child->FindWindow(name);
1195 }
1196
1197 return (wxWindow *)res;
1198}
1199
146ba0fe
VZ
1200
1201// find any window by id or name or label: If parent is non-NULL, look through
1202// children for a label or title matching the specified string. If NULL, look
1203// through all top-level windows.
1204//
1205// to avoid duplicating code we reuse the same helper function but with
1206// different comparators
1207
1208typedef bool (*wxFindWindowCmp)(const wxWindow *win,
1209 const wxString& label, long id);
1210
1211static
1212bool wxFindWindowCmpLabels(const wxWindow *win, const wxString& label,
1213 long WXUNUSED(id))
1214{
1215 return win->GetLabel() == label;
1216}
1217
1218static
1219bool wxFindWindowCmpNames(const wxWindow *win, const wxString& label,
1220 long WXUNUSED(id))
1221{
1222 return win->GetName() == label;
1223}
1224
1225static
1226bool wxFindWindowCmpIds(const wxWindow *win, const wxString& WXUNUSED(label),
1227 long id)
1228{
1229 return win->GetId() == id;
1230}
1231
1232// recursive helper for the FindWindowByXXX() functions
1233static
1234wxWindow *wxFindWindowRecursively(const wxWindow *parent,
1235 const wxString& label,
1236 long id,
1237 wxFindWindowCmp cmp)
1238{
1239 if ( parent )
1240 {
1241 // see if this is the one we're looking for
1242 if ( (*cmp)(parent, label, id) )
1243 return (wxWindow *)parent;
1244
1245 // It wasn't, so check all its children
222ed1d6 1246 for ( wxWindowList::compatibility_iterator node = parent->GetChildren().GetFirst();
146ba0fe
VZ
1247 node;
1248 node = node->GetNext() )
1249 {
1250 // recursively check each child
1251 wxWindow *win = (wxWindow *)node->GetData();
1252 wxWindow *retwin = wxFindWindowRecursively(win, label, id, cmp);
1253 if (retwin)
1254 return retwin;
1255 }
1256 }
1257
1258 // Not found
1259 return NULL;
1260}
1261
1262// helper for FindWindowByXXX()
1263static
1264wxWindow *wxFindWindowHelper(const wxWindow *parent,
1265 const wxString& label,
1266 long id,
1267 wxFindWindowCmp cmp)
1268{
1269 if ( parent )
1270 {
1271 // just check parent and all its children
1272 return wxFindWindowRecursively(parent, label, id, cmp);
1273 }
1274
1275 // start at very top of wx's windows
222ed1d6 1276 for ( wxWindowList::compatibility_iterator node = wxTopLevelWindows.GetFirst();
146ba0fe
VZ
1277 node;
1278 node = node->GetNext() )
1279 {
1280 // recursively check each window & its children
1281 wxWindow *win = node->GetData();
1282 wxWindow *retwin = wxFindWindowRecursively(win, label, id, cmp);
1283 if (retwin)
1284 return retwin;
1285 }
1286
1287 return NULL;
1288}
1289
1290/* static */
1291wxWindow *
1292wxWindowBase::FindWindowByLabel(const wxString& title, const wxWindow *parent)
1293{
1294 return wxFindWindowHelper(parent, title, 0, wxFindWindowCmpLabels);
1295}
1296
1297/* static */
1298wxWindow *
1299wxWindowBase::FindWindowByName(const wxString& title, const wxWindow *parent)
1300{
1301 wxWindow *win = wxFindWindowHelper(parent, title, 0, wxFindWindowCmpNames);
1302
1303 if ( !win )
1304 {
1305 // fall back to the label
1306 win = FindWindowByLabel(title, parent);
1307 }
1308
1309 return win;
1310}
1311
1312/* static */
1313wxWindow *
1314wxWindowBase::FindWindowById( long id, const wxWindow* parent )
1315{
525d8583 1316 return wxFindWindowHelper(parent, wxEmptyString, id, wxFindWindowCmpIds);
146ba0fe
VZ
1317}
1318
f03fc89f
VZ
1319// ----------------------------------------------------------------------------
1320// dialog oriented functions
1321// ----------------------------------------------------------------------------
1322
34636400 1323void wxWindowBase::MakeModal(bool modal)
f03fc89f 1324{
34636400
VZ
1325 // Disable all other windows
1326 if ( IsTopLevel() )
1327 {
222ed1d6 1328 wxWindowList::compatibility_iterator node = wxTopLevelWindows.GetFirst();
34636400
VZ
1329 while (node)
1330 {
1331 wxWindow *win = node->GetData();
1332 if (win != this)
1333 win->Enable(!modal);
1334
1335 node = node->GetNext();
1336 }
1337 }
f03fc89f
VZ
1338}
1339
1340bool wxWindowBase::Validate()
1341{
88ac883a 1342#if wxUSE_VALIDATORS
d80cd92a
VZ
1343 bool recurse = (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY) != 0;
1344
222ed1d6 1345 wxWindowList::compatibility_iterator node;
f03fc89f
VZ
1346 for ( node = m_children.GetFirst(); node; node = node->GetNext() )
1347 {
1348 wxWindowBase *child = node->GetData();
1349 wxValidator *validator = child->GetValidator();
dcd6b914 1350 if ( validator && !validator->Validate((wxWindow *)this) )
f03fc89f 1351 {
e11f4636 1352 return false;
f03fc89f 1353 }
d80cd92a
VZ
1354
1355 if ( recurse && !child->Validate() )
1356 {
e11f4636 1357 return false;
d80cd92a 1358 }
f03fc89f 1359 }
88ac883a 1360#endif // wxUSE_VALIDATORS
f03fc89f 1361
e11f4636 1362 return true;
f03fc89f
VZ
1363}
1364
1365bool wxWindowBase::TransferDataToWindow()
1366{
88ac883a 1367#if wxUSE_VALIDATORS
d80cd92a
VZ
1368 bool recurse = (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY) != 0;
1369
222ed1d6 1370 wxWindowList::compatibility_iterator node;
f03fc89f
VZ
1371 for ( node = m_children.GetFirst(); node; node = node->GetNext() )
1372 {
1373 wxWindowBase *child = node->GetData();
1374 wxValidator *validator = child->GetValidator();
1375 if ( validator && !validator->TransferToWindow() )
1376 {
d80cd92a 1377 wxLogWarning(_("Could not transfer data to window"));
e30285ab 1378#if wxUSE_LOG
d80cd92a 1379 wxLog::FlushActive();
e30285ab 1380#endif // wxUSE_LOG
f03fc89f 1381
e11f4636 1382 return false;
f03fc89f 1383 }
d80cd92a
VZ
1384
1385 if ( recurse )
1386 {
a58a12e9 1387 if ( !child->TransferDataToWindow() )
d80cd92a
VZ
1388 {
1389 // warning already given
e11f4636 1390 return false;
d80cd92a
VZ
1391 }
1392 }
f03fc89f 1393 }
88ac883a 1394#endif // wxUSE_VALIDATORS
f03fc89f 1395
e11f4636 1396 return true;
f03fc89f
VZ
1397}
1398
1399bool wxWindowBase::TransferDataFromWindow()
1400{
88ac883a 1401#if wxUSE_VALIDATORS
d80cd92a
VZ
1402 bool recurse = (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY) != 0;
1403
222ed1d6 1404 wxWindowList::compatibility_iterator node;
f03fc89f
VZ
1405 for ( node = m_children.GetFirst(); node; node = node->GetNext() )
1406 {
1407 wxWindow *child = node->GetData();
d80cd92a
VZ
1408 wxValidator *validator = child->GetValidator();
1409 if ( validator && !validator->TransferFromWindow() )
f03fc89f 1410 {
d80cd92a
VZ
1411 // nop warning here because the application is supposed to give
1412 // one itself - we don't know here what might have gone wrongly
1413
e11f4636 1414 return false;
f03fc89f 1415 }
d80cd92a
VZ
1416
1417 if ( recurse )
1418 {
a58a12e9 1419 if ( !child->TransferDataFromWindow() )
d80cd92a
VZ
1420 {
1421 // warning already given
e11f4636 1422 return false;
d80cd92a
VZ
1423 }
1424 }
f03fc89f 1425 }
88ac883a 1426#endif // wxUSE_VALIDATORS
f03fc89f 1427
e11f4636 1428 return true;
f03fc89f
VZ
1429}
1430
1431void wxWindowBase::InitDialog()
1432{
1433 wxInitDialogEvent event(GetId());
1434 event.SetEventObject( this );
1435 GetEventHandler()->ProcessEvent(event);
1436}
1437
1438// ----------------------------------------------------------------------------
bd83cb56
VZ
1439// context-sensitive help support
1440// ----------------------------------------------------------------------------
1441
1442#if wxUSE_HELP
1443
1444// associate this help text with this window
1445void wxWindowBase::SetHelpText(const wxString& text)
1446{
1447 wxHelpProvider *helpProvider = wxHelpProvider::Get();
1448 if ( helpProvider )
1449 {
1450 helpProvider->AddHelp(this, text);
1451 }
1452}
1453
1454// associate this help text with all windows with the same id as this
1455// one
1456void wxWindowBase::SetHelpTextForId(const wxString& text)
1457{
1458 wxHelpProvider *helpProvider = wxHelpProvider::Get();
1459 if ( helpProvider )
1460 {
1461 helpProvider->AddHelp(GetId(), text);
1462 }
1463}
1464
1465// get the help string associated with this window (may be empty)
1466wxString wxWindowBase::GetHelpText() const
1467{
1468 wxString text;
1469 wxHelpProvider *helpProvider = wxHelpProvider::Get();
1470 if ( helpProvider )
1471 {
1472 text = helpProvider->GetHelp(this);
1473 }
1474
1475 return text;
1476}
1477
1478// show help for this window
1479void wxWindowBase::OnHelp(wxHelpEvent& event)
1480{
1481 wxHelpProvider *helpProvider = wxHelpProvider::Get();
1482 if ( helpProvider )
1483 {
1484 if ( helpProvider->ShowHelp(this) )
1485 {
1486 // skip the event.Skip() below
1487 return;
1488 }
1489 }
1490
1491 event.Skip();
1492}
1493
1494#endif // wxUSE_HELP
1495
1496// ----------------------------------------------------------------------------
574c939e 1497// tooltipsroot.Replace("\\", "/");
f03fc89f
VZ
1498// ----------------------------------------------------------------------------
1499
1500#if wxUSE_TOOLTIPS
1501
1502void wxWindowBase::SetToolTip( const wxString &tip )
1503{
1504 // don't create the new tooltip if we already have one
1505 if ( m_tooltip )
1506 {
1507 m_tooltip->SetTip( tip );
1508 }
1509 else
1510 {
1511 SetToolTip( new wxToolTip( tip ) );
1512 }
1513
1514 // setting empty tooltip text does not remove the tooltip any more - use
1515 // SetToolTip((wxToolTip *)NULL) for this
1516}
1517
1518void wxWindowBase::DoSetToolTip(wxToolTip *tooltip)
1519{
1520 if ( m_tooltip )
1521 delete m_tooltip;
1522
1523 m_tooltip = tooltip;
1524}
1525
1526#endif // wxUSE_TOOLTIPS
1527
1528// ----------------------------------------------------------------------------
1529// constraints and sizers
1530// ----------------------------------------------------------------------------
1531
1532#if wxUSE_CONSTRAINTS
1533
1534void wxWindowBase::SetConstraints( wxLayoutConstraints *constraints )
1535{
1536 if ( m_constraints )
1537 {
1538 UnsetConstraints(m_constraints);
1539 delete m_constraints;
1540 }
1541 m_constraints = constraints;
1542 if ( m_constraints )
1543 {
1544 // Make sure other windows know they're part of a 'meaningful relationship'
1545 if ( m_constraints->left.GetOtherWindow() && (m_constraints->left.GetOtherWindow() != this) )
1546 m_constraints->left.GetOtherWindow()->AddConstraintReference(this);
1547 if ( m_constraints->top.GetOtherWindow() && (m_constraints->top.GetOtherWindow() != this) )
1548 m_constraints->top.GetOtherWindow()->AddConstraintReference(this);
1549 if ( m_constraints->right.GetOtherWindow() && (m_constraints->right.GetOtherWindow() != this) )
1550 m_constraints->right.GetOtherWindow()->AddConstraintReference(this);
1551 if ( m_constraints->bottom.GetOtherWindow() && (m_constraints->bottom.GetOtherWindow() != this) )
1552 m_constraints->bottom.GetOtherWindow()->AddConstraintReference(this);
1553 if ( m_constraints->width.GetOtherWindow() && (m_constraints->width.GetOtherWindow() != this) )
1554 m_constraints->width.GetOtherWindow()->AddConstraintReference(this);
1555 if ( m_constraints->height.GetOtherWindow() && (m_constraints->height.GetOtherWindow() != this) )
1556 m_constraints->height.GetOtherWindow()->AddConstraintReference(this);
1557 if ( m_constraints->centreX.GetOtherWindow() && (m_constraints->centreX.GetOtherWindow() != this) )
1558 m_constraints->centreX.GetOtherWindow()->AddConstraintReference(this);
1559 if ( m_constraints->centreY.GetOtherWindow() && (m_constraints->centreY.GetOtherWindow() != this) )
1560 m_constraints->centreY.GetOtherWindow()->AddConstraintReference(this);
1561 }
1562}
1563
1564// This removes any dangling pointers to this window in other windows'
1565// constraintsInvolvedIn lists.
1566void wxWindowBase::UnsetConstraints(wxLayoutConstraints *c)
1567{
1568 if ( c )
1569 {
1570 if ( c->left.GetOtherWindow() && (c->top.GetOtherWindow() != this) )
1571 c->left.GetOtherWindow()->RemoveConstraintReference(this);
1572 if ( c->top.GetOtherWindow() && (c->top.GetOtherWindow() != this) )
1573 c->top.GetOtherWindow()->RemoveConstraintReference(this);
1574 if ( c->right.GetOtherWindow() && (c->right.GetOtherWindow() != this) )
1575 c->right.GetOtherWindow()->RemoveConstraintReference(this);
1576 if ( c->bottom.GetOtherWindow() && (c->bottom.GetOtherWindow() != this) )
1577 c->bottom.GetOtherWindow()->RemoveConstraintReference(this);
1578 if ( c->width.GetOtherWindow() && (c->width.GetOtherWindow() != this) )
1579 c->width.GetOtherWindow()->RemoveConstraintReference(this);
1580 if ( c->height.GetOtherWindow() && (c->height.GetOtherWindow() != this) )
1581 c->height.GetOtherWindow()->RemoveConstraintReference(this);
1582 if ( c->centreX.GetOtherWindow() && (c->centreX.GetOtherWindow() != this) )
1583 c->centreX.GetOtherWindow()->RemoveConstraintReference(this);
1584 if ( c->centreY.GetOtherWindow() && (c->centreY.GetOtherWindow() != this) )
1585 c->centreY.GetOtherWindow()->RemoveConstraintReference(this);
1586 }
1587}
1588
1589// Back-pointer to other windows we're involved with, so if we delete this
1590// window, we must delete any constraints we're involved with.
1591void wxWindowBase::AddConstraintReference(wxWindowBase *otherWin)
1592{
1593 if ( !m_constraintsInvolvedIn )
1594 m_constraintsInvolvedIn = new wxWindowList;
222ed1d6
MB
1595 if ( !m_constraintsInvolvedIn->Find((wxWindow *)otherWin) )
1596 m_constraintsInvolvedIn->Append((wxWindow *)otherWin);
f03fc89f
VZ
1597}
1598
1599// REMOVE back-pointer to other windows we're involved with.
1600void wxWindowBase::RemoveConstraintReference(wxWindowBase *otherWin)
1601{
1602 if ( m_constraintsInvolvedIn )
222ed1d6 1603 m_constraintsInvolvedIn->DeleteObject((wxWindow *)otherWin);
f03fc89f
VZ
1604}
1605
1606// Reset any constraints that mention this window
1607void wxWindowBase::DeleteRelatedConstraints()
1608{
1609 if ( m_constraintsInvolvedIn )
1610 {
222ed1d6 1611 wxWindowList::compatibility_iterator node = m_constraintsInvolvedIn->GetFirst();
f03fc89f
VZ
1612 while (node)
1613 {
1614 wxWindow *win = node->GetData();
1615 wxLayoutConstraints *constr = win->GetConstraints();
1616
1617 // Reset any constraints involving this window
1618 if ( constr )
1619 {
1620 constr->left.ResetIfWin(this);
1621 constr->top.ResetIfWin(this);
1622 constr->right.ResetIfWin(this);
1623 constr->bottom.ResetIfWin(this);
1624 constr->width.ResetIfWin(this);
1625 constr->height.ResetIfWin(this);
1626 constr->centreX.ResetIfWin(this);
1627 constr->centreY.ResetIfWin(this);
1628 }
1629
222ed1d6
MB
1630 wxWindowList::compatibility_iterator next = node->GetNext();
1631 m_constraintsInvolvedIn->Erase(node);
f03fc89f
VZ
1632 node = next;
1633 }
1634
1635 delete m_constraintsInvolvedIn;
1636 m_constraintsInvolvedIn = (wxWindowList *) NULL;
1637 }
1638}
ec5bb70d
VZ
1639
1640#endif // wxUSE_CONSTRAINTS
f03fc89f 1641
3aa5d532 1642void wxWindowBase::SetSizer(wxSizer *sizer, bool deleteOld)
f03fc89f 1643{
fb89cfc5
RD
1644 if ( sizer == m_windowSizer)
1645 return;
1b69c815 1646
ec5bb70d
VZ
1647 if ( deleteOld )
1648 delete m_windowSizer;
3417c2cd 1649
f03fc89f 1650 m_windowSizer = sizer;
566d84a7 1651
ec5bb70d 1652 SetAutoLayout( sizer != NULL );
566d84a7
RL
1653}
1654
1655void wxWindowBase::SetSizerAndFit(wxSizer *sizer, bool deleteOld)
1656{
1657 SetSizer( sizer, deleteOld );
1658 sizer->SetSizeHints( (wxWindow*) this );
f03fc89f
VZ
1659}
1660
400a9e41 1661
1ebfafde
RD
1662void wxWindowBase::SetContainingSizer(wxSizer* sizer)
1663{
1664 // adding a window to a sizer twice is going to result in fatal and
1665 // hard to debug problems later because when deleting the second
1666 // associated wxSizerItem we're going to dereference a dangling
1667 // pointer; so try to detect this as early as possible
1668 wxASSERT_MSG( !sizer || m_containingSizer != sizer,
1669 _T("Adding a window to the same sizer twice?") );
1ebfafde 1670
400a9e41 1671 m_containingSizer = sizer;
1ebfafde 1672}
400a9e41 1673
ec5bb70d
VZ
1674#if wxUSE_CONSTRAINTS
1675
1676void wxWindowBase::SatisfyConstraints()
1677{
1678 wxLayoutConstraints *constr = GetConstraints();
1679 bool wasOk = constr && constr->AreSatisfied();
1680
1681 ResetConstraints(); // Mark all constraints as unevaluated
1682
1683 int noChanges = 1;
1684
1685 // if we're a top level panel (i.e. our parent is frame/dialog), our
1686 // own constraints will never be satisfied any more unless we do it
1687 // here
1688 if ( wasOk )
1689 {
1690 while ( noChanges > 0 )
1691 {
1692 LayoutPhase1(&noChanges);
1693 }
1694 }
1695
1696 LayoutPhase2(&noChanges);
1697}
1698
1699#endif // wxUSE_CONSTRAINTS
1700
f03fc89f
VZ
1701bool wxWindowBase::Layout()
1702{
3417c2cd 1703 // If there is a sizer, use it instead of the constraints
f03fc89f
VZ
1704 if ( GetSizer() )
1705 {
f1df0927 1706 int w, h;
566d84a7 1707 GetVirtualSize(&w, &h);
3417c2cd 1708 GetSizer()->SetDimension( 0, 0, w, h );
f03fc89f 1709 }
461e93f9 1710#if wxUSE_CONSTRAINTS
f1df0927 1711 else
f03fc89f 1712 {
ec5bb70d 1713 SatisfyConstraints(); // Find the right constraints values
f1df0927 1714 SetConstraintSizes(); // Recursively set the real window sizes
f03fc89f 1715 }
461e93f9 1716#endif
5d4b632b 1717
e11f4636 1718 return true;
f03fc89f
VZ
1719}
1720
461e93f9 1721#if wxUSE_CONSTRAINTS
ec5bb70d
VZ
1722
1723// first phase of the constraints evaluation: set our own constraints
f03fc89f
VZ
1724bool wxWindowBase::LayoutPhase1(int *noChanges)
1725{
1726 wxLayoutConstraints *constr = GetConstraints();
ec5bb70d
VZ
1727
1728 return !constr || constr->SatisfyConstraints(this, noChanges);
f03fc89f
VZ
1729}
1730
ec5bb70d 1731// second phase: set the constraints for our children
f03fc89f
VZ
1732bool wxWindowBase::LayoutPhase2(int *noChanges)
1733{
1734 *noChanges = 0;
1735
1736 // Layout children
1737 DoPhase(1);
ec5bb70d
VZ
1738
1739 // Layout grand children
f03fc89f 1740 DoPhase(2);
ec5bb70d 1741
e11f4636 1742 return true;
f03fc89f
VZ
1743}
1744
1745// Do a phase of evaluating child constraints
1746bool wxWindowBase::DoPhase(int phase)
1747{
ec5bb70d
VZ
1748 // the list containing the children for which the constraints are already
1749 // set correctly
f03fc89f 1750 wxWindowList succeeded;
ec5bb70d
VZ
1751
1752 // the max number of iterations we loop before concluding that we can't set
1753 // the constraints
1754 static const int maxIterations = 500;
1755
1756 for ( int noIterations = 0; noIterations < maxIterations; noIterations++ )
f03fc89f 1757 {
ec5bb70d
VZ
1758 int noChanges = 0;
1759
1760 // loop over all children setting their constraints
222ed1d6 1761 for ( wxWindowList::compatibility_iterator node = GetChildren().GetFirst();
ec5bb70d
VZ
1762 node;
1763 node = node->GetNext() )
f03fc89f
VZ
1764 {
1765 wxWindow *child = node->GetData();
ec5bb70d 1766 if ( child->IsTopLevel() )
f03fc89f 1767 {
ec5bb70d
VZ
1768 // top level children are not inside our client area
1769 continue;
1770 }
1771
1772 if ( !child->GetConstraints() || succeeded.Find(child) )
1773 {
1774 // this one is either already ok or nothing we can do about it
1775 continue;
1776 }
1777
1778 int tempNoChanges = 0;
1779 bool success = phase == 1 ? child->LayoutPhase1(&tempNoChanges)
1780 : child->LayoutPhase2(&tempNoChanges);
1781 noChanges += tempNoChanges;
1782
1783 if ( success )
1784 {
1785 succeeded.Append(child);
f03fc89f 1786 }
f03fc89f
VZ
1787 }
1788
ec5bb70d
VZ
1789 if ( !noChanges )
1790 {
1791 // constraints are set
1792 break;
1793 }
f03fc89f
VZ
1794 }
1795
e11f4636 1796 return true;
f03fc89f
VZ
1797}
1798
1799void wxWindowBase::ResetConstraints()
1800{
1801 wxLayoutConstraints *constr = GetConstraints();
1802 if ( constr )
1803 {
e11f4636
DS
1804 constr->left.SetDone(false);
1805 constr->top.SetDone(false);
1806 constr->right.SetDone(false);
1807 constr->bottom.SetDone(false);
1808 constr->width.SetDone(false);
1809 constr->height.SetDone(false);
1810 constr->centreX.SetDone(false);
1811 constr->centreY.SetDone(false);
f03fc89f 1812 }
f1df0927 1813
222ed1d6 1814 wxWindowList::compatibility_iterator node = GetChildren().GetFirst();
f03fc89f
VZ
1815 while (node)
1816 {
1817 wxWindow *win = node->GetData();
34636400 1818 if ( !win->IsTopLevel() )
f03fc89f
VZ
1819 win->ResetConstraints();
1820 node = node->GetNext();
1821 }
1822}
1823
1824// Need to distinguish between setting the 'fake' size for windows and sizers,
1825// and setting the real values.
1826void wxWindowBase::SetConstraintSizes(bool recurse)
1827{
1828 wxLayoutConstraints *constr = GetConstraints();
4b7f2165 1829 if ( constr && constr->AreSatisfied() )
f03fc89f
VZ
1830 {
1831 int x = constr->left.GetValue();
1832 int y = constr->top.GetValue();
1833 int w = constr->width.GetValue();
1834 int h = constr->height.GetValue();
1835
f03fc89f 1836 if ( (constr->width.GetRelationship() != wxAsIs ) ||
3417c2cd 1837 (constr->height.GetRelationship() != wxAsIs) )
f03fc89f 1838 {
3417c2cd 1839 SetSize(x, y, w, h);
f03fc89f
VZ
1840 }
1841 else
1842 {
3417c2cd
RR
1843 // If we don't want to resize this window, just move it...
1844 Move(x, y);
f03fc89f
VZ
1845 }
1846 }
1847 else if ( constr )
1848 {
4b7f2165 1849 wxLogDebug(wxT("Constraints not satisfied for %s named '%s'."),
f1df0927 1850 GetClassInfo()->GetClassName(),
4b7f2165 1851 GetName().c_str());
f03fc89f
VZ
1852 }
1853
1854 if ( recurse )
1855 {
222ed1d6 1856 wxWindowList::compatibility_iterator node = GetChildren().GetFirst();
f03fc89f
VZ
1857 while (node)
1858 {
1859 wxWindow *win = node->GetData();
e2f9212c 1860 if ( !win->IsTopLevel() && win->GetConstraints() )
f03fc89f
VZ
1861 win->SetConstraintSizes();
1862 node = node->GetNext();
1863 }
1864 }
1865}
1866
f03fc89f
VZ
1867// Only set the size/position of the constraint (if any)
1868void wxWindowBase::SetSizeConstraint(int x, int y, int w, int h)
1869{
1870 wxLayoutConstraints *constr = GetConstraints();
1871 if ( constr )
1872 {
422d0ff0 1873 if ( x != wxDefaultCoord )
f03fc89f
VZ
1874 {
1875 constr->left.SetValue(x);
e11f4636 1876 constr->left.SetDone(true);
f03fc89f 1877 }
422d0ff0 1878 if ( y != wxDefaultCoord )
f03fc89f
VZ
1879 {
1880 constr->top.SetValue(y);
e11f4636 1881 constr->top.SetDone(true);
f03fc89f 1882 }
422d0ff0 1883 if ( w != wxDefaultCoord )
f03fc89f
VZ
1884 {
1885 constr->width.SetValue(w);
e11f4636 1886 constr->width.SetDone(true);
f03fc89f 1887 }
422d0ff0 1888 if ( h != wxDefaultCoord )
f03fc89f
VZ
1889 {
1890 constr->height.SetValue(h);
e11f4636 1891 constr->height.SetDone(true);
f03fc89f
VZ
1892 }
1893 }
1894}
1895
1896void wxWindowBase::MoveConstraint(int x, int y)
1897{
1898 wxLayoutConstraints *constr = GetConstraints();
1899 if ( constr )
1900 {
422d0ff0 1901 if ( x != wxDefaultCoord )
f03fc89f
VZ
1902 {
1903 constr->left.SetValue(x);
e11f4636 1904 constr->left.SetDone(true);
f03fc89f 1905 }
422d0ff0 1906 if ( y != wxDefaultCoord )
f03fc89f
VZ
1907 {
1908 constr->top.SetValue(y);
e11f4636 1909 constr->top.SetDone(true);
f03fc89f
VZ
1910 }
1911 }
1912}
1913
1914void wxWindowBase::GetSizeConstraint(int *w, int *h) const
1915{
1916 wxLayoutConstraints *constr = GetConstraints();
1917 if ( constr )
1918 {
1919 *w = constr->width.GetValue();
1920 *h = constr->height.GetValue();
1921 }
1922 else
1923 GetSize(w, h);
1924}
1925
1926void wxWindowBase::GetClientSizeConstraint(int *w, int *h) const
1927{
1928 wxLayoutConstraints *constr = GetConstraints();
1929 if ( constr )
1930 {
1931 *w = constr->width.GetValue();
1932 *h = constr->height.GetValue();
1933 }
1934 else
1935 GetClientSize(w, h);
1936}
1937
461e93f9
JS
1938void wxWindowBase::GetPositionConstraint(int *x, int *y) const
1939{
1940 wxLayoutConstraints *constr = GetConstraints();
1941 if ( constr )
1942 {
1943 *x = constr->left.GetValue();
1944 *y = constr->top.GetValue();
1945 }
1946 else
1947 GetPosition(x, y);
1948}
1949
1950#endif // wxUSE_CONSTRAINTS
1951
20a1eea1 1952void wxWindowBase::AdjustForParentClientOrigin(int& x, int& y, int sizeFlags) const
a200c35e
VS
1953{
1954 // don't do it for the dialogs/frames - they float independently of their
1955 // parent
1956 if ( !IsTopLevel() )
1957 {
1958 wxWindow *parent = GetParent();
1959 if ( !(sizeFlags & wxSIZE_NO_ADJUSTMENTS) && parent )
1960 {
1961 wxPoint pt(parent->GetClientAreaOrigin());
1962 x += pt.x;
1963 y += pt.y;
1964 }
1965 }
1966}
1967
f03fc89f
VZ
1968// ----------------------------------------------------------------------------
1969// do Update UI processing for child controls
1970// ----------------------------------------------------------------------------
7ec1983b 1971
e39af974 1972void wxWindowBase::UpdateWindowUI(long flags)
7ec1983b 1973{
26bf1ce0 1974 wxUpdateUIEvent event(GetId());
687706f5 1975 event.SetEventObject(this);
26bf1ce0
VZ
1976
1977 if ( GetEventHandler()->ProcessEvent(event) )
7ec1983b 1978 {
e39af974
JS
1979 DoUpdateWindowUI(event);
1980 }
7ec1983b 1981
e39af974
JS
1982 if (flags & wxUPDATE_UI_RECURSE)
1983 {
222ed1d6 1984 wxWindowList::compatibility_iterator node = GetChildren().GetFirst();
e39af974 1985 while (node)
f03fc89f 1986 {
e39af974
JS
1987 wxWindow* child = (wxWindow*) node->GetData();
1988 child->UpdateWindowUI(flags);
1989 node = node->GetNext();
26bf1ce0 1990 }
e39af974
JS
1991 }
1992}
f03fc89f 1993
e39af974
JS
1994// do the window-specific processing after processing the update event
1995// TODO: take specific knowledge out of this function and
1996// put in each control's base class. Unfortunately we don't
1997// yet have base implementation files for wxCheckBox and wxRadioButton.
1998void wxWindowBase::DoUpdateWindowUI(wxUpdateUIEvent& event)
1999{
2000 if ( event.GetSetEnabled() )
2001 Enable(event.GetEnabled());
e11f4636 2002
e39af974
JS
2003#if wxUSE_CONTROLS
2004 if ( event.GetSetText() )
2005 {
2006 wxControl *control = wxDynamicCastThis(wxControl);
2007 if ( control )
2008 {
2009 if ( event.GetText() != control->GetLabel() )
2010 control->SetLabel(event.GetText());
2011 }
f3d618fd
VS
2012 }
2013#endif // wxUSE_CONTROLS
2014
2015 if ( event.GetSetChecked() )
2016 {
88ac883a 2017#if wxUSE_CHECKBOX
f7637829 2018 wxCheckBox *checkbox = wxDynamicCastThis(wxCheckBox);
26bf1ce0
VZ
2019 if ( checkbox )
2020 {
f3d618fd 2021 checkbox->SetValue(event.GetChecked());
26bf1ce0 2022 }
88ac883a
VZ
2023#endif // wxUSE_CHECKBOX
2024
b3402d0d 2025#if wxUSE_RADIOBTN
f7637829 2026 wxRadioButton *radiobtn = wxDynamicCastThis(wxRadioButton);
26bf1ce0
VZ
2027 if ( radiobtn )
2028 {
f3d618fd 2029 radiobtn->SetValue(event.GetChecked());
f03fc89f 2030 }
b3402d0d 2031#endif // wxUSE_RADIOBTN
e11f4636 2032 }
e39af974
JS
2033}
2034
5109ae5d 2035#if 0
e39af974 2036// call internal idle recursively
5109ae5d 2037// may be obsolete (wait until OnIdle scheme stabilises)
e39af974
JS
2038void wxWindowBase::ProcessInternalIdle()
2039{
2040 OnInternalIdle();
2041
222ed1d6 2042 wxWindowList::compatibility_iterator node = GetChildren().GetFirst();
e39af974
JS
2043 while (node)
2044 {
2045 wxWindow *child = node->GetData();
2046 child->ProcessInternalIdle();
2047 node = node->GetNext();
7ec1983b 2048 }
7ec1983b 2049}
5109ae5d 2050#endif
fd71308f 2051
f03fc89f
VZ
2052// ----------------------------------------------------------------------------
2053// dialog units translations
2054// ----------------------------------------------------------------------------
2055
2056wxPoint wxWindowBase::ConvertPixelsToDialog(const wxPoint& pt)
fd71308f
JS
2057{
2058 int charWidth = GetCharWidth();
2059 int charHeight = GetCharHeight();
cab1a605
WS
2060 wxPoint pt2 = wxDefaultPosition;
2061 if (pt.x != wxDefaultCoord)
1b69c815 2062 pt2.x = (int) ((pt.x * 4) / charWidth);
cab1a605 2063 if (pt.y != wxDefaultCoord)
1b69c815 2064 pt2.y = (int) ((pt.y * 8) / charHeight);
fd71308f
JS
2065
2066 return pt2;
2067}
2068
f03fc89f 2069wxPoint wxWindowBase::ConvertDialogToPixels(const wxPoint& pt)
fd71308f
JS
2070{
2071 int charWidth = GetCharWidth();
2072 int charHeight = GetCharHeight();
cab1a605
WS
2073 wxPoint pt2 = wxDefaultPosition;
2074 if (pt.x != wxDefaultCoord)
1b69c815 2075 pt2.x = (int) ((pt.x * charWidth) / 4);
cab1a605 2076 if (pt.y != wxDefaultCoord)
1b69c815 2077 pt2.y = (int) ((pt.y * charHeight) / 8);
fd71308f
JS
2078
2079 return pt2;
2080}
2081
f03fc89f
VZ
2082// ----------------------------------------------------------------------------
2083// event handlers
2084// ----------------------------------------------------------------------------
2085
2086// propagate the colour change event to the subwindows
2087void wxWindowBase::OnSysColourChanged(wxSysColourChangedEvent& event)
2088{
222ed1d6 2089 wxWindowList::compatibility_iterator node = GetChildren().GetFirst();
f03fc89f
VZ
2090 while ( node )
2091 {
2092 // Only propagate to non-top-level windows
2093 wxWindow *win = node->GetData();
2094 if ( !win->IsTopLevel() )
2095 {
2096 wxSysColourChangedEvent event2;
687706f5 2097 event.SetEventObject(win);
f03fc89f
VZ
2098 win->GetEventHandler()->ProcessEvent(event2);
2099 }
2100
2101 node = node->GetNext();
2102 }
9a8477e1
VS
2103
2104 Refresh();
f03fc89f
VZ
2105}
2106
e39af974
JS
2107// the default action is to populate dialog with data when it's created,
2108// and nudge the UI into displaying itself correctly in case
2109// we've turned the wxUpdateUIEvents frequency down low.
f03fc89f
VZ
2110void wxWindowBase::OnInitDialog( wxInitDialogEvent &WXUNUSED(event) )
2111{
2112 TransferDataToWindow();
e11f4636 2113
e39af974
JS
2114 // Update the UI at this point
2115 UpdateWindowUI(wxUPDATE_UI_RECURSE);
f03fc89f
VZ
2116}
2117
dddd1f21
VZ
2118// methods for drawing the sizers in a visible way
2119#ifdef __WXDEBUG__
2120
2121static void DrawSizers(wxWindowBase *win);
2122
2123static void DrawBorder(wxWindowBase *win, const wxRect& rect, bool fill = false)
2124{
2125 wxClientDC dc((wxWindow *)win);
2126 dc.SetPen(*wxRED_PEN);
2127 dc.SetBrush(fill ? wxBrush(*wxRED, wxCROSSDIAG_HATCH): *wxTRANSPARENT_BRUSH);
2128 dc.DrawRectangle(rect.Deflate(1, 1));
2129}
2130
2131static void DrawSizer(wxWindowBase *win, wxSizer *sizer)
2132{
2133 const wxSizerItemList& items = sizer->GetChildren();
2134 for ( wxSizerItemList::const_iterator i = items.begin(),
2135 end = items.end();
2136 i != end;
2137 ++i )
2138 {
2139 wxSizerItem *item = *i;
2140 if ( item->IsSizer() )
2141 {
2142 DrawBorder(win, item->GetRect().Deflate(2));
2143 DrawSizer(win, item->GetSizer());
2144 }
2145 else if ( item->IsSpacer() )
2146 {
2147 DrawBorder(win, item->GetRect().Deflate(2), true);
2148 }
2149 else if ( item->IsWindow() )
2150 {
2151 DrawSizers(item->GetWindow());
2152 }
2153 }
2154}
2155
2156static void DrawSizers(wxWindowBase *win)
2157{
2158 wxSizer *sizer = win->GetSizer();
2159 if ( sizer )
2160 {
2161 DrawBorder(win, win->GetClientSize());
2162 DrawSizer(win, sizer);
2163 }
2164 else // no sizer, still recurse into the children
2165 {
2166 const wxWindowList& children = win->GetChildren();
2167 for ( wxWindowList::const_iterator i = children.begin(),
2168 end = children.end();
2169 i != end;
2170 ++i )
2171 {
2172 DrawSizers(*i);
2173 }
2174 }
2175}
2176
2177#endif // __WXDEBUG__
2178
2179// process special middle clicks
a02dc3e3
VZ
2180void wxWindowBase::OnMiddleClick( wxMouseEvent& event )
2181{
2182 if ( event.ControlDown() && event.AltDown() )
2183 {
dddd1f21
VZ
2184#ifdef __WXDEBUG__
2185 // Ctrl-Alt-Shift-mclick makes the sizers visible in debug builds
2186 if ( event.ShiftDown() )
2187 {
2188 DrawSizers(this);
2189 return;
2190 }
2191#endif // __WXDEBUG__
2192
2193#if wxUSE_MSGDLG
a02dc3e3
VZ
2194 // don't translate these strings
2195 wxString port;
af3062a8
VZ
2196
2197#ifdef __WXUNIVERSAL__
2198 port = _T("Univ/");
2199#endif // __WXUNIVERSAL__
2200
a02dc3e3
VZ
2201 switch ( wxGetOsVersion() )
2202 {
5bd98e93 2203 case wxMOTIF_X: port += _T("Motif"); break;
ff8fda36 2204 case wxMAC:
5bd98e93
VZ
2205 case wxMAC_DARWIN: port += _T("Mac"); break;
2206 case wxBEOS: port += _T("BeOS"); break;
a02dc3e3
VZ
2207 case wxGTK:
2208 case wxGTK_WIN32:
2209 case wxGTK_OS2:
5bd98e93 2210 case wxGTK_BEOS: port += _T("GTK"); break;
a02dc3e3
VZ
2211 case wxWINDOWS:
2212 case wxPENWINDOWS:
2213 case wxWINDOWS_NT:
2214 case wxWIN32S:
2215 case wxWIN95:
5bd98e93 2216 case wxWIN386: port += _T("MS Windows"); break;
a02dc3e3
VZ
2217 case wxMGL_UNIX:
2218 case wxMGL_X:
2219 case wxMGL_WIN32:
5bd98e93 2220 case wxMGL_OS2: port += _T("MGL"); break;
a02dc3e3 2221 case wxWINDOWS_OS2:
5bd98e93
VZ
2222 case wxOS2_PM: port += _T("OS/2"); break;
2223 case wxPALMOS: port += _T("Palm OS"); break;
2224 case wxWINDOWS_CE: port += _T("Windows CE (generic)"); break;
2225 case wxWINDOWS_POCKETPC: port += _T("Windows CE PocketPC"); break;
2226 case wxWINDOWS_SMARTPHONE: port += _T("Windows CE Smartphone"); break;
ea8e90b7 2227 default: port += _T("unknown"); break;
a02dc3e3
VZ
2228 }
2229
2230 wxMessageBox(wxString::Format(
2231 _T(
df311d21 2232 " wxWidgets Library (%s port)\nVersion %d.%d.%d%s%s, compiled at %s %s%s\n Copyright (c) 1995-2006 wxWidgets team"
a02dc3e3
VZ
2233 ),
2234 port.c_str(),
2235 wxMAJOR_VERSION,
2236 wxMINOR_VERSION,
2237 wxRELEASE_NUMBER,
3f562374
VZ
2238#if wxUSE_UNICODE
2239 L" (Unicode)",
2240#else
2241 "",
b1433926 2242#endif
4200d1f4 2243#ifdef __WXDEBUG__
b1433926
RL
2244 _T(" Debug build"),
2245#else
525d8583 2246 wxEmptyString,
3f562374
VZ
2247#endif
2248 __TDATE__,
0118b60b
MR
2249 __TTIME__,
2250#ifdef __WXGTK__
2251 wxString::Format(_T("\nagainst GTK+ %d.%d.%d. Runtime GTK+ version: %d.%d.%d"), GTK_MAJOR_VERSION, GTK_MINOR_VERSION, GTK_MICRO_VERSION, gtk_major_version, gtk_minor_version, gtk_micro_version).c_str()
2252#else
2253 ""
2254#endif
a02dc3e3 2255 ),
77ffb593 2256 _T("wxWidgets information"),
a02dc3e3
VZ
2257 wxICON_INFORMATION | wxOK,
2258 (wxWindow *)this);
2259 }
2260 else
1e6feb95 2261#endif // wxUSE_MSGDLG
a02dc3e3
VZ
2262 {
2263 event.Skip();
2264 }
2265}
2266
ed5317e5
JS
2267// ----------------------------------------------------------------------------
2268// accessibility
2269// ----------------------------------------------------------------------------
2270
2271#if wxUSE_ACCESSIBILITY
2272void wxWindowBase::SetAccessible(wxAccessible* accessible)
2273{
2aefc528 2274 if (m_accessible && (accessible != m_accessible))
ed5317e5
JS
2275 delete m_accessible;
2276 m_accessible = accessible;
2277 if (m_accessible)
2278 m_accessible->SetWindow((wxWindow*) this);
2279}
2280
2281// Returns the accessible object, creating if necessary.
2282wxAccessible* wxWindowBase::GetOrCreateAccessible()
2283{
2284 if (!m_accessible)
2285 m_accessible = CreateAccessible();
2286 return m_accessible;
2287}
2288
2289// Override to create a specific accessible object.
2290wxAccessible* wxWindowBase::CreateAccessible()
2291{
2292 return new wxWindowAccessible((wxWindow*) this);
2293}
2294
2295#endif
2296
f03fc89f
VZ
2297// ----------------------------------------------------------------------------
2298// list classes implementation
2299// ----------------------------------------------------------------------------
2300
ed1288c1
VZ
2301#if wxUSE_STL
2302
7ec69821 2303#include "wx/listimpl.cpp"
412e0d47 2304WX_DEFINE_LIST(wxWindowList)
ed1288c1
VZ
2305
2306#else
2307
f03fc89f
VZ
2308void wxWindowListNode::DeleteData()
2309{
2310 delete (wxWindow *)GetData();
2311}
ed1288c1 2312
222ed1d6 2313#endif
f03fc89f 2314
1e6feb95
VZ
2315// ----------------------------------------------------------------------------
2316// borders
2317// ----------------------------------------------------------------------------
2318
aede4ebb 2319wxBorder wxWindowBase::GetBorder(long flags) const
1e6feb95 2320{
aede4ebb 2321 wxBorder border = (wxBorder)(flags & wxBORDER_MASK);
1e6feb95
VZ
2322 if ( border == wxBORDER_DEFAULT )
2323 {
2324 border = GetDefaultBorder();
2325 }
2326
2327 return border;
2328}
2329
2330wxBorder wxWindowBase::GetDefaultBorder() const
2331{
2332 return wxBORDER_NONE;
2333}
2334
2335// ----------------------------------------------------------------------------
2336// hit testing
2337// ----------------------------------------------------------------------------
2338
2339wxHitTest wxWindowBase::DoHitTest(wxCoord x, wxCoord y) const
2340{
2341 // here we just check if the point is inside the window or not
2342
2343 // check the top and left border first
2344 bool outside = x < 0 || y < 0;
2345 if ( !outside )
2346 {
2347 // check the right and bottom borders too
2348 wxSize size = GetSize();
2349 outside = x >= size.x || y >= size.y;
2350 }
2351
2352 return outside ? wxHT_WINDOW_OUTSIDE : wxHT_WINDOW_INSIDE;
2353}
2354
94633ad9
VZ
2355// ----------------------------------------------------------------------------
2356// mouse capture
2357// ----------------------------------------------------------------------------
2358
2359struct WXDLLEXPORT wxWindowNext
2360{
2361 wxWindow *win;
2362 wxWindowNext *next;
786646f3 2363} *wxWindowBase::ms_winCaptureNext = NULL;
94633ad9 2364
a83e1475 2365void wxWindowBase::CaptureMouse()
94633ad9 2366{
7e555446 2367 wxLogTrace(_T("mousecapture"), _T("CaptureMouse(%p)"), this);
45e0dc94 2368
94633ad9
VZ
2369 wxWindow *winOld = GetCapture();
2370 if ( winOld )
2371 {
df2f507b 2372 ((wxWindowBase*) winOld)->DoReleaseMouse();
edd802c6 2373
94633ad9
VZ
2374 // save it on stack
2375 wxWindowNext *item = new wxWindowNext;
2376 item->win = winOld;
2377 item->next = ms_winCaptureNext;
2378 ms_winCaptureNext = item;
2379 }
2380 //else: no mouse capture to save
2381
2382 DoCaptureMouse();
2383}
2384
a83e1475 2385void wxWindowBase::ReleaseMouse()
94633ad9 2386{
7e555446 2387 wxLogTrace(_T("mousecapture"), _T("ReleaseMouse(%p)"), this);
349d1942 2388
63fd5f0b 2389 wxASSERT_MSG( GetCapture() == this, wxT("attempt to release mouse, but this window hasn't captured it") );
a7b09001 2390
94633ad9
VZ
2391 DoReleaseMouse();
2392
2393 if ( ms_winCaptureNext )
2394 {
44f8caa7 2395 ((wxWindowBase*)ms_winCaptureNext->win)->DoCaptureMouse();
edd802c6 2396
94633ad9
VZ
2397 wxWindowNext *item = ms_winCaptureNext;
2398 ms_winCaptureNext = item->next;
2399 delete item;
2400 }
2401 //else: stack is empty, no previous capture
2402
2403 wxLogTrace(_T("mousecapture"),
e11f4636
DS
2404 (const wxChar *) _T("After ReleaseMouse() mouse is captured by %p"),
2405 GetCapture());
94633ad9
VZ
2406}
2407
5048c832 2408#if wxUSE_HOTKEY
540b6b09
VZ
2409
2410bool
2411wxWindowBase::RegisterHotKey(int WXUNUSED(hotkeyId),
2412 int WXUNUSED(modifiers),
2413 int WXUNUSED(keycode))
5048c832
JS
2414{
2415 // not implemented
2416 return false;
2417}
2418
540b6b09 2419bool wxWindowBase::UnregisterHotKey(int WXUNUSED(hotkeyId))
5048c832
JS
2420{
2421 // not implemented
2422 return false;
2423}
540b6b09
VZ
2424
2425#endif // wxUSE_HOTKEY
7de59551
RD
2426
2427void wxWindowBase::SendDestroyEvent()
2428{
2429 wxWindowDestroyEvent event;
2430 event.SetEventObject(this);
2431 event.SetId(GetId());
2432 GetEventHandler()->ProcessEvent(event);
2433}
2434
4caf847c
VZ
2435// ----------------------------------------------------------------------------
2436// event processing
2437// ----------------------------------------------------------------------------
2438
ac8d0c11 2439bool wxWindowBase::TryValidator(wxEvent& wxVALIDATOR_PARAM(event))
4caf847c 2440{
6eabf58c 2441#if wxUSE_VALIDATORS
4caf847c
VZ
2442 // Can only use the validator of the window which
2443 // is receiving the event
2444 if ( event.GetEventObject() == this )
2445 {
2446 wxValidator *validator = GetValidator();
2447 if ( validator && validator->ProcessEvent(event) )
2448 {
6eabf58c 2449 return true;
4caf847c
VZ
2450 }
2451 }
6eabf58c 2452#endif // wxUSE_VALIDATORS
4caf847c 2453
6eabf58c 2454 return false;
4caf847c
VZ
2455}
2456
4caf847c
VZ
2457bool wxWindowBase::TryParent(wxEvent& event)
2458{
90e572f1 2459 // carry on up the parent-child hierarchy if the propagation count hasn't
040e234d
VZ
2460 // reached zero yet
2461 if ( event.ShouldPropagate() )
4caf847c
VZ
2462 {
2463 // honour the requests to stop propagation at this window: this is
2464 // used by the dialogs, for example, to prevent processing the events
2465 // from the dialog controls in the parent frame which rarely, if ever,
2466 // makes sense
2467 if ( !(GetExtraStyle() & wxWS_EX_BLOCK_EVENTS) )
2468 {
2469 wxWindow *parent = GetParent();
2470 if ( parent && !parent->IsBeingDeleted() )
040e234d
VZ
2471 {
2472 wxPropagateOnce propagateOnce(event);
2473
4caf847c 2474 return parent->GetEventHandler()->ProcessEvent(event);
040e234d 2475 }
4caf847c
VZ
2476 }
2477 }
2478
2479 return wxEvtHandler::TryParent(event);
2480}
2481
5f6cfda7 2482// ----------------------------------------------------------------------------
a24de76b 2483// keyboard navigation
5f6cfda7
JS
2484// ----------------------------------------------------------------------------
2485
2486// Navigates in the specified direction.
eedc82f4 2487bool wxWindowBase::Navigate(int flags)
5f6cfda7
JS
2488{
2489 wxNavigationKeyEvent eventNav;
eedc82f4 2490 eventNav.SetFlags(flags);
5f6cfda7
JS
2491 eventNav.SetEventObject(this);
2492 if ( GetParent()->GetEventHandler()->ProcessEvent(eventNav) )
2493 {
2494 return true;
2495 }
2496 return false;
2497}
2498
a24de76b
VZ
2499void wxWindowBase::DoMoveInTabOrder(wxWindow *win, MoveKind move)
2500{
2501 // check that we're not a top level window
2502 wxCHECK_RET( GetParent(),
2503 _T("MoveBefore/AfterInTabOrder() don't work for TLWs!") );
2504
ef6816ef
VZ
2505 // detect the special case when we have nothing to do anyhow and when the
2506 // code below wouldn't work
2507 if ( win == this )
2508 return;
2509
a24de76b
VZ
2510 // find the target window in the siblings list
2511 wxWindowList& siblings = GetParent()->GetChildren();
2512 wxWindowList::compatibility_iterator i = siblings.Find(win);
2513 wxCHECK_RET( i, _T("MoveBefore/AfterInTabOrder(): win is not a sibling") );
2514
2515 // unfortunately, when wxUSE_STL == 1 DetachNode() is not implemented so we
2516 // can't just move the node around
feef1ecf
VZ
2517 wxWindow *self = (wxWindow *)this;
2518 siblings.DeleteObject(self);
9e9300c4
VZ
2519 if ( move == MoveAfter )
2520 {
2521 i = i->GetNext();
2522 }
2523
2524 if ( i )
a24de76b 2525 {
feef1ecf 2526 siblings.Insert(i, self);
a24de76b
VZ
2527 }
2528 else // MoveAfter and win was the last sibling
2529 {
feef1ecf 2530 siblings.Append(self);
a24de76b
VZ
2531 }
2532}
2533
0fe02759
VS
2534// ----------------------------------------------------------------------------
2535// focus handling
2536// ----------------------------------------------------------------------------
2537
2538/*static*/ wxWindow* wxWindowBase::FindFocus()
2539{
9c52a429 2540 wxWindowBase *win = DoFindFocus();
0fe02759
VS
2541 return win ? win->GetMainWindowOfCompositeControl() : NULL;
2542}
2543
33b494d6
VZ
2544// ----------------------------------------------------------------------------
2545// global functions
2546// ----------------------------------------------------------------------------
2547
2548wxWindow* wxGetTopLevelParent(wxWindow *win)
2549{
2550 while ( win && !win->IsTopLevel() )
2551 win = win->GetParent();
2552
2553 return win;
2554}
2555
ed5317e5
JS
2556#if wxUSE_ACCESSIBILITY
2557// ----------------------------------------------------------------------------
2558// accessible object for windows
2559// ----------------------------------------------------------------------------
2560
2561// Can return either a child object, or an integer
2562// representing the child element, starting from 1.
66b9ec3d 2563wxAccStatus wxWindowAccessible::HitTest(const wxPoint& WXUNUSED(pt), int* WXUNUSED(childId), wxAccessible** WXUNUSED(childObject))
ed5317e5
JS
2564{
2565 wxASSERT( GetWindow() != NULL );
2566 if (!GetWindow())
2567 return wxACC_FAIL;
2568
2569 return wxACC_NOT_IMPLEMENTED;
2570}
2571
2572// Returns the rectangle for this object (id = 0) or a child element (id > 0).
2573wxAccStatus wxWindowAccessible::GetLocation(wxRect& rect, int elementId)
2574{
2575 wxASSERT( GetWindow() != NULL );
2576 if (!GetWindow())
2577 return wxACC_FAIL;
2578
c6e2af45
JS
2579 wxWindow* win = NULL;
2580 if (elementId == 0)
2581 {
2582 win = GetWindow();
2583 }
2584 else
2585 {
2586 if (elementId <= (int) GetWindow()->GetChildren().GetCount())
2587 {
ee6eb8d8 2588 win = GetWindow()->GetChildren().Item(elementId-1)->GetData();
c6e2af45
JS
2589 }
2590 else
2591 return wxACC_FAIL;
2592 }
2593 if (win)
2594 {
2595 rect = win->GetRect();
2596 if (win->GetParent() && !win->IsKindOf(CLASSINFO(wxTopLevelWindow)))
2597 rect.SetPosition(win->GetParent()->ClientToScreen(rect.GetPosition()));
2598 return wxACC_OK;
2599 }
2600
ed5317e5
JS
2601 return wxACC_NOT_IMPLEMENTED;
2602}
2603
2604// Navigates from fromId to toId/toObject.
2605wxAccStatus wxWindowAccessible::Navigate(wxNavDir navDir, int fromId,
66b9ec3d 2606 int* WXUNUSED(toId), wxAccessible** toObject)
ed5317e5
JS
2607{
2608 wxASSERT( GetWindow() != NULL );
2609 if (!GetWindow())
2610 return wxACC_FAIL;
2611
c6e2af45
JS
2612 switch (navDir)
2613 {
2614 case wxNAVDIR_FIRSTCHILD:
2615 {
2616 if (GetWindow()->GetChildren().GetCount() == 0)
2617 return wxACC_FALSE;
2618 wxWindow* childWindow = (wxWindow*) GetWindow()->GetChildren().GetFirst()->GetData();
2619 *toObject = childWindow->GetOrCreateAccessible();
2620
2621 return wxACC_OK;
2622 }
2623 case wxNAVDIR_LASTCHILD:
2624 {
2625 if (GetWindow()->GetChildren().GetCount() == 0)
2626 return wxACC_FALSE;
2627 wxWindow* childWindow = (wxWindow*) GetWindow()->GetChildren().GetLast()->GetData();
2628 *toObject = childWindow->GetOrCreateAccessible();
2629
2630 return wxACC_OK;
2631 }
2632 case wxNAVDIR_RIGHT:
2633 case wxNAVDIR_DOWN:
2634 case wxNAVDIR_NEXT:
2635 {
ee6eb8d8
MB
2636 wxWindowList::compatibility_iterator node =
2637 wxWindowList::compatibility_iterator();
c6e2af45
JS
2638 if (fromId == 0)
2639 {
2640 // Can't navigate to sibling of this window
2641 // if we're a top-level window.
2642 if (!GetWindow()->GetParent())
2643 return wxACC_NOT_IMPLEMENTED;
2644
2645 node = GetWindow()->GetParent()->GetChildren().Find(GetWindow());
2646 }
2647 else
2648 {
2649 if (fromId <= (int) GetWindow()->GetChildren().GetCount())
33b3f7c3 2650 node = GetWindow()->GetChildren().Item(fromId-1);
c6e2af45
JS
2651 }
2652
2653 if (node && node->GetNext())
2654 {
ee6eb8d8 2655 wxWindow* nextWindow = node->GetNext()->GetData();
c6e2af45
JS
2656 *toObject = nextWindow->GetOrCreateAccessible();
2657 return wxACC_OK;
2658 }
2659 else
2660 return wxACC_FALSE;
2661 }
2662 case wxNAVDIR_LEFT:
2663 case wxNAVDIR_UP:
2664 case wxNAVDIR_PREVIOUS:
2665 {
ee6eb8d8
MB
2666 wxWindowList::compatibility_iterator node =
2667 wxWindowList::compatibility_iterator();
c6e2af45
JS
2668 if (fromId == 0)
2669 {
2670 // Can't navigate to sibling of this window
2671 // if we're a top-level window.
2672 if (!GetWindow()->GetParent())
2673 return wxACC_NOT_IMPLEMENTED;
2674
2675 node = GetWindow()->GetParent()->GetChildren().Find(GetWindow());
2676 }
2677 else
2678 {
2679 if (fromId <= (int) GetWindow()->GetChildren().GetCount())
33b3f7c3 2680 node = GetWindow()->GetChildren().Item(fromId-1);
c6e2af45
JS
2681 }
2682
2683 if (node && node->GetPrevious())
2684 {
ee6eb8d8 2685 wxWindow* previousWindow = node->GetPrevious()->GetData();
c6e2af45
JS
2686 *toObject = previousWindow->GetOrCreateAccessible();
2687 return wxACC_OK;
2688 }
2689 else
2690 return wxACC_FALSE;
2691 }
2692 }
2693
ed5317e5
JS
2694 return wxACC_NOT_IMPLEMENTED;
2695}
2696
2697// Gets the name of the specified object.
2698wxAccStatus wxWindowAccessible::GetName(int childId, wxString* name)
2699{
2700 wxASSERT( GetWindow() != NULL );
2701 if (!GetWindow())
2702 return wxACC_FAIL;
2703
2aefc528
JS
2704 wxString title;
2705
77ffb593 2706 // If a child, leave wxWidgets to call the function on the actual
2aefc528
JS
2707 // child object.
2708 if (childId > 0)
2709 return wxACC_NOT_IMPLEMENTED;
2710
2711 // This will eventually be replaced by specialised
77ffb593 2712 // accessible classes, one for each kind of wxWidgets
2aefc528 2713 // control or window.
0b4f47a3 2714#if wxUSE_BUTTON
2aefc528
JS
2715 if (GetWindow()->IsKindOf(CLASSINFO(wxButton)))
2716 title = ((wxButton*) GetWindow())->GetLabel();
2717 else
0b4f47a3 2718#endif
2aefc528 2719 title = GetWindow()->GetName();
e11f4636 2720
ba889513 2721 if (!title.empty())
ed5317e5
JS
2722 {
2723 *name = title;
2724 return wxACC_OK;
2725 }
2726 else
2727 return wxACC_NOT_IMPLEMENTED;
2728}
2729
2730// Gets the number of children.
2731wxAccStatus wxWindowAccessible::GetChildCount(int* childId)
2732{
2733 wxASSERT( GetWindow() != NULL );
2734 if (!GetWindow())
2735 return wxACC_FAIL;
2736
2737 *childId = (int) GetWindow()->GetChildren().GetCount();
2738 return wxACC_OK;
2739}
2740
2741// Gets the specified child (starting from 1).
2742// If *child is NULL and return value is wxACC_OK,
2743// this means that the child is a simple element and
2744// not an accessible object.
2745wxAccStatus wxWindowAccessible::GetChild(int childId, wxAccessible** child)
2746{
2747 wxASSERT( GetWindow() != NULL );
2748 if (!GetWindow())
2749 return wxACC_FAIL;
2750
2751 if (childId == 0)
2752 {
2753 *child = this;
2754 return wxACC_OK;
2755 }
2756
2757 if (childId > (int) GetWindow()->GetChildren().GetCount())
2758 return wxACC_FAIL;
2759
ee6eb8d8 2760 wxWindow* childWindow = GetWindow()->GetChildren().Item(childId-1)->GetData();
ed5317e5
JS
2761 *child = childWindow->GetOrCreateAccessible();
2762 if (*child)
2763 return wxACC_OK;
2764 else
2765 return wxACC_FAIL;
2766}
2767
2768// Gets the parent, or NULL.
2769wxAccStatus wxWindowAccessible::GetParent(wxAccessible** parent)
2770{
2771 wxASSERT( GetWindow() != NULL );
2772 if (!GetWindow())
2773 return wxACC_FAIL;
2774
2775 wxWindow* parentWindow = GetWindow()->GetParent();
c6e2af45 2776 if (!parentWindow)
ed5317e5
JS
2777 {
2778 *parent = NULL;
2779 return wxACC_OK;
2780 }
2781 else
2782 {
2783 *parent = parentWindow->GetOrCreateAccessible();
2784 if (*parent)
2785 return wxACC_OK;
2786 else
2787 return wxACC_FAIL;
2788 }
2789}
2790
2791// Performs the default action. childId is 0 (the action for this object)
2792// or > 0 (the action for a child).
2793// Return wxACC_NOT_SUPPORTED if there is no default action for this
2794// window (e.g. an edit control).
66b9ec3d 2795wxAccStatus wxWindowAccessible::DoDefaultAction(int WXUNUSED(childId))
ed5317e5
JS
2796{
2797 wxASSERT( GetWindow() != NULL );
2798 if (!GetWindow())
2799 return wxACC_FAIL;
2800
2801 return wxACC_NOT_IMPLEMENTED;
2802}
2803
2804// Gets the default action for this object (0) or > 0 (the action for a child).
2805// Return wxACC_OK even if there is no action. actionName is the action, or the empty
2806// string if there is no action.
2807// The retrieved string describes the action that is performed on an object,
2808// not what the object does as a result. For example, a toolbar button that prints
2809// a document has a default action of "Press" rather than "Prints the current document."
66b9ec3d 2810wxAccStatus wxWindowAccessible::GetDefaultAction(int WXUNUSED(childId), wxString* WXUNUSED(actionName))
ed5317e5
JS
2811{
2812 wxASSERT( GetWindow() != NULL );
2813 if (!GetWindow())
2814 return wxACC_FAIL;
2815
2816 return wxACC_NOT_IMPLEMENTED;
2817}
2818
2819// Returns the description for this object or a child.
66b9ec3d 2820wxAccStatus wxWindowAccessible::GetDescription(int WXUNUSED(childId), wxString* description)
ed5317e5
JS
2821{
2822 wxASSERT( GetWindow() != NULL );
2823 if (!GetWindow())
2824 return wxACC_FAIL;
2825
2aefc528 2826 wxString ht(GetWindow()->GetHelpText());
ba889513 2827 if (!ht.empty())
2aefc528
JS
2828 {
2829 *description = ht;
2830 return wxACC_OK;
2831 }
ed5317e5
JS
2832 return wxACC_NOT_IMPLEMENTED;
2833}
2834
2835// Returns help text for this object or a child, similar to tooltip text.
66b9ec3d 2836wxAccStatus wxWindowAccessible::GetHelpText(int WXUNUSED(childId), wxString* helpText)
ed5317e5
JS
2837{
2838 wxASSERT( GetWindow() != NULL );
2839 if (!GetWindow())
2840 return wxACC_FAIL;
2841
2842 wxString ht(GetWindow()->GetHelpText());
ba889513 2843 if (!ht.empty())
ed5317e5
JS
2844 {
2845 *helpText = ht;
2846 return wxACC_OK;
2847 }
2848 return wxACC_NOT_IMPLEMENTED;
2849}
2850
2851// Returns the keyboard shortcut for this object or child.
2852// Return e.g. ALT+K
66b9ec3d 2853wxAccStatus wxWindowAccessible::GetKeyboardShortcut(int WXUNUSED(childId), wxString* WXUNUSED(shortcut))
ed5317e5
JS
2854{
2855 wxASSERT( GetWindow() != NULL );
2856 if (!GetWindow())
2857 return wxACC_FAIL;
2858
2859 return wxACC_NOT_IMPLEMENTED;
2860}
2861
2862// Returns a role constant.
2863wxAccStatus wxWindowAccessible::GetRole(int childId, wxAccRole* role)
2864{
2865 wxASSERT( GetWindow() != NULL );
2866 if (!GetWindow())
2867 return wxACC_FAIL;
2868
77ffb593 2869 // If a child, leave wxWidgets to call the function on the actual
2aefc528
JS
2870 // child object.
2871 if (childId > 0)
2872 return wxACC_NOT_IMPLEMENTED;
2873
2874 if (GetWindow()->IsKindOf(CLASSINFO(wxControl)))
2875 return wxACC_NOT_IMPLEMENTED;
2876#if wxUSE_STATUSBAR
2877 if (GetWindow()->IsKindOf(CLASSINFO(wxStatusBar)))
2878 return wxACC_NOT_IMPLEMENTED;
2879#endif
2880#if wxUSE_TOOLBAR
2881 if (GetWindow()->IsKindOf(CLASSINFO(wxToolBar)))
2882 return wxACC_NOT_IMPLEMENTED;
2883#endif
2884
2885 //*role = wxROLE_SYSTEM_CLIENT;
2886 *role = wxROLE_SYSTEM_CLIENT;
2887 return wxACC_OK;
2888
66b9ec3d 2889 #if 0
ed5317e5 2890 return wxACC_NOT_IMPLEMENTED;
66b9ec3d 2891 #endif
ed5317e5
JS
2892}
2893
2894// Returns a state constant.
2895wxAccStatus wxWindowAccessible::GetState(int childId, long* state)
2896{
2897 wxASSERT( GetWindow() != NULL );
2898 if (!GetWindow())
2899 return wxACC_FAIL;
2900
77ffb593 2901 // If a child, leave wxWidgets to call the function on the actual
2aefc528
JS
2902 // child object.
2903 if (childId > 0)
2904 return wxACC_NOT_IMPLEMENTED;
2905
2906 if (GetWindow()->IsKindOf(CLASSINFO(wxControl)))
2907 return wxACC_NOT_IMPLEMENTED;
2908
2909#if wxUSE_STATUSBAR
2910 if (GetWindow()->IsKindOf(CLASSINFO(wxStatusBar)))
2911 return wxACC_NOT_IMPLEMENTED;
2912#endif
2913#if wxUSE_TOOLBAR
2914 if (GetWindow()->IsKindOf(CLASSINFO(wxToolBar)))
2915 return wxACC_NOT_IMPLEMENTED;
2916#endif
2917
2918 *state = 0;
2919 return wxACC_OK;
2920
66b9ec3d 2921 #if 0
ed5317e5 2922 return wxACC_NOT_IMPLEMENTED;
66b9ec3d 2923 #endif
ed5317e5
JS
2924}
2925
2926// Returns a localized string representing the value for the object
2927// or child.
66b9ec3d 2928wxAccStatus wxWindowAccessible::GetValue(int WXUNUSED(childId), wxString* WXUNUSED(strValue))
ed5317e5
JS
2929{
2930 wxASSERT( GetWindow() != NULL );
2931 if (!GetWindow())
2932 return wxACC_FAIL;
2933
2934 return wxACC_NOT_IMPLEMENTED;
2935}
2936
2937// Selects the object or child.
66b9ec3d 2938wxAccStatus wxWindowAccessible::Select(int WXUNUSED(childId), wxAccSelectionFlags WXUNUSED(selectFlags))
ed5317e5
JS
2939{
2940 wxASSERT( GetWindow() != NULL );
2941 if (!GetWindow())
2942 return wxACC_FAIL;
2943
2944 return wxACC_NOT_IMPLEMENTED;
2945}
2946
2947// Gets the window with the keyboard focus.
2948// If childId is 0 and child is NULL, no object in
2949// this subhierarchy has the focus.
2950// If this object has the focus, child should be 'this'.
66b9ec3d 2951wxAccStatus wxWindowAccessible::GetFocus(int* WXUNUSED(childId), wxAccessible** WXUNUSED(child))
ed5317e5
JS
2952{
2953 wxASSERT( GetWindow() != NULL );
2954 if (!GetWindow())
2955 return wxACC_FAIL;
2956
2957 return wxACC_NOT_IMPLEMENTED;
2958}
2959
2960// Gets a variant representing the selected children
2961// of this object.
2962// Acceptable values:
cab1a605 2963// - a null variant (IsNull() returns true)
ed5317e5
JS
2964// - a list variant (GetType() == wxT("list")
2965// - an integer representing the selected child element,
2966// or 0 if this object is selected (GetType() == wxT("long")
2967// - a "void*" pointer to a wxAccessible child object
66b9ec3d 2968wxAccStatus wxWindowAccessible::GetSelections(wxVariant* WXUNUSED(selections))
ed5317e5
JS
2969{
2970 wxASSERT( GetWindow() != NULL );
2971 if (!GetWindow())
2972 return wxACC_FAIL;
2973
2974 return wxACC_NOT_IMPLEMENTED;
2975}
2976
2977#endif // wxUSE_ACCESSIBILITY