diff options
Diffstat (limited to 'src/widgets/widgets/qmacnativewidget_mac.mm')
-rw-r--r-- | src/widgets/widgets/qmacnativewidget_mac.mm | 133 |
1 files changed, 133 insertions, 0 deletions
diff --git a/src/widgets/widgets/qmacnativewidget_mac.mm b/src/widgets/widgets/qmacnativewidget_mac.mm new file mode 100644 index 0000000000..b3c00d3cc6 --- /dev/null +++ b/src/widgets/widgets/qmacnativewidget_mac.mm @@ -0,0 +1,133 @@ +/**************************************************************************** +** +** 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$ +** GNU Lesser General Public License Usage +** 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. +** +** GNU General Public License Usage +** Alternatively, this file may be used under the terms of the GNU General +** Public License version 3.0 as published by the Free Software Foundation +** and appearing in the file LICENSE.GPL included in the packaging of this +** file. Please review the following information to ensure the GNU General +** Public License version 3.0 requirements will be met: +** http://www.gnu.org/copyleft/gpl.html. +** +** Other Usage +** Alternatively, this file may be used in accordance with the terms and +** conditions contained in a signed written agreement between you and Nokia. +** +** +** +** +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#import <Cocoa/Cocoa.h> +#import <private/qcocoaview_mac_p.h> +#include "qmacnativewidget_mac.h" +#include <private/qwidget_p.h> + +/*! + \class QMacNativeWidget + \since 4.5 + \brief The QMacNativeWidget class provides a widget for Mac OS X that provides a way to put Qt widgets into Carbon + or Cocoa hierarchies depending on how Qt was configured. + + \ingroup advanced + + On Mac OS X, there is a difference between a window and view; + normally expressed as widgets in Qt. Qt makes assumptions about its + parent-child hierarchy that make it complex to put an arbitrary Qt widget + into a hierarchy of "normal" views from Apple frameworks. QMacNativeWidget + bridges the gap between views and windows and makes it possible to put a + hierarchy of Qt widgets into a non-Qt window or view. + + QMacNativeWidget pretends it is a window (i.e. isWindow() will return true), + but it cannot be shown on its own. It needs to be put into a window + when it is created or later through a native call. + + QMacNativeWidget works for either Carbon or Cocoa depending on how Qt was configured. If Qt is + using Carbon, QMacNativeWidget will embed into Carbon hierarchies. If Qt is + using Cocoa, QMacNativeWidget embeds into Cocoa hierarchies. + + Here is an example of putting a QPushButton into a NSWindow: + + \snippet doc/src/snippets/qmacnativewidget/main.mm 0 + + On Carbon, this would do the equivalent: + + \snippet doc/src/snippets/qmacnativewidget/main.mm 1 + + Note that QMacNativeWidget requires knowledge of Carbon or Cocoa. All it + does is get the Qt hierarchy into a window not owned by Qt. It is then up + to the programmer to ensure it is placed correctly in the window and + responds correctly to events. +*/ + +QT_BEGIN_NAMESPACE + +class QMacNativeWidgetPrivate : public QWidgetPrivate +{ +}; + +extern OSViewRef qt_mac_create_widget(QWidget *widget, QWidgetPrivate *widgetPrivate, OSViewRef parent); + + +/*! + Create a QMacNativeWidget with \a parentView as its "superview" (i.e., + parent). The \a parentView is either an HIViewRef if Qt is using Carbon or + a NSView pointer if Qt is using Cocoa. +*/ +QMacNativeWidget::QMacNativeWidget(void *parentView) + : QWidget(*new QMacNativeWidgetPrivate, 0, Qt::Window) +{ + Q_D(QMacNativeWidget); + OSViewRef myView = qt_mac_create_widget(this, d, OSViewRef(parentView)); + + d->topData()->embedded = true; + create(WId(myView), false, false); + setPalette(QPalette(Qt::transparent)); + setAttribute(Qt::WA_SetPalette, false); + setAttribute(Qt::WA_LayoutUsesWidgetRect); +} + +/*! + Destroy the QMacNativeWidget. +*/ +QMacNativeWidget::~QMacNativeWidget() +{ +} + +/*! + \reimp +*/ +QSize QMacNativeWidget::sizeHint() const +{ + return QSize(200, 200); +} +/*! + \reimp +*/ +bool QMacNativeWidget::event(QEvent *ev) +{ + return QWidget::event(ev); +} + +QT_END_NAMESPACE |