1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/common/window.cpp
3 // Purpose: common (to all ports) wxWindow functions
4 // Author: Julian Smart, Vadim Zeitlin
8 // Copyright: (c) wxWidgets team
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
20 // For compilers that support precompilation, includes "wx.h".
21 #include "wx/wxprec.h"
28 #include "wx/string.h"
32 #include "wx/window.h"
33 #include "wx/control.h"
34 #include "wx/checkbox.h"
35 #include "wx/radiobut.h"
36 #include "wx/statbox.h"
37 #include "wx/textctrl.h"
38 #include "wx/settings.h"
39 #include "wx/dialog.h"
40 #include "wx/msgdlg.h"
41 #include "wx/statusbr.h"
42 #include "wx/toolbar.h"
43 #include "wx/dcclient.h"
44 #include "wx/scrolbar.h"
45 #include "wx/layout.h"
49 #if wxUSE_DRAG_AND_DROP
51 #endif // wxUSE_DRAG_AND_DROP
53 #if wxUSE_ACCESSIBILITY
54 #include "wx/access.h"
58 #include "wx/cshelp.h"
62 #include "wx/tooltip.h"
63 #endif // wxUSE_TOOLTIPS
69 #if wxUSE_SYSTEM_OPTIONS
70 #include "wx/sysopt.h"
73 // For reporting compile- and runtime version of GTK+ in the ctrl+alt+mclick dialog.
74 // The gtk includes don't pull any other headers in, at least not on my system - MR
77 #include <gtk/gtkversion.h>
79 #include <gtk/gtkfeatures.h>
83 #include "wx/platinfo.h"
86 WXDLLIMPEXP_DATA_CORE(wxWindowList
) wxTopLevelWindows
;
89 #if wxUSE_MENUS_NATIVE
90 wxMenu
*wxCurrentPopupMenu
= NULL
;
91 #endif // wxUSE_MENUS_NATIVE
93 // ----------------------------------------------------------------------------
95 // ----------------------------------------------------------------------------
98 IMPLEMENT_ABSTRACT_CLASS(wxWindowBase
, wxEvtHandler
)
100 // ----------------------------------------------------------------------------
102 // ----------------------------------------------------------------------------
104 BEGIN_EVENT_TABLE(wxWindowBase
, wxEvtHandler
)
105 EVT_SYS_COLOUR_CHANGED(wxWindowBase
::OnSysColourChanged
)
106 EVT_INIT_DIALOG(wxWindowBase
::OnInitDialog
)
107 EVT_MIDDLE_DOWN(wxWindowBase
::OnMiddleClick
)
110 EVT_HELP(wxID_ANY
, wxWindowBase
::OnHelp
)
115 // ============================================================================
116 // implementation of the common functionality of the wxWindow class
117 // ============================================================================
119 // ----------------------------------------------------------------------------
121 // ----------------------------------------------------------------------------
123 // the default initialization
124 wxWindowBase
::wxWindowBase()
126 // no window yet, no parent nor children
127 m_parent
= (wxWindow
*)NULL
;
128 m_windowId
= wxID_ANY
;
130 // no constraints on the minimal window size
132 m_maxWidth
= wxDefaultCoord
;
134 m_maxHeight
= wxDefaultCoord
;
136 // invalidiated cache value
137 m_bestSizeCache
= wxDefaultSize
;
139 // window are created enabled and visible by default
143 // the default event handler is just this window
144 m_eventHandler
= this;
148 m_windowValidator
= (wxValidator
*) NULL
;
149 #endif // wxUSE_VALIDATORS
151 // the colours/fonts are default for now, so leave m_font,
152 // m_backgroundColour and m_foregroundColour uninitialized and set those
158 m_inheritFont
= false;
164 m_backgroundStyle
= wxBG_STYLE_SYSTEM
;
166 #if wxUSE_CONSTRAINTS
167 // no constraints whatsoever
168 m_constraints
= (wxLayoutConstraints
*) NULL
;
169 m_constraintsInvolvedIn
= (wxWindowList
*) NULL
;
170 #endif // wxUSE_CONSTRAINTS
172 m_windowSizer
= (wxSizer
*) NULL
;
173 m_containingSizer
= (wxSizer
*) NULL
;
174 m_autoLayout
= false;
177 #if wxUSE_DRAG_AND_DROP
178 m_dropTarget
= (wxDropTarget
*)NULL
;
179 #endif // wxUSE_DRAG_AND_DROP
182 m_tooltip
= (wxToolTip
*)NULL
;
183 #endif // wxUSE_TOOLTIPS
186 m_caret
= (wxCaret
*)NULL
;
187 #endif // wxUSE_CARET
190 m_hasCustomPalette
= false;
191 #endif // wxUSE_PALETTE
193 #if wxUSE_ACCESSIBILITY
197 m_virtualSize
= wxDefaultSize
;
199 m_scrollHelper
= (wxScrollHelper
*) NULL
;
201 m_windowVariant
= wxWINDOW_VARIANT_NORMAL
;
202 #if wxUSE_SYSTEM_OPTIONS
203 if ( wxSystemOptions
::HasOption(wxWINDOW_DEFAULT_VARIANT
) )
205 m_windowVariant
= (wxWindowVariant
) wxSystemOptions
::GetOptionInt( wxWINDOW_DEFAULT_VARIANT
) ;
209 // Whether we're using the current theme for this window (wxGTK only for now)
210 m_themeEnabled
= false;
212 // VZ: this one shouldn't exist...
213 m_isBeingDeleted
= false;
216 // common part of window creation process
217 bool wxWindowBase
::CreateBase(wxWindowBase
*parent
,
219 const wxPoint
& WXUNUSED(pos
),
220 const wxSize
& WXUNUSED(size
),
222 const wxValidator
& wxVALIDATOR_PARAM(validator
),
223 const wxString
& name
)
226 // wxGTK doesn't allow to create controls with static box as the parent so
227 // this will result in a crash when the program is ported to wxGTK so warn
230 // if you get this assert, the correct solution is to create the controls
231 // as siblings of the static box
232 wxASSERT_MSG( !parent
|| !wxDynamicCast(parent
, wxStaticBox
),
233 _T("wxStaticBox can't be used as a window parent!") );
234 #endif // wxUSE_STATBOX
236 // ids are limited to 16 bits under MSW so if you care about portability,
237 // it's not a good idea to use ids out of this range (and negative ids are
238 // reserved for wxWidgets own usage)
239 wxASSERT_MSG( id
== wxID_ANY
|| (id
>= 0 && id
< 32767) ||
240 (id
>= wxID_AUTO_LOWEST
&& id
<= wxID_AUTO_HIGHEST
),
241 _T("invalid id value") );
243 // generate a new id if the user doesn't care about it
244 if ( id
== wxID_ANY
)
246 m_windowId
= NewControlId();
248 // remember to call ReleaseControlId() when this window is destroyed
251 else // valid id specified
256 // don't use SetWindowStyleFlag() here, this function should only be called
257 // to change the flag after creation as it tries to reflect the changes in
258 // flags by updating the window dynamically and we don't need this here
259 m_windowStyle
= style
;
265 SetValidator(validator
);
266 #endif // wxUSE_VALIDATORS
268 // if the parent window has wxWS_EX_VALIDATE_RECURSIVELY set, we want to
269 // have it too - like this it's possible to set it only in the top level
270 // dialog/frame and all children will inherit it by defult
271 if ( parent
&& (parent
->GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY
) )
273 SetExtraStyle(GetExtraStyle() | wxWS_EX_VALIDATE_RECURSIVELY
);
279 bool wxWindowBase
::ToggleWindowStyle(int flag
)
281 wxASSERT_MSG( flag
, _T("flags with 0 value can't be toggled") );
284 long style
= GetWindowStyleFlag();
290 else // currently off
296 SetWindowStyleFlag(style
);
301 // ----------------------------------------------------------------------------
303 // ----------------------------------------------------------------------------
306 wxWindowBase
::~wxWindowBase()
308 wxASSERT_MSG( GetCapture() != this, wxT("attempt to destroy window with mouse capture") );
310 // mark the id as unused if we allocated it for this control
312 ReleaseControlId(m_windowId
);
314 // FIXME if these 2 cases result from programming errors in the user code
315 // we should probably assert here instead of silently fixing them
317 // Just in case the window has been Closed, but we're then deleting
318 // immediately: don't leave dangling pointers.
319 wxPendingDelete
.DeleteObject(this);
321 // Just in case we've loaded a top-level window via LoadNativeDialog but
322 // we weren't a dialog class
323 wxTopLevelWindows
.DeleteObject((wxWindow
*)this);
325 // The associated popup menu can still be alive, disassociate from it in
327 if ( wxCurrentPopupMenu
&& wxCurrentPopupMenu
->GetInvokingWindow() == this )
328 wxCurrentPopupMenu
->SetInvokingWindow(NULL
);
330 wxASSERT_MSG( GetChildren().GetCount() == 0, wxT("children not destroyed") );
332 // notify the parent about this window destruction
334 m_parent
->RemoveChild(this);
338 #endif // wxUSE_CARET
341 delete m_windowValidator
;
342 #endif // wxUSE_VALIDATORS
344 #if wxUSE_CONSTRAINTS
345 // Have to delete constraints/sizer FIRST otherwise sizers may try to look
346 // at deleted windows as they delete themselves.
347 DeleteRelatedConstraints();
351 // This removes any dangling pointers to this window in other windows'
352 // constraintsInvolvedIn lists.
353 UnsetConstraints(m_constraints
);
354 delete m_constraints
;
355 m_constraints
= NULL
;
357 #endif // wxUSE_CONSTRAINTS
359 if ( m_containingSizer
)
360 m_containingSizer
->Detach( (wxWindow
*)this );
362 delete m_windowSizer
;
364 #if wxUSE_DRAG_AND_DROP
366 #endif // wxUSE_DRAG_AND_DROP
370 #endif // wxUSE_TOOLTIPS
372 #if wxUSE_ACCESSIBILITY
377 void wxWindowBase
::SendDestroyEvent()
379 wxWindowDestroyEvent event
;
380 event
.SetEventObject(this);
381 event
.SetId(GetId());
382 GetEventHandler()->ProcessEvent(event
);
385 bool wxWindowBase
::Destroy()
392 bool wxWindowBase
::Close(bool force
)
394 wxCloseEvent
event(wxEVT_CLOSE_WINDOW
, m_windowId
);
395 event
.SetEventObject(this);
396 event
.SetCanVeto(!force
);
398 // return false if window wasn't closed because the application vetoed the
400 return GetEventHandler()->ProcessEvent(event
) && !event
.GetVeto();
403 bool wxWindowBase
::DestroyChildren()
405 wxWindowList
::compatibility_iterator node
;
408 // we iterate until the list becomes empty
409 node
= GetChildren().GetFirst();
413 wxWindow
*child
= node
->GetData();
415 // note that we really want to call delete and not ->Destroy() here
416 // because we want to delete the child immediately, before we are
417 // deleted, and delayed deletion would result in problems as our (top
418 // level) child could outlive its parent
421 wxASSERT_MSG( !GetChildren().Find(child
),
422 wxT("child didn't remove itself using RemoveChild()") );
428 // ----------------------------------------------------------------------------
429 // size/position related methods
430 // ----------------------------------------------------------------------------
432 // centre the window with respect to its parent in either (or both) directions
433 void wxWindowBase
::DoCentre(int dir
)
435 wxCHECK_RET( !(dir
& wxCENTRE_ON_SCREEN
) && GetParent(),
436 _T("this method only implements centering child windows") );
438 SetSize(GetRect().CentreIn(GetParent()->GetClientSize(), dir
));
441 // fits the window around the children
442 void wxWindowBase
::Fit()
444 if ( !GetChildren().empty() )
446 SetSize(GetBestSize());
448 //else: do nothing if we have no children
451 // fits virtual size (ie. scrolled area etc.) around children
452 void wxWindowBase
::FitInside()
454 if ( GetChildren().GetCount() > 0 )
456 SetVirtualSize( GetBestVirtualSize() );
460 // On Mac, scrollbars are explicitly children.
462 static bool wxHasRealChildren(const wxWindowBase
* win
)
464 int realChildCount
= 0;
466 for ( wxWindowList
::compatibility_iterator node
= win
->GetChildren().GetFirst();
468 node
= node
->GetNext() )
470 wxWindow
*win
= node
->GetData();
471 if ( !win
->IsTopLevel() && win
->IsShown() && !win
->IsKindOf(CLASSINFO(wxScrollBar
)))
474 return (realChildCount
> 0);
478 void wxWindowBase
::InvalidateBestSize()
480 m_bestSizeCache
= wxDefaultSize
;
482 // parent's best size calculation may depend on its children's
483 // as long as child window we are in is not top level window itself
484 // (because the TLW size is never resized automatically)
485 // so let's invalidate it as well to be safe:
486 if (m_parent
&& !IsTopLevel())
487 m_parent
->InvalidateBestSize();
490 // return the size best suited for the current window
491 wxSize wxWindowBase
::DoGetBestSize() const
497 best
= m_windowSizer
->GetMinSize();
499 #if wxUSE_CONSTRAINTS
500 else if ( m_constraints
)
502 wxConstCast(this, wxWindowBase
)->SatisfyConstraints();
504 // our minimal acceptable size is such that all our windows fit inside
508 for ( wxWindowList
::compatibility_iterator node
= GetChildren().GetFirst();
510 node
= node
->GetNext() )
512 wxLayoutConstraints
*c
= node
->GetData()->GetConstraints();
515 // it's not normal that we have an unconstrained child, but
516 // what can we do about it?
520 int x
= c
->right
.GetValue(),
521 y
= c
->bottom
.GetValue();
529 // TODO: we must calculate the overlaps somehow, otherwise we
530 // will never return a size bigger than the current one :-(
533 best
= wxSize(maxX
, maxY
);
535 #endif // wxUSE_CONSTRAINTS
536 else if ( !GetChildren().empty()
538 && wxHasRealChildren(this)
542 // our minimal acceptable size is such that all our visible child
543 // windows fit inside
547 for ( wxWindowList
::compatibility_iterator node
= GetChildren().GetFirst();
549 node
= node
->GetNext() )
551 wxWindow
*win
= node
->GetData();
552 if ( win
->IsTopLevel()
555 || wxDynamicCast(win
, wxStatusBar
)
556 #endif // wxUSE_STATUSBAR
559 // dialogs and frames lie in different top level windows -
560 // don't deal with them here; as for the status bars, they
561 // don't lie in the client area at all
566 win
->GetPosition(&wx
, &wy
);
568 // if the window hadn't been positioned yet, assume that it is in
570 if ( wx
== wxDefaultCoord
)
572 if ( wy
== wxDefaultCoord
)
575 win
->GetSize(&ww
, &wh
);
576 if ( wx
+ ww
> maxX
)
578 if ( wy
+ wh
> maxY
)
582 best
= wxSize(maxX
, maxY
);
584 else // ! has children
586 // for a generic window there is no natural best size so, if the
587 // minimal size is not set, use the current size but take care to
588 // remember it as minimal size for the next time because our best size
589 // should be constant: otherwise we could get into a situation when the
590 // window is initially at some size, then expanded to a larger size and
591 // then, when the containing window is shrunk back (because our initial
592 // best size had been used for computing the parent min size), we can't
593 // be shrunk back any more because our best size is now bigger
594 wxSize size
= GetMinSize();
595 if ( !size
.IsFullySpecified() )
597 size
.SetDefaults(GetSize());
598 wxConstCast(this, wxWindowBase
)->SetMinSize(size
);
601 // return as-is, unadjusted by the client size difference.
605 // Add any difference between size and client size
606 wxSize diff
= GetSize() - GetClientSize();
607 best
.x
+= wxMax(0, diff
.x
);
608 best
.y
+= wxMax(0, diff
.y
);
613 // helper of GetWindowBorderSize(): as many ports don't implement support for
614 // wxSYS_BORDER/EDGE_X/Y metrics in their wxSystemSettings, use hard coded
615 // fallbacks in this case
616 static int wxGetMetricOrDefault(wxSystemMetric what
)
618 int rc
= wxSystemSettings
::GetMetric(what
);
625 // 2D border is by default 1 pixel wide
631 // 3D borders are by default 2 pixels
636 wxFAIL_MSG( _T("unexpected wxGetMetricOrDefault() argument") );
644 wxSize wxWindowBase
::GetWindowBorderSize() const
648 switch ( GetBorder() )
651 // nothing to do, size is already (0, 0)
654 case wxBORDER_SIMPLE
:
655 case wxBORDER_STATIC
:
656 size
.x
= wxGetMetricOrDefault(wxSYS_BORDER_X
);
657 size
.y
= wxGetMetricOrDefault(wxSYS_BORDER_Y
);
660 case wxBORDER_SUNKEN
:
661 case wxBORDER_RAISED
:
662 size
.x
= wxMax(wxGetMetricOrDefault(wxSYS_EDGE_X
),
663 wxGetMetricOrDefault(wxSYS_BORDER_X
));
664 size
.y
= wxMax(wxGetMetricOrDefault(wxSYS_EDGE_Y
),
665 wxGetMetricOrDefault(wxSYS_BORDER_Y
));
668 case wxBORDER_DOUBLE
:
669 size
.x
= wxGetMetricOrDefault(wxSYS_EDGE_X
) +
670 wxGetMetricOrDefault(wxSYS_BORDER_X
);
671 size
.y
= wxGetMetricOrDefault(wxSYS_EDGE_Y
) +
672 wxGetMetricOrDefault(wxSYS_BORDER_Y
);
676 wxFAIL_MSG(_T("Unknown border style."));
680 // we have borders on both sides
684 wxSize wxWindowBase
::GetEffectiveMinSize() const
686 // merge the best size with the min size, giving priority to the min size
687 wxSize min
= GetMinSize();
688 if (min
.x
== wxDefaultCoord
|| min
.y
== wxDefaultCoord
)
690 wxSize best
= GetBestSize();
691 if (min
.x
== wxDefaultCoord
) min
.x
= best
.x
;
692 if (min
.y
== wxDefaultCoord
) min
.y
= best
.y
;
698 void wxWindowBase
::SetInitialSize(const wxSize
& size
)
700 // Set the min size to the size passed in. This will usually either be
701 // wxDefaultSize or the size passed to this window's ctor/Create function.
704 // Merge the size with the best size if needed
705 wxSize best
= GetEffectiveMinSize();
707 // If the current size doesn't match then change it
708 if (GetSize() != best
)
713 // by default the origin is not shifted
714 wxPoint wxWindowBase
::GetClientAreaOrigin() const
719 void wxWindowBase
::SetWindowVariant( wxWindowVariant variant
)
721 if ( m_windowVariant
!= variant
)
723 m_windowVariant
= variant
;
725 DoSetWindowVariant(variant
);
729 void wxWindowBase
::DoSetWindowVariant( wxWindowVariant variant
)
731 // adjust the font height to correspond to our new variant (notice that
732 // we're only called if something really changed)
733 wxFont font
= GetFont();
734 int size
= font
.GetPointSize();
737 case wxWINDOW_VARIANT_NORMAL
:
740 case wxWINDOW_VARIANT_SMALL
:
745 case wxWINDOW_VARIANT_MINI
:
750 case wxWINDOW_VARIANT_LARGE
:
756 wxFAIL_MSG(_T("unexpected window variant"));
760 font
.SetPointSize(size
);
764 void wxWindowBase
::DoSetSizeHints( int minW
, int minH
,
766 int WXUNUSED(incW
), int WXUNUSED(incH
) )
768 wxCHECK_RET( (minW
== wxDefaultCoord
|| maxW
== wxDefaultCoord
|| minW
<= maxW
) &&
769 (minH
== wxDefaultCoord
|| maxH
== wxDefaultCoord
|| minH
<= maxH
),
770 _T("min width/height must be less than max width/height!") );
779 #if WXWIN_COMPATIBILITY_2_8
780 void wxWindowBase
::SetVirtualSizeHints(int WXUNUSED(minW
), int WXUNUSED(minH
),
781 int WXUNUSED(maxW
), int WXUNUSED(maxH
))
785 void wxWindowBase
::SetVirtualSizeHints(const wxSize
& WXUNUSED(minsize
),
786 const wxSize
& WXUNUSED(maxsize
))
789 #endif // WXWIN_COMPATIBILITY_2_8
791 void wxWindowBase
::DoSetVirtualSize( int x
, int y
)
793 m_virtualSize
= wxSize(x
, y
);
796 wxSize wxWindowBase
::DoGetVirtualSize() const
798 // we should use the entire client area so if it is greater than our
799 // virtual size, expand it to fit (otherwise if the window is big enough we
800 // wouldn't be using parts of it)
801 wxSize size
= GetClientSize();
802 if ( m_virtualSize
.x
> size
.x
)
803 size
.x
= m_virtualSize
.x
;
805 if ( m_virtualSize
.y
>= size
.y
)
806 size
.y
= m_virtualSize
.y
;
811 void wxWindowBase
::DoGetScreenPosition(int *x
, int *y
) const
813 // screen position is the same as (0, 0) in client coords for non TLWs (and
814 // TLWs override this method)
820 ClientToScreen(x
, y
);
823 // ----------------------------------------------------------------------------
824 // show/hide/enable/disable the window
825 // ----------------------------------------------------------------------------
827 bool wxWindowBase
::Show(bool show
)
829 if ( show
!= m_isShown
)
841 bool wxWindowBase
::IsEnabled() const
843 return IsThisEnabled() && (IsTopLevel() || !GetParent() || GetParent()->IsEnabled());
846 void wxWindowBase
::NotifyWindowOnEnableChange(bool enabled
)
848 #ifndef wxHAS_NATIVE_ENABLED_MANAGEMENT
850 #endif // !defined(wxHAS_NATIVE_ENABLED_MANAGEMENT)
854 // If we are top-level then the logic doesn't apply - otherwise
855 // showing a modal dialog would result in total greying out (and ungreying
856 // out later) of everything which would be really ugly
860 for ( wxWindowList
::compatibility_iterator node
= GetChildren().GetFirst();
862 node
= node
->GetNext() )
864 wxWindowBase
* const child
= node
->GetData();
865 if ( !child
->IsTopLevel() && child
->IsThisEnabled() )
866 child
->NotifyWindowOnEnableChange(enabled
);
870 bool wxWindowBase
::Enable(bool enable
)
872 if ( enable
== IsThisEnabled() )
875 m_isEnabled
= enable
;
877 #ifdef wxHAS_NATIVE_ENABLED_MANAGEMENT
879 #else // !defined(wxHAS_NATIVE_ENABLED_MANAGEMENT)
880 wxWindowBase
* const parent
= GetParent();
881 if( !IsTopLevel() && parent
&& !parent
->IsEnabled() )
885 #endif // !defined(wxHAS_NATIVE_ENABLED_MANAGEMENT)
887 NotifyWindowOnEnableChange(enable
);
892 bool wxWindowBase
::IsShownOnScreen() const
894 // A window is shown on screen if it itself is shown and so are all its
895 // parents. But if a window is toplevel one, then its always visible on
896 // screen if IsShown() returns true, even if it has a hidden parent.
898 (IsTopLevel() || GetParent() == NULL
|| GetParent()->IsShownOnScreen());
901 // ----------------------------------------------------------------------------
903 // ----------------------------------------------------------------------------
905 bool wxWindowBase
::IsTopLevel() const
910 // ----------------------------------------------------------------------------
911 // reparenting the window
912 // ----------------------------------------------------------------------------
914 void wxWindowBase
::AddChild(wxWindowBase
*child
)
916 wxCHECK_RET( child
, wxT("can't add a NULL child") );
918 // this should never happen and it will lead to a crash later if it does
919 // because RemoveChild() will remove only one node from the children list
920 // and the other(s) one(s) will be left with dangling pointers in them
921 wxASSERT_MSG( !GetChildren().Find((wxWindow
*)child
), _T("AddChild() called twice") );
923 GetChildren().Append((wxWindow
*)child
);
924 child
->SetParent(this);
927 void wxWindowBase
::RemoveChild(wxWindowBase
*child
)
929 wxCHECK_RET( child
, wxT("can't remove a NULL child") );
931 GetChildren().DeleteObject((wxWindow
*)child
);
932 child
->SetParent(NULL
);
935 bool wxWindowBase
::Reparent(wxWindowBase
*newParent
)
937 wxWindow
*oldParent
= GetParent();
938 if ( newParent
== oldParent
)
944 const bool oldEnabledState
= IsEnabled();
946 // unlink this window from the existing parent.
949 oldParent
->RemoveChild(this);
953 wxTopLevelWindows
.DeleteObject((wxWindow
*)this);
956 // add it to the new one
959 newParent
->AddChild(this);
963 wxTopLevelWindows
.Append((wxWindow
*)this);
966 // We need to notify window (and its subwindows) if by changing the parent
967 // we also change our enabled/disabled status.
968 const bool newEnabledState
= IsEnabled();
969 if ( newEnabledState
!= oldEnabledState
)
971 NotifyWindowOnEnableChange(newEnabledState
);
977 // ----------------------------------------------------------------------------
978 // event handler stuff
979 // ----------------------------------------------------------------------------
981 void wxWindowBase
::PushEventHandler(wxEvtHandler
*handler
)
983 wxEvtHandler
*handlerOld
= GetEventHandler();
985 handler
->SetNextHandler(handlerOld
);
988 GetEventHandler()->SetPreviousHandler(handler
);
990 SetEventHandler(handler
);
993 wxEvtHandler
*wxWindowBase
::PopEventHandler(bool deleteHandler
)
995 wxEvtHandler
*handlerA
= GetEventHandler();
998 wxEvtHandler
*handlerB
= handlerA
->GetNextHandler();
999 handlerA
->SetNextHandler((wxEvtHandler
*)NULL
);
1002 handlerB
->SetPreviousHandler((wxEvtHandler
*)NULL
);
1003 SetEventHandler(handlerB
);
1005 if ( deleteHandler
)
1008 handlerA
= (wxEvtHandler
*)NULL
;
1015 bool wxWindowBase
::RemoveEventHandler(wxEvtHandler
*handler
)
1017 wxCHECK_MSG( handler
, false, _T("RemoveEventHandler(NULL) called") );
1019 wxEvtHandler
*handlerPrev
= NULL
,
1020 *handlerCur
= GetEventHandler();
1021 while ( handlerCur
)
1023 wxEvtHandler
*handlerNext
= handlerCur
->GetNextHandler();
1025 if ( handlerCur
== handler
)
1029 handlerPrev
->SetNextHandler(handlerNext
);
1033 SetEventHandler(handlerNext
);
1038 handlerNext
->SetPreviousHandler ( handlerPrev
);
1041 handler
->SetNextHandler(NULL
);
1042 handler
->SetPreviousHandler(NULL
);
1047 handlerPrev
= handlerCur
;
1048 handlerCur
= handlerNext
;
1051 wxFAIL_MSG( _T("where has the event handler gone?") );
1056 bool wxWindowBase
::HandleWindowEvent(wxEvent
& event
) const
1058 return GetEventHandler()->SafelyProcessEvent(event
);
1061 // ----------------------------------------------------------------------------
1062 // colours, fonts &c
1063 // ----------------------------------------------------------------------------
1065 void wxWindowBase
::InheritAttributes()
1067 const wxWindowBase
* const parent
= GetParent();
1071 // we only inherit attributes which had been explicitly set for the parent
1072 // which ensures that this only happens if the user really wants it and
1073 // not by default which wouldn't make any sense in modern GUIs where the
1074 // controls don't all use the same fonts (nor colours)
1075 if ( parent
->m_inheritFont
&& !m_hasFont
)
1076 SetFont(parent
->GetFont());
1078 // in addition, there is a possibility to explicitly forbid inheriting
1079 // colours at each class level by overriding ShouldInheritColours()
1080 if ( ShouldInheritColours() )
1082 if ( parent
->m_inheritFgCol
&& !m_hasFgCol
)
1083 SetForegroundColour(parent
->GetForegroundColour());
1085 // inheriting (solid) background colour is wrong as it totally breaks
1086 // any kind of themed backgrounds
1088 // instead, the controls should use the same background as their parent
1089 // (ideally by not drawing it at all)
1091 if ( parent
->m_inheritBgCol
&& !m_hasBgCol
)
1092 SetBackgroundColour(parent
->GetBackgroundColour());
1097 /* static */ wxVisualAttributes
1098 wxWindowBase
::GetClassDefaultAttributes(wxWindowVariant
WXUNUSED(variant
))
1100 // it is important to return valid values for all attributes from here,
1101 // GetXXX() below rely on this
1102 wxVisualAttributes attrs
;
1103 attrs
.font
= wxSystemSettings
::GetFont(wxSYS_DEFAULT_GUI_FONT
);
1104 attrs
.colFg
= wxSystemSettings
::GetColour(wxSYS_COLOUR_WINDOWTEXT
);
1106 // On Smartphone/PocketPC, wxSYS_COLOUR_WINDOW is a better reflection of
1107 // the usual background colour than wxSYS_COLOUR_BTNFACE.
1108 // It's a pity that wxSYS_COLOUR_WINDOW isn't always a suitable background
1109 // colour on other platforms.
1111 #if defined(__WXWINCE__) && (defined(__SMARTPHONE__) || defined(__POCKETPC__))
1112 attrs
.colBg
= wxSystemSettings
::GetColour(wxSYS_COLOUR_WINDOW
);
1114 attrs
.colBg
= wxSystemSettings
::GetColour(wxSYS_COLOUR_BTNFACE
);
1119 wxColour wxWindowBase
::GetBackgroundColour() const
1121 if ( !m_backgroundColour
.IsOk() )
1123 wxASSERT_MSG( !m_hasBgCol
, _T("we have invalid explicit bg colour?") );
1125 // get our default background colour
1126 wxColour colBg
= GetDefaultAttributes().colBg
;
1128 // we must return some valid colour to avoid redoing this every time
1129 // and also to avoid surprizing the applications written for older
1130 // wxWidgets versions where GetBackgroundColour() always returned
1131 // something -- so give them something even if it doesn't make sense
1132 // for this window (e.g. it has a themed background)
1134 colBg
= GetClassDefaultAttributes().colBg
;
1139 return m_backgroundColour
;
1142 wxColour wxWindowBase
::GetForegroundColour() const
1144 // logic is the same as above
1145 if ( !m_hasFgCol
&& !m_foregroundColour
.Ok() )
1147 wxColour colFg
= GetDefaultAttributes().colFg
;
1149 if ( !colFg
.IsOk() )
1150 colFg
= GetClassDefaultAttributes().colFg
;
1155 return m_foregroundColour
;
1158 bool wxWindowBase
::SetBackgroundColour( const wxColour
&colour
)
1160 if ( colour
== m_backgroundColour
)
1163 m_hasBgCol
= colour
.IsOk();
1164 if ( m_backgroundStyle
!= wxBG_STYLE_CUSTOM
)
1165 m_backgroundStyle
= m_hasBgCol ? wxBG_STYLE_COLOUR
: wxBG_STYLE_SYSTEM
;
1167 m_inheritBgCol
= m_hasBgCol
;
1168 m_backgroundColour
= colour
;
1169 SetThemeEnabled( !m_hasBgCol
&& !m_foregroundColour
.Ok() );
1173 bool wxWindowBase
::SetForegroundColour( const wxColour
&colour
)
1175 if (colour
== m_foregroundColour
)
1178 m_hasFgCol
= colour
.IsOk();
1179 m_inheritFgCol
= m_hasFgCol
;
1180 m_foregroundColour
= colour
;
1181 SetThemeEnabled( !m_hasFgCol
&& !m_backgroundColour
.Ok() );
1185 bool wxWindowBase
::SetCursor(const wxCursor
& cursor
)
1187 // setting an invalid cursor is ok, it means that we don't have any special
1189 if ( m_cursor
.IsSameAs(cursor
) )
1200 wxFont wxWindowBase
::GetFont() const
1202 // logic is the same as in GetBackgroundColour()
1203 if ( !m_font
.IsOk() )
1205 wxASSERT_MSG( !m_hasFont
, _T("we have invalid explicit font?") );
1207 wxFont font
= GetDefaultAttributes().font
;
1209 font
= GetClassDefaultAttributes().font
;
1217 bool wxWindowBase
::SetFont(const wxFont
& font
)
1219 if ( font
== m_font
)
1226 m_hasFont
= font
.IsOk();
1227 m_inheritFont
= m_hasFont
;
1229 InvalidateBestSize();
1236 void wxWindowBase
::SetPalette(const wxPalette
& pal
)
1238 m_hasCustomPalette
= true;
1241 // VZ: can anyone explain me what do we do here?
1242 wxWindowDC
d((wxWindow
*) this);
1246 wxWindow
*wxWindowBase
::GetAncestorWithCustomPalette() const
1248 wxWindow
*win
= (wxWindow
*)this;
1249 while ( win
&& !win
->HasCustomPalette() )
1251 win
= win
->GetParent();
1257 #endif // wxUSE_PALETTE
1260 void wxWindowBase
::SetCaret(wxCaret
*caret
)
1271 wxASSERT_MSG( m_caret
->GetWindow() == this,
1272 wxT("caret should be created associated to this window") );
1275 #endif // wxUSE_CARET
1277 #if wxUSE_VALIDATORS
1278 // ----------------------------------------------------------------------------
1280 // ----------------------------------------------------------------------------
1282 void wxWindowBase
::SetValidator(const wxValidator
& validator
)
1284 if ( m_windowValidator
)
1285 delete m_windowValidator
;
1287 m_windowValidator
= (wxValidator
*)validator
.Clone();
1289 if ( m_windowValidator
)
1290 m_windowValidator
->SetWindow(this);
1292 #endif // wxUSE_VALIDATORS
1294 // ----------------------------------------------------------------------------
1295 // update region stuff
1296 // ----------------------------------------------------------------------------
1298 wxRect wxWindowBase
::GetUpdateClientRect() const
1300 wxRegion rgnUpdate
= GetUpdateRegion();
1301 rgnUpdate
.Intersect(GetClientRect());
1302 wxRect rectUpdate
= rgnUpdate
.GetBox();
1303 wxPoint ptOrigin
= GetClientAreaOrigin();
1304 rectUpdate
.x
-= ptOrigin
.x
;
1305 rectUpdate
.y
-= ptOrigin
.y
;
1310 bool wxWindowBase
::DoIsExposed(int x
, int y
) const
1312 return m_updateRegion
.Contains(x
, y
) != wxOutRegion
;
1315 bool wxWindowBase
::DoIsExposed(int x
, int y
, int w
, int h
) const
1317 return m_updateRegion
.Contains(x
, y
, w
, h
) != wxOutRegion
;
1320 void wxWindowBase
::ClearBackground()
1322 // wxGTK uses its own version, no need to add never used code
1324 wxClientDC
dc((wxWindow
*)this);
1325 wxBrush
brush(GetBackgroundColour(), wxSOLID
);
1326 dc
.SetBackground(brush
);
1331 // ----------------------------------------------------------------------------
1332 // find child window by id or name
1333 // ----------------------------------------------------------------------------
1335 wxWindow
*wxWindowBase
::FindWindow(long id
) const
1337 if ( id
== m_windowId
)
1338 return (wxWindow
*)this;
1340 wxWindowBase
*res
= (wxWindow
*)NULL
;
1341 wxWindowList
::compatibility_iterator node
;
1342 for ( node
= m_children
.GetFirst(); node
&& !res
; node
= node
->GetNext() )
1344 wxWindowBase
*child
= node
->GetData();
1345 res
= child
->FindWindow( id
);
1348 return (wxWindow
*)res
;
1351 wxWindow
*wxWindowBase
::FindWindow(const wxString
& name
) const
1353 if ( name
== m_windowName
)
1354 return (wxWindow
*)this;
1356 wxWindowBase
*res
= (wxWindow
*)NULL
;
1357 wxWindowList
::compatibility_iterator node
;
1358 for ( node
= m_children
.GetFirst(); node
&& !res
; node
= node
->GetNext() )
1360 wxWindow
*child
= node
->GetData();
1361 res
= child
->FindWindow(name
);
1364 return (wxWindow
*)res
;
1368 // find any window by id or name or label: If parent is non-NULL, look through
1369 // children for a label or title matching the specified string. If NULL, look
1370 // through all top-level windows.
1372 // to avoid duplicating code we reuse the same helper function but with
1373 // different comparators
1375 typedef bool (*wxFindWindowCmp
)(const wxWindow
*win
,
1376 const wxString
& label
, long id
);
1379 bool wxFindWindowCmpLabels(const wxWindow
*win
, const wxString
& label
,
1382 return win
->GetLabel() == label
;
1386 bool wxFindWindowCmpNames(const wxWindow
*win
, const wxString
& label
,
1389 return win
->GetName() == label
;
1393 bool wxFindWindowCmpIds(const wxWindow
*win
, const wxString
& WXUNUSED(label
),
1396 return win
->GetId() == id
;
1399 // recursive helper for the FindWindowByXXX() functions
1401 wxWindow
*wxFindWindowRecursively(const wxWindow
*parent
,
1402 const wxString
& label
,
1404 wxFindWindowCmp cmp
)
1408 // see if this is the one we're looking for
1409 if ( (*cmp
)(parent
, label
, id
) )
1410 return (wxWindow
*)parent
;
1412 // It wasn't, so check all its children
1413 for ( wxWindowList
::compatibility_iterator node
= parent
->GetChildren().GetFirst();
1415 node
= node
->GetNext() )
1417 // recursively check each child
1418 wxWindow
*win
= (wxWindow
*)node
->GetData();
1419 wxWindow
*retwin
= wxFindWindowRecursively(win
, label
, id
, cmp
);
1429 // helper for FindWindowByXXX()
1431 wxWindow
*wxFindWindowHelper(const wxWindow
*parent
,
1432 const wxString
& label
,
1434 wxFindWindowCmp cmp
)
1438 // just check parent and all its children
1439 return wxFindWindowRecursively(parent
, label
, id
, cmp
);
1442 // start at very top of wx's windows
1443 for ( wxWindowList
::compatibility_iterator node
= wxTopLevelWindows
.GetFirst();
1445 node
= node
->GetNext() )
1447 // recursively check each window & its children
1448 wxWindow
*win
= node
->GetData();
1449 wxWindow
*retwin
= wxFindWindowRecursively(win
, label
, id
, cmp
);
1459 wxWindowBase
::FindWindowByLabel(const wxString
& title
, const wxWindow
*parent
)
1461 return wxFindWindowHelper(parent
, title
, 0, wxFindWindowCmpLabels
);
1466 wxWindowBase
::FindWindowByName(const wxString
& title
, const wxWindow
*parent
)
1468 wxWindow
*win
= wxFindWindowHelper(parent
, title
, 0, wxFindWindowCmpNames
);
1472 // fall back to the label
1473 win
= FindWindowByLabel(title
, parent
);
1481 wxWindowBase
::FindWindowById( long id
, const wxWindow
* parent
)
1483 return wxFindWindowHelper(parent
, wxEmptyString
, id
, wxFindWindowCmpIds
);
1486 // ----------------------------------------------------------------------------
1487 // dialog oriented functions
1488 // ----------------------------------------------------------------------------
1490 void wxWindowBase
::MakeModal(bool modal
)
1492 // Disable all other windows
1495 wxWindowList
::compatibility_iterator node
= wxTopLevelWindows
.GetFirst();
1498 wxWindow
*win
= node
->GetData();
1500 win
->Enable(!modal
);
1502 node
= node
->GetNext();
1507 bool wxWindowBase
::Validate()
1509 #if wxUSE_VALIDATORS
1510 bool recurse
= (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY
) != 0;
1512 wxWindowList
::compatibility_iterator node
;
1513 for ( node
= m_children
.GetFirst(); node
; node
= node
->GetNext() )
1515 wxWindowBase
*child
= node
->GetData();
1516 wxValidator
*validator
= child
->GetValidator();
1517 if ( validator
&& !validator
->Validate((wxWindow
*)this) )
1522 if ( recurse
&& !child
->Validate() )
1527 #endif // wxUSE_VALIDATORS
1532 bool wxWindowBase
::TransferDataToWindow()
1534 #if wxUSE_VALIDATORS
1535 bool recurse
= (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY
) != 0;
1537 wxWindowList
::compatibility_iterator node
;
1538 for ( node
= m_children
.GetFirst(); node
; node
= node
->GetNext() )
1540 wxWindowBase
*child
= node
->GetData();
1541 wxValidator
*validator
= child
->GetValidator();
1542 if ( validator
&& !validator
->TransferToWindow() )
1544 wxLogWarning(_("Could not transfer data to window"));
1546 wxLog
::FlushActive();
1554 if ( !child
->TransferDataToWindow() )
1556 // warning already given
1561 #endif // wxUSE_VALIDATORS
1566 bool wxWindowBase
::TransferDataFromWindow()
1568 #if wxUSE_VALIDATORS
1569 bool recurse
= (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY
) != 0;
1571 wxWindowList
::compatibility_iterator node
;
1572 for ( node
= m_children
.GetFirst(); node
; node
= node
->GetNext() )
1574 wxWindow
*child
= node
->GetData();
1575 wxValidator
*validator
= child
->GetValidator();
1576 if ( validator
&& !validator
->TransferFromWindow() )
1578 // nop warning here because the application is supposed to give
1579 // one itself - we don't know here what might have gone wrongly
1586 if ( !child
->TransferDataFromWindow() )
1588 // warning already given
1593 #endif // wxUSE_VALIDATORS
1598 void wxWindowBase
::InitDialog()
1600 wxInitDialogEvent
event(GetId());
1601 event
.SetEventObject( this );
1602 GetEventHandler()->ProcessEvent(event
);
1605 // ----------------------------------------------------------------------------
1606 // context-sensitive help support
1607 // ----------------------------------------------------------------------------
1611 // associate this help text with this window
1612 void wxWindowBase
::SetHelpText(const wxString
& text
)
1614 wxHelpProvider
*helpProvider
= wxHelpProvider
::Get();
1617 helpProvider
->AddHelp(this, text
);
1621 // associate this help text with all windows with the same id as this
1623 void wxWindowBase
::SetHelpTextForId(const wxString
& text
)
1625 wxHelpProvider
*helpProvider
= wxHelpProvider
::Get();
1628 helpProvider
->AddHelp(GetId(), text
);
1632 // get the help string associated with this window (may be empty)
1633 // default implementation forwards calls to the help provider
1635 wxWindowBase
::GetHelpTextAtPoint(const wxPoint
& WXUNUSED(pt
),
1636 wxHelpEvent
::Origin
WXUNUSED(origin
)) const
1639 wxHelpProvider
*helpProvider
= wxHelpProvider
::Get();
1642 text
= helpProvider
->GetHelp(this);
1648 // show help for this window
1649 void wxWindowBase
::OnHelp(wxHelpEvent
& event
)
1651 wxHelpProvider
*helpProvider
= wxHelpProvider
::Get();
1654 if ( helpProvider
->ShowHelpAtPoint(this, event
.GetPosition(), event
.GetOrigin()) )
1656 // skip the event.Skip() below
1664 #endif // wxUSE_HELP
1666 // ----------------------------------------------------------------------------
1668 // ----------------------------------------------------------------------------
1672 void wxWindowBase
::SetToolTip( const wxString
&tip
)
1674 // don't create the new tooltip if we already have one
1677 m_tooltip
->SetTip( tip
);
1681 SetToolTip( new wxToolTip( tip
) );
1684 // setting empty tooltip text does not remove the tooltip any more - use
1685 // SetToolTip((wxToolTip *)NULL) for this
1688 void wxWindowBase
::DoSetToolTip(wxToolTip
*tooltip
)
1690 if ( m_tooltip
!= tooltip
)
1695 m_tooltip
= tooltip
;
1699 #endif // wxUSE_TOOLTIPS
1701 // ----------------------------------------------------------------------------
1702 // constraints and sizers
1703 // ----------------------------------------------------------------------------
1705 #if wxUSE_CONSTRAINTS
1707 void wxWindowBase
::SetConstraints( wxLayoutConstraints
*constraints
)
1709 if ( m_constraints
)
1711 UnsetConstraints(m_constraints
);
1712 delete m_constraints
;
1714 m_constraints
= constraints
;
1715 if ( m_constraints
)
1717 // Make sure other windows know they're part of a 'meaningful relationship'
1718 if ( m_constraints
->left
.GetOtherWindow() && (m_constraints
->left
.GetOtherWindow() != this) )
1719 m_constraints
->left
.GetOtherWindow()->AddConstraintReference(this);
1720 if ( m_constraints
->top
.GetOtherWindow() && (m_constraints
->top
.GetOtherWindow() != this) )
1721 m_constraints
->top
.GetOtherWindow()->AddConstraintReference(this);
1722 if ( m_constraints
->right
.GetOtherWindow() && (m_constraints
->right
.GetOtherWindow() != this) )
1723 m_constraints
->right
.GetOtherWindow()->AddConstraintReference(this);
1724 if ( m_constraints
->bottom
.GetOtherWindow() && (m_constraints
->bottom
.GetOtherWindow() != this) )
1725 m_constraints
->bottom
.GetOtherWindow()->AddConstraintReference(this);
1726 if ( m_constraints
->width
.GetOtherWindow() && (m_constraints
->width
.GetOtherWindow() != this) )
1727 m_constraints
->width
.GetOtherWindow()->AddConstraintReference(this);
1728 if ( m_constraints
->height
.GetOtherWindow() && (m_constraints
->height
.GetOtherWindow() != this) )
1729 m_constraints
->height
.GetOtherWindow()->AddConstraintReference(this);
1730 if ( m_constraints
->centreX
.GetOtherWindow() && (m_constraints
->centreX
.GetOtherWindow() != this) )
1731 m_constraints
->centreX
.GetOtherWindow()->AddConstraintReference(this);
1732 if ( m_constraints
->centreY
.GetOtherWindow() && (m_constraints
->centreY
.GetOtherWindow() != this) )
1733 m_constraints
->centreY
.GetOtherWindow()->AddConstraintReference(this);
1737 // This removes any dangling pointers to this window in other windows'
1738 // constraintsInvolvedIn lists.
1739 void wxWindowBase
::UnsetConstraints(wxLayoutConstraints
*c
)
1743 if ( c
->left
.GetOtherWindow() && (c
->top
.GetOtherWindow() != this) )
1744 c
->left
.GetOtherWindow()->RemoveConstraintReference(this);
1745 if ( c
->top
.GetOtherWindow() && (c
->top
.GetOtherWindow() != this) )
1746 c
->top
.GetOtherWindow()->RemoveConstraintReference(this);
1747 if ( c
->right
.GetOtherWindow() && (c
->right
.GetOtherWindow() != this) )
1748 c
->right
.GetOtherWindow()->RemoveConstraintReference(this);
1749 if ( c
->bottom
.GetOtherWindow() && (c
->bottom
.GetOtherWindow() != this) )
1750 c
->bottom
.GetOtherWindow()->RemoveConstraintReference(this);
1751 if ( c
->width
.GetOtherWindow() && (c
->width
.GetOtherWindow() != this) )
1752 c
->width
.GetOtherWindow()->RemoveConstraintReference(this);
1753 if ( c
->height
.GetOtherWindow() && (c
->height
.GetOtherWindow() != this) )
1754 c
->height
.GetOtherWindow()->RemoveConstraintReference(this);
1755 if ( c
->centreX
.GetOtherWindow() && (c
->centreX
.GetOtherWindow() != this) )
1756 c
->centreX
.GetOtherWindow()->RemoveConstraintReference(this);
1757 if ( c
->centreY
.GetOtherWindow() && (c
->centreY
.GetOtherWindow() != this) )
1758 c
->centreY
.GetOtherWindow()->RemoveConstraintReference(this);
1762 // Back-pointer to other windows we're involved with, so if we delete this
1763 // window, we must delete any constraints we're involved with.
1764 void wxWindowBase
::AddConstraintReference(wxWindowBase
*otherWin
)
1766 if ( !m_constraintsInvolvedIn
)
1767 m_constraintsInvolvedIn
= new wxWindowList
;
1768 if ( !m_constraintsInvolvedIn
->Find((wxWindow
*)otherWin
) )
1769 m_constraintsInvolvedIn
->Append((wxWindow
*)otherWin
);
1772 // REMOVE back-pointer to other windows we're involved with.
1773 void wxWindowBase
::RemoveConstraintReference(wxWindowBase
*otherWin
)
1775 if ( m_constraintsInvolvedIn
)
1776 m_constraintsInvolvedIn
->DeleteObject((wxWindow
*)otherWin
);
1779 // Reset any constraints that mention this window
1780 void wxWindowBase
::DeleteRelatedConstraints()
1782 if ( m_constraintsInvolvedIn
)
1784 wxWindowList
::compatibility_iterator node
= m_constraintsInvolvedIn
->GetFirst();
1787 wxWindow
*win
= node
->GetData();
1788 wxLayoutConstraints
*constr
= win
->GetConstraints();
1790 // Reset any constraints involving this window
1793 constr
->left
.ResetIfWin(this);
1794 constr
->top
.ResetIfWin(this);
1795 constr
->right
.ResetIfWin(this);
1796 constr
->bottom
.ResetIfWin(this);
1797 constr
->width
.ResetIfWin(this);
1798 constr
->height
.ResetIfWin(this);
1799 constr
->centreX
.ResetIfWin(this);
1800 constr
->centreY
.ResetIfWin(this);
1803 wxWindowList
::compatibility_iterator next
= node
->GetNext();
1804 m_constraintsInvolvedIn
->Erase(node
);
1808 delete m_constraintsInvolvedIn
;
1809 m_constraintsInvolvedIn
= (wxWindowList
*) NULL
;
1813 #endif // wxUSE_CONSTRAINTS
1815 void wxWindowBase
::SetSizer(wxSizer
*sizer
, bool deleteOld
)
1817 if ( sizer
== m_windowSizer
)
1820 if ( m_windowSizer
)
1822 m_windowSizer
->SetContainingWindow(NULL
);
1825 delete m_windowSizer
;
1828 m_windowSizer
= sizer
;
1829 if ( m_windowSizer
)
1831 m_windowSizer
->SetContainingWindow((wxWindow
*)this);
1834 SetAutoLayout(m_windowSizer
!= NULL
);
1837 void wxWindowBase
::SetSizerAndFit(wxSizer
*sizer
, bool deleteOld
)
1839 SetSizer( sizer
, deleteOld
);
1840 sizer
->SetSizeHints( (wxWindow
*) this );
1844 void wxWindowBase
::SetContainingSizer(wxSizer
* sizer
)
1846 // adding a window to a sizer twice is going to result in fatal and
1847 // hard to debug problems later because when deleting the second
1848 // associated wxSizerItem we're going to dereference a dangling
1849 // pointer; so try to detect this as early as possible
1850 wxASSERT_MSG( !sizer
|| m_containingSizer
!= sizer
,
1851 _T("Adding a window to the same sizer twice?") );
1853 m_containingSizer
= sizer
;
1856 #if wxUSE_CONSTRAINTS
1858 void wxWindowBase
::SatisfyConstraints()
1860 wxLayoutConstraints
*constr
= GetConstraints();
1861 bool wasOk
= constr
&& constr
->AreSatisfied();
1863 ResetConstraints(); // Mark all constraints as unevaluated
1867 // if we're a top level panel (i.e. our parent is frame/dialog), our
1868 // own constraints will never be satisfied any more unless we do it
1872 while ( noChanges
> 0 )
1874 LayoutPhase1(&noChanges
);
1878 LayoutPhase2(&noChanges
);
1881 #endif // wxUSE_CONSTRAINTS
1883 bool wxWindowBase
::Layout()
1885 // If there is a sizer, use it instead of the constraints
1889 GetVirtualSize(&w
, &h
);
1890 GetSizer()->SetDimension( 0, 0, w
, h
);
1892 #if wxUSE_CONSTRAINTS
1895 SatisfyConstraints(); // Find the right constraints values
1896 SetConstraintSizes(); // Recursively set the real window sizes
1903 #if wxUSE_CONSTRAINTS
1905 // first phase of the constraints evaluation: set our own constraints
1906 bool wxWindowBase
::LayoutPhase1(int *noChanges
)
1908 wxLayoutConstraints
*constr
= GetConstraints();
1910 return !constr
|| constr
->SatisfyConstraints(this, noChanges
);
1913 // second phase: set the constraints for our children
1914 bool wxWindowBase
::LayoutPhase2(int *noChanges
)
1921 // Layout grand children
1927 // Do a phase of evaluating child constraints
1928 bool wxWindowBase
::DoPhase(int phase
)
1930 // the list containing the children for which the constraints are already
1932 wxWindowList succeeded
;
1934 // the max number of iterations we loop before concluding that we can't set
1936 static const int maxIterations
= 500;
1938 for ( int noIterations
= 0; noIterations
< maxIterations
; noIterations
++ )
1942 // loop over all children setting their constraints
1943 for ( wxWindowList
::compatibility_iterator node
= GetChildren().GetFirst();
1945 node
= node
->GetNext() )
1947 wxWindow
*child
= node
->GetData();
1948 if ( child
->IsTopLevel() )
1950 // top level children are not inside our client area
1954 if ( !child
->GetConstraints() || succeeded
.Find(child
) )
1956 // this one is either already ok or nothing we can do about it
1960 int tempNoChanges
= 0;
1961 bool success
= phase
== 1 ? child
->LayoutPhase1(&tempNoChanges
)
1962 : child
->LayoutPhase2(&tempNoChanges
);
1963 noChanges
+= tempNoChanges
;
1967 succeeded
.Append(child
);
1973 // constraints are set
1981 void wxWindowBase
::ResetConstraints()
1983 wxLayoutConstraints
*constr
= GetConstraints();
1986 constr
->left
.SetDone(false);
1987 constr
->top
.SetDone(false);
1988 constr
->right
.SetDone(false);
1989 constr
->bottom
.SetDone(false);
1990 constr
->width
.SetDone(false);
1991 constr
->height
.SetDone(false);
1992 constr
->centreX
.SetDone(false);
1993 constr
->centreY
.SetDone(false);
1996 wxWindowList
::compatibility_iterator node
= GetChildren().GetFirst();
1999 wxWindow
*win
= node
->GetData();
2000 if ( !win
->IsTopLevel() )
2001 win
->ResetConstraints();
2002 node
= node
->GetNext();
2006 // Need to distinguish between setting the 'fake' size for windows and sizers,
2007 // and setting the real values.
2008 void wxWindowBase
::SetConstraintSizes(bool recurse
)
2010 wxLayoutConstraints
*constr
= GetConstraints();
2011 if ( constr
&& constr
->AreSatisfied() )
2013 int x
= constr
->left
.GetValue();
2014 int y
= constr
->top
.GetValue();
2015 int w
= constr
->width
.GetValue();
2016 int h
= constr
->height
.GetValue();
2018 if ( (constr
->width
.GetRelationship() != wxAsIs
) ||
2019 (constr
->height
.GetRelationship() != wxAsIs
) )
2021 SetSize(x
, y
, w
, h
);
2025 // If we don't want to resize this window, just move it...
2031 wxLogDebug(wxT("Constraints not satisfied for %s named '%s'."),
2032 GetClassInfo()->GetClassName(),
2038 wxWindowList
::compatibility_iterator node
= GetChildren().GetFirst();
2041 wxWindow
*win
= node
->GetData();
2042 if ( !win
->IsTopLevel() && win
->GetConstraints() )
2043 win
->SetConstraintSizes();
2044 node
= node
->GetNext();
2049 // Only set the size/position of the constraint (if any)
2050 void wxWindowBase
::SetSizeConstraint(int x
, int y
, int w
, int h
)
2052 wxLayoutConstraints
*constr
= GetConstraints();
2055 if ( x
!= wxDefaultCoord
)
2057 constr
->left
.SetValue(x
);
2058 constr
->left
.SetDone(true);
2060 if ( y
!= wxDefaultCoord
)
2062 constr
->top
.SetValue(y
);
2063 constr
->top
.SetDone(true);
2065 if ( w
!= wxDefaultCoord
)
2067 constr
->width
.SetValue(w
);
2068 constr
->width
.SetDone(true);
2070 if ( h
!= wxDefaultCoord
)
2072 constr
->height
.SetValue(h
);
2073 constr
->height
.SetDone(true);
2078 void wxWindowBase
::MoveConstraint(int x
, int y
)
2080 wxLayoutConstraints
*constr
= GetConstraints();
2083 if ( x
!= wxDefaultCoord
)
2085 constr
->left
.SetValue(x
);
2086 constr
->left
.SetDone(true);
2088 if ( y
!= wxDefaultCoord
)
2090 constr
->top
.SetValue(y
);
2091 constr
->top
.SetDone(true);
2096 void wxWindowBase
::GetSizeConstraint(int *w
, int *h
) const
2098 wxLayoutConstraints
*constr
= GetConstraints();
2101 *w
= constr
->width
.GetValue();
2102 *h
= constr
->height
.GetValue();
2108 void wxWindowBase
::GetClientSizeConstraint(int *w
, int *h
) const
2110 wxLayoutConstraints
*constr
= GetConstraints();
2113 *w
= constr
->width
.GetValue();
2114 *h
= constr
->height
.GetValue();
2117 GetClientSize(w
, h
);
2120 void wxWindowBase
::GetPositionConstraint(int *x
, int *y
) const
2122 wxLayoutConstraints
*constr
= GetConstraints();
2125 *x
= constr
->left
.GetValue();
2126 *y
= constr
->top
.GetValue();
2132 #endif // wxUSE_CONSTRAINTS
2134 void wxWindowBase
::AdjustForParentClientOrigin(int& x
, int& y
, int sizeFlags
) const
2136 // don't do it for the dialogs/frames - they float independently of their
2138 if ( !IsTopLevel() )
2140 wxWindow
*parent
= GetParent();
2141 if ( !(sizeFlags
& wxSIZE_NO_ADJUSTMENTS
) && parent
)
2143 wxPoint
pt(parent
->GetClientAreaOrigin());
2150 // ----------------------------------------------------------------------------
2151 // Update UI processing
2152 // ----------------------------------------------------------------------------
2154 void wxWindowBase
::UpdateWindowUI(long flags
)
2156 wxUpdateUIEvent
event(GetId());
2157 event
.SetEventObject(this);
2159 if ( GetEventHandler()->ProcessEvent(event
) )
2161 DoUpdateWindowUI(event
);
2164 if (flags
& wxUPDATE_UI_RECURSE
)
2166 wxWindowList
::compatibility_iterator node
= GetChildren().GetFirst();
2169 wxWindow
* child
= (wxWindow
*) node
->GetData();
2170 child
->UpdateWindowUI(flags
);
2171 node
= node
->GetNext();
2176 // do the window-specific processing after processing the update event
2177 void wxWindowBase
::DoUpdateWindowUI(wxUpdateUIEvent
& event
)
2179 if ( event
.GetSetEnabled() )
2180 Enable(event
.GetEnabled());
2182 if ( event
.GetSetShown() )
2183 Show(event
.GetShown());
2186 // ----------------------------------------------------------------------------
2187 // dialog units translations
2188 // ----------------------------------------------------------------------------
2190 wxPoint wxWindowBase
::ConvertPixelsToDialog(const wxPoint
& pt
)
2192 int charWidth
= GetCharWidth();
2193 int charHeight
= GetCharHeight();
2194 wxPoint pt2
= wxDefaultPosition
;
2195 if (pt
.x
!= wxDefaultCoord
)
2196 pt2
.x
= (int) ((pt
.x
* 4) / charWidth
);
2197 if (pt
.y
!= wxDefaultCoord
)
2198 pt2
.y
= (int) ((pt
.y
* 8) / charHeight
);
2203 wxPoint wxWindowBase
::ConvertDialogToPixels(const wxPoint
& pt
)
2205 int charWidth
= GetCharWidth();
2206 int charHeight
= GetCharHeight();
2207 wxPoint pt2
= wxDefaultPosition
;
2208 if (pt
.x
!= wxDefaultCoord
)
2209 pt2
.x
= (int) ((pt
.x
* charWidth
) / 4);
2210 if (pt
.y
!= wxDefaultCoord
)
2211 pt2
.y
= (int) ((pt
.y
* charHeight
) / 8);
2216 // ----------------------------------------------------------------------------
2218 // ----------------------------------------------------------------------------
2220 // propagate the colour change event to the subwindows
2221 void wxWindowBase
::OnSysColourChanged(wxSysColourChangedEvent
& event
)
2223 wxWindowList
::compatibility_iterator node
= GetChildren().GetFirst();
2226 // Only propagate to non-top-level windows
2227 wxWindow
*win
= node
->GetData();
2228 if ( !win
->IsTopLevel() )
2230 wxSysColourChangedEvent event2
;
2231 event
.SetEventObject(win
);
2232 win
->GetEventHandler()->ProcessEvent(event2
);
2235 node
= node
->GetNext();
2241 // the default action is to populate dialog with data when it's created,
2242 // and nudge the UI into displaying itself correctly in case
2243 // we've turned the wxUpdateUIEvents frequency down low.
2244 void wxWindowBase
::OnInitDialog( wxInitDialogEvent
&WXUNUSED(event
) )
2246 TransferDataToWindow();
2248 // Update the UI at this point
2249 UpdateWindowUI(wxUPDATE_UI_RECURSE
);
2252 // ----------------------------------------------------------------------------
2253 // menu-related functions
2254 // ----------------------------------------------------------------------------
2258 bool wxWindowBase
::PopupMenu(wxMenu
*menu
, int x
, int y
)
2260 wxCHECK_MSG( menu
, false, "can't popup NULL menu" );
2262 wxCurrentPopupMenu
= menu
;
2263 const bool rc
= DoPopupMenu(menu
, x
, y
);
2264 wxCurrentPopupMenu
= NULL
;
2269 // this is used to pass the id of the selected item from the menu event handler
2270 // to the main function itself
2272 // it's ok to use a global here as there can be at most one popup menu shown at
2274 static int gs_popupMenuSelection
= wxID_NONE
;
2276 void wxWindowBase
::InternalOnPopupMenu(wxCommandEvent
& event
)
2278 // store the id in a global variable where we'll retrieve it from later
2279 gs_popupMenuSelection
= event
.GetId();
2283 wxWindowBase
::DoGetPopupMenuSelectionFromUser(wxMenu
& menu
, int x
, int y
)
2285 gs_popupMenuSelection
= wxID_NONE
;
2287 Connect(wxEVT_COMMAND_MENU_SELECTED
,
2288 wxCommandEventHandler(wxWindowBase
::InternalOnPopupMenu
),
2292 PopupMenu(&menu
, x
, y
);
2294 Disconnect(wxEVT_COMMAND_MENU_SELECTED
,
2295 wxCommandEventHandler(wxWindowBase
::InternalOnPopupMenu
),
2299 return gs_popupMenuSelection
;
2302 #endif // wxUSE_MENUS
2304 // methods for drawing the sizers in a visible way
2307 static void DrawSizers(wxWindowBase
*win
);
2309 static void DrawBorder(wxWindowBase
*win
, const wxRect
& rect
, bool fill
= false)
2311 wxClientDC
dc((wxWindow
*)win
);
2312 dc
.SetPen(*wxRED_PEN
);
2313 dc
.SetBrush(fill ?
wxBrush(*wxRED
, wxCROSSDIAG_HATCH
): *wxTRANSPARENT_BRUSH
);
2314 dc
.DrawRectangle(rect
.Deflate(1, 1));
2317 static void DrawSizer(wxWindowBase
*win
, wxSizer
*sizer
)
2319 const wxSizerItemList
& items
= sizer
->GetChildren();
2320 for ( wxSizerItemList
::const_iterator i
= items
.begin(),
2325 wxSizerItem
*item
= *i
;
2326 if ( item
->IsSizer() )
2328 DrawBorder(win
, item
->GetRect().Deflate(2));
2329 DrawSizer(win
, item
->GetSizer());
2331 else if ( item
->IsSpacer() )
2333 DrawBorder(win
, item
->GetRect().Deflate(2), true);
2335 else if ( item
->IsWindow() )
2337 DrawSizers(item
->GetWindow());
2342 static void DrawSizers(wxWindowBase
*win
)
2344 wxSizer
*sizer
= win
->GetSizer();
2347 DrawBorder(win
, win
->GetClientSize());
2348 DrawSizer(win
, sizer
);
2350 else // no sizer, still recurse into the children
2352 const wxWindowList
& children
= win
->GetChildren();
2353 for ( wxWindowList
::const_iterator i
= children
.begin(),
2354 end
= children
.end();
2363 #endif // __WXDEBUG__
2365 // process special middle clicks
2366 void wxWindowBase
::OnMiddleClick( wxMouseEvent
& event
)
2368 if ( event
.ControlDown() && event
.AltDown() )
2371 // Ctrl-Alt-Shift-mclick makes the sizers visible in debug builds
2372 if ( event
.ShiftDown() )
2377 #endif // __WXDEBUG__
2378 ::wxInfoMessageBox((wxWindow
*)this);
2386 // ----------------------------------------------------------------------------
2388 // ----------------------------------------------------------------------------
2390 #if wxUSE_ACCESSIBILITY
2391 void wxWindowBase
::SetAccessible(wxAccessible
* accessible
)
2393 if (m_accessible
&& (accessible
!= m_accessible
))
2394 delete m_accessible
;
2395 m_accessible
= accessible
;
2397 m_accessible
->SetWindow((wxWindow
*) this);
2400 // Returns the accessible object, creating if necessary.
2401 wxAccessible
* wxWindowBase
::GetOrCreateAccessible()
2404 m_accessible
= CreateAccessible();
2405 return m_accessible
;
2408 // Override to create a specific accessible object.
2409 wxAccessible
* wxWindowBase
::CreateAccessible()
2411 return new wxWindowAccessible((wxWindow
*) this);
2416 // ----------------------------------------------------------------------------
2417 // list classes implementation
2418 // ----------------------------------------------------------------------------
2422 #include "wx/listimpl.cpp"
2423 WX_DEFINE_LIST(wxWindowList
)
2427 void wxWindowListNode
::DeleteData()
2429 delete (wxWindow
*)GetData();
2432 #endif // wxUSE_STL/!wxUSE_STL
2434 // ----------------------------------------------------------------------------
2436 // ----------------------------------------------------------------------------
2438 wxBorder wxWindowBase
::GetBorder(long flags
) const
2440 wxBorder border
= (wxBorder
)(flags
& wxBORDER_MASK
);
2441 if ( border
== wxBORDER_DEFAULT
)
2443 border
= GetDefaultBorder();
2445 else if ( border
== wxBORDER_THEME
)
2447 border
= GetDefaultBorderForControl();
2453 wxBorder wxWindowBase
::GetDefaultBorder() const
2455 return wxBORDER_NONE
;
2458 // ----------------------------------------------------------------------------
2460 // ----------------------------------------------------------------------------
2462 wxHitTest wxWindowBase
::DoHitTest(wxCoord x
, wxCoord y
) const
2464 // here we just check if the point is inside the window or not
2466 // check the top and left border first
2467 bool outside
= x
< 0 || y
< 0;
2470 // check the right and bottom borders too
2471 wxSize size
= GetSize();
2472 outside
= x
>= size
.x
|| y
>= size
.y
;
2475 return outside ? wxHT_WINDOW_OUTSIDE
: wxHT_WINDOW_INSIDE
;
2478 // ----------------------------------------------------------------------------
2480 // ----------------------------------------------------------------------------
2482 struct WXDLLEXPORT wxWindowNext
2486 } *wxWindowBase
::ms_winCaptureNext
= NULL
;
2487 wxWindow
*wxWindowBase
::ms_winCaptureCurrent
= NULL
;
2488 bool wxWindowBase
::ms_winCaptureChanging
= false;
2490 void wxWindowBase
::CaptureMouse()
2492 wxLogTrace(_T("mousecapture"), _T("CaptureMouse(%p)"), wx_static_cast(void*, this));
2494 wxASSERT_MSG( !ms_winCaptureChanging
, _T("recursive CaptureMouse call?") );
2496 ms_winCaptureChanging
= true;
2498 wxWindow
*winOld
= GetCapture();
2501 ((wxWindowBase
*) winOld
)->DoReleaseMouse();
2504 wxWindowNext
*item
= new wxWindowNext
;
2506 item
->next
= ms_winCaptureNext
;
2507 ms_winCaptureNext
= item
;
2509 //else: no mouse capture to save
2512 ms_winCaptureCurrent
= (wxWindow
*)this;
2514 ms_winCaptureChanging
= false;
2517 void wxWindowBase
::ReleaseMouse()
2519 wxLogTrace(_T("mousecapture"), _T("ReleaseMouse(%p)"), wx_static_cast(void*, this));
2521 wxASSERT_MSG( !ms_winCaptureChanging
, _T("recursive ReleaseMouse call?") );
2523 wxASSERT_MSG( GetCapture() == this, wxT("attempt to release mouse, but this window hasn't captured it") );
2525 ms_winCaptureChanging
= true;
2528 ms_winCaptureCurrent
= NULL
;
2530 if ( ms_winCaptureNext
)
2532 ((wxWindowBase
*)ms_winCaptureNext
->win
)->DoCaptureMouse();
2533 ms_winCaptureCurrent
= ms_winCaptureNext
->win
;
2535 wxWindowNext
*item
= ms_winCaptureNext
;
2536 ms_winCaptureNext
= item
->next
;
2539 //else: stack is empty, no previous capture
2541 ms_winCaptureChanging
= false;
2543 wxLogTrace(_T("mousecapture"),
2544 (const wxChar
*) _T("After ReleaseMouse() mouse is captured by %p"),
2545 wx_static_cast(void*, GetCapture()));
2548 static void DoNotifyWindowAboutCaptureLost(wxWindow
*win
)
2550 wxMouseCaptureLostEvent
event(win
->GetId());
2551 event
.SetEventObject(win
);
2552 if ( !win
->GetEventHandler()->ProcessEvent(event
) )
2554 // windows must handle this event, otherwise the app wouldn't behave
2555 // correctly if it loses capture unexpectedly; see the discussion here:
2556 // http://sourceforge.net/tracker/index.php?func=detail&aid=1153662&group_id=9863&atid=109863
2557 // http://article.gmane.org/gmane.comp.lib.wxwidgets.devel/82376
2558 wxFAIL_MSG( _T("window that captured the mouse didn't process wxEVT_MOUSE_CAPTURE_LOST") );
2563 void wxWindowBase
::NotifyCaptureLost()
2565 // don't do anything if capture lost was expected, i.e. resulted from
2566 // a wx call to ReleaseMouse or CaptureMouse:
2567 if ( ms_winCaptureChanging
)
2570 // if the capture was lost unexpectedly, notify every window that has
2571 // capture (on stack or current) about it and clear the stack:
2573 if ( ms_winCaptureCurrent
)
2575 DoNotifyWindowAboutCaptureLost(ms_winCaptureCurrent
);
2576 ms_winCaptureCurrent
= NULL
;
2579 while ( ms_winCaptureNext
)
2581 wxWindowNext
*item
= ms_winCaptureNext
;
2582 ms_winCaptureNext
= item
->next
;
2584 DoNotifyWindowAboutCaptureLost(item
->win
);
2593 wxWindowBase
::RegisterHotKey(int WXUNUSED(hotkeyId
),
2594 int WXUNUSED(modifiers
),
2595 int WXUNUSED(keycode
))
2601 bool wxWindowBase
::UnregisterHotKey(int WXUNUSED(hotkeyId
))
2607 #endif // wxUSE_HOTKEY
2609 // ----------------------------------------------------------------------------
2611 // ----------------------------------------------------------------------------
2613 bool wxWindowBase
::TryValidator(wxEvent
& wxVALIDATOR_PARAM(event
))
2615 #if wxUSE_VALIDATORS
2616 // Can only use the validator of the window which
2617 // is receiving the event
2618 if ( event
.GetEventObject() == this )
2620 wxValidator
*validator
= GetValidator();
2621 if ( validator
&& validator
->ProcessEvent(event
) )
2626 #endif // wxUSE_VALIDATORS
2631 bool wxWindowBase
::TryParent(wxEvent
& event
)
2633 // carry on up the parent-child hierarchy if the propagation count hasn't
2635 if ( event
.ShouldPropagate() )
2637 // honour the requests to stop propagation at this window: this is
2638 // used by the dialogs, for example, to prevent processing the events
2639 // from the dialog controls in the parent frame which rarely, if ever,
2641 if ( !(GetExtraStyle() & wxWS_EX_BLOCK_EVENTS
) )
2643 wxWindow
*parent
= GetParent();
2644 if ( parent
&& !parent
->IsBeingDeleted() )
2646 wxPropagateOnce
propagateOnce(event
);
2648 return parent
->GetEventHandler()->ProcessEvent(event
);
2653 return wxEvtHandler
::TryParent(event
);
2656 // ----------------------------------------------------------------------------
2657 // window relationships
2658 // ----------------------------------------------------------------------------
2660 wxWindow
*wxWindowBase
::DoGetSibling(WindowOrder order
) const
2662 wxCHECK_MSG( GetParent(), NULL
,
2663 _T("GetPrev/NextSibling() don't work for TLWs!") );
2665 wxWindowList
& siblings
= GetParent()->GetChildren();
2666 wxWindowList
::compatibility_iterator i
= siblings
.Find((wxWindow
*)this);
2667 wxCHECK_MSG( i
, NULL
, _T("window not a child of its parent?") );
2669 if ( order
== OrderBefore
)
2670 i
= i
->GetPrevious();
2674 return i ? i
->GetData() : NULL
;
2677 // ----------------------------------------------------------------------------
2678 // keyboard navigation
2679 // ----------------------------------------------------------------------------
2681 // Navigates in the specified direction inside this window
2682 bool wxWindowBase
::DoNavigateIn(int flags
)
2684 #ifdef wxHAS_NATIVE_TAB_TRAVERSAL
2685 // native code doesn't process our wxNavigationKeyEvents anyhow
2688 #else // !wxHAS_NATIVE_TAB_TRAVERSAL
2689 wxNavigationKeyEvent eventNav
;
2690 eventNav
.SetFlags(flags
);
2691 eventNav
.SetEventObject(FindFocus());
2692 return GetEventHandler()->ProcessEvent(eventNav
);
2693 #endif // wxHAS_NATIVE_TAB_TRAVERSAL/!wxHAS_NATIVE_TAB_TRAVERSAL
2696 void wxWindowBase
::DoMoveInTabOrder(wxWindow
*win
, WindowOrder move
)
2698 // check that we're not a top level window
2699 wxCHECK_RET( GetParent(),
2700 _T("MoveBefore/AfterInTabOrder() don't work for TLWs!") );
2702 // detect the special case when we have nothing to do anyhow and when the
2703 // code below wouldn't work
2707 // find the target window in the siblings list
2708 wxWindowList
& siblings
= GetParent()->GetChildren();
2709 wxWindowList
::compatibility_iterator i
= siblings
.Find(win
);
2710 wxCHECK_RET( i
, _T("MoveBefore/AfterInTabOrder(): win is not a sibling") );
2712 // unfortunately, when wxUSE_STL == 1 DetachNode() is not implemented so we
2713 // can't just move the node around
2714 wxWindow
*self
= (wxWindow
*)this;
2715 siblings
.DeleteObject(self
);
2716 if ( move
== OrderAfter
)
2723 siblings
.Insert(i
, self
);
2725 else // OrderAfter and win was the last sibling
2727 siblings
.Append(self
);
2731 // ----------------------------------------------------------------------------
2733 // ----------------------------------------------------------------------------
2735 /*static*/ wxWindow
* wxWindowBase
::FindFocus()
2737 wxWindowBase
*win
= DoFindFocus();
2738 return win ? win
->GetMainWindowOfCompositeControl() : NULL
;
2741 // ----------------------------------------------------------------------------
2743 // ----------------------------------------------------------------------------
2745 wxWindow
* wxGetTopLevelParent(wxWindow
*win
)
2747 while ( win
&& !win
->IsTopLevel() )
2748 win
= win
->GetParent();
2753 #if wxUSE_ACCESSIBILITY
2754 // ----------------------------------------------------------------------------
2755 // accessible object for windows
2756 // ----------------------------------------------------------------------------
2758 // Can return either a child object, or an integer
2759 // representing the child element, starting from 1.
2760 wxAccStatus wxWindowAccessible
::HitTest(const wxPoint
& WXUNUSED(pt
), int* WXUNUSED(childId
), wxAccessible
** WXUNUSED(childObject
))
2762 wxASSERT( GetWindow() != NULL
);
2766 return wxACC_NOT_IMPLEMENTED
;
2769 // Returns the rectangle for this object (id = 0) or a child element (id > 0).
2770 wxAccStatus wxWindowAccessible
::GetLocation(wxRect
& rect
, int elementId
)
2772 wxASSERT( GetWindow() != NULL
);
2776 wxWindow
* win
= NULL
;
2783 if (elementId
<= (int) GetWindow()->GetChildren().GetCount())
2785 win
= GetWindow()->GetChildren().Item(elementId
-1)->GetData();
2792 rect
= win
->GetRect();
2793 if (win
->GetParent() && !win
->IsKindOf(CLASSINFO(wxTopLevelWindow
)))
2794 rect
.SetPosition(win
->GetParent()->ClientToScreen(rect
.GetPosition()));
2798 return wxACC_NOT_IMPLEMENTED
;
2801 // Navigates from fromId to toId/toObject.
2802 wxAccStatus wxWindowAccessible
::Navigate(wxNavDir navDir
, int fromId
,
2803 int* WXUNUSED(toId
), wxAccessible
** toObject
)
2805 wxASSERT( GetWindow() != NULL
);
2811 case wxNAVDIR_FIRSTCHILD
:
2813 if (GetWindow()->GetChildren().GetCount() == 0)
2815 wxWindow
* childWindow
= (wxWindow
*) GetWindow()->GetChildren().GetFirst()->GetData();
2816 *toObject
= childWindow
->GetOrCreateAccessible();
2820 case wxNAVDIR_LASTCHILD
:
2822 if (GetWindow()->GetChildren().GetCount() == 0)
2824 wxWindow
* childWindow
= (wxWindow
*) GetWindow()->GetChildren().GetLast()->GetData();
2825 *toObject
= childWindow
->GetOrCreateAccessible();
2829 case wxNAVDIR_RIGHT
:
2833 wxWindowList
::compatibility_iterator node
=
2834 wxWindowList
::compatibility_iterator();
2837 // Can't navigate to sibling of this window
2838 // if we're a top-level window.
2839 if (!GetWindow()->GetParent())
2840 return wxACC_NOT_IMPLEMENTED
;
2842 node
= GetWindow()->GetParent()->GetChildren().Find(GetWindow());
2846 if (fromId
<= (int) GetWindow()->GetChildren().GetCount())
2847 node
= GetWindow()->GetChildren().Item(fromId
-1);
2850 if (node
&& node
->GetNext())
2852 wxWindow
* nextWindow
= node
->GetNext()->GetData();
2853 *toObject
= nextWindow
->GetOrCreateAccessible();
2861 case wxNAVDIR_PREVIOUS
:
2863 wxWindowList
::compatibility_iterator node
=
2864 wxWindowList
::compatibility_iterator();
2867 // Can't navigate to sibling of this window
2868 // if we're a top-level window.
2869 if (!GetWindow()->GetParent())
2870 return wxACC_NOT_IMPLEMENTED
;
2872 node
= GetWindow()->GetParent()->GetChildren().Find(GetWindow());
2876 if (fromId
<= (int) GetWindow()->GetChildren().GetCount())
2877 node
= GetWindow()->GetChildren().Item(fromId
-1);
2880 if (node
&& node
->GetPrevious())
2882 wxWindow
* previousWindow
= node
->GetPrevious()->GetData();
2883 *toObject
= previousWindow
->GetOrCreateAccessible();
2891 return wxACC_NOT_IMPLEMENTED
;
2894 // Gets the name of the specified object.
2895 wxAccStatus wxWindowAccessible
::GetName(int childId
, wxString
* name
)
2897 wxASSERT( GetWindow() != NULL
);
2903 // If a child, leave wxWidgets to call the function on the actual
2906 return wxACC_NOT_IMPLEMENTED
;
2908 // This will eventually be replaced by specialised
2909 // accessible classes, one for each kind of wxWidgets
2910 // control or window.
2912 if (GetWindow()->IsKindOf(CLASSINFO(wxButton
)))
2913 title
= ((wxButton
*) GetWindow())->GetLabel();
2916 title
= GetWindow()->GetName();
2924 return wxACC_NOT_IMPLEMENTED
;
2927 // Gets the number of children.
2928 wxAccStatus wxWindowAccessible
::GetChildCount(int* childId
)
2930 wxASSERT( GetWindow() != NULL
);
2934 *childId
= (int) GetWindow()->GetChildren().GetCount();
2938 // Gets the specified child (starting from 1).
2939 // If *child is NULL and return value is wxACC_OK,
2940 // this means that the child is a simple element and
2941 // not an accessible object.
2942 wxAccStatus wxWindowAccessible
::GetChild(int childId
, wxAccessible
** child
)
2944 wxASSERT( GetWindow() != NULL
);
2954 if (childId
> (int) GetWindow()->GetChildren().GetCount())
2957 wxWindow
* childWindow
= GetWindow()->GetChildren().Item(childId
-1)->GetData();
2958 *child
= childWindow
->GetOrCreateAccessible();
2965 // Gets the parent, or NULL.
2966 wxAccStatus wxWindowAccessible
::GetParent(wxAccessible
** parent
)
2968 wxASSERT( GetWindow() != NULL
);
2972 wxWindow
* parentWindow
= GetWindow()->GetParent();
2980 *parent
= parentWindow
->GetOrCreateAccessible();
2988 // Performs the default action. childId is 0 (the action for this object)
2989 // or > 0 (the action for a child).
2990 // Return wxACC_NOT_SUPPORTED if there is no default action for this
2991 // window (e.g. an edit control).
2992 wxAccStatus wxWindowAccessible
::DoDefaultAction(int WXUNUSED(childId
))
2994 wxASSERT( GetWindow() != NULL
);
2998 return wxACC_NOT_IMPLEMENTED
;
3001 // Gets the default action for this object (0) or > 0 (the action for a child).
3002 // Return wxACC_OK even if there is no action. actionName is the action, or the empty
3003 // string if there is no action.
3004 // The retrieved string describes the action that is performed on an object,
3005 // not what the object does as a result. For example, a toolbar button that prints
3006 // a document has a default action of "Press" rather than "Prints the current document."
3007 wxAccStatus wxWindowAccessible
::GetDefaultAction(int WXUNUSED(childId
), wxString
* WXUNUSED(actionName
))
3009 wxASSERT( GetWindow() != NULL
);
3013 return wxACC_NOT_IMPLEMENTED
;
3016 // Returns the description for this object or a child.
3017 wxAccStatus wxWindowAccessible
::GetDescription(int WXUNUSED(childId
), wxString
* description
)
3019 wxASSERT( GetWindow() != NULL
);
3023 wxString
ht(GetWindow()->GetHelpTextAtPoint(wxDefaultPosition
, wxHelpEvent
::Origin_Keyboard
));
3029 return wxACC_NOT_IMPLEMENTED
;
3032 // Returns help text for this object or a child, similar to tooltip text.
3033 wxAccStatus wxWindowAccessible
::GetHelpText(int WXUNUSED(childId
), wxString
* helpText
)
3035 wxASSERT( GetWindow() != NULL
);
3039 wxString
ht(GetWindow()->GetHelpTextAtPoint(wxDefaultPosition
, wxHelpEvent
::Origin_Keyboard
));
3045 return wxACC_NOT_IMPLEMENTED
;
3048 // Returns the keyboard shortcut for this object or child.
3049 // Return e.g. ALT+K
3050 wxAccStatus wxWindowAccessible
::GetKeyboardShortcut(int WXUNUSED(childId
), wxString
* WXUNUSED(shortcut
))
3052 wxASSERT( GetWindow() != NULL
);
3056 return wxACC_NOT_IMPLEMENTED
;
3059 // Returns a role constant.
3060 wxAccStatus wxWindowAccessible
::GetRole(int childId
, wxAccRole
* role
)
3062 wxASSERT( GetWindow() != NULL
);
3066 // If a child, leave wxWidgets to call the function on the actual
3069 return wxACC_NOT_IMPLEMENTED
;
3071 if (GetWindow()->IsKindOf(CLASSINFO(wxControl
)))
3072 return wxACC_NOT_IMPLEMENTED
;
3074 if (GetWindow()->IsKindOf(CLASSINFO(wxStatusBar
)))
3075 return wxACC_NOT_IMPLEMENTED
;
3078 if (GetWindow()->IsKindOf(CLASSINFO(wxToolBar
)))
3079 return wxACC_NOT_IMPLEMENTED
;
3082 //*role = wxROLE_SYSTEM_CLIENT;
3083 *role
= wxROLE_SYSTEM_CLIENT
;
3087 return wxACC_NOT_IMPLEMENTED
;
3091 // Returns a state constant.
3092 wxAccStatus wxWindowAccessible
::GetState(int childId
, long* state
)
3094 wxASSERT( GetWindow() != NULL
);
3098 // If a child, leave wxWidgets to call the function on the actual
3101 return wxACC_NOT_IMPLEMENTED
;
3103 if (GetWindow()->IsKindOf(CLASSINFO(wxControl
)))
3104 return wxACC_NOT_IMPLEMENTED
;
3107 if (GetWindow()->IsKindOf(CLASSINFO(wxStatusBar
)))
3108 return wxACC_NOT_IMPLEMENTED
;
3111 if (GetWindow()->IsKindOf(CLASSINFO(wxToolBar
)))
3112 return wxACC_NOT_IMPLEMENTED
;
3119 return wxACC_NOT_IMPLEMENTED
;
3123 // Returns a localized string representing the value for the object
3125 wxAccStatus wxWindowAccessible
::GetValue(int WXUNUSED(childId
), wxString
* WXUNUSED(strValue
))
3127 wxASSERT( GetWindow() != NULL
);
3131 return wxACC_NOT_IMPLEMENTED
;
3134 // Selects the object or child.
3135 wxAccStatus wxWindowAccessible
::Select(int WXUNUSED(childId
), wxAccSelectionFlags
WXUNUSED(selectFlags
))
3137 wxASSERT( GetWindow() != NULL
);
3141 return wxACC_NOT_IMPLEMENTED
;
3144 // Gets the window with the keyboard focus.
3145 // If childId is 0 and child is NULL, no object in
3146 // this subhierarchy has the focus.
3147 // If this object has the focus, child should be 'this'.
3148 wxAccStatus wxWindowAccessible
::GetFocus(int* WXUNUSED(childId
), wxAccessible
** WXUNUSED(child
))
3150 wxASSERT( GetWindow() != NULL
);
3154 return wxACC_NOT_IMPLEMENTED
;
3158 // Gets a variant representing the selected children
3160 // Acceptable values:
3161 // - a null variant (IsNull() returns true)
3162 // - a list variant (GetType() == wxT("list")
3163 // - an integer representing the selected child element,
3164 // or 0 if this object is selected (GetType() == wxT("long")
3165 // - a "void*" pointer to a wxAccessible child object
3166 wxAccStatus wxWindowAccessible
::GetSelections(wxVariant
* WXUNUSED(selections
))
3168 wxASSERT( GetWindow() != NULL
);
3172 return wxACC_NOT_IMPLEMENTED
;
3174 #endif // wxUSE_VARIANT
3176 #endif // wxUSE_ACCESSIBILITY
3178 // ----------------------------------------------------------------------------
3180 // ----------------------------------------------------------------------------
3183 wxWindowBase
::AdjustForLayoutDirection(wxCoord x
,
3185 wxCoord widthTotal
) const
3187 if ( GetLayoutDirection() == wxLayout_RightToLeft
)
3189 x
= widthTotal
- x
- width
;
3195 // ----------------------------------------------------------------------------
3196 // Window (and menu items) identifiers management
3197 // ----------------------------------------------------------------------------
3202 // this array contains, in packed form, the "in use" flags for the entire
3203 // auto-generated ids range: N-th element of the array contains the flags for
3204 // ids in [wxID_AUTO_LOWEST + 8*N, wxID_AUTO_LOWEST + 8*N + 7] range
3206 // initially no ids are in use and we allocate them consecutively, but after we
3207 // exhaust the entire range, we wrap around and reuse the ids freed in the
3209 wxByte gs_autoIdsInUse
[(wxID_AUTO_HIGHEST
- wxID_AUTO_LOWEST
+ 1)/8 + 1] = { 0 };
3211 // this is an optimization used until we wrap around wxID_AUTO_HIGHEST: if this
3212 // value is < wxID_AUTO_HIGHEST we know that we haven't wrapped yet and so can
3213 // allocate the ids simply by incrementing it
3214 static wxWindowID gs_nextControlId
= wxID_AUTO_LOWEST
;
3216 void MarkAutoIdUsed(wxWindowID id
)
3218 id
-= wxID_AUTO_LOWEST
;
3220 const int theByte
= id
/ 8;
3221 const int theBit
= id
% 8;
3223 gs_autoIdsInUse
[theByte
] |= 1 << theBit
;
3226 void FreeAutoId(wxWindowID id
)
3228 id
-= wxID_AUTO_LOWEST
;
3230 const int theByte
= id
/ 8;
3231 const int theBit
= id
% 8;
3233 gs_autoIdsInUse
[theByte
] &= ~(1 << theBit
);
3236 bool IsAutoIdInUse(wxWindowID id
)
3238 id
-= wxID_AUTO_LOWEST
;
3240 const int theByte
= id
/ 8;
3241 const int theBit
= id
% 8;
3243 return (gs_autoIdsInUse
[theByte
] & (1 << theBit
)) != 0;
3246 } // anonymous namespace
3250 bool wxWindowBase
::IsAutoGeneratedId(wxWindowID id
)
3252 if ( id
< wxID_AUTO_LOWEST
|| id
> wxID_AUTO_HIGHEST
)
3255 // we shouldn't have any stray ids in this range
3256 wxASSERT_MSG( IsAutoIdInUse(id
), "unused automatically generated id?" );
3261 wxWindowID wxWindowBase
::NewControlId(int count
)
3263 wxASSERT_MSG( count
> 0, "can't allocate less than 1 id" );
3265 if ( gs_nextControlId
+ count
- 1 <= wxID_AUTO_HIGHEST
)
3267 // we haven't wrapped yet, so we can just grab the next count ids
3268 wxWindowID id
= gs_nextControlId
;
3271 MarkAutoIdUsed(gs_nextControlId
++);
3275 else // we've already wrapped or are now going to
3277 // brute-force search for the id values
3279 // number of consecutive free ids found so far
3282 for ( wxWindowID id
= wxID_AUTO_LOWEST
; id
<= wxID_AUTO_HIGHEST
; id
++ )
3284 if ( !IsAutoIdInUse(id
) )
3286 // found another consecutive available id
3288 if ( found
== count
)
3290 // mark all count consecutive free ids we found as being in
3291 // use now and rewind back to the start of available range
3294 MarkAutoIdUsed(id
--);
3299 else // this id is in use
3301 // reset the number of consecutive free values found
3307 // if we get here, there are not enough consecutive free ids
3311 void wxWindowBase
::ReleaseControlId(wxWindowID id
)
3313 wxCHECK_RET( IsAutoGeneratedId(id
), "can't release non auto-generated id" );