QMacNativeWidget Class

The QMacNativeWidget class provides a widget for macOS that provides a way to put Qt widgets into Cocoa hierarchies. 更多...

头：	#include <QMacNativeWidget>
qmake:	QT += widgets
Since:	Qt 4.5
继承：	QWidget

所有成员列表，包括继承成员

公共函数

	QMacNativeWidget (NSView * parentView = Q_NULLPTR)
	~QMacNativeWidget ()
NSView *	nativeView () const

重实现公共函数

virtual QSize

sizeHint () const override

214 公共函数继承自 QWidget
32 公共函数继承自 QObject
14 公共函数继承自 QPaintDevice

重实现保护函数

virtual bool

event (QEvent * ev ) override

35 保护函数继承自 QWidget
9 保护函数继承自 QObject
1 保护函数继承自 QPaintDevice

额外继承成员

59 特性继承自 QWidget
1 特性继承自 QObject
19 公共槽继承自 QWidget
1 公共槽继承自 QObject
3 信号继承自 QWidget
2 信号继承自 QObject
5 静态公共成员继承自 QWidget
11 静态公共成员继承自 QObject
35 保护函数继承自 QWidget
9 保护函数继承自 QObject
1 保护函数继承自 QPaintDevice
1 保护槽继承自 QWidget

详细描述

The QMacNativeWidget class provides a widget for macOS that provides a way to put Qt widgets into Cocoa hierarchies.

On macOS, 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.

Here is an example showing how to put a QPushButton into a NSWindow:

    NSAutoreleasePool *pool = [[NSAutoreleasePool alloc] init];
    NSWindow *window = [[NSWindow alloc] initWithContentRect:NSMakeRect(200, app.desktop()->height() - 200, 239, 200)
                        styleMask:NSTitledWindowMask | NSClosableWindowMask
                                  | NSMiniaturizableWindowMask | NSResizableWindowMask
                        backing:NSBackingStoreBuffered defer:NO];
    QMacNativeWidget *nativeWidget = new QMacNativeWidget();
    nativeWidget->move(0, 0);
    nativeWidget->setPalette(QPalette(Qt::red));
    nativeWidget->setAutoFillBackground(true);
    QVBoxLayout *layout = new QVBoxLayout();
    QPushButton *pushButton = new QPushButton("An Embedded Qt Button!", nativeWidget);
    pushButton->setAttribute(Qt::WA_LayoutUsesWidgetRect); // Don't use the layout rect calculated from QMacStyle.
    layout->addWidget(pushButton);
    nativeWidget->setLayout(layout);
    // Adjust Cocoa layouts
    NSView *nativeWidgetView = reinterpret_cast<NSView *>(nativeWidget->winId());
    NSView *contentView = [window contentView];
    [contentView setAutoresizesSubviews:YES];
    [nativeWidgetView setAutoresizingMask:NSViewWidthSizable | NSViewHeightSizable];
    [nativeWidgetView setAutoresizesSubviews:YES];
    NSView *pushButtonView = reinterpret_cast<NSView *>(pushButton->winId());
    [pushButtonView setAutoresizingMask:NSViewWidthSizable];
    // Add the nativeWidget to the window.
    [contentView addSubview:nativeWidgetView positioned:NSWindowAbove relativeTo:nil];
    nativeWidget->show();
    pushButton->show();
    // Show the window.
    [window makeKeyAndOrderFront:window];
    [pool release];

注意， QMacNativeWidget requires knowledge of 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.

成员函数文档编制

QMacNativeWidget:: QMacNativeWidget ( NSView * parentView = Q_NULLPTR)

创建 QMacNativeWidget with parentView as its "superview" (i.e., parent). The parentView is a NSView pointer.

QMacNativeWidget:: ~QMacNativeWidget ()

Destroy the QMacNativeWidget .

`[override virtual protected]` bool QMacNativeWidget:: event ( QEvent * ev )

重实现自 QObject::event ().

NSView *QMacNativeWidget:: nativeView () const

Returns the native view backing the QMacNativeWidget .

`[override virtual]` QSize QMacNativeWidget:: sizeHint () const

重实现自 QWidget::sizeHint ().

内容