diff -r 000000000000 -r 1918ee327afb src/gui/widgets/qmacnativewidget_mac.mm --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/gui/widgets/qmacnativewidget_mac.mm Mon Jan 11 14:00:40 2010 +0000 @@ -0,0 +1,133 @@ +/**************************************************************************** +** +** Copyright (C) 2009 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 +#import +#include "qmacnativewidget_mac.h" +#include + +/*! + \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