1 /////////////////////////////////////////////////////////////////////////////
2 // Name: common/window.cpp
3 // Purpose: common (to all ports) wxWindow functions
4 // Author: Julian Smart, Vadim Zeitlin
8 // Copyright: (c) wxWindows team
9 // Licence: wxWindows license
10 /////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
21 #pragma implementation "windowbase.h"
24 // For compilers that support precompilation, includes "wx.h".
25 #include "wx/wxprec.h"
32 #include "wx/string.h"
37 #include "wx/window.h"
38 #include "wx/checkbox.h"
39 #include "wx/radiobut.h"
40 #include "wx/textctrl.h"
41 #include "wx/settings.h"
42 #include "wx/dialog.h"
43 #include "wx/msgdlg.h"
44 #include "wx/statusbr.h"
48 #include "wx/layout.h"
50 #endif // wxUSE_CONSTRAINTS
52 #if wxUSE_DRAG_AND_DROP
54 #endif // wxUSE_DRAG_AND_DROP
57 #include "wx/cshelp.h"
61 #include "wx/tooltip.h"
62 #endif // wxUSE_TOOLTIPS
68 // ----------------------------------------------------------------------------
70 // ----------------------------------------------------------------------------
72 int wxWindowBase::ms_lastControlId
= -200;
74 IMPLEMENT_ABSTRACT_CLASS(wxWindowBase
, wxEvtHandler
)
76 // ----------------------------------------------------------------------------
78 // ----------------------------------------------------------------------------
80 BEGIN_EVENT_TABLE(wxWindowBase
, wxEvtHandler
)
81 EVT_SYS_COLOUR_CHANGED(wxWindowBase::OnSysColourChanged
)
82 EVT_INIT_DIALOG(wxWindowBase::OnInitDialog
)
83 EVT_MIDDLE_DOWN(wxWindowBase::OnMiddleClick
)
86 EVT_HELP(-1, wxWindowBase::OnHelp
)
91 // ============================================================================
92 // implementation of the common functionality of the wxWindow class
93 // ============================================================================
95 // ----------------------------------------------------------------------------
97 // ----------------------------------------------------------------------------
99 // the default initialization
100 void wxWindowBase::InitBase()
102 // no window yet, no parent nor children
103 m_parent
= (wxWindow
*)NULL
;
105 m_children
.DeleteContents( FALSE
); // don't auto delete node data
107 // no constraints on the minimal window size
113 // window is created enabled but it's not visible yet
117 // no client data (yet)
119 m_clientDataType
= ClientData_None
;
121 // the default event handler is just this window
122 m_eventHandler
= this;
126 m_windowValidator
= (wxValidator
*) NULL
;
127 #endif // wxUSE_VALIDATORS
129 // use the system default colours
130 wxSystemSettings settings
;
132 m_backgroundColour
= settings
.GetSystemColour(wxSYS_COLOUR_BTNFACE
);
133 // m_foregroundColour = *wxBLACK; // TODO take this from sys settings too?
134 m_foregroundColour
= wxSystemSettings::GetSystemColour(wxSYS_COLOUR_WINDOWTEXT
);
136 // GRG, changed Mar/2000
137 m_font
= settings
.GetSystemFont(wxSYS_DEFAULT_GUI_FONT
);
142 // an optimization for the event processing: checking this flag is much
143 // faster than using IsKindOf(CLASSINFO(wxWindow))
146 #if wxUSE_CONSTRAINTS
147 // no constraints whatsoever
148 m_constraints
= (wxLayoutConstraints
*) NULL
;
149 m_constraintsInvolvedIn
= (wxWindowList
*) NULL
;
150 m_windowSizer
= (wxSizer
*) NULL
;
151 m_autoLayout
= FALSE
;
152 #endif // wxUSE_CONSTRAINTS
154 #if wxUSE_DRAG_AND_DROP
155 m_dropTarget
= (wxDropTarget
*)NULL
;
156 #endif // wxUSE_DRAG_AND_DROP
159 m_tooltip
= (wxToolTip
*)NULL
;
160 #endif // wxUSE_TOOLTIPS
163 m_caret
= (wxCaret
*)NULL
;
164 #endif // wxUSE_CARET
166 // Whether we're using the current theme for this window (wxGTK only for now)
167 m_themeEnabled
= FALSE
;
170 // common part of window creation process
171 bool wxWindowBase::CreateBase(wxWindowBase
*parent
,
173 const wxPoint
& WXUNUSED(pos
),
174 const wxSize
& WXUNUSED(size
),
176 const wxValidator
& validator
,
177 const wxString
& name
)
179 // m_isWindow is set to TRUE in wxWindowBase::Init() as well as many other
180 // member variables - check that it has been called (will catch the case
181 // when a new ctor is added which doesn't call InitWindow)
182 wxASSERT_MSG( m_isWindow
, wxT("Init() must have been called before!") );
184 // generate a new id if the user doesn't care about it
185 m_windowId
= id
== -1 ? NewControlId() : id
;
188 SetWindowStyleFlag(style
);
192 SetValidator(validator
);
193 #endif // wxUSE_VALIDATORS
195 // if the parent window has wxWS_EX_VALIDATE_RECURSIVELY set, we want to
196 // have it too - like this it's possible to set it only in the top level
197 // dialog/frame and all children will inherit it by defult
198 if ( parent
&& (parent
->GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY
) )
200 SetExtraStyle(wxWS_EX_VALIDATE_RECURSIVELY
);
206 // ----------------------------------------------------------------------------
208 // ----------------------------------------------------------------------------
211 wxWindowBase::~wxWindowBase()
213 // FIXME if these 2 cases result from programming errors in the user code
214 // we should probably assert here instead of silently fixing them
216 // Just in case the window has been Closed, but we're then deleting
217 // immediately: don't leave dangling pointers.
218 wxPendingDelete
.DeleteObject(this);
220 // Just in case we've loaded a top-level window via LoadNativeDialog but
221 // we weren't a dialog class
222 wxTopLevelWindows
.DeleteObject(this);
224 wxASSERT_MSG( GetChildren().GetCount() == 0, wxT("children not destroyed") );
226 // make sure that there are no dangling pointers left pointing to us
227 wxPanel
*panel
= wxDynamicCast(GetParent(), wxPanel
);
230 if ( panel
->GetLastFocus() == this )
232 panel
->SetLastFocus((wxWindow
*)NULL
);
239 #endif // wxUSE_CARET
242 if ( m_windowValidator
)
243 delete m_windowValidator
;
244 #endif // wxUSE_VALIDATORS
246 // we only delete object data, not untyped
247 if ( m_clientDataType
== ClientData_Object
)
248 delete m_clientObject
;
250 #if wxUSE_CONSTRAINTS
251 // Have to delete constraints/sizer FIRST otherwise sizers may try to look
252 // at deleted windows as they delete themselves.
253 DeleteRelatedConstraints();
257 // This removes any dangling pointers to this window in other windows'
258 // constraintsInvolvedIn lists.
259 UnsetConstraints(m_constraints
);
260 delete m_constraints
;
261 m_constraints
= NULL
;
265 delete m_windowSizer
;
267 #endif // wxUSE_CONSTRAINTS
269 #if wxUSE_DRAG_AND_DROP
272 #endif // wxUSE_DRAG_AND_DROP
277 #endif // wxUSE_TOOLTIPS
280 bool wxWindowBase::Destroy()
287 bool wxWindowBase::Close(bool force
)
289 wxCloseEvent
event(wxEVT_CLOSE_WINDOW
, m_windowId
);
290 event
.SetEventObject(this);
291 #if WXWIN_COMPATIBILITY
292 event
.SetForce(force
);
293 #endif // WXWIN_COMPATIBILITY
294 event
.SetCanVeto(!force
);
296 // return FALSE if window wasn't closed because the application vetoed the
298 return GetEventHandler()->ProcessEvent(event
) && !event
.GetVeto();
301 bool wxWindowBase::DestroyChildren()
303 wxWindowList::Node
*node
;
306 // we iterate until the list becomes empty
307 node
= GetChildren().GetFirst();
311 wxWindow
*child
= node
->GetData();
313 wxASSERT_MSG( child
, wxT("children list contains empty nodes") );
317 wxASSERT_MSG( !GetChildren().Find(child
),
318 wxT("child didn't remove itself using RemoveChild()") );
324 // ----------------------------------------------------------------------------
325 // size/position related methods
326 // ----------------------------------------------------------------------------
328 // centre the window with respect to its parent in either (or both) directions
329 void wxWindowBase::Centre(int direction
)
331 // the position/size of the parent window or of the entire screen
333 int widthParent
, heightParent
;
335 wxWindow
*parent
= NULL
;
337 if ( !(direction
& wxCENTRE_ON_SCREEN
) )
339 // find the parent to centre this window on: it should be the
340 // immediate parent for the controls but the top level parent for the
341 // top level windows (like dialogs)
342 parent
= GetParent();
345 while ( parent
&& !parent
->IsTopLevel() )
347 parent
= parent
->GetParent();
351 // did we find the parent?
355 direction
|= wxCENTRE_ON_SCREEN
;
359 if ( direction
& wxCENTRE_ON_SCREEN
)
361 // centre with respect to the whole screen
362 wxDisplaySize(&widthParent
, &heightParent
);
368 // centre on the parent
369 parent
->GetSize(&widthParent
, &heightParent
);
371 // adjust to the parents position
372 posParent
= parent
->GetPosition();
376 // centre inside the parents client rectangle
377 parent
->GetClientSize(&widthParent
, &heightParent
);
382 GetSize(&width
, &height
);
387 if ( direction
& wxHORIZONTAL
)
388 xNew
= (widthParent
- width
)/2;
390 if ( direction
& wxVERTICAL
)
391 yNew
= (heightParent
- height
)/2;
396 // move the centre of this window to this position
400 // fits the window around the children
401 void wxWindowBase::Fit()
403 if ( GetChildren().GetCount() > 0 )
405 wxSize size
= DoGetBestSize();
407 // for compatibility with the old versions and because it really looks
408 // slightly more pretty like this, add a pad
414 //else: do nothing if we have no children
417 // return the size best suited for the current window
418 wxSize
wxWindowBase::DoGetBestSize() const
420 if ( GetChildren().GetCount() > 0 )
422 // our minimal acceptable size is such that all our windows fit inside
426 for ( wxWindowList::Node
*node
= GetChildren().GetFirst();
428 node
= node
->GetNext() )
430 wxWindow
*win
= node
->GetData();
431 if ( win
->IsTopLevel() || wxDynamicCast(win
, wxStatusBar
) || !win
->IsShown())
433 // dialogs and frames lie in different top level windows -
434 // don't deal with them here; as for the status bars, they
435 // don't lie in the client area at all
440 win
->GetPosition(&wx
, &wy
);
442 // if the window hadn't been positioned yet, assume that it is in
449 win
->GetSize(&ww
, &wh
);
450 if ( wx
+ ww
> maxX
)
452 if ( wy
+ wh
> maxY
)
456 return wxSize(maxX
, maxY
);
460 // for a generic window there is no natural best size - just use the
466 // set the min/max size of the window
467 void wxWindowBase::SetSizeHints(int minW
, int minH
,
469 int WXUNUSED(incW
), int WXUNUSED(incH
))
477 // ----------------------------------------------------------------------------
478 // show/hide/enable/disable the window
479 // ----------------------------------------------------------------------------
481 bool wxWindowBase::Show(bool show
)
483 if ( show
!= m_isShown
)
495 bool wxWindowBase::Enable(bool enable
)
497 if ( enable
!= m_isEnabled
)
499 m_isEnabled
= enable
;
508 // ----------------------------------------------------------------------------
510 // ----------------------------------------------------------------------------
512 bool wxWindowBase::IsTopLevel() const
517 // ----------------------------------------------------------------------------
518 // reparenting the window
519 // ----------------------------------------------------------------------------
521 void wxWindowBase::AddChild(wxWindowBase
*child
)
523 wxCHECK_RET( child
, wxT("can't add a NULL child") );
525 // this should never happen and it will lead to a crash later if it does
526 // because RemoveChild() will remove only one node from the children list
527 // and the other(s) one(s) will be left with dangling pointers in them
528 wxASSERT_MSG( !GetChildren().Find(child
), _T("AddChild() called twice") );
530 GetChildren().Append(child
);
531 child
->SetParent(this);
534 void wxWindowBase::RemoveChild(wxWindowBase
*child
)
536 wxCHECK_RET( child
, wxT("can't remove a NULL child") );
538 GetChildren().DeleteObject(child
);
539 child
->SetParent((wxWindow
*)NULL
);
542 bool wxWindowBase::Reparent(wxWindowBase
*newParent
)
544 wxWindow
*oldParent
= GetParent();
545 if ( newParent
== oldParent
)
551 // unlink this window from the existing parent.
554 oldParent
->RemoveChild(this);
558 wxTopLevelWindows
.DeleteObject(this);
561 // add it to the new one
564 newParent
->AddChild(this);
568 wxTopLevelWindows
.Append(this);
574 // ----------------------------------------------------------------------------
575 // event handler stuff
576 // ----------------------------------------------------------------------------
578 void wxWindowBase::PushEventHandler(wxEvtHandler
*handler
)
580 handler
->SetNextHandler(GetEventHandler());
581 SetEventHandler(handler
);
584 wxEvtHandler
*wxWindowBase::PopEventHandler(bool deleteHandler
)
586 wxEvtHandler
*handlerA
= GetEventHandler();
589 wxEvtHandler
*handlerB
= handlerA
->GetNextHandler();
590 handlerA
->SetNextHandler((wxEvtHandler
*)NULL
);
591 SetEventHandler(handlerB
);
595 handlerA
= (wxEvtHandler
*)NULL
;
602 // ----------------------------------------------------------------------------
604 // ----------------------------------------------------------------------------
606 bool wxWindowBase::SetBackgroundColour( const wxColour
&colour
)
608 if ( !colour
.Ok() || (colour
== m_backgroundColour
) )
611 m_backgroundColour
= colour
;
616 bool wxWindowBase::SetForegroundColour( const wxColour
&colour
)
618 if ( !colour
.Ok() || (colour
== m_foregroundColour
) )
621 m_foregroundColour
= colour
;
626 bool wxWindowBase::SetCursor(const wxCursor
& cursor
)
628 // setting an invalid cursor is ok, it means that we don't have any special
630 if ( m_cursor
== cursor
)
641 bool wxWindowBase::SetFont(const wxFont
& font
)
643 // don't try to set invalid font, always fall back to the default
644 const wxFont
& fontOk
= font
.Ok() ? font
: *wxSWISS_FONT
;
646 if ( (wxFont
&)fontOk
== m_font
)
658 void wxWindowBase::SetCaret(wxCaret
*caret
)
669 wxASSERT_MSG( m_caret
->GetWindow() == this,
670 wxT("caret should be created associated to this window") );
673 #endif // wxUSE_CARET
676 // ----------------------------------------------------------------------------
678 // ----------------------------------------------------------------------------
680 void wxWindowBase::SetValidator(const wxValidator
& validator
)
682 if ( m_windowValidator
)
683 delete m_windowValidator
;
685 m_windowValidator
= (wxValidator
*)validator
.Clone();
687 if ( m_windowValidator
)
688 m_windowValidator
->SetWindow(this) ;
690 #endif // wxUSE_VALIDATORS
692 // ----------------------------------------------------------------------------
693 // update region testing
694 // ----------------------------------------------------------------------------
696 bool wxWindowBase::IsExposed(int x
, int y
) const
698 return m_updateRegion
.Contains(x
, y
) != wxOutRegion
;
701 bool wxWindowBase::IsExposed(int x
, int y
, int w
, int h
) const
703 return m_updateRegion
.Contains(x
, y
, w
, h
) != wxOutRegion
;
706 // ----------------------------------------------------------------------------
707 // find window by id or name
708 // ----------------------------------------------------------------------------
710 wxWindow
*wxWindowBase::FindWindow( long id
)
712 if ( id
== m_windowId
)
713 return (wxWindow
*)this;
715 wxWindowBase
*res
= (wxWindow
*)NULL
;
716 wxWindowList::Node
*node
;
717 for ( node
= m_children
.GetFirst(); node
&& !res
; node
= node
->GetNext() )
719 wxWindowBase
*child
= node
->GetData();
720 res
= child
->FindWindow( id
);
723 return (wxWindow
*)res
;
726 wxWindow
*wxWindowBase::FindWindow( const wxString
& name
)
728 if ( name
== m_windowName
)
729 return (wxWindow
*)this;
731 wxWindowBase
*res
= (wxWindow
*)NULL
;
732 wxWindowList::Node
*node
;
733 for ( node
= m_children
.GetFirst(); node
&& !res
; node
= node
->GetNext() )
735 wxWindow
*child
= node
->GetData();
736 res
= child
->FindWindow(name
);
739 return (wxWindow
*)res
;
742 // ----------------------------------------------------------------------------
743 // dialog oriented functions
744 // ----------------------------------------------------------------------------
746 void wxWindowBase::MakeModal(bool modal
)
748 // Disable all other windows
751 wxWindowList::Node
*node
= wxTopLevelWindows
.GetFirst();
754 wxWindow
*win
= node
->GetData();
758 node
= node
->GetNext();
763 bool wxWindowBase::Validate()
766 bool recurse
= (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY
) != 0;
768 wxWindowList::Node
*node
;
769 for ( node
= m_children
.GetFirst(); node
; node
= node
->GetNext() )
771 wxWindowBase
*child
= node
->GetData();
772 wxValidator
*validator
= child
->GetValidator();
773 if ( validator
&& !validator
->Validate((wxWindow
*)this) )
778 if ( recurse
&& !child
->Validate() )
783 #endif // wxUSE_VALIDATORS
788 bool wxWindowBase::TransferDataToWindow()
791 bool recurse
= (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY
) != 0;
793 wxWindowList::Node
*node
;
794 for ( node
= m_children
.GetFirst(); node
; node
= node
->GetNext() )
796 wxWindowBase
*child
= node
->GetData();
797 wxValidator
*validator
= child
->GetValidator();
798 if ( validator
&& !validator
->TransferToWindow() )
800 wxLogWarning(_("Could not transfer data to window"));
801 wxLog::FlushActive();
808 if ( !child
->TransferDataToWindow() )
810 // warning already given
815 #endif // wxUSE_VALIDATORS
820 bool wxWindowBase::TransferDataFromWindow()
823 bool recurse
= (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY
) != 0;
825 wxWindowList::Node
*node
;
826 for ( node
= m_children
.GetFirst(); node
; node
= node
->GetNext() )
828 wxWindow
*child
= node
->GetData();
829 wxValidator
*validator
= child
->GetValidator();
830 if ( validator
&& !validator
->TransferFromWindow() )
832 // nop warning here because the application is supposed to give
833 // one itself - we don't know here what might have gone wrongly
840 if ( !child
->TransferDataFromWindow() )
842 // warning already given
847 #endif // wxUSE_VALIDATORS
852 void wxWindowBase::InitDialog()
854 wxInitDialogEvent
event(GetId());
855 event
.SetEventObject( this );
856 GetEventHandler()->ProcessEvent(event
);
859 // ----------------------------------------------------------------------------
860 // context-sensitive help support
861 // ----------------------------------------------------------------------------
865 // associate this help text with this window
866 void wxWindowBase::SetHelpText(const wxString
& text
)
868 wxHelpProvider
*helpProvider
= wxHelpProvider::Get();
871 helpProvider
->AddHelp(this, text
);
875 // associate this help text with all windows with the same id as this
877 void wxWindowBase::SetHelpTextForId(const wxString
& text
)
879 wxHelpProvider
*helpProvider
= wxHelpProvider::Get();
882 helpProvider
->AddHelp(GetId(), text
);
886 // get the help string associated with this window (may be empty)
887 wxString
wxWindowBase::GetHelpText() const
890 wxHelpProvider
*helpProvider
= wxHelpProvider::Get();
893 text
= helpProvider
->GetHelp(this);
899 // show help for this window
900 void wxWindowBase::OnHelp(wxHelpEvent
& event
)
902 wxHelpProvider
*helpProvider
= wxHelpProvider::Get();
905 if ( helpProvider
->ShowHelp(this) )
907 // skip the event.Skip() below
917 // ----------------------------------------------------------------------------
919 // ----------------------------------------------------------------------------
923 void wxWindowBase::SetToolTip( const wxString
&tip
)
925 // don't create the new tooltip if we already have one
928 m_tooltip
->SetTip( tip
);
932 SetToolTip( new wxToolTip( tip
) );
935 // setting empty tooltip text does not remove the tooltip any more - use
936 // SetToolTip((wxToolTip *)NULL) for this
939 void wxWindowBase::DoSetToolTip(wxToolTip
*tooltip
)
947 #endif // wxUSE_TOOLTIPS
949 // ----------------------------------------------------------------------------
950 // constraints and sizers
951 // ----------------------------------------------------------------------------
953 #if wxUSE_CONSTRAINTS
955 void wxWindowBase::SetConstraints( wxLayoutConstraints
*constraints
)
959 UnsetConstraints(m_constraints
);
960 delete m_constraints
;
962 m_constraints
= constraints
;
965 // Make sure other windows know they're part of a 'meaningful relationship'
966 if ( m_constraints
->left
.GetOtherWindow() && (m_constraints
->left
.GetOtherWindow() != this) )
967 m_constraints
->left
.GetOtherWindow()->AddConstraintReference(this);
968 if ( m_constraints
->top
.GetOtherWindow() && (m_constraints
->top
.GetOtherWindow() != this) )
969 m_constraints
->top
.GetOtherWindow()->AddConstraintReference(this);
970 if ( m_constraints
->right
.GetOtherWindow() && (m_constraints
->right
.GetOtherWindow() != this) )
971 m_constraints
->right
.GetOtherWindow()->AddConstraintReference(this);
972 if ( m_constraints
->bottom
.GetOtherWindow() && (m_constraints
->bottom
.GetOtherWindow() != this) )
973 m_constraints
->bottom
.GetOtherWindow()->AddConstraintReference(this);
974 if ( m_constraints
->width
.GetOtherWindow() && (m_constraints
->width
.GetOtherWindow() != this) )
975 m_constraints
->width
.GetOtherWindow()->AddConstraintReference(this);
976 if ( m_constraints
->height
.GetOtherWindow() && (m_constraints
->height
.GetOtherWindow() != this) )
977 m_constraints
->height
.GetOtherWindow()->AddConstraintReference(this);
978 if ( m_constraints
->centreX
.GetOtherWindow() && (m_constraints
->centreX
.GetOtherWindow() != this) )
979 m_constraints
->centreX
.GetOtherWindow()->AddConstraintReference(this);
980 if ( m_constraints
->centreY
.GetOtherWindow() && (m_constraints
->centreY
.GetOtherWindow() != this) )
981 m_constraints
->centreY
.GetOtherWindow()->AddConstraintReference(this);
985 // This removes any dangling pointers to this window in other windows'
986 // constraintsInvolvedIn lists.
987 void wxWindowBase::UnsetConstraints(wxLayoutConstraints
*c
)
991 if ( c
->left
.GetOtherWindow() && (c
->top
.GetOtherWindow() != this) )
992 c
->left
.GetOtherWindow()->RemoveConstraintReference(this);
993 if ( c
->top
.GetOtherWindow() && (c
->top
.GetOtherWindow() != this) )
994 c
->top
.GetOtherWindow()->RemoveConstraintReference(this);
995 if ( c
->right
.GetOtherWindow() && (c
->right
.GetOtherWindow() != this) )
996 c
->right
.GetOtherWindow()->RemoveConstraintReference(this);
997 if ( c
->bottom
.GetOtherWindow() && (c
->bottom
.GetOtherWindow() != this) )
998 c
->bottom
.GetOtherWindow()->RemoveConstraintReference(this);
999 if ( c
->width
.GetOtherWindow() && (c
->width
.GetOtherWindow() != this) )
1000 c
->width
.GetOtherWindow()->RemoveConstraintReference(this);
1001 if ( c
->height
.GetOtherWindow() && (c
->height
.GetOtherWindow() != this) )
1002 c
->height
.GetOtherWindow()->RemoveConstraintReference(this);
1003 if ( c
->centreX
.GetOtherWindow() && (c
->centreX
.GetOtherWindow() != this) )
1004 c
->centreX
.GetOtherWindow()->RemoveConstraintReference(this);
1005 if ( c
->centreY
.GetOtherWindow() && (c
->centreY
.GetOtherWindow() != this) )
1006 c
->centreY
.GetOtherWindow()->RemoveConstraintReference(this);
1010 // Back-pointer to other windows we're involved with, so if we delete this
1011 // window, we must delete any constraints we're involved with.
1012 void wxWindowBase::AddConstraintReference(wxWindowBase
*otherWin
)
1014 if ( !m_constraintsInvolvedIn
)
1015 m_constraintsInvolvedIn
= new wxWindowList
;
1016 if ( !m_constraintsInvolvedIn
->Find(otherWin
) )
1017 m_constraintsInvolvedIn
->Append(otherWin
);
1020 // REMOVE back-pointer to other windows we're involved with.
1021 void wxWindowBase::RemoveConstraintReference(wxWindowBase
*otherWin
)
1023 if ( m_constraintsInvolvedIn
)
1024 m_constraintsInvolvedIn
->DeleteObject(otherWin
);
1027 // Reset any constraints that mention this window
1028 void wxWindowBase::DeleteRelatedConstraints()
1030 if ( m_constraintsInvolvedIn
)
1032 wxWindowList::Node
*node
= m_constraintsInvolvedIn
->GetFirst();
1035 wxWindow
*win
= node
->GetData();
1036 wxLayoutConstraints
*constr
= win
->GetConstraints();
1038 // Reset any constraints involving this window
1041 constr
->left
.ResetIfWin(this);
1042 constr
->top
.ResetIfWin(this);
1043 constr
->right
.ResetIfWin(this);
1044 constr
->bottom
.ResetIfWin(this);
1045 constr
->width
.ResetIfWin(this);
1046 constr
->height
.ResetIfWin(this);
1047 constr
->centreX
.ResetIfWin(this);
1048 constr
->centreY
.ResetIfWin(this);
1051 wxWindowList::Node
*next
= node
->GetNext();
1056 delete m_constraintsInvolvedIn
;
1057 m_constraintsInvolvedIn
= (wxWindowList
*) NULL
;
1061 void wxWindowBase::SetSizer(wxSizer
*sizer
)
1063 if (m_windowSizer
) delete m_windowSizer
;
1065 m_windowSizer
= sizer
;
1068 bool wxWindowBase::Layout()
1070 // If there is a sizer, use it instead of the constraints
1074 GetClientSize(&w
, &h
);
1076 GetSizer()->SetDimension( 0, 0, w
, h
);
1080 wxLayoutConstraints
*constr
= GetConstraints();
1081 bool wasOk
= constr
&& constr
->AreSatisfied();
1083 ResetConstraints(); // Mark all constraints as unevaluated
1085 // if we're a top level panel (i.e. our parent is frame/dialog), our
1086 // own constraints will never be satisfied any more unless we do it
1091 while ( noChanges
> 0 )
1093 constr
->SatisfyConstraints(this, &noChanges
);
1097 DoPhase(1); // Layout children
1098 DoPhase(2); // Layout grand children
1099 SetConstraintSizes(); // Recursively set the real window sizes
1106 // Do a phase of evaluating constraints: the default behaviour. wxSizers may
1107 // do a similar thing, but also impose their own 'constraints' and order the
1108 // evaluation differently.
1109 bool wxWindowBase::LayoutPhase1(int *noChanges
)
1111 wxLayoutConstraints
*constr
= GetConstraints();
1114 return constr
->SatisfyConstraints(this, noChanges
);
1120 bool wxWindowBase::LayoutPhase2(int *noChanges
)
1130 // Do a phase of evaluating child constraints
1131 bool wxWindowBase::DoPhase(int phase
)
1133 int noIterations
= 0;
1134 int maxIterations
= 500;
1137 wxWindowList succeeded
;
1138 while ((noChanges
> 0) && (noIterations
< maxIterations
))
1142 wxWindowList::Node
*node
= GetChildren().GetFirst();
1145 wxWindow
*child
= node
->GetData();
1146 if ( !child
->IsTopLevel() )
1148 wxLayoutConstraints
*constr
= child
->GetConstraints();
1151 if ( !succeeded
.Find(child
) )
1153 int tempNoChanges
= 0;
1154 bool success
= ( (phase
== 1) ? child
->LayoutPhase1(&tempNoChanges
) : child
->LayoutPhase2(&tempNoChanges
) ) ;
1155 noChanges
+= tempNoChanges
;
1158 succeeded
.Append(child
);
1163 node
= node
->GetNext();
1172 void wxWindowBase::ResetConstraints()
1174 wxLayoutConstraints
*constr
= GetConstraints();
1177 constr
->left
.SetDone(FALSE
);
1178 constr
->top
.SetDone(FALSE
);
1179 constr
->right
.SetDone(FALSE
);
1180 constr
->bottom
.SetDone(FALSE
);
1181 constr
->width
.SetDone(FALSE
);
1182 constr
->height
.SetDone(FALSE
);
1183 constr
->centreX
.SetDone(FALSE
);
1184 constr
->centreY
.SetDone(FALSE
);
1187 wxWindowList::Node
*node
= GetChildren().GetFirst();
1190 wxWindow
*win
= node
->GetData();
1191 if ( !win
->IsTopLevel() )
1192 win
->ResetConstraints();
1193 node
= node
->GetNext();
1197 // Need to distinguish between setting the 'fake' size for windows and sizers,
1198 // and setting the real values.
1199 void wxWindowBase::SetConstraintSizes(bool recurse
)
1201 wxLayoutConstraints
*constr
= GetConstraints();
1202 if ( constr
&& constr
->AreSatisfied() )
1204 int x
= constr
->left
.GetValue();
1205 int y
= constr
->top
.GetValue();
1206 int w
= constr
->width
.GetValue();
1207 int h
= constr
->height
.GetValue();
1209 if ( (constr
->width
.GetRelationship() != wxAsIs
) ||
1210 (constr
->height
.GetRelationship() != wxAsIs
) )
1212 SetSize(x
, y
, w
, h
);
1216 // If we don't want to resize this window, just move it...
1222 wxLogDebug(wxT("Constraints not satisfied for %s named '%s'."),
1223 GetClassInfo()->GetClassName(),
1229 wxWindowList::Node
*node
= GetChildren().GetFirst();
1232 wxWindow
*win
= node
->GetData();
1233 if ( !win
->IsTopLevel() )
1234 win
->SetConstraintSizes();
1235 node
= node
->GetNext();
1240 // Only set the size/position of the constraint (if any)
1241 void wxWindowBase::SetSizeConstraint(int x
, int y
, int w
, int h
)
1243 wxLayoutConstraints
*constr
= GetConstraints();
1248 constr
->left
.SetValue(x
);
1249 constr
->left
.SetDone(TRUE
);
1253 constr
->top
.SetValue(y
);
1254 constr
->top
.SetDone(TRUE
);
1258 constr
->width
.SetValue(w
);
1259 constr
->width
.SetDone(TRUE
);
1263 constr
->height
.SetValue(h
);
1264 constr
->height
.SetDone(TRUE
);
1269 void wxWindowBase::MoveConstraint(int x
, int y
)
1271 wxLayoutConstraints
*constr
= GetConstraints();
1276 constr
->left
.SetValue(x
);
1277 constr
->left
.SetDone(TRUE
);
1281 constr
->top
.SetValue(y
);
1282 constr
->top
.SetDone(TRUE
);
1287 void wxWindowBase::GetSizeConstraint(int *w
, int *h
) const
1289 wxLayoutConstraints
*constr
= GetConstraints();
1292 *w
= constr
->width
.GetValue();
1293 *h
= constr
->height
.GetValue();
1299 void wxWindowBase::GetClientSizeConstraint(int *w
, int *h
) const
1301 wxLayoutConstraints
*constr
= GetConstraints();
1304 *w
= constr
->width
.GetValue();
1305 *h
= constr
->height
.GetValue();
1308 GetClientSize(w
, h
);
1311 void wxWindowBase::GetPositionConstraint(int *x
, int *y
) const
1313 wxLayoutConstraints
*constr
= GetConstraints();
1316 *x
= constr
->left
.GetValue();
1317 *y
= constr
->top
.GetValue();
1323 #endif // wxUSE_CONSTRAINTS
1325 // ----------------------------------------------------------------------------
1326 // do Update UI processing for child controls
1327 // ----------------------------------------------------------------------------
1329 // TODO: should this be implemented for the child window rather
1330 // than the parent? Then you can override it e.g. for wxCheckBox
1331 // to do the Right Thing rather than having to assume a fixed number
1332 // of control classes.
1333 void wxWindowBase::UpdateWindowUI()
1335 wxUpdateUIEvent
event(GetId());
1336 event
.m_eventObject
= this;
1338 if ( GetEventHandler()->ProcessEvent(event
) )
1340 if ( event
.GetSetEnabled() )
1341 Enable(event
.GetEnabled());
1343 if ( event
.GetSetText() )
1345 wxControl
*control
= wxDynamicCast(this, wxControl
);
1348 wxTextCtrl
*text
= wxDynamicCast(control
, wxTextCtrl
);
1350 text
->SetValue(event
.GetText());
1352 control
->SetLabel(event
.GetText());
1357 wxCheckBox
*checkbox
= wxDynamicCast(this, wxCheckBox
);
1360 if ( event
.GetSetChecked() )
1361 checkbox
->SetValue(event
.GetChecked());
1363 #endif // wxUSE_CHECKBOX
1366 wxRadioButton
*radiobtn
= wxDynamicCast(this, wxRadioButton
);
1369 if ( event
.GetSetChecked() )
1370 radiobtn
->SetValue(event
.GetChecked());
1372 #endif // wxUSE_RADIOBTN
1376 // ----------------------------------------------------------------------------
1377 // dialog units translations
1378 // ----------------------------------------------------------------------------
1380 wxPoint
wxWindowBase::ConvertPixelsToDialog(const wxPoint
& pt
)
1382 int charWidth
= GetCharWidth();
1383 int charHeight
= GetCharHeight();
1384 wxPoint
pt2(-1, -1);
1386 pt2
.x
= (int) ((pt
.x
* 4) / charWidth
) ;
1388 pt2
.y
= (int) ((pt
.y
* 8) / charHeight
) ;
1393 wxPoint
wxWindowBase::ConvertDialogToPixels(const wxPoint
& pt
)
1395 int charWidth
= GetCharWidth();
1396 int charHeight
= GetCharHeight();
1397 wxPoint
pt2(-1, -1);
1399 pt2
.x
= (int) ((pt
.x
* charWidth
) / 4) ;
1401 pt2
.y
= (int) ((pt
.y
* charHeight
) / 8) ;
1406 // ----------------------------------------------------------------------------
1408 // ----------------------------------------------------------------------------
1410 void wxWindowBase::DoSetClientObject( wxClientData
*data
)
1412 wxASSERT_MSG( m_clientDataType
!= ClientData_Void
,
1413 wxT("can't have both object and void client data") );
1415 if ( m_clientObject
)
1416 delete m_clientObject
;
1418 m_clientObject
= data
;
1419 m_clientDataType
= ClientData_Object
;
1422 wxClientData
*wxWindowBase::DoGetClientObject() const
1424 // it's not an error to call GetClientObject() on a window which doesn't
1425 // have client data at all - NULL will be returned
1426 wxASSERT_MSG( m_clientDataType
!= ClientData_Void
,
1427 wxT("this window doesn't have object client data") );
1429 return m_clientObject
;
1432 void wxWindowBase::DoSetClientData( void *data
)
1434 wxASSERT_MSG( m_clientDataType
!= ClientData_Object
,
1435 wxT("can't have both object and void client data") );
1437 m_clientData
= data
;
1438 m_clientDataType
= ClientData_Void
;
1441 void *wxWindowBase::DoGetClientData() const
1443 // it's not an error to call GetClientData() on a window which doesn't have
1444 // client data at all - NULL will be returned
1445 wxASSERT_MSG( m_clientDataType
!= ClientData_Object
,
1446 wxT("this window doesn't have void client data") );
1448 return m_clientData
;
1451 // ----------------------------------------------------------------------------
1453 // ----------------------------------------------------------------------------
1455 // propagate the colour change event to the subwindows
1456 void wxWindowBase::OnSysColourChanged(wxSysColourChangedEvent
& event
)
1458 wxWindowList::Node
*node
= GetChildren().GetFirst();
1461 // Only propagate to non-top-level windows
1462 wxWindow
*win
= node
->GetData();
1463 if ( !win
->IsTopLevel() )
1465 wxSysColourChangedEvent event2
;
1466 event
.m_eventObject
= win
;
1467 win
->GetEventHandler()->ProcessEvent(event2
);
1470 node
= node
->GetNext();
1474 // the default action is to populate dialog with data when it's created
1475 void wxWindowBase::OnInitDialog( wxInitDialogEvent
&WXUNUSED(event
) )
1477 TransferDataToWindow();
1480 // process Ctrl-Alt-mclick
1481 void wxWindowBase::OnMiddleClick( wxMouseEvent
& event
)
1483 if ( event
.ControlDown() && event
.AltDown() )
1485 // don't translate these strings
1487 switch ( wxGetOsVersion() )
1489 case wxMOTIF_X
: port
= _T("Motif"); break;
1490 case wxMACINTOSH
: port
= _T("Mac"); break;
1491 case wxBEOS
: port
= _T("BeOS"); break;
1495 case wxGTK_BEOS
: port
= _T("GTK"); break;
1501 case wxWIN386
: port
= _T("MS Windows"); break;
1505 case wxMGL_OS2
: port
= _T("MGL"); break;
1507 case wxOS2_PM
: port
= _T("OS/2"); break;
1508 default: port
= _T("unknown"); break;
1511 wxMessageBox(wxString::Format(
1513 " wxWindows Library (%s port)\nVersion %u.%u.%u, compiled at %s %s\n Copyright (c) 1995-2000 wxWindows team"
1522 _T("wxWindows information"),
1523 wxICON_INFORMATION
| wxOK
,
1532 // ----------------------------------------------------------------------------
1533 // list classes implementation
1534 // ----------------------------------------------------------------------------
1536 void wxWindowListNode::DeleteData()
1538 delete (wxWindow
*)GetData();