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 SetClientSize(DoGetBestSize());
407 //else: do nothing if we have no children
410 // return the size best suited for the current window
411 wxSize
wxWindowBase::DoGetBestSize() const
413 if ( GetChildren().GetCount() > 0 )
415 // our minimal acceptable size is such that all our windows fit inside
419 for ( wxWindowList::Node
*node
= GetChildren().GetFirst();
421 node
= node
->GetNext() )
423 wxWindow
*win
= node
->GetData();
424 if ( win
->IsTopLevel() || wxDynamicCast(win
, wxStatusBar
) || !win
->IsShown())
426 // dialogs and frames lie in different top level windows -
427 // don't deal with them here; as for the status bars, they
428 // don't lie in the client area at all
433 win
->GetPosition(&wx
, &wy
);
435 // if the window hadn't been positioned yet, assume that it is in
442 win
->GetSize(&ww
, &wh
);
443 if ( wx
+ ww
> maxX
)
445 if ( wy
+ wh
> maxY
)
450 return wxSize(maxX
+ 7, maxY
+ 14);
454 // for a generic window there is no natural best size - just use the
460 // set the min/max size of the window
461 void wxWindowBase::SetSizeHints(int minW
, int minH
,
463 int WXUNUSED(incW
), int WXUNUSED(incH
))
471 // ----------------------------------------------------------------------------
472 // show/hide/enable/disable the window
473 // ----------------------------------------------------------------------------
475 bool wxWindowBase::Show(bool show
)
477 if ( show
!= m_isShown
)
489 bool wxWindowBase::Enable(bool enable
)
491 if ( enable
!= m_isEnabled
)
493 m_isEnabled
= enable
;
502 // ----------------------------------------------------------------------------
504 // ----------------------------------------------------------------------------
506 bool wxWindowBase::IsTopLevel() const
511 // ----------------------------------------------------------------------------
512 // reparenting the window
513 // ----------------------------------------------------------------------------
515 void wxWindowBase::AddChild(wxWindowBase
*child
)
517 wxCHECK_RET( child
, wxT("can't add a NULL child") );
519 // this should never happen and it will lead to a crash later if it does
520 // because RemoveChild() will remove only one node from the children list
521 // and the other(s) one(s) will be left with dangling pointers in them
522 wxASSERT_MSG( !GetChildren().Find(child
), _T("AddChild() called twice") );
524 GetChildren().Append(child
);
525 child
->SetParent(this);
528 void wxWindowBase::RemoveChild(wxWindowBase
*child
)
530 wxCHECK_RET( child
, wxT("can't remove a NULL child") );
532 GetChildren().DeleteObject(child
);
533 child
->SetParent((wxWindow
*)NULL
);
536 bool wxWindowBase::Reparent(wxWindowBase
*newParent
)
538 wxWindow
*oldParent
= GetParent();
539 if ( newParent
== oldParent
)
545 // unlink this window from the existing parent.
548 oldParent
->RemoveChild(this);
552 wxTopLevelWindows
.DeleteObject(this);
555 // add it to the new one
558 newParent
->AddChild(this);
562 wxTopLevelWindows
.Append(this);
568 // ----------------------------------------------------------------------------
569 // event handler stuff
570 // ----------------------------------------------------------------------------
572 void wxWindowBase::PushEventHandler(wxEvtHandler
*handler
)
574 handler
->SetNextHandler(GetEventHandler());
575 SetEventHandler(handler
);
578 wxEvtHandler
*wxWindowBase::PopEventHandler(bool deleteHandler
)
580 wxEvtHandler
*handlerA
= GetEventHandler();
583 wxEvtHandler
*handlerB
= handlerA
->GetNextHandler();
584 handlerA
->SetNextHandler((wxEvtHandler
*)NULL
);
585 SetEventHandler(handlerB
);
589 handlerA
= (wxEvtHandler
*)NULL
;
596 // ----------------------------------------------------------------------------
598 // ----------------------------------------------------------------------------
600 bool wxWindowBase::SetBackgroundColour( const wxColour
&colour
)
602 if ( !colour
.Ok() || (colour
== m_backgroundColour
) )
605 m_backgroundColour
= colour
;
610 bool wxWindowBase::SetForegroundColour( const wxColour
&colour
)
612 if ( !colour
.Ok() || (colour
== m_foregroundColour
) )
615 m_foregroundColour
= colour
;
620 bool wxWindowBase::SetCursor(const wxCursor
& cursor
)
622 // setting an invalid cursor is ok, it means that we don't have any special
624 if ( m_cursor
== cursor
)
635 bool wxWindowBase::SetFont(const wxFont
& font
)
637 // don't try to set invalid font, always fall back to the default
638 const wxFont
& fontOk
= font
.Ok() ? font
: *wxSWISS_FONT
;
640 if ( (wxFont
&)fontOk
== m_font
)
652 void wxWindowBase::SetCaret(wxCaret
*caret
)
663 wxASSERT_MSG( m_caret
->GetWindow() == this,
664 wxT("caret should be created associated to this window") );
667 #endif // wxUSE_CARET
670 // ----------------------------------------------------------------------------
672 // ----------------------------------------------------------------------------
674 void wxWindowBase::SetValidator(const wxValidator
& validator
)
676 if ( m_windowValidator
)
677 delete m_windowValidator
;
679 m_windowValidator
= (wxValidator
*)validator
.Clone();
681 if ( m_windowValidator
)
682 m_windowValidator
->SetWindow(this) ;
684 #endif // wxUSE_VALIDATORS
686 // ----------------------------------------------------------------------------
687 // update region testing
688 // ----------------------------------------------------------------------------
690 bool wxWindowBase::IsExposed(int x
, int y
) const
692 return m_updateRegion
.Contains(x
, y
) != wxOutRegion
;
695 bool wxWindowBase::IsExposed(int x
, int y
, int w
, int h
) const
697 return m_updateRegion
.Contains(x
, y
, w
, h
) != wxOutRegion
;
700 // ----------------------------------------------------------------------------
701 // find window by id or name
702 // ----------------------------------------------------------------------------
704 wxWindow
*wxWindowBase::FindWindow( long id
)
706 if ( id
== m_windowId
)
707 return (wxWindow
*)this;
709 wxWindowBase
*res
= (wxWindow
*)NULL
;
710 wxWindowList::Node
*node
;
711 for ( node
= m_children
.GetFirst(); node
&& !res
; node
= node
->GetNext() )
713 wxWindowBase
*child
= node
->GetData();
714 res
= child
->FindWindow( id
);
717 return (wxWindow
*)res
;
720 wxWindow
*wxWindowBase::FindWindow( const wxString
& name
)
722 if ( name
== m_windowName
)
723 return (wxWindow
*)this;
725 wxWindowBase
*res
= (wxWindow
*)NULL
;
726 wxWindowList::Node
*node
;
727 for ( node
= m_children
.GetFirst(); node
&& !res
; node
= node
->GetNext() )
729 wxWindow
*child
= node
->GetData();
730 res
= child
->FindWindow(name
);
733 return (wxWindow
*)res
;
736 // ----------------------------------------------------------------------------
737 // dialog oriented functions
738 // ----------------------------------------------------------------------------
740 void wxWindowBase::MakeModal(bool modal
)
742 // Disable all other windows
745 wxWindowList::Node
*node
= wxTopLevelWindows
.GetFirst();
748 wxWindow
*win
= node
->GetData();
752 node
= node
->GetNext();
757 bool wxWindowBase::Validate()
760 bool recurse
= (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY
) != 0;
762 wxWindowList::Node
*node
;
763 for ( node
= m_children
.GetFirst(); node
; node
= node
->GetNext() )
765 wxWindowBase
*child
= node
->GetData();
766 wxValidator
*validator
= child
->GetValidator();
767 if ( validator
&& !validator
->Validate((wxWindow
*)this) )
772 if ( recurse
&& !child
->Validate() )
777 #endif // wxUSE_VALIDATORS
782 bool wxWindowBase::TransferDataToWindow()
785 bool recurse
= (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY
) != 0;
787 wxWindowList::Node
*node
;
788 for ( node
= m_children
.GetFirst(); node
; node
= node
->GetNext() )
790 wxWindowBase
*child
= node
->GetData();
791 wxValidator
*validator
= child
->GetValidator();
792 if ( validator
&& !validator
->TransferToWindow() )
794 wxLogWarning(_("Could not transfer data to window"));
795 wxLog::FlushActive();
802 if ( !child
->TransferDataToWindow() )
804 // warning already given
809 #endif // wxUSE_VALIDATORS
814 bool wxWindowBase::TransferDataFromWindow()
817 bool recurse
= (GetExtraStyle() & wxWS_EX_VALIDATE_RECURSIVELY
) != 0;
819 wxWindowList::Node
*node
;
820 for ( node
= m_children
.GetFirst(); node
; node
= node
->GetNext() )
822 wxWindow
*child
= node
->GetData();
823 wxValidator
*validator
= child
->GetValidator();
824 if ( validator
&& !validator
->TransferFromWindow() )
826 // nop warning here because the application is supposed to give
827 // one itself - we don't know here what might have gone wrongly
834 if ( !child
->TransferDataFromWindow() )
836 // warning already given
841 #endif // wxUSE_VALIDATORS
846 void wxWindowBase::InitDialog()
848 wxInitDialogEvent
event(GetId());
849 event
.SetEventObject( this );
850 GetEventHandler()->ProcessEvent(event
);
853 // ----------------------------------------------------------------------------
854 // context-sensitive help support
855 // ----------------------------------------------------------------------------
859 // associate this help text with this window
860 void wxWindowBase::SetHelpText(const wxString
& text
)
862 wxHelpProvider
*helpProvider
= wxHelpProvider::Get();
865 helpProvider
->AddHelp(this, text
);
869 // associate this help text with all windows with the same id as this
871 void wxWindowBase::SetHelpTextForId(const wxString
& text
)
873 wxHelpProvider
*helpProvider
= wxHelpProvider::Get();
876 helpProvider
->AddHelp(GetId(), text
);
880 // get the help string associated with this window (may be empty)
881 wxString
wxWindowBase::GetHelpText() const
884 wxHelpProvider
*helpProvider
= wxHelpProvider::Get();
887 text
= helpProvider
->GetHelp(this);
893 // show help for this window
894 void wxWindowBase::OnHelp(wxHelpEvent
& event
)
896 wxHelpProvider
*helpProvider
= wxHelpProvider::Get();
899 if ( helpProvider
->ShowHelp(this) )
901 // skip the event.Skip() below
911 // ----------------------------------------------------------------------------
913 // ----------------------------------------------------------------------------
917 void wxWindowBase::SetToolTip( const wxString
&tip
)
919 // don't create the new tooltip if we already have one
922 m_tooltip
->SetTip( tip
);
926 SetToolTip( new wxToolTip( tip
) );
929 // setting empty tooltip text does not remove the tooltip any more - use
930 // SetToolTip((wxToolTip *)NULL) for this
933 void wxWindowBase::DoSetToolTip(wxToolTip
*tooltip
)
941 #endif // wxUSE_TOOLTIPS
943 // ----------------------------------------------------------------------------
944 // constraints and sizers
945 // ----------------------------------------------------------------------------
947 #if wxUSE_CONSTRAINTS
949 void wxWindowBase::SetConstraints( wxLayoutConstraints
*constraints
)
953 UnsetConstraints(m_constraints
);
954 delete m_constraints
;
956 m_constraints
= constraints
;
959 // Make sure other windows know they're part of a 'meaningful relationship'
960 if ( m_constraints
->left
.GetOtherWindow() && (m_constraints
->left
.GetOtherWindow() != this) )
961 m_constraints
->left
.GetOtherWindow()->AddConstraintReference(this);
962 if ( m_constraints
->top
.GetOtherWindow() && (m_constraints
->top
.GetOtherWindow() != this) )
963 m_constraints
->top
.GetOtherWindow()->AddConstraintReference(this);
964 if ( m_constraints
->right
.GetOtherWindow() && (m_constraints
->right
.GetOtherWindow() != this) )
965 m_constraints
->right
.GetOtherWindow()->AddConstraintReference(this);
966 if ( m_constraints
->bottom
.GetOtherWindow() && (m_constraints
->bottom
.GetOtherWindow() != this) )
967 m_constraints
->bottom
.GetOtherWindow()->AddConstraintReference(this);
968 if ( m_constraints
->width
.GetOtherWindow() && (m_constraints
->width
.GetOtherWindow() != this) )
969 m_constraints
->width
.GetOtherWindow()->AddConstraintReference(this);
970 if ( m_constraints
->height
.GetOtherWindow() && (m_constraints
->height
.GetOtherWindow() != this) )
971 m_constraints
->height
.GetOtherWindow()->AddConstraintReference(this);
972 if ( m_constraints
->centreX
.GetOtherWindow() && (m_constraints
->centreX
.GetOtherWindow() != this) )
973 m_constraints
->centreX
.GetOtherWindow()->AddConstraintReference(this);
974 if ( m_constraints
->centreY
.GetOtherWindow() && (m_constraints
->centreY
.GetOtherWindow() != this) )
975 m_constraints
->centreY
.GetOtherWindow()->AddConstraintReference(this);
979 // This removes any dangling pointers to this window in other windows'
980 // constraintsInvolvedIn lists.
981 void wxWindowBase::UnsetConstraints(wxLayoutConstraints
*c
)
985 if ( c
->left
.GetOtherWindow() && (c
->top
.GetOtherWindow() != this) )
986 c
->left
.GetOtherWindow()->RemoveConstraintReference(this);
987 if ( c
->top
.GetOtherWindow() && (c
->top
.GetOtherWindow() != this) )
988 c
->top
.GetOtherWindow()->RemoveConstraintReference(this);
989 if ( c
->right
.GetOtherWindow() && (c
->right
.GetOtherWindow() != this) )
990 c
->right
.GetOtherWindow()->RemoveConstraintReference(this);
991 if ( c
->bottom
.GetOtherWindow() && (c
->bottom
.GetOtherWindow() != this) )
992 c
->bottom
.GetOtherWindow()->RemoveConstraintReference(this);
993 if ( c
->width
.GetOtherWindow() && (c
->width
.GetOtherWindow() != this) )
994 c
->width
.GetOtherWindow()->RemoveConstraintReference(this);
995 if ( c
->height
.GetOtherWindow() && (c
->height
.GetOtherWindow() != this) )
996 c
->height
.GetOtherWindow()->RemoveConstraintReference(this);
997 if ( c
->centreX
.GetOtherWindow() && (c
->centreX
.GetOtherWindow() != this) )
998 c
->centreX
.GetOtherWindow()->RemoveConstraintReference(this);
999 if ( c
->centreY
.GetOtherWindow() && (c
->centreY
.GetOtherWindow() != this) )
1000 c
->centreY
.GetOtherWindow()->RemoveConstraintReference(this);
1004 // Back-pointer to other windows we're involved with, so if we delete this
1005 // window, we must delete any constraints we're involved with.
1006 void wxWindowBase::AddConstraintReference(wxWindowBase
*otherWin
)
1008 if ( !m_constraintsInvolvedIn
)
1009 m_constraintsInvolvedIn
= new wxWindowList
;
1010 if ( !m_constraintsInvolvedIn
->Find(otherWin
) )
1011 m_constraintsInvolvedIn
->Append(otherWin
);
1014 // REMOVE back-pointer to other windows we're involved with.
1015 void wxWindowBase::RemoveConstraintReference(wxWindowBase
*otherWin
)
1017 if ( m_constraintsInvolvedIn
)
1018 m_constraintsInvolvedIn
->DeleteObject(otherWin
);
1021 // Reset any constraints that mention this window
1022 void wxWindowBase::DeleteRelatedConstraints()
1024 if ( m_constraintsInvolvedIn
)
1026 wxWindowList::Node
*node
= m_constraintsInvolvedIn
->GetFirst();
1029 wxWindow
*win
= node
->GetData();
1030 wxLayoutConstraints
*constr
= win
->GetConstraints();
1032 // Reset any constraints involving this window
1035 constr
->left
.ResetIfWin(this);
1036 constr
->top
.ResetIfWin(this);
1037 constr
->right
.ResetIfWin(this);
1038 constr
->bottom
.ResetIfWin(this);
1039 constr
->width
.ResetIfWin(this);
1040 constr
->height
.ResetIfWin(this);
1041 constr
->centreX
.ResetIfWin(this);
1042 constr
->centreY
.ResetIfWin(this);
1045 wxWindowList::Node
*next
= node
->GetNext();
1050 delete m_constraintsInvolvedIn
;
1051 m_constraintsInvolvedIn
= (wxWindowList
*) NULL
;
1055 void wxWindowBase::SetSizer(wxSizer
*sizer
)
1057 if (m_windowSizer
) delete m_windowSizer
;
1059 m_windowSizer
= sizer
;
1062 bool wxWindowBase::Layout()
1064 // If there is a sizer, use it instead of the constraints
1068 GetClientSize(&w
, &h
);
1070 GetSizer()->SetDimension( 0, 0, w
, h
);
1074 wxLayoutConstraints
*constr
= GetConstraints();
1075 bool wasOk
= constr
&& constr
->AreSatisfied();
1077 ResetConstraints(); // Mark all constraints as unevaluated
1079 // if we're a top level panel (i.e. our parent is frame/dialog), our
1080 // own constraints will never be satisfied any more unless we do it
1085 while ( noChanges
> 0 )
1087 constr
->SatisfyConstraints(this, &noChanges
);
1091 DoPhase(1); // Layout children
1092 DoPhase(2); // Layout grand children
1093 SetConstraintSizes(); // Recursively set the real window sizes
1100 // Do a phase of evaluating constraints: the default behaviour. wxSizers may
1101 // do a similar thing, but also impose their own 'constraints' and order the
1102 // evaluation differently.
1103 bool wxWindowBase::LayoutPhase1(int *noChanges
)
1105 wxLayoutConstraints
*constr
= GetConstraints();
1108 return constr
->SatisfyConstraints(this, noChanges
);
1114 bool wxWindowBase::LayoutPhase2(int *noChanges
)
1124 // Do a phase of evaluating child constraints
1125 bool wxWindowBase::DoPhase(int phase
)
1127 int noIterations
= 0;
1128 int maxIterations
= 500;
1131 wxWindowList succeeded
;
1132 while ((noChanges
> 0) && (noIterations
< maxIterations
))
1136 wxWindowList::Node
*node
= GetChildren().GetFirst();
1139 wxWindow
*child
= node
->GetData();
1140 if ( !child
->IsTopLevel() )
1142 wxLayoutConstraints
*constr
= child
->GetConstraints();
1145 if ( !succeeded
.Find(child
) )
1147 int tempNoChanges
= 0;
1148 bool success
= ( (phase
== 1) ? child
->LayoutPhase1(&tempNoChanges
) : child
->LayoutPhase2(&tempNoChanges
) ) ;
1149 noChanges
+= tempNoChanges
;
1152 succeeded
.Append(child
);
1157 node
= node
->GetNext();
1166 void wxWindowBase::ResetConstraints()
1168 wxLayoutConstraints
*constr
= GetConstraints();
1171 constr
->left
.SetDone(FALSE
);
1172 constr
->top
.SetDone(FALSE
);
1173 constr
->right
.SetDone(FALSE
);
1174 constr
->bottom
.SetDone(FALSE
);
1175 constr
->width
.SetDone(FALSE
);
1176 constr
->height
.SetDone(FALSE
);
1177 constr
->centreX
.SetDone(FALSE
);
1178 constr
->centreY
.SetDone(FALSE
);
1181 wxWindowList::Node
*node
= GetChildren().GetFirst();
1184 wxWindow
*win
= node
->GetData();
1185 if ( !win
->IsTopLevel() )
1186 win
->ResetConstraints();
1187 node
= node
->GetNext();
1191 // Need to distinguish between setting the 'fake' size for windows and sizers,
1192 // and setting the real values.
1193 void wxWindowBase::SetConstraintSizes(bool recurse
)
1195 wxLayoutConstraints
*constr
= GetConstraints();
1196 if ( constr
&& constr
->AreSatisfied() )
1198 int x
= constr
->left
.GetValue();
1199 int y
= constr
->top
.GetValue();
1200 int w
= constr
->width
.GetValue();
1201 int h
= constr
->height
.GetValue();
1203 if ( (constr
->width
.GetRelationship() != wxAsIs
) ||
1204 (constr
->height
.GetRelationship() != wxAsIs
) )
1206 SetSize(x
, y
, w
, h
);
1210 // If we don't want to resize this window, just move it...
1216 wxLogDebug(wxT("Constraints not satisfied for %s named '%s'."),
1217 GetClassInfo()->GetClassName(),
1223 wxWindowList::Node
*node
= GetChildren().GetFirst();
1226 wxWindow
*win
= node
->GetData();
1227 if ( !win
->IsTopLevel() )
1228 win
->SetConstraintSizes();
1229 node
= node
->GetNext();
1234 // Only set the size/position of the constraint (if any)
1235 void wxWindowBase::SetSizeConstraint(int x
, int y
, int w
, int h
)
1237 wxLayoutConstraints
*constr
= GetConstraints();
1242 constr
->left
.SetValue(x
);
1243 constr
->left
.SetDone(TRUE
);
1247 constr
->top
.SetValue(y
);
1248 constr
->top
.SetDone(TRUE
);
1252 constr
->width
.SetValue(w
);
1253 constr
->width
.SetDone(TRUE
);
1257 constr
->height
.SetValue(h
);
1258 constr
->height
.SetDone(TRUE
);
1263 void wxWindowBase::MoveConstraint(int x
, int y
)
1265 wxLayoutConstraints
*constr
= GetConstraints();
1270 constr
->left
.SetValue(x
);
1271 constr
->left
.SetDone(TRUE
);
1275 constr
->top
.SetValue(y
);
1276 constr
->top
.SetDone(TRUE
);
1281 void wxWindowBase::GetSizeConstraint(int *w
, int *h
) const
1283 wxLayoutConstraints
*constr
= GetConstraints();
1286 *w
= constr
->width
.GetValue();
1287 *h
= constr
->height
.GetValue();
1293 void wxWindowBase::GetClientSizeConstraint(int *w
, int *h
) const
1295 wxLayoutConstraints
*constr
= GetConstraints();
1298 *w
= constr
->width
.GetValue();
1299 *h
= constr
->height
.GetValue();
1302 GetClientSize(w
, h
);
1305 void wxWindowBase::GetPositionConstraint(int *x
, int *y
) const
1307 wxLayoutConstraints
*constr
= GetConstraints();
1310 *x
= constr
->left
.GetValue();
1311 *y
= constr
->top
.GetValue();
1317 #endif // wxUSE_CONSTRAINTS
1319 // ----------------------------------------------------------------------------
1320 // do Update UI processing for child controls
1321 // ----------------------------------------------------------------------------
1323 // TODO: should this be implemented for the child window rather
1324 // than the parent? Then you can override it e.g. for wxCheckBox
1325 // to do the Right Thing rather than having to assume a fixed number
1326 // of control classes.
1327 void wxWindowBase::UpdateWindowUI()
1329 wxUpdateUIEvent
event(GetId());
1330 event
.m_eventObject
= this;
1332 if ( GetEventHandler()->ProcessEvent(event
) )
1334 if ( event
.GetSetEnabled() )
1335 Enable(event
.GetEnabled());
1337 if ( event
.GetSetText() )
1339 wxControl
*control
= wxDynamicCast(this, wxControl
);
1342 wxTextCtrl
*text
= wxDynamicCast(control
, wxTextCtrl
);
1344 text
->SetValue(event
.GetText());
1346 control
->SetLabel(event
.GetText());
1351 wxCheckBox
*checkbox
= wxDynamicCast(this, wxCheckBox
);
1354 if ( event
.GetSetChecked() )
1355 checkbox
->SetValue(event
.GetChecked());
1357 #endif // wxUSE_CHECKBOX
1360 wxRadioButton
*radiobtn
= wxDynamicCast(this, wxRadioButton
);
1363 if ( event
.GetSetChecked() )
1364 radiobtn
->SetValue(event
.GetChecked());
1366 #endif // wxUSE_RADIOBTN
1370 // ----------------------------------------------------------------------------
1371 // dialog units translations
1372 // ----------------------------------------------------------------------------
1374 wxPoint
wxWindowBase::ConvertPixelsToDialog(const wxPoint
& pt
)
1376 int charWidth
= GetCharWidth();
1377 int charHeight
= GetCharHeight();
1378 wxPoint
pt2(-1, -1);
1380 pt2
.x
= (int) ((pt
.x
* 4) / charWidth
) ;
1382 pt2
.y
= (int) ((pt
.y
* 8) / charHeight
) ;
1387 wxPoint
wxWindowBase::ConvertDialogToPixels(const wxPoint
& pt
)
1389 int charWidth
= GetCharWidth();
1390 int charHeight
= GetCharHeight();
1391 wxPoint
pt2(-1, -1);
1393 pt2
.x
= (int) ((pt
.x
* charWidth
) / 4) ;
1395 pt2
.y
= (int) ((pt
.y
* charHeight
) / 8) ;
1400 // ----------------------------------------------------------------------------
1402 // ----------------------------------------------------------------------------
1404 void wxWindowBase::DoSetClientObject( wxClientData
*data
)
1406 wxASSERT_MSG( m_clientDataType
!= ClientData_Void
,
1407 wxT("can't have both object and void client data") );
1409 if ( m_clientObject
)
1410 delete m_clientObject
;
1412 m_clientObject
= data
;
1413 m_clientDataType
= ClientData_Object
;
1416 wxClientData
*wxWindowBase::DoGetClientObject() const
1418 // it's not an error to call GetClientObject() on a window which doesn't
1419 // have client data at all - NULL will be returned
1420 wxASSERT_MSG( m_clientDataType
!= ClientData_Void
,
1421 wxT("this window doesn't have object client data") );
1423 return m_clientObject
;
1426 void wxWindowBase::DoSetClientData( void *data
)
1428 wxASSERT_MSG( m_clientDataType
!= ClientData_Object
,
1429 wxT("can't have both object and void client data") );
1431 m_clientData
= data
;
1432 m_clientDataType
= ClientData_Void
;
1435 void *wxWindowBase::DoGetClientData() const
1437 // it's not an error to call GetClientData() on a window which doesn't have
1438 // client data at all - NULL will be returned
1439 wxASSERT_MSG( m_clientDataType
!= ClientData_Object
,
1440 wxT("this window doesn't have void client data") );
1442 return m_clientData
;
1445 // ----------------------------------------------------------------------------
1447 // ----------------------------------------------------------------------------
1449 // propagate the colour change event to the subwindows
1450 void wxWindowBase::OnSysColourChanged(wxSysColourChangedEvent
& event
)
1452 wxWindowList::Node
*node
= GetChildren().GetFirst();
1455 // Only propagate to non-top-level windows
1456 wxWindow
*win
= node
->GetData();
1457 if ( !win
->IsTopLevel() )
1459 wxSysColourChangedEvent event2
;
1460 event
.m_eventObject
= win
;
1461 win
->GetEventHandler()->ProcessEvent(event2
);
1464 node
= node
->GetNext();
1468 // the default action is to populate dialog with data when it's created
1469 void wxWindowBase::OnInitDialog( wxInitDialogEvent
&WXUNUSED(event
) )
1471 TransferDataToWindow();
1474 // process Ctrl-Alt-mclick
1475 void wxWindowBase::OnMiddleClick( wxMouseEvent
& event
)
1477 if ( event
.ControlDown() && event
.AltDown() )
1479 // don't translate these strings
1481 switch ( wxGetOsVersion() )
1483 case wxMOTIF_X
: port
= _T("Motif"); break;
1484 case wxMACINTOSH
: port
= _T("Mac"); break;
1485 case wxBEOS
: port
= _T("BeOS"); break;
1489 case wxGTK_BEOS
: port
= _T("GTK"); break;
1495 case wxWIN386
: port
= _T("MS Windows"); break;
1499 case wxMGL_OS2
: port
= _T("MGL"); break;
1501 case wxOS2_PM
: port
= _T("OS/2"); break;
1502 default: port
= _T("unknown"); break;
1505 wxMessageBox(wxString::Format(
1507 " wxWindows Library (%s port)\nVersion %u.%u.%u, compiled at %s %s\n Copyright (c) 1995-2000 wxWindows team"
1516 _T("wxWindows information"),
1517 wxICON_INFORMATION
| wxOK
,
1526 // ----------------------------------------------------------------------------
1527 // list classes implementation
1528 // ----------------------------------------------------------------------------
1530 void wxWindowListNode::DeleteData()
1532 delete (wxWindow
*)GetData();