src/common/wincmn.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        common/window.cpp
   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$
   8 // Copyright:   (c) wxWindows team
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 #ifdef __GNUG__
  21     #pragma implementation "windowbase.h"
  22 #endif
  23
  24 // For compilers that support precompilation, includes "wx.h".
  25 #include "wx/wxprec.h"
  26
  27 #ifdef __BORLANDC__
  28     #pragma hdrstop
  29 #endif
  30
  31 #ifndef WX_PRECOMP
  32     #include "wx/string.h"
  33     #include "wx/log.h"
  34     #include "wx/intl.h"
  35     #include "wx/frame.h"
  36     #include "wx/defs.h"
  37     #include "wx/window.h"
  38     #include "wx/control.h"
  39     #include "wx/checkbox.h"
  40     #include "wx/radiobut.h"
  41     #include "wx/statbox.h"
  42     #include "wx/textctrl.h"
  43     #include "wx/settings.h"
  44     #include "wx/dialog.h"
  45     #include "wx/msgdlg.h"
  46     #include "wx/statusbr.h"
  47     #include "wx/dcclient.h"
  48 #endif //WX_PRECOMP
  49
  50 #if wxUSE_CONSTRAINTS
  51     #include "wx/layout.h"
  52 #endif // wxUSE_CONSTRAINTS
  53
  54 #include "wx/sizer.h"
  55
  56 #if wxUSE_DRAG_AND_DROP
  57     #include "wx/dnd.h"
  58 #endif // wxUSE_DRAG_AND_DROP
  59
  60 #if wxUSE_ACCESSIBILITY
  61     #include "wx/access.h"
  62 #endif
  63
  64 #if wxUSE_HELP
  65     #include "wx/cshelp.h"
  66 #endif // wxUSE_HELP
  67
  68 #if wxUSE_TOOLTIPS
  69     #include "wx/tooltip.h"
  70 #endif // wxUSE_TOOLTIPS
  71
  72 #if wxUSE_CARET
  73     #include "wx/caret.h"
  74 #endif // wxUSE_CARET
  75
  76 // ----------------------------------------------------------------------------
  77 // static data
  78 // ----------------------------------------------------------------------------
  79
  80 #if defined(__WXPM__)
  81 int wxWindowBase::ms_lastControlId = 2000;
  82 #else
  83 int wxWindowBase::ms_lastControlId = -200;
  84 #endif
  85
  86 IMPLEMENT_ABSTRACT_CLASS(wxWindowBase, wxEvtHandler)
  87
  88 // ----------------------------------------------------------------------------
  89 // event table
  90 // ----------------------------------------------------------------------------
  91
  92 BEGIN_EVENT_TABLE(wxWindowBase, wxEvtHandler)
  93     EVT_SYS_COLOUR_CHANGED(wxWindowBase::OnSysColourChanged)
  94     EVT_INIT_DIALOG(wxWindowBase::OnInitDialog)
  95     EVT_MIDDLE_DOWN(wxWindowBase::OnMiddleClick)
  96
  97 #if wxUSE_HELP
  98     EVT_HELP(-1, wxWindowBase::OnHelp)
  99 #endif // wxUSE_HELP
 100
 101 END_EVENT_TABLE()
 102
 103 // ============================================================================
 104 // implementation of the common functionality of the wxWindow class
 105 // ============================================================================
 106
 107 // ----------------------------------------------------------------------------
 108 // initialization
 109 // ----------------------------------------------------------------------------
 110
 111 // the default initialization
 112 void wxWindowBase::InitBase()
 113 {
 114     // no window yet, no parent nor children
 115     m_parent = (wxWindow *)NULL;
 116     m_windowId = -1;
 117     m_children.DeleteContents( FALSE ); // don't auto delete node data
 118
 119     // no constraints on the minimal window size
 120     m_minWidth =
 121     m_minHeight =
 122     m_maxWidth =
 123     m_maxHeight = -1;
 124
 125     // window is created enabled but it's not visible yet
 126     m_isShown = FALSE;
 127     m_isEnabled = TRUE;
 128
 129     // the default event handler is just this window
 130     m_eventHandler = this;
 131
 132 #if wxUSE_VALIDATORS
 133     // no validator
 134     m_windowValidator = (wxValidator *) NULL;
 135 #endif // wxUSE_VALIDATORS
 136
 137     // use the system default colours
 138     m_backgroundColour = wxSystemSettings::GetColour(wxSYS_COLOUR_BTNFACE);
 139     m_foregroundColour = wxSystemSettings::GetColour(wxSYS_COLOUR_WINDOWTEXT);
 140
 141     // don't set the font here for wxMSW as we don't call WM_SETFONT here and
 142     // so the font is *not* really set - but calls to SetFont() later won't do
 143     // anything because m_font appears to be already set!
 144 #ifndef __WXMSW__
 145     m_font = wxSystemSettings::GetFont(wxSYS_DEFAULT_GUI_FONT);
 146 #endif // __WXMSW__
 147
 148     // the colours/fonts are default for now
 149     m_hasBgCol =
 150     m_hasFgCol =
 151     m_hasFont = FALSE;
 152
 153     m_isBeingDeleted = FALSE;
 154
 155     // no style bits
 156     m_exStyle =
 157     m_windowStyle = 0;
 158
 159     // an optimization for the event processing: checking this flag is much
 160     // faster than using IsKindOf(CLASSINFO(wxWindow))
 161     m_isWindow = TRUE;
 162
 163 #if wxUSE_CONSTRAINTS
 164     // no constraints whatsoever
 165     m_constraints = (wxLayoutConstraints *) NULL;
 166     m_constraintsInvolvedIn = (wxWindowList *) NULL;
 167 #endif // wxUSE_CONSTRAINTS
 168
 169     m_windowSizer = (wxSizer *) NULL;
 170     m_containingSizer = (wxSizer *) NULL;
 171     m_autoLayout = FALSE;
 172
 173 #if wxUSE_DRAG_AND_DROP
 174     m_dropTarget = (wxDropTarget *)NULL;
 175 #endif // wxUSE_DRAG_AND_DROP
 176
 177 #if wxUSE_TOOLTIPS
 178     m_tooltip = (wxToolTip *)NULL;
 179 #endif // wxUSE_TOOLTIPS
 180
 181 #if wxUSE_CARET
 182     m_caret = (wxCaret *)NULL;
 183 #endif // wxUSE_CARET
 184
 185 #if wxUSE_PALETTE
 186     m_hasCustomPalette = FALSE;
 187 #endif // wxUSE_PALETTE
 188
 189 #if wxUSE_ACCESSIBILITY
 190     m_accessible = NULL;
 191 #endif
 192
 193     m_virtualSize = wxDefaultSize;
 194
 195     m_minVirtualWidth =
 196     m_minVirtualHeight =
 197     m_maxVirtualWidth =
 198     m_maxVirtualHeight = -1;
 199
 200     // Whether we're using the current theme for this window (wxGTK only for now)
 201     m_themeEnabled = FALSE;
 202 }
 203
 204 // common part of window creation process
 205 bool wxWindowBase::CreateBase(wxWindowBase *parent,
 206                               wxWindowID id,
 207                               const wxPoint& WXUNUSED(pos),
 208                               const wxSize& WXUNUSED(size),
 209                               long style,
 210                               const wxValidator& validator,
 211                               const wxString& name)
 212 {
 213     // m_isWindow is set to TRUE in wxWindowBase::Init() as well as many other
 214     // member variables - check that it has been called (will catch the case
 215     // when a new ctor is added which doesn't call InitWindow)
 216     wxASSERT_MSG( m_isWindow, wxT("Init() must have been called before!") );
 217
 218 #if wxUSE_STATBOX
 219     // wxGTK doesn't allow to create controls with static box as the parent so
 220     // this will result in a crash when the program is ported to wxGTK so warn
 221     // the user about it
 222
 223     // if you get this assert, the correct solution is to create the controls
 224     // as siblings of the static box
 225     wxASSERT_MSG( !parent || !wxDynamicCast(parent, wxStaticBox),
 226                   _T("wxStaticBox can't be used as a window parent!") );
 227 #endif // wxUSE_STATBOX
 228
 229     // ids are limited to 16 bits under MSW so if you care about portability,
 230     // it's not a good idea to use ids out of this range (and negative ids are
 231     // reserved for wxWindows own usage)
 232     wxASSERT_MSG( id == wxID_ANY || (id >= 0 && id < 32767),
 233                   _T("invalid id value") );
 234
 235     // generate a new id if the user doesn't care about it
 236     m_windowId = id == wxID_ANY ? NewControlId() : id;
 237
 238     SetName(name);
 239     SetWindowStyleFlag(style);
 240     SetParent(parent);
 241
 242 #if wxUSE_VALIDATORS
 243     SetValidator(validator);
 244 #endif // wxUSE_VALIDATORS
 245
 246     // if the parent window has wxWS_EX_VALIDATE_RECURSIVELY set, we want to
 247     // have it too - like this it's possible to set it only in the top level
 248     // dialog/frame and all children will inherit it by defult
 249     if ( parent && (parent->GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY) )
 250     {
 251         SetExtraStyle(GetExtraStyle() | wxWS_EX_VALIDATE_RECURSIVELY);
 252     }
 253
 254     return TRUE;
 255 }
 256
 257 // ----------------------------------------------------------------------------
 258 // destruction
 259 // ----------------------------------------------------------------------------
 260
 261 // common clean up
 262 wxWindowBase::~wxWindowBase()
 263 {
 264     wxASSERT_MSG( GetCapture() != this, wxT("attempt to destroy window with mouse capture") );
 265
 266     // FIXME if these 2 cases result from programming errors in the user code
 267     //       we should probably assert here instead of silently fixing them
 268
 269     // Just in case the window has been Closed, but we're then deleting
 270     // immediately: don't leave dangling pointers.
 271     wxPendingDelete.DeleteObject(this);
 272
 273     // Just in case we've loaded a top-level window via LoadNativeDialog but
 274     // we weren't a dialog class
 275     wxTopLevelWindows.DeleteObject(this);
 276
 277     wxASSERT_MSG( GetChildren().GetCount() == 0, wxT("children not destroyed") );
 278
 279 #if wxUSE_CARET
 280     if ( m_caret )
 281         delete m_caret;
 282 #endif // wxUSE_CARET
 283
 284 #if wxUSE_VALIDATORS
 285     if ( m_windowValidator )
 286         delete m_windowValidator;
 287 #endif // wxUSE_VALIDATORS
 288
 289 #if wxUSE_CONSTRAINTS
 290     // Have to delete constraints/sizer FIRST otherwise sizers may try to look
 291     // at deleted windows as they delete themselves.
 292     DeleteRelatedConstraints();
 293
 294     if ( m_constraints )
 295     {
 296         // This removes any dangling pointers to this window in other windows'
 297         // constraintsInvolvedIn lists.
 298         UnsetConstraints(m_constraints);
 299         delete m_constraints;
 300         m_constraints = NULL;
 301     }
 302
 303 #endif // wxUSE_CONSTRAINTS
 304
 305     if ( m_containingSizer )
 306         m_containingSizer->Detach( (wxWindow*)this );
 307
 308     if ( m_windowSizer )
 309         delete m_windowSizer;
 310
 311 #if wxUSE_DRAG_AND_DROP
 312     if ( m_dropTarget )
 313         delete m_dropTarget;
 314 #endif // wxUSE_DRAG_AND_DROP
 315
 316 #if wxUSE_TOOLTIPS
 317     if ( m_tooltip )
 318         delete m_tooltip;
 319 #endif // wxUSE_TOOLTIPS
 320
 321 #if wxUSE_ACCESSIBILITY
 322     if ( m_accessible )
 323         delete m_accessible;
 324 #endif
 325
 326     // reset the dangling pointer our parent window may keep to us
 327     if ( m_parent && m_parent->GetDefaultItem() == this )
 328     {
 329         m_parent->SetDefaultItem(NULL);
 330     }
 331 }
 332
 333 bool wxWindowBase::Destroy()
 334 {
 335     delete this;
 336
 337     return TRUE;
 338 }
 339
 340 bool wxWindowBase::Close(bool force)
 341 {
 342     wxCloseEvent event(wxEVT_CLOSE_WINDOW, m_windowId);
 343     event.SetEventObject(this);
 344 #if WXWIN_COMPATIBILITY
 345     event.SetForce(force);
 346 #endif // WXWIN_COMPATIBILITY
 347     event.SetCanVeto(!force);
 348
 349     // return FALSE if window wasn't closed because the application vetoed the
 350     // close event
 351     return GetEventHandler()->ProcessEvent(event) && !event.GetVeto();
 352 }
 353
 354 bool wxWindowBase::DestroyChildren()
 355 {
 356     wxWindowList::Node *node;
 357     for ( ;; )
 358     {
 359         // we iterate until the list becomes empty
 360         node = GetChildren().GetFirst();
 361         if ( !node )
 362             break;
 363
 364         wxWindow *child = node->GetData();
 365
 366         wxASSERT_MSG( child, wxT("children list contains empty nodes") );
 367
 368         child->Show(FALSE);
 369         delete child;
 370
 371         wxASSERT_MSG( !GetChildren().Find(child),
 372                       wxT("child didn't remove itself using RemoveChild()") );
 373     }
 374
 375     return TRUE;
 376 }
 377
 378 // ----------------------------------------------------------------------------
 379 // size/position related methods
 380 // ----------------------------------------------------------------------------
 381
 382 // centre the window with respect to its parent in either (or both) directions
 383 void wxWindowBase::Centre(int direction)
 384 {
 385     // the position/size of the parent window or of the entire screen
 386     wxPoint posParent;
 387     int widthParent, heightParent;
 388
 389     wxWindow *parent = NULL;
 390
 391     if ( !(direction & wxCENTRE_ON_SCREEN) )
 392     {
 393         // find the parent to centre this window on: it should be the
 394         // immediate parent for the controls but the top level parent for the
 395         // top level windows (like dialogs)
 396         parent = GetParent();
 397         if ( IsTopLevel() )
 398         {
 399             while ( parent && !parent->IsTopLevel() )
 400             {
 401                 parent = parent->GetParent();
 402             }
 403         }
 404
 405         // there is no wxTopLevelWindow under wxMotif yet
 406 #ifndef __WXMOTIF__
 407         // we shouldn't center the dialog on the iconized window: under
 408         // Windows, for example, this places it completely off the screen
 409         if ( parent )
 410         {
 411             wxTopLevelWindow *winTop = wxDynamicCast(parent, wxTopLevelWindow);
 412             if ( winTop && winTop->IsIconized() )
 413             {
 414                 parent = NULL;
 415             }
 416         }
 417 #endif // __WXMOTIF__
 418
 419         // did we find the parent?
 420         if ( !parent )
 421         {
 422             // no other choice
 423             direction |= wxCENTRE_ON_SCREEN;
 424         }
 425     }
 426
 427     if ( direction & wxCENTRE_ON_SCREEN )
 428     {
 429         // centre with respect to the whole screen
 430         wxDisplaySize(&widthParent, &heightParent);
 431     }
 432     else
 433     {
 434         if ( IsTopLevel() )
 435         {
 436             // centre on the parent
 437             parent->GetSize(&widthParent, &heightParent);
 438
 439             // adjust to the parents position
 440             posParent = parent->GetPosition();
 441         }
 442         else
 443         {
 444             // centre inside the parents client rectangle
 445             parent->GetClientSize(&widthParent, &heightParent);
 446         }
 447     }
 448
 449     int width, height;
 450     GetSize(&width, &height);
 451
 452     int xNew = -1,
 453         yNew = -1;
 454
 455     if ( direction & wxHORIZONTAL )
 456         xNew = (widthParent - width)/2;
 457
 458     if ( direction & wxVERTICAL )
 459         yNew = (heightParent - height)/2;
 460
 461     xNew += posParent.x;
 462     yNew += posParent.y;
 463
 464     // Base size of the visible dimensions of the display
 465     // to take into account the taskbar
 466     wxRect rect = wxGetClientDisplayRect();
 467     wxSize size (rect.width,rect.height);
 468
 469     // NB: in wxMSW, negative position may not neccessary mean "out of screen",
 470     //     but it may mean that the window is placed on other than the main
 471     //     display. Therefore we only make sure centered window is on the main display
 472     //     if the parent is at least partially present here.
 473     if (posParent.x + widthParent >= 0)  // if parent is (partially) on the main display
 474     {
 475         if (xNew < 0)
 476             xNew = 0;
 477         else if (xNew+width > size.x)
 478             xNew = size.x-width-1;
 479     }
 480     if (posParent.y + heightParent >= 0)  // if parent is (partially) on the main display
 481     {
 482         if (yNew+height > size.y)
 483             yNew = size.y-height-1;
 484
 485         // Make certain that the title bar is initially visible
 486         // always, even if this would push the bottom of the
 487         // dialog of the visible area of the display
 488         if (yNew < 0)
 489             yNew = 0;
 490     }
 491
 492     // move the window to this position (keeping the old size but using
 493     // SetSize() and not Move() to allow xNew and/or yNew to be -1)
 494     SetSize(xNew, yNew, width, height, wxSIZE_ALLOW_MINUS_ONE);
 495 }
 496
 497 // fits the window around the children
 498 void wxWindowBase::Fit()
 499 {
 500     if ( GetChildren().GetCount() > 0 )
 501     {
 502         SetClientSize(DoGetBestSize());
 503     }
 504     //else: do nothing if we have no children
 505 }
 506
 507 // fits virtual size (ie. scrolled area etc.) around children
 508 void wxWindowBase::FitInside()
 509 {
 510     if ( GetChildren().GetCount() > 0 )
 511     {
 512         SetVirtualSize( GetBestVirtualSize() );
 513     }
 514 }
 515
 516 // return the size best suited for the current window
 517 wxSize wxWindowBase::DoGetBestSize() const
 518 {
 519     if ( m_windowSizer )
 520     {
 521         return m_windowSizer->GetMinSize();
 522     }
 523 #if wxUSE_CONSTRAINTS
 524     else if ( m_constraints )
 525     {
 526         wxConstCast(this, wxWindowBase)->SatisfyConstraints();
 527
 528         // our minimal acceptable size is such that all our windows fit inside
 529         int maxX = 0,
 530             maxY = 0;
 531
 532         for ( wxWindowList::Node *node = GetChildren().GetFirst();
 533               node;
 534               node = node->GetNext() )
 535         {
 536             wxLayoutConstraints *c = node->GetData()->GetConstraints();
 537             if ( !c )
 538             {
 539                 // it's not normal that we have an unconstrained child, but
 540                 // what can we do about it?
 541                 continue;
 542             }
 543
 544             int x = c->right.GetValue(),
 545                 y = c->bottom.GetValue();
 546
 547             if ( x > maxX )
 548                 maxX = x;
 549
 550             if ( y > maxY )
 551                 maxY = y;
 552
 553             // TODO: we must calculate the overlaps somehow, otherwise we
 554             //       will never return a size bigger than the current one :-(
 555         }
 556
 557         return wxSize(maxX, maxY);
 558     }
 559 #endif // wxUSE_CONSTRAINTS
 560     else if ( GetChildren().GetCount() > 0 )
 561     {
 562         // our minimal acceptable size is such that all our windows fit inside
 563         int maxX = 0,
 564             maxY = 0;
 565
 566         for ( wxWindowList::Node *node = GetChildren().GetFirst();
 567               node;
 568               node = node->GetNext() )
 569         {
 570             wxWindow *win = node->GetData();
 571             if ( win->IsTopLevel()
 572 #if wxUSE_STATUSBAR
 573                     || wxDynamicCast(win, wxStatusBar)
 574 #endif // wxUSE_STATUSBAR
 575                )
 576             {
 577                 // dialogs and frames lie in different top level windows -
 578                 // don't deal with them here; as for the status bars, they
 579                 // don't lie in the client area at all
 580                 continue;
 581             }
 582
 583             int wx, wy, ww, wh;
 584             win->GetPosition(&wx, &wy);
 585
 586             // if the window hadn't been positioned yet, assume that it is in
 587             // the origin
 588             if ( wx == -1 )
 589                 wx = 0;
 590             if ( wy == -1 )
 591                 wy = 0;
 592
 593             win->GetSize(&ww, &wh);
 594             if ( wx + ww > maxX )
 595                 maxX = wx + ww;
 596             if ( wy + wh > maxY )
 597                 maxY = wy + wh;
 598         }
 599
 600         // for compatibility with the old versions and because it really looks
 601         // slightly more pretty like this, add a pad
 602         maxX += 7;
 603         maxY += 14;
 604
 605         return wxSize(maxX, maxY);
 606     }
 607     else
 608     {
 609         // for a generic window there is no natural best size - just use the
 610         // current one
 611         return GetSize();
 612     }
 613 }
 614
 615 // by default the origin is not shifted
 616 wxPoint wxWindowBase::GetClientAreaOrigin() const
 617 {
 618     return wxPoint(0, 0);
 619 }
 620
 621 // set the min/max size of the window
 622 void wxWindowBase::SetSizeHints(int minW, int minH,
 623                                 int maxW, int maxH,
 624                                 int WXUNUSED(incW), int WXUNUSED(incH))
 625 {
 626     // setting min width greater than max width leads to infinite loops under
 627     // X11 and generally doesn't make any sense, so don't allow it
 628     wxCHECK_RET( (minW == -1 || maxW == -1 || minW <= maxW) &&
 629                     (minH == -1 || maxH == -1 || minH <= maxH),
 630                  _T("min width/height must be less than max width/height!") );
 631
 632     m_minWidth = minW;
 633     m_maxWidth = maxW;
 634     m_minHeight = minH;
 635     m_maxHeight = maxH;
 636 }
 637
 638 void wxWindowBase::SetVirtualSizeHints( int minW, int minH,
 639                                         int maxW, int maxH )
 640 {
 641     m_minVirtualWidth = minW;
 642     m_maxVirtualWidth = maxW;
 643     m_minVirtualHeight = minH;
 644     m_maxVirtualHeight = maxH;
 645 }
 646
 647 void wxWindowBase::DoSetVirtualSize( int x, int y )
 648 {
 649     if ( m_minVirtualWidth != -1 && m_minVirtualWidth > x )
 650         x = m_minVirtualWidth;
 651     if ( m_maxVirtualWidth != -1 && m_maxVirtualWidth < x )
 652         x = m_maxVirtualWidth;
 653     if ( m_minVirtualHeight != -1 && m_minVirtualHeight > y )
 654         y = m_minVirtualHeight;
 655     if ( m_maxVirtualHeight != -1 && m_maxVirtualHeight < y )
 656         y = m_maxVirtualHeight;
 657
 658     m_virtualSize = wxSize(x, y);
 659 }
 660
 661 wxSize wxWindowBase::DoGetVirtualSize() const
 662 {
 663     wxSize  s( GetClientSize() );
 664
 665     return wxSize( wxMax( m_virtualSize.GetWidth(), s.GetWidth() ),
 666                    wxMax( m_virtualSize.GetHeight(), s.GetHeight() ) );
 667 }
 668
 669 // ----------------------------------------------------------------------------
 670 // show/hide/enable/disable the window
 671 // ----------------------------------------------------------------------------
 672
 673 bool wxWindowBase::Show(bool show)
 674 {
 675     if ( show != m_isShown )
 676     {
 677         m_isShown = show;
 678
 679         return TRUE;
 680     }
 681     else
 682     {
 683         return FALSE;
 684     }
 685 }
 686
 687 bool wxWindowBase::Enable(bool enable)
 688 {
 689     if ( enable != m_isEnabled )
 690     {
 691         m_isEnabled = enable;
 692
 693         return TRUE;
 694     }
 695     else
 696     {
 697         return FALSE;
 698     }
 699 }
 700 // ----------------------------------------------------------------------------
 701 // RTTI
 702 // ----------------------------------------------------------------------------
 703
 704 bool wxWindowBase::IsTopLevel() const
 705 {
 706     return FALSE;
 707 }
 708
 709 // ----------------------------------------------------------------------------
 710 // reparenting the window
 711 // ----------------------------------------------------------------------------
 712
 713 void wxWindowBase::AddChild(wxWindowBase *child)
 714 {
 715     wxCHECK_RET( child, wxT("can't add a NULL child") );
 716
 717     // this should never happen and it will lead to a crash later if it does
 718     // because RemoveChild() will remove only one node from the children list
 719     // and the other(s) one(s) will be left with dangling pointers in them
 720     wxASSERT_MSG( !GetChildren().Find(child), _T("AddChild() called twice") );
 721
 722     GetChildren().Append(child);
 723     child->SetParent(this);
 724 }
 725
 726 void wxWindowBase::RemoveChild(wxWindowBase *child)
 727 {
 728     wxCHECK_RET( child, wxT("can't remove a NULL child") );
 729
 730     GetChildren().DeleteObject(child);
 731     child->SetParent((wxWindow *)NULL);
 732 }
 733
 734 bool wxWindowBase::Reparent(wxWindowBase *newParent)
 735 {
 736     wxWindow *oldParent = GetParent();
 737     if ( newParent == oldParent )
 738     {
 739         // nothing done
 740         return FALSE;
 741     }
 742
 743     // unlink this window from the existing parent.
 744     if ( oldParent )
 745     {
 746         oldParent->RemoveChild(this);
 747     }
 748     else
 749     {
 750         wxTopLevelWindows.DeleteObject(this);
 751     }
 752
 753     // add it to the new one
 754     if ( newParent )
 755     {
 756         newParent->AddChild(this);
 757     }
 758     else
 759     {
 760         wxTopLevelWindows.Append(this);
 761     }
 762
 763     return TRUE;
 764 }
 765
 766 // ----------------------------------------------------------------------------
 767 // event handler stuff
 768 // ----------------------------------------------------------------------------
 769
 770 void wxWindowBase::PushEventHandler(wxEvtHandler *handler)
 771 {
 772     wxEvtHandler *handlerOld = GetEventHandler();
 773
 774     handler->SetNextHandler(handlerOld);
 775
 776     if ( handlerOld )
 777         GetEventHandler()->SetPreviousHandler(handler);
 778
 779     SetEventHandler(handler);
 780 }
 781
 782 wxEvtHandler *wxWindowBase::PopEventHandler(bool deleteHandler)
 783 {
 784     wxEvtHandler *handlerA = GetEventHandler();
 785     if ( handlerA )
 786     {
 787         wxEvtHandler *handlerB = handlerA->GetNextHandler();
 788         handlerA->SetNextHandler((wxEvtHandler *)NULL);
 789
 790         if ( handlerB )
 791             handlerB->SetPreviousHandler((wxEvtHandler *)NULL);
 792         SetEventHandler(handlerB);
 793
 794         if ( deleteHandler )
 795         {
 796             delete handlerA;
 797             handlerA = (wxEvtHandler *)NULL;
 798         }
 799     }
 800
 801     return handlerA;
 802 }
 803
 804 bool wxWindowBase::RemoveEventHandler(wxEvtHandler *handler)
 805 {
 806     wxCHECK_MSG( handler, FALSE, _T("RemoveEventHandler(NULL) called") );
 807
 808     wxEvtHandler *handlerPrev = NULL,
 809                  *handlerCur = GetEventHandler();
 810     while ( handlerCur )
 811     {
 812         wxEvtHandler *handlerNext = handlerCur->GetNextHandler();
 813
 814         if ( handlerCur == handler )
 815         {
 816             if ( handlerPrev )
 817             {
 818                 handlerPrev->SetNextHandler(handlerNext);
 819             }
 820             else
 821             {
 822                 SetEventHandler(handlerNext);
 823             }
 824
 825             if ( handlerNext )
 826             {
 827                 handlerNext->SetPreviousHandler ( handlerPrev );
 828             }
 829             handler->SetNextHandler(NULL);
 830
 831             return TRUE;
 832         }
 833
 834         handlerPrev = handlerCur;
 835         handlerCur = handlerNext;
 836     }
 837
 838     wxFAIL_MSG( _T("where has the event handler gone?") );
 839
 840     return FALSE;
 841 }
 842
 843 // ----------------------------------------------------------------------------
 844 // cursors, fonts &c
 845 // ----------------------------------------------------------------------------
 846
 847 bool wxWindowBase::SetBackgroundColour( const wxColour &colour )
 848 {
 849     if ( !colour.Ok() || (colour == m_backgroundColour) )
 850         return FALSE;
 851
 852     m_backgroundColour = colour;
 853
 854     m_hasBgCol = TRUE;
 855
 856     return TRUE;
 857 }
 858
 859 bool wxWindowBase::SetForegroundColour( const wxColour &colour )
 860 {
 861     if ( !colour.Ok() || (colour == m_foregroundColour) )
 862         return FALSE;
 863
 864     m_foregroundColour = colour;
 865
 866     m_hasFgCol = TRUE;
 867
 868     return TRUE;
 869 }
 870
 871 bool wxWindowBase::SetCursor(const wxCursor& cursor)
 872 {
 873     // setting an invalid cursor is ok, it means that we don't have any special
 874     // cursor
 875     if ( m_cursor == cursor )
 876     {
 877         // no change
 878         return FALSE;
 879     }
 880
 881     m_cursor = cursor;
 882
 883     return TRUE;
 884 }
 885
 886 bool wxWindowBase::SetFont(const wxFont& font)
 887 {
 888     // don't try to set invalid font, always fall back to the default
 889     const wxFont& fontOk = font.Ok() ? font : *wxSWISS_FONT;
 890
 891     if ( fontOk == m_font )
 892     {
 893         // no change
 894         return FALSE;
 895     }
 896
 897     m_font = fontOk;
 898
 899     m_hasFont = TRUE;
 900
 901     return TRUE;
 902 }
 903
 904 #if wxUSE_PALETTE
 905
 906 void wxWindowBase::SetPalette(const wxPalette& pal)
 907 {
 908     m_hasCustomPalette = TRUE;
 909     m_palette = pal;
 910
 911     // VZ: can anyone explain me what do we do here?
 912     wxWindowDC d((wxWindow *) this);
 913     d.SetPalette(pal);
 914 }
 915
 916 wxWindow *wxWindowBase::GetAncestorWithCustomPalette() const
 917 {
 918     wxWindow *win = (wxWindow *)this;
 919     while ( win && !win->HasCustomPalette() )
 920     {
 921         win = win->GetParent();
 922     }
 923
 924     return win;
 925 }
 926
 927 #endif // wxUSE_PALETTE
 928
 929 #if wxUSE_CARET
 930 void wxWindowBase::SetCaret(wxCaret *caret)
 931 {
 932     if ( m_caret )
 933     {
 934         delete m_caret;
 935     }
 936
 937     m_caret = caret;
 938
 939     if ( m_caret )
 940     {
 941         wxASSERT_MSG( m_caret->GetWindow() == this,
 942                       wxT("caret should be created associated to this window") );
 943     }
 944 }
 945 #endif // wxUSE_CARET
 946
 947 #if wxUSE_VALIDATORS
 948 // ----------------------------------------------------------------------------
 949 // validators
 950 // ----------------------------------------------------------------------------
 951
 952 void wxWindowBase::SetValidator(const wxValidator& validator)
 953 {
 954     if ( m_windowValidator )
 955         delete m_windowValidator;
 956
 957     m_windowValidator = (wxValidator *)validator.Clone();
 958
 959     if ( m_windowValidator )
 960         m_windowValidator->SetWindow(this) ;
 961 }
 962 #endif // wxUSE_VALIDATORS
 963
 964 // ----------------------------------------------------------------------------
 965 // update region stuff
 966 // ----------------------------------------------------------------------------
 967
 968 wxRect wxWindowBase::GetUpdateClientRect() const
 969 {
 970     wxRegion rgnUpdate = GetUpdateRegion();
 971     rgnUpdate.Intersect(GetClientRect());
 972     wxRect rectUpdate = rgnUpdate.GetBox();
 973     wxPoint ptOrigin = GetClientAreaOrigin();
 974     rectUpdate.x -= ptOrigin.x;
 975     rectUpdate.y -= ptOrigin.y;
 976
 977     return rectUpdate;
 978 }
 979
 980 bool wxWindowBase::IsExposed(int x, int y) const
 981 {
 982     return m_updateRegion.Contains(x, y) != wxOutRegion;
 983 }
 984
 985 bool wxWindowBase::IsExposed(int x, int y, int w, int h) const
 986 {
 987     return m_updateRegion.Contains(x, y, w, h) != wxOutRegion;
 988 }
 989
 990 // ----------------------------------------------------------------------------
 991 // find child window by id or name
 992 // ----------------------------------------------------------------------------
 993
 994 wxWindow *wxWindowBase::FindWindow( long id )
 995 {
 996     if ( id == m_windowId )
 997         return (wxWindow *)this;
 998
 999     wxWindowBase *res = (wxWindow *)NULL;
1000     wxWindowList::Node *node;
1001     for ( node = m_children.GetFirst(); node && !res; node = node->GetNext() )
1002     {
1003         wxWindowBase *child = node->GetData();
1004         res = child->FindWindow( id );
1005     }
1006
1007     return (wxWindow *)res;
1008 }
1009
1010 wxWindow *wxWindowBase::FindWindow( const wxString& name )
1011 {
1012     if ( name == m_windowName )
1013         return (wxWindow *)this;
1014
1015     wxWindowBase *res = (wxWindow *)NULL;
1016     wxWindowList::Node *node;
1017     for ( node = m_children.GetFirst(); node && !res; node = node->GetNext() )
1018     {
1019         wxWindow *child = node->GetData();
1020         res = child->FindWindow(name);
1021     }
1022
1023     return (wxWindow *)res;
1024 }
1025
1026
1027 // find any window by id or name or label: If parent is non-NULL, look through
1028 // children for a label or title matching the specified string. If NULL, look
1029 // through all top-level windows.
1030 //
1031 // to avoid duplicating code we reuse the same helper function but with
1032 // different comparators
1033
1034 typedef bool (*wxFindWindowCmp)(const wxWindow *win,
1035                                 const wxString& label, long id);
1036
1037 static
1038 bool wxFindWindowCmpLabels(const wxWindow *win, const wxString& label,
1039                            long WXUNUSED(id))
1040 {
1041     return win->GetLabel() == label;
1042 }
1043
1044 static
1045 bool wxFindWindowCmpNames(const wxWindow *win, const wxString& label,
1046                           long WXUNUSED(id))
1047 {
1048     return win->GetName() == label;
1049 }
1050
1051 static
1052 bool wxFindWindowCmpIds(const wxWindow *win, const wxString& WXUNUSED(label),
1053                         long id)
1054 {
1055     return win->GetId() == id;
1056 }
1057
1058 // recursive helper for the FindWindowByXXX() functions
1059 static
1060 wxWindow *wxFindWindowRecursively(const wxWindow *parent,
1061                                   const wxString& label,
1062                                   long id,
1063                                   wxFindWindowCmp cmp)
1064 {
1065     if ( parent )
1066     {
1067         // see if this is the one we're looking for
1068         if ( (*cmp)(parent, label, id) )
1069             return (wxWindow *)parent;
1070
1071         // It wasn't, so check all its children
1072         for ( wxWindowList::Node * node = parent->GetChildren().GetFirst();
1073               node;
1074               node = node->GetNext() )
1075         {
1076             // recursively check each child
1077             wxWindow *win = (wxWindow *)node->GetData();
1078             wxWindow *retwin = wxFindWindowRecursively(win, label, id, cmp);
1079             if (retwin)
1080                 return retwin;
1081         }
1082     }
1083
1084     // Not found
1085     return NULL;
1086 }
1087
1088 // helper for FindWindowByXXX()
1089 static
1090 wxWindow *wxFindWindowHelper(const wxWindow *parent,
1091                              const wxString& label,
1092                              long id,
1093                              wxFindWindowCmp cmp)
1094 {
1095     if ( parent )
1096     {
1097         // just check parent and all its children
1098         return wxFindWindowRecursively(parent, label, id, cmp);
1099     }
1100
1101     // start at very top of wx's windows
1102     for ( wxWindowList::Node * node = wxTopLevelWindows.GetFirst();
1103           node;
1104           node = node->GetNext() )
1105     {
1106         // recursively check each window & its children
1107         wxWindow *win = node->GetData();
1108         wxWindow *retwin = wxFindWindowRecursively(win, label, id, cmp);
1109         if (retwin)
1110             return retwin;
1111     }
1112
1113     return NULL;
1114 }
1115
1116 /* static */
1117 wxWindow *
1118 wxWindowBase::FindWindowByLabel(const wxString& title, const wxWindow *parent)
1119 {
1120     return wxFindWindowHelper(parent, title, 0, wxFindWindowCmpLabels);
1121 }
1122
1123 /* static */
1124 wxWindow *
1125 wxWindowBase::FindWindowByName(const wxString& title, const wxWindow *parent)
1126 {
1127     wxWindow *win = wxFindWindowHelper(parent, title, 0, wxFindWindowCmpNames);
1128
1129     if ( !win )
1130     {
1131         // fall back to the label
1132         win = FindWindowByLabel(title, parent);
1133     }
1134
1135     return win;
1136 }
1137
1138 /* static */
1139 wxWindow *
1140 wxWindowBase::FindWindowById( long id, const wxWindow* parent )
1141 {
1142     return wxFindWindowHelper(parent, _T(""), id, wxFindWindowCmpIds);
1143 }
1144
1145 // ----------------------------------------------------------------------------
1146 // dialog oriented functions
1147 // ----------------------------------------------------------------------------
1148
1149 void wxWindowBase::MakeModal(bool modal)
1150 {
1151     // Disable all other windows
1152     if ( IsTopLevel() )
1153     {
1154         wxWindowList::Node *node = wxTopLevelWindows.GetFirst();
1155         while (node)
1156         {
1157             wxWindow *win = node->GetData();
1158             if (win != this)
1159                 win->Enable(!modal);
1160
1161             node = node->GetNext();
1162         }
1163     }
1164 }
1165
1166 bool wxWindowBase::Validate()
1167 {
1168 #if wxUSE_VALIDATORS
1169     bool recurse = (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY) != 0;
1170
1171     wxWindowList::Node *node;
1172     for ( node = m_children.GetFirst(); node; node = node->GetNext() )
1173     {
1174         wxWindowBase *child = node->GetData();
1175         wxValidator *validator = child->GetValidator();
1176         if ( validator && !validator->Validate((wxWindow *)this) )
1177         {
1178             return FALSE;
1179         }
1180
1181         if ( recurse && !child->Validate() )
1182         {
1183             return FALSE;
1184         }
1185     }
1186 #endif // wxUSE_VALIDATORS
1187
1188     return TRUE;
1189 }
1190
1191 bool wxWindowBase::TransferDataToWindow()
1192 {
1193 #if wxUSE_VALIDATORS
1194     bool recurse = (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY) != 0;
1195
1196     wxWindowList::Node *node;
1197     for ( node = m_children.GetFirst(); node; node = node->GetNext() )
1198     {
1199         wxWindowBase *child = node->GetData();
1200         wxValidator *validator = child->GetValidator();
1201         if ( validator && !validator->TransferToWindow() )
1202         {
1203             wxLogWarning(_("Could not transfer data to window"));
1204 #if wxUSE_LOG
1205             wxLog::FlushActive();
1206 #endif // wxUSE_LOG
1207
1208             return FALSE;
1209         }
1210
1211         if ( recurse )
1212         {
1213             if ( !child->TransferDataToWindow() )
1214             {
1215                 // warning already given
1216                 return FALSE;
1217             }
1218         }
1219     }
1220 #endif // wxUSE_VALIDATORS
1221
1222     return TRUE;
1223 }
1224
1225 bool wxWindowBase::TransferDataFromWindow()
1226 {
1227 #if wxUSE_VALIDATORS
1228     bool recurse = (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY) != 0;
1229
1230     wxWindowList::Node *node;
1231     for ( node = m_children.GetFirst(); node; node = node->GetNext() )
1232     {
1233         wxWindow *child = node->GetData();
1234         wxValidator *validator = child->GetValidator();
1235         if ( validator && !validator->TransferFromWindow() )
1236         {
1237             // nop warning here because the application is supposed to give
1238             // one itself - we don't know here what might have gone wrongly
1239
1240             return FALSE;
1241         }
1242
1243         if ( recurse )
1244         {
1245             if ( !child->TransferDataFromWindow() )
1246             {
1247                 // warning already given
1248                 return FALSE;
1249             }
1250         }
1251     }
1252 #endif // wxUSE_VALIDATORS
1253
1254     return TRUE;
1255 }
1256
1257 void wxWindowBase::InitDialog()
1258 {
1259     wxInitDialogEvent event(GetId());
1260     event.SetEventObject( this );
1261     GetEventHandler()->ProcessEvent(event);
1262 }
1263
1264 // ----------------------------------------------------------------------------
1265 // context-sensitive help support
1266 // ----------------------------------------------------------------------------
1267
1268 #if wxUSE_HELP
1269
1270 // associate this help text with this window
1271 void wxWindowBase::SetHelpText(const wxString& text)
1272 {
1273     wxHelpProvider *helpProvider = wxHelpProvider::Get();
1274     if ( helpProvider )
1275     {
1276         helpProvider->AddHelp(this, text);
1277     }
1278 }
1279
1280 // associate this help text with all windows with the same id as this
1281 // one
1282 void wxWindowBase::SetHelpTextForId(const wxString& text)
1283 {
1284     wxHelpProvider *helpProvider = wxHelpProvider::Get();
1285     if ( helpProvider )
1286     {
1287         helpProvider->AddHelp(GetId(), text);
1288     }
1289 }
1290
1291 // get the help string associated with this window (may be empty)
1292 wxString wxWindowBase::GetHelpText() const
1293 {
1294     wxString text;
1295     wxHelpProvider *helpProvider = wxHelpProvider::Get();
1296     if ( helpProvider )
1297     {
1298         text = helpProvider->GetHelp(this);
1299     }
1300
1301     return text;
1302 }
1303
1304 // show help for this window
1305 void wxWindowBase::OnHelp(wxHelpEvent& event)
1306 {
1307     wxHelpProvider *helpProvider = wxHelpProvider::Get();
1308     if ( helpProvider )
1309     {
1310         if ( helpProvider->ShowHelp(this) )
1311         {
1312             // skip the event.Skip() below
1313             return;
1314         }
1315     }
1316
1317     event.Skip();
1318 }
1319
1320 #endif // wxUSE_HELP
1321
1322 // ----------------------------------------------------------------------------
1323 // tooltipsroot.Replace("\\", "/");
1324 // ----------------------------------------------------------------------------
1325
1326 #if wxUSE_TOOLTIPS
1327
1328 void wxWindowBase::SetToolTip( const wxString &tip )
1329 {
1330     // don't create the new tooltip if we already have one
1331     if ( m_tooltip )
1332     {
1333         m_tooltip->SetTip( tip );
1334     }
1335     else
1336     {
1337         SetToolTip( new wxToolTip( tip ) );
1338     }
1339
1340     // setting empty tooltip text does not remove the tooltip any more - use
1341     // SetToolTip((wxToolTip *)NULL) for this
1342 }
1343
1344 void wxWindowBase::DoSetToolTip(wxToolTip *tooltip)
1345 {
1346     if ( m_tooltip )
1347         delete m_tooltip;
1348
1349     m_tooltip = tooltip;
1350 }
1351
1352 #endif // wxUSE_TOOLTIPS
1353
1354 // ----------------------------------------------------------------------------
1355 // constraints and sizers
1356 // ----------------------------------------------------------------------------
1357
1358 #if wxUSE_CONSTRAINTS
1359
1360 void wxWindowBase::SetConstraints( wxLayoutConstraints *constraints )
1361 {
1362     if ( m_constraints )
1363     {
1364         UnsetConstraints(m_constraints);
1365         delete m_constraints;
1366     }
1367     m_constraints = constraints;
1368     if ( m_constraints )
1369     {
1370         // Make sure other windows know they're part of a 'meaningful relationship'
1371         if ( m_constraints->left.GetOtherWindow() && (m_constraints->left.GetOtherWindow() != this) )
1372             m_constraints->left.GetOtherWindow()->AddConstraintReference(this);
1373         if ( m_constraints->top.GetOtherWindow() && (m_constraints->top.GetOtherWindow() != this) )
1374             m_constraints->top.GetOtherWindow()->AddConstraintReference(this);
1375         if ( m_constraints->right.GetOtherWindow() && (m_constraints->right.GetOtherWindow() != this) )
1376             m_constraints->right.GetOtherWindow()->AddConstraintReference(this);
1377         if ( m_constraints->bottom.GetOtherWindow() && (m_constraints->bottom.GetOtherWindow() != this) )
1378             m_constraints->bottom.GetOtherWindow()->AddConstraintReference(this);
1379         if ( m_constraints->width.GetOtherWindow() && (m_constraints->width.GetOtherWindow() != this) )
1380             m_constraints->width.GetOtherWindow()->AddConstraintReference(this);
1381         if ( m_constraints->height.GetOtherWindow() && (m_constraints->height.GetOtherWindow() != this) )
1382             m_constraints->height.GetOtherWindow()->AddConstraintReference(this);
1383         if ( m_constraints->centreX.GetOtherWindow() && (m_constraints->centreX.GetOtherWindow() != this) )
1384             m_constraints->centreX.GetOtherWindow()->AddConstraintReference(this);
1385         if ( m_constraints->centreY.GetOtherWindow() && (m_constraints->centreY.GetOtherWindow() != this) )
1386             m_constraints->centreY.GetOtherWindow()->AddConstraintReference(this);
1387     }
1388 }
1389
1390 // This removes any dangling pointers to this window in other windows'
1391 // constraintsInvolvedIn lists.
1392 void wxWindowBase::UnsetConstraints(wxLayoutConstraints *c)
1393 {
1394     if ( c )
1395     {
1396         if ( c->left.GetOtherWindow() && (c->top.GetOtherWindow() != this) )
1397             c->left.GetOtherWindow()->RemoveConstraintReference(this);
1398         if ( c->top.GetOtherWindow() && (c->top.GetOtherWindow() != this) )
1399             c->top.GetOtherWindow()->RemoveConstraintReference(this);
1400         if ( c->right.GetOtherWindow() && (c->right.GetOtherWindow() != this) )
1401             c->right.GetOtherWindow()->RemoveConstraintReference(this);
1402         if ( c->bottom.GetOtherWindow() && (c->bottom.GetOtherWindow() != this) )
1403             c->bottom.GetOtherWindow()->RemoveConstraintReference(this);
1404         if ( c->width.GetOtherWindow() && (c->width.GetOtherWindow() != this) )
1405             c->width.GetOtherWindow()->RemoveConstraintReference(this);
1406         if ( c->height.GetOtherWindow() && (c->height.GetOtherWindow() != this) )
1407             c->height.GetOtherWindow()->RemoveConstraintReference(this);
1408         if ( c->centreX.GetOtherWindow() && (c->centreX.GetOtherWindow() != this) )
1409             c->centreX.GetOtherWindow()->RemoveConstraintReference(this);
1410         if ( c->centreY.GetOtherWindow() && (c->centreY.GetOtherWindow() != this) )
1411             c->centreY.GetOtherWindow()->RemoveConstraintReference(this);
1412     }
1413 }
1414
1415 // Back-pointer to other windows we're involved with, so if we delete this
1416 // window, we must delete any constraints we're involved with.
1417 void wxWindowBase::AddConstraintReference(wxWindowBase *otherWin)
1418 {
1419     if ( !m_constraintsInvolvedIn )
1420         m_constraintsInvolvedIn = new wxWindowList;
1421     if ( !m_constraintsInvolvedIn->Find(otherWin) )
1422         m_constraintsInvolvedIn->Append(otherWin);
1423 }
1424
1425 // REMOVE back-pointer to other windows we're involved with.
1426 void wxWindowBase::RemoveConstraintReference(wxWindowBase *otherWin)
1427 {
1428     if ( m_constraintsInvolvedIn )
1429         m_constraintsInvolvedIn->DeleteObject(otherWin);
1430 }
1431
1432 // Reset any constraints that mention this window
1433 void wxWindowBase::DeleteRelatedConstraints()
1434 {
1435     if ( m_constraintsInvolvedIn )
1436     {
1437         wxWindowList::Node *node = m_constraintsInvolvedIn->GetFirst();
1438         while (node)
1439         {
1440             wxWindow *win = node->GetData();
1441             wxLayoutConstraints *constr = win->GetConstraints();
1442
1443             // Reset any constraints involving this window
1444             if ( constr )
1445             {
1446                 constr->left.ResetIfWin(this);
1447                 constr->top.ResetIfWin(this);
1448                 constr->right.ResetIfWin(this);
1449                 constr->bottom.ResetIfWin(this);
1450                 constr->width.ResetIfWin(this);
1451                 constr->height.ResetIfWin(this);
1452                 constr->centreX.ResetIfWin(this);
1453                 constr->centreY.ResetIfWin(this);
1454             }
1455
1456             wxWindowList::Node *next = node->GetNext();
1457             delete node;
1458             node = next;
1459         }
1460
1461         delete m_constraintsInvolvedIn;
1462         m_constraintsInvolvedIn = (wxWindowList *) NULL;
1463     }
1464 }
1465
1466 #endif // wxUSE_CONSTRAINTS
1467
1468 void wxWindowBase::SetSizer(wxSizer *sizer, bool deleteOld)
1469 {
1470     if ( deleteOld )
1471         delete m_windowSizer;
1472
1473     m_windowSizer = sizer;
1474
1475     SetAutoLayout( sizer != NULL );
1476 }
1477
1478 void wxWindowBase::SetSizerAndFit(wxSizer *sizer, bool deleteOld)
1479 {
1480     SetSizer( sizer, deleteOld );
1481     sizer->SetSizeHints( (wxWindow*) this );
1482 }
1483
1484 #if wxUSE_CONSTRAINTS
1485
1486 void wxWindowBase::SatisfyConstraints()
1487 {
1488     wxLayoutConstraints *constr = GetConstraints();
1489     bool wasOk = constr && constr->AreSatisfied();
1490
1491     ResetConstraints();   // Mark all constraints as unevaluated
1492
1493     int noChanges = 1;
1494
1495     // if we're a top level panel (i.e. our parent is frame/dialog), our
1496     // own constraints will never be satisfied any more unless we do it
1497     // here
1498     if ( wasOk )
1499     {
1500         while ( noChanges > 0 )
1501         {
1502             LayoutPhase1(&noChanges);
1503         }
1504     }
1505
1506     LayoutPhase2(&noChanges);
1507 }
1508
1509 #endif // wxUSE_CONSTRAINTS
1510
1511 bool wxWindowBase::Layout()
1512 {
1513     // If there is a sizer, use it instead of the constraints
1514     if ( GetSizer() )
1515     {
1516         int w, h;
1517         GetVirtualSize(&w, &h);
1518         GetSizer()->SetDimension( 0, 0, w, h );
1519     }
1520 #if wxUSE_CONSTRAINTS
1521     else
1522     {
1523         SatisfyConstraints(); // Find the right constraints values
1524         SetConstraintSizes(); // Recursively set the real window sizes
1525     }
1526 #endif
1527
1528     return TRUE;
1529 }
1530
1531 #if wxUSE_CONSTRAINTS
1532
1533 // first phase of the constraints evaluation: set our own constraints
1534 bool wxWindowBase::LayoutPhase1(int *noChanges)
1535 {
1536     wxLayoutConstraints *constr = GetConstraints();
1537
1538     return !constr || constr->SatisfyConstraints(this, noChanges);
1539 }
1540
1541 // second phase: set the constraints for our children
1542 bool wxWindowBase::LayoutPhase2(int *noChanges)
1543 {
1544     *noChanges = 0;
1545
1546     // Layout children
1547     DoPhase(1);
1548
1549     // Layout grand children
1550     DoPhase(2);
1551
1552     return TRUE;
1553 }
1554
1555 // Do a phase of evaluating child constraints
1556 bool wxWindowBase::DoPhase(int phase)
1557 {
1558     // the list containing the children for which the constraints are already
1559     // set correctly
1560     wxWindowList succeeded;
1561
1562     // the max number of iterations we loop before concluding that we can't set
1563     // the constraints
1564     static const int maxIterations = 500;
1565
1566     for ( int noIterations = 0; noIterations < maxIterations; noIterations++ )
1567     {
1568         int noChanges = 0;
1569
1570         // loop over all children setting their constraints
1571         for ( wxWindowList::Node *node = GetChildren().GetFirst();
1572               node;
1573               node = node->GetNext() )
1574         {
1575             wxWindow *child = node->GetData();
1576             if ( child->IsTopLevel() )
1577             {
1578                 // top level children are not inside our client area
1579                 continue;
1580             }
1581
1582             if ( !child->GetConstraints() || succeeded.Find(child) )
1583             {
1584                 // this one is either already ok or nothing we can do about it
1585                 continue;
1586             }
1587
1588             int tempNoChanges = 0;
1589             bool success = phase == 1 ? child->LayoutPhase1(&tempNoChanges)
1590                                       : child->LayoutPhase2(&tempNoChanges);
1591             noChanges += tempNoChanges;
1592
1593             if ( success )
1594             {
1595                 succeeded.Append(child);
1596             }
1597         }
1598
1599         if ( !noChanges )
1600         {
1601             // constraints are set
1602             break;
1603         }
1604     }
1605
1606     return TRUE;
1607 }
1608
1609 void wxWindowBase::ResetConstraints()
1610 {
1611     wxLayoutConstraints *constr = GetConstraints();
1612     if ( constr )
1613     {
1614         constr->left.SetDone(FALSE);
1615         constr->top.SetDone(FALSE);
1616         constr->right.SetDone(FALSE);
1617         constr->bottom.SetDone(FALSE);
1618         constr->width.SetDone(FALSE);
1619         constr->height.SetDone(FALSE);
1620         constr->centreX.SetDone(FALSE);
1621         constr->centreY.SetDone(FALSE);
1622     }
1623
1624     wxWindowList::Node *node = GetChildren().GetFirst();
1625     while (node)
1626     {
1627         wxWindow *win = node->GetData();
1628         if ( !win->IsTopLevel() )
1629             win->ResetConstraints();
1630         node = node->GetNext();
1631     }
1632 }
1633
1634 // Need to distinguish between setting the 'fake' size for windows and sizers,
1635 // and setting the real values.
1636 void wxWindowBase::SetConstraintSizes(bool recurse)
1637 {
1638     wxLayoutConstraints *constr = GetConstraints();
1639     if ( constr && constr->AreSatisfied() )
1640     {
1641         int x = constr->left.GetValue();
1642         int y = constr->top.GetValue();
1643         int w = constr->width.GetValue();
1644         int h = constr->height.GetValue();
1645
1646         if ( (constr->width.GetRelationship() != wxAsIs ) ||
1647              (constr->height.GetRelationship() != wxAsIs) )
1648         {
1649             SetSize(x, y, w, h);
1650         }
1651         else
1652         {
1653             // If we don't want to resize this window, just move it...
1654             Move(x, y);
1655         }
1656     }
1657     else if ( constr )
1658     {
1659         wxLogDebug(wxT("Constraints not satisfied for %s named '%s'."),
1660                    GetClassInfo()->GetClassName(),
1661                    GetName().c_str());
1662     }
1663
1664     if ( recurse )
1665     {
1666         wxWindowList::Node *node = GetChildren().GetFirst();
1667         while (node)
1668         {
1669             wxWindow *win = node->GetData();
1670             if ( !win->IsTopLevel() && win->GetConstraints() )
1671                 win->SetConstraintSizes();
1672             node = node->GetNext();
1673         }
1674     }
1675 }
1676
1677 // Only set the size/position of the constraint (if any)
1678 void wxWindowBase::SetSizeConstraint(int x, int y, int w, int h)
1679 {
1680     wxLayoutConstraints *constr = GetConstraints();
1681     if ( constr )
1682     {
1683         if ( x != -1 )
1684         {
1685             constr->left.SetValue(x);
1686             constr->left.SetDone(TRUE);
1687         }
1688         if ( y != -1 )
1689         {
1690             constr->top.SetValue(y);
1691             constr->top.SetDone(TRUE);
1692         }
1693         if ( w != -1 )
1694         {
1695             constr->width.SetValue(w);
1696             constr->width.SetDone(TRUE);
1697         }
1698         if ( h != -1 )
1699         {
1700             constr->height.SetValue(h);
1701             constr->height.SetDone(TRUE);
1702         }
1703     }
1704 }
1705
1706 void wxWindowBase::MoveConstraint(int x, int y)
1707 {
1708     wxLayoutConstraints *constr = GetConstraints();
1709     if ( constr )
1710     {
1711         if ( x != -1 )
1712         {
1713             constr->left.SetValue(x);
1714             constr->left.SetDone(TRUE);
1715         }
1716         if ( y != -1 )
1717         {
1718             constr->top.SetValue(y);
1719             constr->top.SetDone(TRUE);
1720         }
1721     }
1722 }
1723
1724 void wxWindowBase::GetSizeConstraint(int *w, int *h) const
1725 {
1726     wxLayoutConstraints *constr = GetConstraints();
1727     if ( constr )
1728     {
1729         *w = constr->width.GetValue();
1730         *h = constr->height.GetValue();
1731     }
1732     else
1733         GetSize(w, h);
1734 }
1735
1736 void wxWindowBase::GetClientSizeConstraint(int *w, int *h) const
1737 {
1738     wxLayoutConstraints *constr = GetConstraints();
1739     if ( constr )
1740     {
1741         *w = constr->width.GetValue();
1742         *h = constr->height.GetValue();
1743     }
1744     else
1745         GetClientSize(w, h);
1746 }
1747
1748 void wxWindowBase::GetPositionConstraint(int *x, int *y) const
1749 {
1750     wxLayoutConstraints *constr = GetConstraints();
1751     if ( constr )
1752     {
1753         *x = constr->left.GetValue();
1754         *y = constr->top.GetValue();
1755     }
1756     else
1757         GetPosition(x, y);
1758 }
1759
1760 #endif // wxUSE_CONSTRAINTS
1761
1762 void wxWindowBase::AdjustForParentClientOrigin(int& x, int& y, int sizeFlags) const
1763 {
1764     // don't do it for the dialogs/frames - they float independently of their
1765     // parent
1766     if ( !IsTopLevel() )
1767     {
1768         wxWindow *parent = GetParent();
1769         if ( !(sizeFlags & wxSIZE_NO_ADJUSTMENTS) && parent )
1770         {
1771             wxPoint pt(parent->GetClientAreaOrigin());
1772             x += pt.x;
1773             y += pt.y;
1774         }
1775     }
1776 }
1777
1778 // ----------------------------------------------------------------------------
1779 // do Update UI processing for child controls
1780 // ----------------------------------------------------------------------------
1781
1782 // TODO: should this be implemented for the child window rather
1783 // than the parent? Then you can override it e.g. for wxCheckBox
1784 // to do the Right Thing rather than having to assume a fixed number
1785 // of control classes.
1786 void wxWindowBase::UpdateWindowUI()
1787 {
1788 #if wxUSE_CONTROLS
1789     wxUpdateUIEvent event(GetId());
1790     event.m_eventObject = this;
1791
1792     if ( GetEventHandler()->ProcessEvent(event) )
1793     {
1794         if ( event.GetSetEnabled() )
1795             Enable(event.GetEnabled());
1796
1797         if ( event.GetSetText() )
1798         {
1799             wxControl *control = wxDynamicCastThis(wxControl);
1800             if ( control )
1801             {
1802 #if wxUSE_TEXTCTRL
1803                 wxTextCtrl *text = wxDynamicCast(control, wxTextCtrl);
1804                 if ( text )
1805                 {
1806                         if ( event.GetText() != text->GetValue() )
1807                         text->SetValue(event.GetText());
1808                 }
1809                 else
1810 #endif // wxUSE_TEXTCTRL
1811                                 {
1812                                         if ( event.GetText() != control->GetLabel() )
1813                         control->SetLabel(event.GetText());
1814                 }
1815             }
1816         }
1817
1818 #if wxUSE_CHECKBOX
1819         wxCheckBox *checkbox = wxDynamicCastThis(wxCheckBox);
1820         if ( checkbox )
1821         {
1822             if ( event.GetSetChecked() )
1823                 checkbox->SetValue(event.GetChecked());
1824         }
1825 #endif // wxUSE_CHECKBOX
1826
1827 #if wxUSE_RADIOBTN
1828         wxRadioButton *radiobtn = wxDynamicCastThis(wxRadioButton);
1829         if ( radiobtn )
1830         {
1831             if ( event.GetSetChecked() )
1832                 radiobtn->SetValue(event.GetChecked());
1833         }
1834 #endif // wxUSE_RADIOBTN
1835     }
1836 #endif // wxUSE_CONTROLS
1837 }
1838
1839 // ----------------------------------------------------------------------------
1840 // dialog units translations
1841 // ----------------------------------------------------------------------------
1842
1843 wxPoint wxWindowBase::ConvertPixelsToDialog(const wxPoint& pt)
1844 {
1845     int charWidth = GetCharWidth();
1846     int charHeight = GetCharHeight();
1847     wxPoint pt2(-1, -1);
1848     if (pt.x != -1)
1849         pt2.x = (int) ((pt.x * 4) / charWidth) ;
1850     if (pt.y != -1)
1851         pt2.y = (int) ((pt.y * 8) / charHeight) ;
1852
1853     return pt2;
1854 }
1855
1856 wxPoint wxWindowBase::ConvertDialogToPixels(const wxPoint& pt)
1857 {
1858     int charWidth = GetCharWidth();
1859     int charHeight = GetCharHeight();
1860     wxPoint pt2(-1, -1);
1861     if (pt.x != -1)
1862         pt2.x = (int) ((pt.x * charWidth) / 4) ;
1863     if (pt.y != -1)
1864         pt2.y = (int) ((pt.y * charHeight) / 8) ;
1865
1866     return pt2;
1867 }
1868
1869 // ----------------------------------------------------------------------------
1870 // event handlers
1871 // ----------------------------------------------------------------------------
1872
1873 // propagate the colour change event to the subwindows
1874 void wxWindowBase::OnSysColourChanged(wxSysColourChangedEvent& event)
1875 {
1876     wxWindowList::Node *node = GetChildren().GetFirst();
1877     while ( node )
1878     {
1879         // Only propagate to non-top-level windows
1880         wxWindow *win = node->GetData();
1881         if ( !win->IsTopLevel() )
1882         {
1883             wxSysColourChangedEvent event2;
1884             event.m_eventObject = win;
1885             win->GetEventHandler()->ProcessEvent(event2);
1886         }
1887
1888         node = node->GetNext();
1889     }
1890 }
1891
1892 // the default action is to populate dialog with data when it's created
1893 void wxWindowBase::OnInitDialog( wxInitDialogEvent &WXUNUSED(event) )
1894 {
1895     TransferDataToWindow();
1896 }
1897
1898 // process Ctrl-Alt-mclick
1899 void wxWindowBase::OnMiddleClick( wxMouseEvent& event )
1900 {
1901 #if wxUSE_MSGDLG
1902     if ( event.ControlDown() && event.AltDown() )
1903     {
1904         // don't translate these strings
1905         wxString port;
1906
1907 #ifdef __WXUNIVERSAL__
1908         port = _T("Univ/");
1909 #endif // __WXUNIVERSAL__
1910
1911         switch ( wxGetOsVersion() )
1912         {
1913             case wxMOTIF_X:     port += _T("Motif"); break;
1914             case wxMAC:
1915             case wxMAC_DARWIN:  port += _T("Mac"); break;
1916             case wxBEOS:        port += _T("BeOS"); break;
1917             case wxGTK:
1918             case wxGTK_WIN32:
1919             case wxGTK_OS2:
1920             case wxGTK_BEOS:    port += _T("GTK"); break;
1921             case wxWINDOWS:
1922             case wxPENWINDOWS:
1923             case wxWINDOWS_NT:
1924             case wxWIN32S:
1925             case wxWIN95:
1926             case wxWIN386:      port += _T("MS Windows"); break;
1927             case wxMGL_UNIX:
1928             case wxMGL_X:
1929             case wxMGL_WIN32:
1930             case wxMGL_OS2:     port += _T("MGL"); break;
1931             case wxWINDOWS_OS2:
1932             case wxOS2_PM:      port += _T("OS/2"); break;
1933             default:            port += _T("unknown"); break;
1934         }
1935
1936         wxMessageBox(wxString::Format(
1937                                       _T(
1938                                         "       wxWindows Library (%s port)\nVersion %u.%u.%u%s, compiled at %s %s\n   Copyright (c) 1995-2002 wxWindows team"
1939                                         ),
1940                                       port.c_str(),
1941                                       wxMAJOR_VERSION,
1942                                       wxMINOR_VERSION,
1943                                       wxRELEASE_NUMBER,
1944 #if wxUSE_UNICODE
1945                                       L" (Unicode)",
1946 #else
1947                                       "",
1948 #endif
1949                                       __TDATE__,
1950                                       __TTIME__
1951                                      ),
1952                      _T("wxWindows information"),
1953                      wxICON_INFORMATION | wxOK,
1954                      (wxWindow *)this);
1955     }
1956     else
1957 #endif // wxUSE_MSGDLG
1958     {
1959         event.Skip();
1960     }
1961 }
1962
1963 // ----------------------------------------------------------------------------
1964 // accessibility
1965 // ----------------------------------------------------------------------------
1966
1967 #if wxUSE_ACCESSIBILITY
1968 void wxWindowBase::SetAccessible(wxAccessible* accessible)
1969 {
1970     if (m_accessible && (accessible != m_accessible))
1971         delete m_accessible;
1972     m_accessible = accessible;
1973     if (m_accessible)
1974         m_accessible->SetWindow((wxWindow*) this);
1975 }
1976
1977 // Returns the accessible object, creating if necessary.
1978 wxAccessible* wxWindowBase::GetOrCreateAccessible()
1979 {
1980     if (!m_accessible)
1981         m_accessible = CreateAccessible();
1982     return m_accessible;
1983 }
1984
1985 // Override to create a specific accessible object.
1986 wxAccessible* wxWindowBase::CreateAccessible()
1987 {
1988     return new wxWindowAccessible((wxWindow*) this);
1989 }
1990
1991 #endif
1992
1993 // ----------------------------------------------------------------------------
1994 // list classes implementation
1995 // ----------------------------------------------------------------------------
1996
1997 void wxWindowListNode::DeleteData()
1998 {
1999     delete (wxWindow *)GetData();
2000 }
2001
2002 // ----------------------------------------------------------------------------
2003 // borders
2004 // ----------------------------------------------------------------------------
2005
2006 wxBorder wxWindowBase::GetBorder() const
2007 {
2008     wxBorder border = (wxBorder)(m_windowStyle & wxBORDER_MASK);
2009     if ( border == wxBORDER_DEFAULT )
2010     {
2011         border = GetDefaultBorder();
2012     }
2013
2014     return border;
2015 }
2016
2017 wxBorder wxWindowBase::GetDefaultBorder() const
2018 {
2019     return wxBORDER_NONE;
2020 }
2021
2022 // ----------------------------------------------------------------------------
2023 // hit testing
2024 // ----------------------------------------------------------------------------
2025
2026 wxHitTest wxWindowBase::DoHitTest(wxCoord x, wxCoord y) const
2027 {
2028     // here we just check if the point is inside the window or not
2029
2030     // check the top and left border first
2031     bool outside = x < 0 || y < 0;
2032     if ( !outside )
2033     {
2034         // check the right and bottom borders too
2035         wxSize size = GetSize();
2036         outside = x >= size.x || y >= size.y;
2037     }
2038
2039     return outside ? wxHT_WINDOW_OUTSIDE : wxHT_WINDOW_INSIDE;
2040 }
2041
2042 // ----------------------------------------------------------------------------
2043 // mouse capture
2044 // ----------------------------------------------------------------------------
2045
2046 struct WXDLLEXPORT wxWindowNext
2047 {
2048     wxWindow *win;
2049     wxWindowNext *next;
2050 } *wxWindowBase::ms_winCaptureNext = NULL;
2051
2052 void wxWindowBase::CaptureMouse()
2053 {
2054     wxLogTrace(_T("mousecapture"), _T("CaptureMouse(%p)"), this);
2055
2056     wxWindow *winOld = GetCapture();
2057     if ( winOld )
2058     {
2059         ((wxWindowBase*) winOld)->DoReleaseMouse();
2060
2061         // save it on stack
2062         wxWindowNext *item = new wxWindowNext;
2063         item->win = winOld;
2064         item->next = ms_winCaptureNext;
2065         ms_winCaptureNext = item;
2066     }
2067     //else: no mouse capture to save
2068
2069     DoCaptureMouse();
2070 }
2071
2072 void wxWindowBase::ReleaseMouse()
2073 {
2074     wxLogTrace(_T("mousecapture"), _T("ReleaseMouse(%p)"), this);
2075
2076     wxASSERT_MSG( GetCapture() == this, wxT("attempt to release mouse, but this window hasn't captured it") );
2077
2078     DoReleaseMouse();
2079
2080     if ( ms_winCaptureNext )
2081     {
2082         ((wxWindowBase*)ms_winCaptureNext->win)->DoCaptureMouse();
2083
2084         wxWindowNext *item = ms_winCaptureNext;
2085         ms_winCaptureNext = item->next;
2086         delete item;
2087     }
2088     //else: stack is empty, no previous capture
2089
2090     wxLogTrace(_T("mousecapture"),
2091                _T("After ReleaseMouse() mouse is captured by %p"),
2092                GetCapture());
2093 }
2094
2095
2096 void wxWindowBase::SendDestroyEvent()
2097 {
2098     wxWindowDestroyEvent event;
2099     event.SetEventObject(this);
2100     event.SetId(GetId());
2101     GetEventHandler()->ProcessEvent(event);
2102 }
2103
2104 // ----------------------------------------------------------------------------
2105 // event processing
2106 // ----------------------------------------------------------------------------
2107
2108 #if wxUSE_VALIDATORS
2109
2110 bool wxWindowBase::TryValidator(wxEvent& event)
2111 {
2112     // Can only use the validator of the window which
2113     // is receiving the event
2114     if ( event.GetEventObject() == this )
2115     {
2116         wxValidator *validator = GetValidator();
2117         if ( validator && validator->ProcessEvent(event) )
2118         {
2119             return TRUE;
2120         }
2121     }
2122
2123     return FALSE;
2124 }
2125
2126 #endif // wxUSE_VALIDATORS
2127
2128 bool wxWindowBase::TryParent(wxEvent& event)
2129 {
2130     // Carry on up the parent-child hierarchy, but only if event is a command
2131     // event: it wouldn't make sense for a parent to receive a child's size
2132     // event, for example
2133     if ( event.IsCommandEvent() )
2134     {
2135         // honour the requests to stop propagation at this window: this is
2136         // used by the dialogs, for example, to prevent processing the events
2137         // from the dialog controls in the parent frame which rarely, if ever,
2138         // makes sense
2139         if ( !(GetExtraStyle() & wxWS_EX_BLOCK_EVENTS) )
2140         {
2141             wxWindow *parent = GetParent();
2142             if ( parent && !parent->IsBeingDeleted() )
2143                 return parent->GetEventHandler()->ProcessEvent(event);
2144         }
2145     }
2146
2147     return wxEvtHandler::TryParent(event);
2148 }
2149
2150 // ----------------------------------------------------------------------------
2151 // global functions
2152 // ----------------------------------------------------------------------------
2153
2154 wxWindow* wxGetTopLevelParent(wxWindow *win)
2155 {
2156     while ( win && !win->IsTopLevel() )
2157          win = win->GetParent();
2158
2159     return win;
2160 }
2161
2162 #if wxUSE_ACCESSIBILITY
2163 // ----------------------------------------------------------------------------
2164 // accessible object for windows
2165 // ----------------------------------------------------------------------------
2166
2167 // Can return either a child object, or an integer
2168 // representing the child element, starting from 1.
2169 wxAccStatus wxWindowAccessible::HitTest(const wxPoint& pt, int* childId, wxAccessible** childObject)
2170 {
2171     wxASSERT( GetWindow() != NULL );
2172     if (!GetWindow())
2173         return wxACC_FAIL;
2174
2175     return wxACC_NOT_IMPLEMENTED;
2176 }
2177
2178 // Returns the rectangle for this object (id = 0) or a child element (id > 0).
2179 wxAccStatus wxWindowAccessible::GetLocation(wxRect& rect, int elementId)
2180 {
2181     wxASSERT( GetWindow() != NULL );
2182     if (!GetWindow())
2183         return wxACC_FAIL;
2184
2185     wxWindow* win = NULL;
2186     if (elementId == 0)
2187     {
2188         win = GetWindow();
2189     }
2190     else
2191     {
2192         if (elementId <= (int) GetWindow()->GetChildren().GetCount())
2193         {
2194             win = (wxWindow*) GetWindow()->GetChildren().Nth(elementId-1)->GetData();
2195         }
2196         else
2197             return wxACC_FAIL;
2198     }
2199     if (win)
2200     {
2201         rect = win->GetRect();
2202         if (win->GetParent() && !win->IsKindOf(CLASSINFO(wxTopLevelWindow)))
2203             rect.SetPosition(win->GetParent()->ClientToScreen(rect.GetPosition()));
2204         return wxACC_OK;
2205     }
2206
2207     return wxACC_NOT_IMPLEMENTED;
2208 }
2209
2210 // Navigates from fromId to toId/toObject.
2211 wxAccStatus wxWindowAccessible::Navigate(wxNavDir navDir, int fromId,
2212                              int* toId, wxAccessible** toObject)
2213 {
2214     wxASSERT( GetWindow() != NULL );
2215     if (!GetWindow())
2216         return wxACC_FAIL;
2217
2218     switch (navDir)
2219     {
2220     case wxNAVDIR_FIRSTCHILD:
2221         {
2222             if (GetWindow()->GetChildren().GetCount() == 0)
2223                 return wxACC_FALSE;
2224             wxWindow* childWindow = (wxWindow*) GetWindow()->GetChildren().GetFirst()->GetData();
2225             *toObject = childWindow->GetOrCreateAccessible();
2226
2227             return wxACC_OK;
2228         }
2229     case wxNAVDIR_LASTCHILD:
2230         {
2231             if (GetWindow()->GetChildren().GetCount() == 0)
2232                 return wxACC_FALSE;
2233             wxWindow* childWindow = (wxWindow*) GetWindow()->GetChildren().GetLast()->GetData();
2234             *toObject = childWindow->GetOrCreateAccessible();
2235
2236             return wxACC_OK;
2237         }
2238     case wxNAVDIR_RIGHT:
2239     case wxNAVDIR_DOWN:
2240     case wxNAVDIR_NEXT:
2241         {
2242             wxWindowList::Node *node = NULL;
2243             if (fromId == 0)
2244             {
2245                 // Can't navigate to sibling of this window
2246                 // if we're a top-level window.
2247                 if (!GetWindow()->GetParent())
2248                     return wxACC_NOT_IMPLEMENTED;
2249
2250                 node = GetWindow()->GetParent()->GetChildren().Find(GetWindow());
2251             }
2252             else
2253             {
2254                 if (fromId <= (int) GetWindow()->GetChildren().GetCount())
2255                     node = (wxWindowList::Node*) GetWindow()->GetChildren().Nth(fromId-1);
2256             }
2257
2258             if (node && node->GetNext())
2259             {
2260                 wxWindow* nextWindow = (wxWindow*) node->GetNext()->Data();
2261                 *toObject = nextWindow->GetOrCreateAccessible();
2262                 return wxACC_OK;
2263             }
2264             else
2265                 return wxACC_FALSE;
2266         }
2267     case wxNAVDIR_LEFT:
2268     case wxNAVDIR_UP:
2269     case wxNAVDIR_PREVIOUS:
2270         {
2271             wxWindowList::Node *node = NULL;
2272             if (fromId == 0)
2273             {
2274                 // Can't navigate to sibling of this window
2275                 // if we're a top-level window.
2276                 if (!GetWindow()->GetParent())
2277                     return wxACC_NOT_IMPLEMENTED;
2278
2279                 node = GetWindow()->GetParent()->GetChildren().Find(GetWindow());
2280             }
2281             else
2282             {
2283                 if (fromId <= (int) GetWindow()->GetChildren().GetCount())
2284                     node = (wxWindowList::Node*) GetWindow()->GetChildren().Nth(fromId-1);
2285             }
2286
2287             if (node && node->GetPrevious())
2288             {
2289                 wxWindow* previousWindow = (wxWindow*) node->GetPrevious()->Data();
2290                 *toObject = previousWindow->GetOrCreateAccessible();
2291                 return wxACC_OK;
2292             }
2293             else
2294                 return wxACC_FALSE;
2295         }
2296     }
2297
2298     return wxACC_NOT_IMPLEMENTED;
2299 }
2300
2301 // Gets the name of the specified object.
2302 wxAccStatus wxWindowAccessible::GetName(int childId, wxString* name)
2303 {
2304     wxASSERT( GetWindow() != NULL );
2305     if (!GetWindow())
2306         return wxACC_FAIL;
2307
2308     wxString title;
2309
2310     // If a child, leave wxWindows to call the function on the actual
2311     // child object.
2312     if (childId > 0)
2313         return wxACC_NOT_IMPLEMENTED;
2314
2315     // This will eventually be replaced by specialised
2316     // accessible classes, one for each kind of wxWindows
2317     // control or window.
2318     if (GetWindow()->IsKindOf(CLASSINFO(wxButton)))
2319         title = ((wxButton*) GetWindow())->GetLabel();
2320     else
2321         title = GetWindow()->GetName();
2322
2323     if (!title.IsEmpty())
2324     {
2325         *name = title;
2326         return wxACC_OK;
2327     }
2328     else
2329         return wxACC_NOT_IMPLEMENTED;
2330 }
2331
2332 // Gets the number of children.
2333 wxAccStatus wxWindowAccessible::GetChildCount(int* childId)
2334 {
2335     wxASSERT( GetWindow() != NULL );
2336     if (!GetWindow())
2337         return wxACC_FAIL;
2338
2339     *childId = (int) GetWindow()->GetChildren().GetCount();
2340     return wxACC_OK;
2341 }
2342
2343 // Gets the specified child (starting from 1).
2344 // If *child is NULL and return value is wxACC_OK,
2345 // this means that the child is a simple element and
2346 // not an accessible object.
2347 wxAccStatus wxWindowAccessible::GetChild(int childId, wxAccessible** child)
2348 {
2349     wxASSERT( GetWindow() != NULL );
2350     if (!GetWindow())
2351         return wxACC_FAIL;
2352
2353     if (childId == 0)
2354     {
2355         *child = this;
2356         return wxACC_OK;
2357     }
2358
2359     if (childId > (int) GetWindow()->GetChildren().GetCount())
2360         return wxACC_FAIL;
2361
2362     wxWindow* childWindow = (wxWindow*) GetWindow()->GetChildren().Nth(childId-1)->GetData();
2363     *child = childWindow->GetOrCreateAccessible();
2364     if (*child)
2365         return wxACC_OK;
2366     else
2367         return wxACC_FAIL;
2368 }
2369
2370 // Gets the parent, or NULL.
2371 wxAccStatus wxWindowAccessible::GetParent(wxAccessible** parent)
2372 {
2373     wxASSERT( GetWindow() != NULL );
2374     if (!GetWindow())
2375         return wxACC_FAIL;
2376
2377     wxWindow* parentWindow = GetWindow()->GetParent();
2378     if (!parentWindow)
2379     {
2380         *parent = NULL;
2381         return wxACC_OK;
2382     }
2383     else
2384     {
2385         *parent = parentWindow->GetOrCreateAccessible();
2386         if (*parent)
2387             return wxACC_OK;
2388         else
2389             return wxACC_FAIL;
2390     }
2391 }
2392
2393 // Performs the default action. childId is 0 (the action for this object)
2394 // or > 0 (the action for a child).
2395 // Return wxACC_NOT_SUPPORTED if there is no default action for this
2396 // window (e.g. an edit control).
2397 wxAccStatus wxWindowAccessible::DoDefaultAction(int childId)
2398 {
2399     wxASSERT( GetWindow() != NULL );
2400     if (!GetWindow())
2401         return wxACC_FAIL;
2402
2403     return wxACC_NOT_IMPLEMENTED;
2404 }
2405
2406 // Gets the default action for this object (0) or > 0 (the action for a child).
2407 // Return wxACC_OK even if there is no action. actionName is the action, or the empty
2408 // string if there is no action.
2409 // The retrieved string describes the action that is performed on an object,
2410 // not what the object does as a result. For example, a toolbar button that prints
2411 // a document has a default action of "Press" rather than "Prints the current document."
2412 wxAccStatus wxWindowAccessible::GetDefaultAction(int childId, wxString* actionName)
2413 {
2414     wxASSERT( GetWindow() != NULL );
2415     if (!GetWindow())
2416         return wxACC_FAIL;
2417
2418     return wxACC_NOT_IMPLEMENTED;
2419 }
2420
2421 // Returns the description for this object or a child.
2422 wxAccStatus wxWindowAccessible::GetDescription(int childId, wxString* description)
2423 {
2424     wxASSERT( GetWindow() != NULL );
2425     if (!GetWindow())
2426         return wxACC_FAIL;
2427
2428     wxString ht(GetWindow()->GetHelpText());
2429     if (!ht.IsEmpty())
2430     {
2431         *description = ht;
2432         return wxACC_OK;
2433     }
2434     return wxACC_NOT_IMPLEMENTED;
2435 }
2436
2437 // Returns help text for this object or a child, similar to tooltip text.
2438 wxAccStatus wxWindowAccessible::GetHelpText(int childId, wxString* helpText)
2439 {
2440     wxASSERT( GetWindow() != NULL );
2441     if (!GetWindow())
2442         return wxACC_FAIL;
2443
2444     wxString ht(GetWindow()->GetHelpText());
2445     if (!ht.IsEmpty())
2446     {
2447         *helpText = ht;
2448         return wxACC_OK;
2449     }
2450     return wxACC_NOT_IMPLEMENTED;
2451 }
2452
2453 // Returns the keyboard shortcut for this object or child.
2454 // Return e.g. ALT+K
2455 wxAccStatus wxWindowAccessible::GetKeyboardShortcut(int childId, wxString* shortcut)
2456 {
2457     wxASSERT( GetWindow() != NULL );
2458     if (!GetWindow())
2459         return wxACC_FAIL;
2460
2461     return wxACC_NOT_IMPLEMENTED;
2462 }
2463
2464 // Returns a role constant.
2465 wxAccStatus wxWindowAccessible::GetRole(int childId, wxAccRole* role)
2466 {
2467     wxASSERT( GetWindow() != NULL );
2468     if (!GetWindow())
2469         return wxACC_FAIL;
2470
2471     // If a child, leave wxWindows to call the function on the actual
2472     // child object.
2473     if (childId > 0)
2474         return wxACC_NOT_IMPLEMENTED;
2475
2476     if (GetWindow()->IsKindOf(CLASSINFO(wxControl)))
2477         return wxACC_NOT_IMPLEMENTED;
2478 #if wxUSE_STATUSBAR
2479     if (GetWindow()->IsKindOf(CLASSINFO(wxStatusBar)))
2480         return wxACC_NOT_IMPLEMENTED;
2481 #endif
2482 #if wxUSE_TOOLBAR
2483     if (GetWindow()->IsKindOf(CLASSINFO(wxToolBar)))
2484         return wxACC_NOT_IMPLEMENTED;
2485 #endif
2486
2487     //*role = wxROLE_SYSTEM_CLIENT;
2488     *role = wxROLE_SYSTEM_CLIENT;
2489     return wxACC_OK;
2490
2491     return wxACC_NOT_IMPLEMENTED;
2492 }
2493
2494 // Returns a state constant.
2495 wxAccStatus wxWindowAccessible::GetState(int childId, long* state)
2496 {
2497     wxASSERT( GetWindow() != NULL );
2498     if (!GetWindow())
2499         return wxACC_FAIL;
2500
2501     // If a child, leave wxWindows to call the function on the actual
2502     // child object.
2503     if (childId > 0)
2504         return wxACC_NOT_IMPLEMENTED;
2505
2506     if (GetWindow()->IsKindOf(CLASSINFO(wxControl)))
2507         return wxACC_NOT_IMPLEMENTED;
2508
2509 #if wxUSE_STATUSBAR
2510     if (GetWindow()->IsKindOf(CLASSINFO(wxStatusBar)))
2511         return wxACC_NOT_IMPLEMENTED;
2512 #endif
2513 #if wxUSE_TOOLBAR
2514     if (GetWindow()->IsKindOf(CLASSINFO(wxToolBar)))
2515         return wxACC_NOT_IMPLEMENTED;
2516 #endif
2517
2518     *state = 0;
2519     return wxACC_OK;
2520
2521     return wxACC_NOT_IMPLEMENTED;
2522 }
2523
2524 // Returns a localized string representing the value for the object
2525 // or child.
2526 wxAccStatus wxWindowAccessible::GetValue(int childId, wxString* strValue)
2527 {
2528     wxASSERT( GetWindow() != NULL );
2529     if (!GetWindow())
2530         return wxACC_FAIL;
2531
2532     return wxACC_NOT_IMPLEMENTED;
2533 }
2534
2535 // Selects the object or child.
2536 wxAccStatus wxWindowAccessible::Select(int childId, wxAccSelectionFlags selectFlags)
2537 {
2538     wxASSERT( GetWindow() != NULL );
2539     if (!GetWindow())
2540         return wxACC_FAIL;
2541
2542     return wxACC_NOT_IMPLEMENTED;
2543 }
2544
2545 // Gets the window with the keyboard focus.
2546 // If childId is 0 and child is NULL, no object in
2547 // this subhierarchy has the focus.
2548 // If this object has the focus, child should be 'this'.
2549 wxAccStatus wxWindowAccessible::GetFocus(int* childId, wxAccessible** child)
2550 {
2551     wxASSERT( GetWindow() != NULL );
2552     if (!GetWindow())
2553         return wxACC_FAIL;
2554
2555     return wxACC_NOT_IMPLEMENTED;
2556 }
2557
2558 // Gets a variant representing the selected children
2559 // of this object.
2560 // Acceptable values:
2561 // - a null variant (IsNull() returns TRUE)
2562 // - a list variant (GetType() == wxT("list")
2563 // - an integer representing the selected child element,
2564 //   or 0 if this object is selected (GetType() == wxT("long")
2565 // - a "void*" pointer to a wxAccessible child object
2566 wxAccStatus wxWindowAccessible::GetSelections(wxVariant* selections)
2567 {
2568     wxASSERT( GetWindow() != NULL );
2569     if (!GetWindow())
2570         return wxACC_FAIL;
2571
2572     return wxACC_NOT_IMPLEMENTED;
2573 }
2574
2575 #endif // wxUSE_ACCESSIBILITY