library split

1 files changed, 187 insertions, 0 deletions

diff --git a/src/widgets/widgets/qmaccocoaviewcontainer_mac.mm b/src/widgets/widgets/qmaccocoaviewcontainer_mac.mm
new file mode 100644
index 0000000000..cefc93f734
--- /dev/null
+++ b/src/widgets/widgets/qmaccocoaviewcontainer_mac.mm
@@ -0,0 +1,187 @@
+/****************************************************************************
+**
+** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the QtGui module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights.  These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#import <Cocoa/Cocoa.h>
+#include <private/qwidget_p.h>
+#include "qmaccocoaviewcontainer_mac.h"
+#include <private/qt_mac_p.h>
+
+/*!
+    \class QMacCocoaViewContainer
+    \since 4.5
+
+    \brief The QMacCocoaViewContainer class provides a widget for Mac OS X that can be used to wrap arbitrary
+    Cocoa views (i.e., NSView subclasses) and insert them into Qt hierarchies.
+
+    \ingroup advanced
+
+    While Qt offers a lot of classes for writing your application, Apple's
+    Cocoa framework offers lots of functionality that is not currently in Qt or
+    may never end up in Qt. Using QMacCocoaViewContainer, it is possible to put an
+    arbitrary NSView-derived class from Cocoa and put it in a Qt hierarchy.
+    Depending on how comfortable you are with using objective-C, you can use
+    QMacCocoaViewContainer directly, or subclass it to wrap further functionality
+    of the underlying NSView.
+
+    QMacCocoaViewContainer works regardless if Qt is built against Carbon or
+    Cocoa. However, QCocoaContainerView requires Mac OS X 10.5 or better to be
+    used with Carbon.
+
+    It should be also noted that at the low level on Mac OS X, there is a
+    difference between windows (top-levels) and view (widgets that are inside a
+    window). For this reason, make sure that the NSView that you are wrapping
+    doesn't end up as a top-level. The best way to ensure this is to make sure
+    you always have a parent and not set the parent to 0.
+
+    If you are using QMacCocoaViewContainer as a sub-class and are mixing and
+    matching objective-C with C++ (a.k.a. objective-C++). It is probably
+    simpler to have your file end with \tt{.mm} than \tt{.cpp}. Most Apple tools will
+    correctly identify the source as objective-C++.
+
+    QMacCocoaViewContainer requires knowledge of how Cocoa works, especially in
+    regard to its reference counting (retain/release) nature. It is noted in
+    the functions below if there is any change in the reference count. Cocoa
+    views often generate temporary objects that are released by an autorelease
+    pool. If this is done outside of a running event loop, it is up to the
+    developer to provide the autorelease pool.
+
+    The following is a snippet of subclassing QMacCocoaViewContainer to wrap a NSSearchField.
+    \snippet demos/macmainwindow/macmainwindow.mm 0
+
+*/
+
+QT_BEGIN_NAMESPACE
+
+class QMacCocoaViewContainerPrivate : public QWidgetPrivate
+{
+    Q_DECLARE_PUBLIC(QMacCocoaViewContainer)
+public:
+    NSView *nsview;
+#ifndef QT_MAC_USE_COCOA
+    HIViewRef wrapperView;
+#endif
+    QMacCocoaViewContainerPrivate();
+    ~QMacCocoaViewContainerPrivate();
+};
+
+QMacCocoaViewContainerPrivate::QMacCocoaViewContainerPrivate()
+     : nsview(0)
+#ifndef QT_MAC_USE_COCOA
+       , wrapperView(0)
+#endif
+{
+}
+
+QMacCocoaViewContainerPrivate::~QMacCocoaViewContainerPrivate()
+{
+    [nsview release];
+#ifndef QT_MAC_USE_COCOA
+    if (wrapperView)
+        CFRelease(wrapperView);
+#endif
+}
+
+/*!
+    \fn QMacCocoaViewContainer::QMacCocoaViewContainer(void *cocoaViewToWrap, QWidget *parent)
+ 
+    Create a new QMacCocoaViewContainer using the NSView pointer in \a
+    cocoaViewToWrap with parent, \a parent. QMacCocoaViewContainer will
+    retain \a cocoaViewToWrap.
+
+    \a cocoaViewToWrap is a void pointer that allows the header to be included
+    with C++ source.
+*/
+QMacCocoaViewContainer::QMacCocoaViewContainer(void *cocoaViewToWrap, QWidget *parent)
+   : QWidget(*new QMacCocoaViewContainerPrivate, parent, 0)
+{
+    if (cocoaViewToWrap)
+        setCocoaView(cocoaViewToWrap);
+}
+
+/*!
+    Destroy the QMacCocoaViewContainer and release the wrapped view.
+*/
+QMacCocoaViewContainer::~QMacCocoaViewContainer()
+{
+}
+
+/*!
+    Returns the NSView that has been set on this container.  The returned view
+    has been autoreleased, so you will need to retain it if you want to make
+    use of it.
+*/
+void *QMacCocoaViewContainer::cocoaView() const
+{
+    Q_D(const QMacCocoaViewContainer);
+    return [[d->nsview retain] autorelease];
+}
+
+/*!
+    Sets the NSView to contain to be \a cocoaViewToWrap and retains it. If this
+    container already had a view set, it will release the previously set view.
+*/
+void QMacCocoaViewContainer::setCocoaView(void *cocoaViewToWrap)
+{
+    Q_D(QMacCocoaViewContainer);
+    QMacCocoaAutoReleasePool pool;
+    NSView *view = static_cast<NSView *>(cocoaViewToWrap);
+    NSView *oldView = d->nsview;
+    destroy(true, true);
+    [view retain];
+    d->nsview = view;
+#ifndef QT_MAC_USE_COCOA
+    if (QSysInfo::MacintoshVersion < QSysInfo::MV_10_5) {
+        qWarning("QMacCocoaViewContainer::setCocoaView: You cannot use this class with Carbon on versions of Mac OS X less than 10.5.");
+        return;
+    }
+#if MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_5
+    if (d->wrapperView)
+        CFRelease(d->wrapperView);
+    HICocoaViewCreate(d->nsview, 0, &d->wrapperView);
+    create(WId(d->wrapperView), false, true);
+#endif
+#else
+    create(WId(d->nsview), false, true);
+#endif
+    [oldView release];
+}
+
+QT_END_NAMESPACE