1 /////////////////////////////////////////////////////////////////////////////
2 // Name: include/wx/mac/carbon/window.h
3 // Purpose: wxWindowMac class
4 // Author: Stefan Csomor
8 // Copyright: (c) Stefan Csomor
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
18 class WXDLLIMPEXP_FWD_CORE wxButton
;
19 class WXDLLIMPEXP_FWD_CORE wxScrollBar
;
20 class WXDLLIMPEXP_FWD_CORE wxTopLevelWindowMac
;
24 class WXDLLEXPORT wxWindowMac
: public wxWindowBase
26 DECLARE_DYNAMIC_CLASS(wxWindowMac
)
29 friend class wxPaintDC
;
34 wxWindowMac( wxWindowMac
*parent
,
36 const wxPoint
& pos
= wxDefaultPosition
,
37 const wxSize
& size
= wxDefaultSize
,
39 const wxString
& name
= wxPanelNameStr
);
41 virtual ~wxWindowMac();
43 bool Create( wxWindowMac
*parent
,
45 const wxPoint
& pos
= wxDefaultPosition
,
46 const wxSize
& size
= wxDefaultSize
,
48 const wxString
& name
= wxPanelNameStr
);
50 // implement base class pure virtuals
51 virtual void SetLabel( const wxString
& label
);
52 virtual wxString
GetLabel() const;
57 virtual bool Show( bool show
= true );
59 virtual void SetFocus();
61 virtual void WarpPointer( int x
, int y
);
63 virtual void Refresh( bool eraseBackground
= true,
64 const wxRect
*rect
= NULL
);
65 virtual void Freeze();
67 virtual bool IsFrozen() const;
69 virtual void Update() ;
70 virtual void ClearBackground();
72 virtual bool SetCursor( const wxCursor
&cursor
);
73 virtual bool SetFont( const wxFont
&font
);
74 virtual bool SetBackgroundColour( const wxColour
&colour
);
75 virtual bool SetForegroundColour( const wxColour
&colour
);
77 virtual int GetCharHeight() const;
78 virtual int GetCharWidth() const;
79 virtual void GetTextExtent( const wxString
& string
,
82 int *externalLeading
= NULL
,
83 const wxFont
*theFont
= NULL
)
86 virtual void DoEnable( bool enable
);
87 virtual void OnEnabled( bool enabled
);
88 virtual bool DoPopupMenu( wxMenu
*menu
, int x
, int y
);
91 virtual void SetScrollbar( int orient
, int pos
, int thumbVisible
,
92 int range
, bool refresh
= true );
93 virtual void SetScrollPos( int orient
, int pos
, bool refresh
= true );
94 virtual int GetScrollPos( int orient
) const;
95 virtual int GetScrollThumb( int orient
) const;
96 virtual int GetScrollRange( int orient
) const;
97 virtual void ScrollWindow( int dx
, int dy
,
98 const wxRect
* rect
= (wxRect
*) NULL
);
99 virtual void AlwaysShowScrollbars(bool horz
= true, bool vert
= true);
100 virtual bool IsScrollbarAlwaysShown(int orient
) const
102 return orient
== wxHORIZONTAL
? m_hScrollBarAlwaysShown
103 : m_vScrollBarAlwaysShown
;
106 virtual bool Reparent( wxWindowBase
*newParent
);
108 #if wxUSE_DRAG_AND_DROP
109 virtual void SetDropTarget( wxDropTarget
*dropTarget
);
112 // Accept files for dragging
113 virtual void DragAcceptFiles( bool accept
);
115 // implementation from now on
116 // --------------------------
118 void MacClientToRootWindow( int *x
, int *y
) const;
119 void MacRootWindowToClient( int *x
, int *y
) const;
121 void MacWindowToRootWindow( int *x
, int *y
) const;
122 void MacWindowToRootWindow( short *x
, short *y
) const;
124 void MacRootWindowToWindow( int *x
, int *y
) const;
125 void MacRootWindowToWindow( short *x
, short *y
) const;
127 virtual wxString
MacGetToolTipString( wxPoint
&where
);
132 virtual WXWidget
GetHandle() const;
134 virtual bool SetTransparent(wxByte alpha
);
135 virtual bool CanSetTransparent();
136 virtual wxByte
GetTransparent() const ;
140 void OnSetFocus( wxFocusEvent
& event
);
141 void OnPaint( wxPaintEvent
& event
);
142 void OnNcPaint( wxNcPaintEvent
& event
);
143 void OnEraseBackground(wxEraseEvent
& event
);
144 void OnMouseEvent( wxMouseEvent
&event
);
146 void MacOnScroll( wxScrollEvent
&event
);
148 virtual bool AcceptsFocus() const;
150 virtual bool IsDoubleBuffered() const { return true; }
153 static long MacRemoveBordersFromStyle( long style
) ;
156 void OnInternalIdle();
158 // For implementation purposes:
159 // sometimes decorations make the client area smaller
160 virtual wxPoint
GetClientAreaOrigin() const;
162 wxWindowMac
*FindItem(long id
) const;
163 wxWindowMac
*FindItemByHWND(WXHWND hWnd
, bool controlOnly
= false) const;
165 virtual void MacHandleControlClick( WXWidget control
, wxInt16 controlpart
, bool mouseStillDown
) ;
166 virtual bool MacDoRedraw( WXHRGN updatergn
, long time
) ;
167 virtual bool MacCanFocus() const ;
169 // this should not be overriden in classes above wxWindowMac
170 // because it is called from its destructor via DeleteChildren
171 virtual void RemoveChild( wxWindowBase
*child
);
172 virtual void MacPaintBorders( int left
, int top
) ;
173 void MacPaintGrowBox();
175 // invalidates the borders and focus area around the control;
176 // must not be virtual as it will be called during destruction
177 void MacInvalidateBorders() ;
179 WXWindow
MacGetTopLevelWindowRef() const ;
180 wxTopLevelWindowMac
* MacGetTopLevelWindow() const ;
182 virtual long MacGetLeftBorderSize() const ;
183 virtual long MacGetRightBorderSize() const ;
184 virtual long MacGetTopBorderSize() const ;
185 virtual long MacGetBottomBorderSize() const ;
187 virtual void MacSuperChangedPosition() ;
189 // absolute coordinates of this window's root have changed
190 virtual void MacTopLevelWindowChangedPosition() ;
192 virtual void MacChildAdded() ;
193 virtual void MacVisibilityChanged() ;
194 virtual void MacEnabledStateChanged() ;
195 virtual void MacHiliteChanged() ;
196 virtual wxInt32
MacControlHit( WXEVENTHANDLERREF handler
, WXEVENTREF event
) ;
198 bool MacIsReallyShown() ;
199 bool MacIsReallyEnabled() ;
200 bool MacIsReallyHilited() ;
202 bool MacIsUserPane() { return m_macIsUserPane
; }
204 virtual bool MacSetupCursor( const wxPoint
& pt
) ;
205 virtual void MacSetBackgroundBrush( const wxBrush
&brush
) ;
206 const wxBrush
& MacGetBackgroundBrush() const { return m_macBackgroundBrush
; }
208 // return the rectangle that would be visible of this control,
209 // regardless whether controls are hidden
210 // only taking into account clipping by parent windows
211 const wxRect
& MacGetClippedClientRect() const ;
212 const wxRect
& MacGetClippedRect() const ;
213 const wxRect
& MacGetClippedRectWithOuterStructure() const ;
215 // returns the visible region of this control in window ie non-client coordinates
216 const wxRegion
& MacGetVisibleRegion( bool includeOuterStructures
= false ) ;
218 // returns true if children have to clipped to the content area
219 // (e.g., scrolled windows)
220 bool MacClipChildren() const { return m_clipChildren
; }
221 void MacSetClipChildren( bool clip
) { m_clipChildren
= clip
; }
223 // returns true if the grandchildren need to be clipped to the children's content area
224 // (e.g., splitter windows)
225 virtual bool MacClipGrandChildren() const { return false ; }
226 bool MacIsWindowScrollbar( const wxWindow
* sb
) const
227 { return ((wxWindow
*)m_hScrollBar
== sb
|| (wxWindow
*)m_vScrollBar
== sb
) ; }
228 virtual bool IsClientAreaChild(const wxWindow
*child
) const
230 return !MacIsWindowScrollbar(child
) &&
231 wxWindowBase::IsClientAreaChild(child
);
234 virtual void MacInstallEventHandler(WXWidget native
) ;
235 void MacPostControlCreate(const wxPoint
& pos
, const wxSize
& size
) ;
236 wxList
& GetSubcontrols() { return m_subControls
; }
237 WXEVENTHANDLERREF
MacGetControlEventHandler() { return m_macControlEventHandler
; }
239 // translate wxWidgets coords into ones suitable
240 // to be passed to CreateControl calls
242 // returns true if non-default coords are returned, false otherwise
243 bool MacGetBoundsForControl(const wxPoint
& pos
,
246 int& w
, int& h
, bool adjustForOrigin
) const ;
248 // calculates the real window position and size from the native control
249 void MacGetPositionAndSizeFromControl(int& x
, int& y
,
250 int& w
, int& h
) const ;
252 // gets the inset from every part
253 virtual void MacGetContentAreaInset( int &left
, int &top
, int &right
, int &bottom
) ;
255 // visibly flash the current invalid area:
256 // useful for debugging in OSX composited (double-buffered) situation
257 void MacFlashInvalidAreas() ;
259 // the 'true' OS level control for this wxWindow
260 wxMacControl
* GetPeer() const { return m_peer
; }
262 void * MacGetCGContextRef() { return m_cgContextRef
; }
263 void MacSetCGContextRef(void * cg
) { m_cgContextRef
= cg
; }
266 // For controls like radio buttons which are genuinely composite
267 wxList m_subControls
;
269 // number of calls to Freeze() minus number of calls to Thaw()
270 unsigned int m_frozenness
;
272 // the peer object, allowing for cleaner API support
273 wxMacControl
* m_peer
;
275 void * m_cgContextRef
;
277 // cache the clipped rectangles within the window hierarchy
278 void MacUpdateClippedRects() const ;
280 mutable bool m_cachedClippedRectValid
;
281 mutable wxRect m_cachedClippedRectWithOuterStructure
;
282 mutable wxRect m_cachedClippedRect
;
283 mutable wxRect m_cachedClippedClientRect
;
284 mutable wxRegion m_cachedClippedRegionWithOuterStructure
;
285 mutable wxRegion m_cachedClippedRegion
;
286 mutable wxRegion m_cachedClippedClientRegion
;
288 // true if is is not a native control but a wxWindow control
289 bool m_macIsUserPane
;
290 wxBrush m_macBackgroundBrush
;
292 // insets of the mac control from the wx top left corner
293 wxPoint m_macTopLeftInset
;
294 wxPoint m_macBottomRightInset
;
297 wxScrollBar
* m_hScrollBar
;
298 wxScrollBar
* m_vScrollBar
;
299 bool m_hScrollBarAlwaysShown
;
300 bool m_vScrollBarAlwaysShown
;
303 // set to true if we do a sharp clip at the content area of this window
304 // must be dynamic as eg a panel normally is not clipping precisely, but if
305 // it becomes the target window of a scrolled window it has to...
306 bool m_clipChildren
;
308 virtual bool MacIsChildOfClientArea( const wxWindow
* child
) const ;
310 bool MacHasScrollBarCorner() const;
311 void MacCreateScrollBars( long style
) ;
312 void MacRepositionScrollBars() ;
313 void MacUpdateControlFont() ;
315 void MacPropagateVisibilityChanged() ;
316 void MacPropagateEnabledStateChanged() ;
317 void MacPropagateHiliteChanged() ;
319 // implement the base class pure virtuals
320 virtual wxSize
DoGetBestSize() const;
321 virtual wxSize
DoGetSizeFromClientSize( const wxSize
& size
) const;
322 virtual void DoClientToScreen( int *x
, int *y
) const;
323 virtual void DoScreenToClient( int *x
, int *y
) const;
324 virtual void DoGetPosition( int *x
, int *y
) const;
325 virtual void DoGetSize( int *width
, int *height
) const;
326 virtual void DoGetClientSize( int *width
, int *height
) const;
327 virtual void DoSetSize(int x
, int y
,
328 int width
, int height
,
329 int sizeFlags
= wxSIZE_AUTO
);
330 virtual void DoSetClientSize(int width
, int height
);
332 virtual void DoCaptureMouse();
333 virtual void DoReleaseMouse();
335 // move the window to the specified location and resize it: this is called
336 // from both DoSetSize() and DoSetClientSize() and would usually just call
337 // ::MoveWindow() except for composite controls which will want to arrange
338 // themselves inside the given rectangle
339 virtual void DoMoveWindow( int x
, int y
, int width
, int height
);
340 virtual void DoSetWindowVariant( wxWindowVariant variant
);
343 virtual void DoSetToolTip( wxToolTip
*tip
);
347 // common part of all ctors
350 // show/hide scrollbars as needed, common part of SetScrollbar() and
351 // AlwaysShowScrollbars()
352 void DoUpdateScrollbarVisibility();
355 WXEVENTHANDLERREF m_macControlEventHandler
;
357 DECLARE_NO_COPY_CLASS(wxWindowMac
)
358 DECLARE_EVENT_TABLE()
361 #endif // _WX_WINDOW_H_