-#if wxOSX_USE_CARBON
- wxMacControl* GetPeer() const { return m_peer ; }
-#else
- wxWidgetImpl* GetPeer() const { return m_peer ; }
-#endif
-
+ wxOSXWidgetImpl* GetPeer() const;
+
+ // optimization to avoid creating a user pane in wxWindow::Create if we already know
+ // we will replace it with our own peer
+ void DontCreatePeer();
+
+ // return true unless DontCreatePeer() had been called
+ bool ShouldCreatePeer() const;
+
+ // sets the native implementation wrapper, can replace an existing peer, use peer = NULL to
+ // release existing peer
+ void SetPeer(wxOSXWidgetImpl* peer);
+
+ // wraps the already existing peer with the wrapper
+ void SetWrappingPeer(wxOSXWidgetImpl* wrapper);
+
+#if wxOSX_USE_COCOA_OR_IPHONE
+ // the NSView or NSWindow of this window: can be used for both child and
+ // non-owned windows
+ //
+ // this is useful for a few Cocoa function which can work with either views
+ // or windows indiscriminately, e.g. for setting NSViewAnimationTargetKey
+ virtual void *OSXGetViewOrWindow() const { return GetHandle(); }
+#endif // Cocoa
+