![]() |
Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
|
#include <qcocoawindow.h>
Classes | |
struct | BorderRange |
Public Types | |
enum | RecreationReason { RecreationNotNeeded = 0 , ParentChanged = 0x1 , MissingWindow = 0x2 , WindowModalityChanged = 0x4 , ContentViewChanged = 0x10 , PanelChanged = 0x20 } |
enum | HandleFlags { NoHandleFlags = 0 , HandleUnconditionally = 1 } |
Public Member Functions | |
QCocoaWindow (QWindow *tlw, WId nativeHandle=0) | |
~QCocoaWindow () | |
void | initialize () override |
Called as part of QWindow::create(), after constructing the window. | |
void | setGeometry (const QRect &rect) override |
This function is called by Qt whenever a window is moved or resized using the QWindow API. | |
QRect | geometry () const override |
Returns the current geometry of a window. | |
QRect | normalGeometry () const override |
the geometry of the window as it will appear when shown as a normal (not maximized or full screen) top-level window. | |
void | setCocoaGeometry (const QRect &rect) |
QMargins | safeAreaMargins () const override |
The safe area margins of a window represent the area that is safe to place content within, without intersecting areas of the screen where system UI is placed, or where a screen bezel may cover the content. | |
void | setVisible (bool visible) override |
Reimplemented in subclasses to show the surface if visible is true , and hide it if visible is false . | |
void | setWindowFlags (Qt::WindowFlags flags) override |
Requests setting the window flags of this surface to flags. | |
void | setWindowState (Qt::WindowStates state) override |
Changes the state of the NSWindow, going in/out of minimize/zoomed/fullscreen. | |
void | setWindowTitle (const QString &title) override |
Reimplement to set the window title to title. | |
void | setWindowFilePath (const QString &filePath) override |
Reimplement to set the window file path to filePath. | |
void | setWindowIcon (const QIcon &icon) override |
Reimplement to set the window icon to icon. | |
void | setAlertState (bool enabled) override |
Reimplement this method to set whether the window demands attention (for example, by flashing the taskbar icon) depending on enabled. | |
bool | isAlertState () const override |
Reimplement this method return whether the window is in an alert state. | |
void | raise () override |
Reimplement to be able to let Qt raise windows to the top of the desktop. | |
void | lower () override |
Reimplement to be able to let Qt lower windows to the bottom of the desktop. | |
bool | isExposed () const override |
Returns if this window is exposed in the windowing system. | |
bool | isEmbedded () const override |
Returns true if the window is a child of a non-Qt window. | |
bool | isOpaque () const |
void | propagateSizeHints () override |
Reimplement to propagate the size hints of the QWindow. | |
void | setOpacity (qreal level) override |
Reimplement to be able to let Qt set the opacity level of a window. | |
void | setMask (const QRegion ®ion) override |
Reimplement to be able to let Qt set the mask of a window. | |
bool | setKeyboardGrabEnabled (bool grab) override |
bool | setMouseGrabEnabled (bool grab) override |
QMargins | frameMargins () const override |
QSurfaceFormat | format () const override |
Returns the actual surface format of the window. | |
bool | isForeignWindow () const override |
void | requestUpdate () override |
Requests an QEvent::UpdateRequest event. | |
bool | updatesWithDisplayLink () const |
void | deliverUpdateRequest () override |
Delivers an QEvent::UpdateRequest event to the window. | |
void | requestActivateWindow () override |
Reimplement to let Qt be able to request activation/focus for a window. | |
WId | winId () const override |
Reimplement in subclasses to return a handle to the native window. | |
void | setParent (const QPlatformWindow *window) override |
This function is called to enable native child window in QPA. | |
NSView * | view () const |
NSWindow * | nativeWindow () const |
void | setEmbeddedInForeignView () |
Q_NOTIFICATION_HANDLER (NSViewFrameDidChangeNotification) void viewDidChangeFrame() | |
Q_NOTIFICATION_HANDLER (NSViewGlobalFrameDidChangeNotification) void viewDidChangeGlobalFrame() | |
Q_NOTIFICATION_HANDLER (NSWindowDidMoveNotification) void windowDidMove() | |
Q_NOTIFICATION_HANDLER (NSWindowDidResizeNotification) void windowDidResize() | |
Q_NOTIFICATION_HANDLER (NSWindowWillStartLiveResizeNotification) void windowWillStartLiveResize() | |
Q_NOTIFICATION_HANDLER (NSWindowDidEndLiveResizeNotification) void windowDidEndLiveResize() | |
Q_NOTIFICATION_HANDLER (NSWindowDidBecomeKeyNotification) void windowDidBecomeKey() | |
Q_NOTIFICATION_HANDLER (NSWindowDidResignKeyNotification) void windowDidResignKey() | |
Q_NOTIFICATION_HANDLER (NSWindowDidMiniaturizeNotification) void windowDidMiniaturize() | |
Q_NOTIFICATION_HANDLER (NSWindowDidDeminiaturizeNotification) void windowDidDeminiaturize() | |
Q_NOTIFICATION_HANDLER (NSWindowWillEnterFullScreenNotification) void windowWillEnterFullScreen() | |
Q_NOTIFICATION_HANDLER (NSWindowDidEnterFullScreenNotification) void windowDidEnterFullScreen() | |
Q_NOTIFICATION_HANDLER (NSWindowWillExitFullScreenNotification) void windowWillExitFullScreen() | |
Q_NOTIFICATION_HANDLER (NSWindowDidExitFullScreenNotification) void windowDidExitFullScreen() | |
Q_NOTIFICATION_HANDLER (NSWindowDidOrderOnScreenAndFinishAnimatingNotification) void windowDidOrderOnScreen() | |
Q_NOTIFICATION_HANDLER (NSWindowDidOrderOffScreenNotification) void windowDidOrderOffScreen() | |
Q_NOTIFICATION_HANDLER (NSWindowDidChangeOcclusionStateNotification) void windowDidChangeOcclusionState() | |
Q_NOTIFICATION_HANDLER (NSWindowDidChangeScreenNotification) void windowDidChangeScreen() | |
void | windowWillZoom () |
bool | windowShouldClose () |
bool | windowIsPopupType (Qt::WindowType type=Qt::Widget) const |
NSInteger | windowLevel (Qt::WindowFlags flags) |
NSUInteger | windowStyleMask (Qt::WindowFlags flags) |
void | updateTitleBarButtons (Qt::WindowFlags flags) |
bool | isFixedSize () const |
bool | setWindowModified (bool modified) override |
Reimplement to be able to let Qt indicate that the window has been modified. | |
void | setFrameStrutEventsEnabled (bool enabled) override |
Reimplement this method to set whether frame strut events should be sent to enabled. | |
bool | frameStrutEventsEnabled () const override |
Reimplement this method to return whether frame strut events are enabled. | |
void | setMenubar (QCocoaMenuBar *mb) |
QCocoaMenuBar * | menubar () const |
void | setWindowCursor (NSCursor *cursor) |
void | registerTouch (bool enable) |
void | registerContentBorderArea (quintptr identifier, int upper, int lower) |
void | setContentBorderAreaEnabled (quintptr identifier, bool enable) |
void | setContentBorderEnabled (bool enable) override |
bool | testContentBorderAreaPosition (int position) const |
void | applyContentBorderThickness (NSWindow *window=nullptr) |
qreal | devicePixelRatio () const override |
Reimplement this function in subclass to return the device pixel ratio for the window. | |
QWindow * | childWindowAt (QPoint windowPoint) |
bool | shouldRefuseKeyWindowAndFirstResponder () |
bool | windowEvent (QEvent *event) override |
Reimplement this method to be able to do any platform specific event handling. | |
QPoint | bottomLeftClippedByNSWindowOffset () const override |
void | updateNormalGeometry () |
bool | allowsIndependentThreadedRendering () const override |
Returns whether applications can render new frames from any thread without co-ordination with the main thread. | |
bool | isContentView () const |
Checks if the window is the content view of its immediate NSWindow. | |
bool | alwaysShowToolWindow () const |
void | handleGeometryChange () |
void | handleWindowStateChanged (HandleFlags flags=NoHandleFlags) |
void | handleExposeEvent (const QRegion ®ion) |
CALayer * | contentLayer () const override |
void | manageVisualEffectArea (quintptr identifier, const QRect &rect, NSVisualEffectMaterial material, NSVisualEffectBlendingMode blendMode, NSVisualEffectState activationState) override |
void | updateSafeAreaMarginsIfNeeded () |
Public Member Functions inherited from QObject | |
Q_INVOKABLE | QObject (QObject *parent=nullptr) |
Constructs an object with parent object parent. | |
virtual | ~QObject () |
Destroys the object, deleting all its child objects. | |
virtual bool | event (QEvent *event) |
This virtual function receives events to an object and should return true if the event e was recognized and processed. | |
virtual bool | eventFilter (QObject *watched, QEvent *event) |
Filters events if this object has been installed as an event filter for the watched object. | |
QString | objectName () const |
Q_WEAK_OVERLOAD void | setObjectName (const QString &name) |
Sets the object's name to name. | |
void | setObjectName (QAnyStringView name) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
QBindable< QString > | bindableObjectName () |
bool | isWidgetType () const |
Returns true if the object is a widget; otherwise returns false . | |
bool | isWindowType () const |
Returns true if the object is a window; otherwise returns false . | |
bool | isQuickItemType () const |
Returns true if the object is a QQuickItem; otherwise returns false . | |
bool | isQmlObjectType () const |
Returns whether the object has been created by the QML engine or ownership has been explicitly set via QJSEngine::setObjectOwnership(). | |
bool | signalsBlocked () const noexcept |
Returns true if signals are blocked; otherwise returns false . | |
bool | blockSignals (bool b) noexcept |
If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). | |
QThread * | thread () const |
Returns the thread in which the object lives. | |
bool | moveToThread (QThread *thread QT6_DECL_NEW_OVERLOAD_TAIL) |
Changes the thread affinity for this object and its children and returns true on success. | |
int | startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer) |
This is an overloaded function that will start a timer of type timerType and a timeout of interval milliseconds. | |
int | startTimer (std::chrono::nanoseconds time, Qt::TimerType timerType=Qt::CoarseTimer) |
void | killTimer (int id) |
Kills the timer with timer identifier, id. | |
void | killTimer (Qt::TimerId id) |
template<typename T> | |
T | findChild (QAnyStringView aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const |
Returns the child of this object that can be cast into type T and that is called name, or \nullptr if there is no such object. | |
template<typename T> | |
QList< T > | findChildren (QAnyStringView aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const |
Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. | |
template<typename T> | |
T | findChild (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
template<typename T> | |
QList< T > | findChildren (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
const QObjectList & | children () const |
Returns a list of child objects. | |
void | setParent (QObject *parent) |
Makes the object a child of parent. | |
void | installEventFilter (QObject *filterObj) |
Installs an event filter filterObj on this object. | |
void | removeEventFilter (QObject *obj) |
Removes an event filter object obj from this object. | |
QMetaObject::Connection | connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const |
bool | disconnect (const char *signal=nullptr, const QObject *receiver=nullptr, const char *member=nullptr) const |
bool | disconnect (const QObject *receiver, const char *member=nullptr) const |
void | dumpObjectTree () const |
Dumps a tree of children to the debug output. | |
void | dumpObjectInfo () const |
Dumps information about signal connections, etc. | |
bool | setProperty (const char *name, const QVariant &value) |
Sets the value of the object's name property to value. | |
bool | setProperty (const char *name, QVariant &&value) |
QVariant | property (const char *name) const |
Returns the value of the object's name property. | |
QList< QByteArray > | dynamicPropertyNames () const |
QBindingStorage * | bindingStorage () |
const QBindingStorage * | bindingStorage () const |
QObject * | parent () const |
Returns a pointer to the parent object. | |
bool | inherits (const char *classname) const |
Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false . | |
Public Member Functions inherited from QPlatformWindow | |
QPlatformWindow (QWindow *window) | |
Constructs a platform window with the given top level window. | |
~QPlatformWindow () override | |
Virtual destructor does not delete its top level window. | |
QWindow * | window () const |
Returns the window which belongs to the QPlatformWindow. | |
QPlatformWindow * | parent () const |
Returns the parent platform window (or \nullptr if orphan). | |
QPlatformScreen * | screen () const override |
Returns the platform screen handle corresponding to this platform window, or null if the window is not associated with a screen. | |
virtual QString | windowTitle () const |
Reimplement to return the actual window title used in the underlying windowing system unless the title set for the QWindow which belongs to this QPlatformWindow (i.e. | |
virtual bool | close () |
Reimplement to let the platform handle non-spontaneous window close. | |
virtual bool | isActive () const |
Returns true if the window should appear active from a style perspective. | |
virtual bool | isAncestorOf (const QPlatformWindow *child) const |
Returns true if the window is an ancestor of the given child. | |
virtual QPoint | mapToGlobal (const QPoint &pos) const |
Translates the window coordinate pos to global screen coordinates using native methods. | |
QPointF | mapToGlobalF (const QPointF &pos) const |
virtual QPoint | mapFromGlobal (const QPoint &pos) const |
Translates the global screen coordinate pos to window coordinates using native methods. | |
QPointF | mapFromGlobalF (const QPointF &pos) const |
virtual void | handleContentOrientationChange (Qt::ScreenOrientation orientation) |
Handle changes to the orientation of the platform window's contents. | |
virtual bool | startSystemResize (Qt::Edges edges) |
Reimplement this method to start a system resize operation if the system supports it and return true to indicate success. | |
virtual void | invalidateSurface () |
Invalidates the window's surface by releasing its surface buffers. | |
bool | hasPendingUpdateRequest () const |
Returns true if the window has a pending update request. | |
QSize | windowMinimumSize () const |
Returns the QWindow minimum size. | |
QSize | windowMaximumSize () const |
Returns the QWindow maximum size. | |
QSize | windowBaseSize () const |
Returns the QWindow base size. | |
QSize | windowSizeIncrement () const |
Returns the QWindow size increment. | |
QRect | windowGeometry () const |
Returns the QWindow geometry. | |
QRect | windowFrameGeometry () const |
Returns the QWindow frame geometry. | |
QRectF | windowClosestAcceptableGeometry (const QRectF &nativeRect) const |
Public Member Functions inherited from QPlatformSurface | |
virtual | ~QPlatformSurface () |
QSurface * | surface () const |
Static Public Member Functions | |
static void | closeAllPopups () |
static void | setupPopupMonitor () |
static void | removePopupMonitor () |
Static Public Member Functions inherited from QObject | |
static QMetaObject::Connection | connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection) |
\threadsafe | |
static QMetaObject::Connection | connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection) |
template<typename Func1, typename Func2> | |
static QMetaObject::Connection | connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::ContextTypeForFunctor< Func2 >::ContextType *context, Func2 &&slot, Qt::ConnectionType type=Qt::AutoConnection) |
template<typename Func1, typename Func2> | |
static QMetaObject::Connection | connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, Func2 &&slot) |
static bool | disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member) |
\threadsafe | |
static bool | disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member) |
static bool | disconnect (const QMetaObject::Connection &) |
Disconnect a connection. | |
template<typename Func1, typename Func2> | |
static bool | disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object *receiver, Func2 slot) |
template<typename Func1> | |
static bool | disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const QObject *receiver, void **zero) |
Static Public Member Functions inherited from QPlatformWindow | |
static QRect | initialGeometry (const QWindow *w, const QRect &initialGeometry, int defaultWidth, int defaultHeight, const QScreen **resultingScreenReturn=nullptr) |
Helper function to get initial geometry on windowing systems which do not do smart positioning and also do not provide a means of centering a transient window w.r.t. | |
static QRectF | closestAcceptableGeometry (const QWindow *w, const QRectF &nativeRect) |
Returns the closest acceptable geometry for a given geometry before a resize/move event for platforms that support it, for example to implement heightForWidth(). |
Public Attributes | |
QFlatMap< quintptr, NSVisualEffectView * > | m_effectViews |
NSView * | m_view = nil |
QCocoaNSWindow * | m_nsWindow = nil |
Qt::WindowStates | m_lastReportedWindowState = Qt::WindowNoState |
Qt::WindowModality | m_windowModality = Qt::NonModal |
bool | m_initialized = false |
bool | m_inSetVisible = false |
bool | m_inSetGeometry = false |
bool | m_inSetStyleMask = false |
bool | m_inLiveResize = false |
QCocoaMenuBar * | m_menubar = nullptr |
bool | m_frameStrutEventsEnabled = false |
QRect | m_exposedRect |
QRect | m_normalGeometry |
int | m_registerTouchCount = 0 |
bool | m_resizableTransientParent = false |
QMacKeyValueObserver | m_safeAreaInsetsObserver |
QMargins | m_lastReportedSafeAreaMargins |
NSInteger | m_alertRequest = NoAlertRequest |
bool | m_drawContentBorderGradient = false |
QHash< quintptr, BorderRange > | m_contentBorderAreas |
QHash< quintptr, bool > | m_enabledContentBorderAreas |
Static Public Attributes | |
static QPointer< QCocoaWindow > | s_windowUnderMouse |
static const int | NoAlertRequest = -1 |
static id | s_globalMouseMonitor = 0 |
static id | s_applicationActivationObserver = 0 |
Protected Member Functions | |
void | recreateWindowIfNeeded () |
Recreates (or removes) the NSWindow for this QWindow, if needed. | |
QCocoaNSWindow * | createNSWindow (bool shouldBePanel) |
Qt::WindowStates | windowState () const |
void | applyWindowState (Qt::WindowStates newState) |
void | toggleMaximized () |
void | toggleFullScreen () |
bool | isTransitioningToFullScreen () const |
bool | startSystemMove () override |
Reimplement this method to start a system move operation if the system supports it and return true to indicate success. | |
Protected Member Functions inherited from QObject | |
QObject * | sender () const |
Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns \nullptr. | |
int | senderSignalIndex () const |
int | receivers (const char *signal) const |
Returns the number of receivers connected to the signal. | |
bool | isSignalConnected (const QMetaMethod &signal) const |
virtual void | timerEvent (QTimerEvent *event) |
This event handler can be reimplemented in a subclass to receive timer events for the object. | |
virtual void | childEvent (QChildEvent *event) |
This event handler can be reimplemented in a subclass to receive child events. | |
virtual void | customEvent (QEvent *event) |
This event handler can be reimplemented in a subclass to receive custom events. | |
virtual void | connectNotify (const QMetaMethod &signal) |
virtual void | disconnectNotify (const QMetaMethod &signal) |
QObject (QObjectPrivate &dd, QObject *parent=nullptr) | |
Protected Member Functions inherited from QPlatformWindow | |
QPlatformScreen * | screenForGeometry (const QRect &newGeometry) const |
Helper function for finding the new screen for newGeometry in response to a geometry changed event. |
Friends | |
class | QCocoaBackingStore |
class | QCocoaNativeInterface |
Additional Inherited Members | |
Public Slots inherited from QObject | |
void | deleteLater () |
\threadsafe | |
Signals inherited from QObject | |
void | destroyed (QObject *=nullptr) |
This signal is emitted immediately before the object obj is destroyed, after any instances of QPointer have been notified, and cannot be blocked. | |
void | objectNameChanged (const QString &objectName, QPrivateSignal) |
This signal is emitted after the object's name has been changed. | |
Static Protected Member Functions inherited from QPlatformWindow | |
static QString | formatWindowTitle (const QString &title, const QString &separator) |
Call this method to put together a window title composed of title separator the application display name. | |
static QSize | constrainWindowSize (const QSize &size) |
Returns a size with both dimensions bounded to [0, QWINDOWSIZE_MAX]. | |
Protected Attributes inherited from QObject | |
QScopedPointer< QObjectData > | d_ptr |
Protected Attributes inherited from QPlatformWindow | |
QScopedPointer< QPlatformWindowPrivate > | d_ptr |
Properties inherited from QObject | |
QString | objectName |
the name of this object | |
Related Symbols inherited from QObject | |
template< class T > T | qobject_cast (const QObject *object) |
Returns the given object cast to type T if the object is of type T (or of a subclass); otherwise returns \nullptr. | |
template< typename T > T | qFindChildqFindChildren (const QObject *obj, const QString &name)() |
template< typename T > QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QString &name)() |
QObjectList | |
\macro Q_CLASSINFO(Name, Value) |
Definition at line 71 of file qcocoawindow.h.
Enumerator | |
---|---|
NoHandleFlags | |
HandleUnconditionally |
Definition at line 218 of file qcocoawindow.h.
Enumerator | |
---|---|
RecreationNotNeeded | |
ParentChanged | |
MissingWindow | |
WindowModalityChanged | |
ContentViewChanged | |
PanelChanged |
Definition at line 184 of file qcocoawindow.h.
QCocoaWindow::QCocoaWindow | ( | QWindow * | tlw, |
WId | nativeHandle = 0 ) |
Definition at line 103 of file qcocoawindow.mm.
QCocoaWindow::~QCocoaWindow | ( | ) |
Definition at line 157 of file qcocoawindow.mm.
References isForeignWindow().
|
overridevirtual |
Returns whether applications can render new frames from any thread without co-ordination with the main thread.
Platform windows may set this to true during resize events for more control over submitted frames.
This function may be called from any thread.
Reimplemented from QPlatformWindow.
Definition at line 1334 of file qcocoawindow.mm.
bool QCocoaWindow::alwaysShowToolWindow | ( | ) | const |
Definition at line 1962 of file qcocoawindow.mm.
void QCocoaWindow::applyContentBorderThickness | ( | NSWindow * | window = nullptr | ) |
Definition at line 2052 of file qcocoawindow.mm.
|
protected |
Definition at line 792 of file qcocoawindow.mm.
|
override |
Definition at line 2194 of file qcocoawindow.mm.
Definition at line 2135 of file qcocoawindow.mm.
|
static |
Definition at line 1767 of file qcocoawindow.mm.
|
override |
Definition at line 2224 of file qcocoawindow.mm.
|
protected |
Definition at line 1833 of file qcocoawindow.mm.
|
overridevirtual |
Delivers an QEvent::UpdateRequest event to the window.
QPlatformWindow subclasses can re-implement this function to provide e.g. logging or tracing of the delivery, but should always call the base class function.
Reimplemented from QPlatformWindow.
Definition at line 1734 of file qcocoawindow.mm.
|
overridevirtual |
Reimplement this function in subclass to return the device pixel ratio for the window.
This is the ratio between physical pixels and device-independent pixels.
Reimplemented from QPlatformWindow.
Definition at line 2124 of file qcocoawindow.mm.
|
overridevirtual |
Returns the actual surface format of the window.
Reimplemented from QPlatformWindow.
Definition at line 201 of file qcocoawindow.mm.
|
overridevirtual |
Reimplemented from QPlatformWindow.
Definition at line 2205 of file qcocoawindow.mm.
|
inlineoverridevirtual |
Reimplement this method to return whether frame strut events are enabled.
Reimplemented from QPlatformWindow.
Definition at line 158 of file qcocoawindow.h.
References m_frameStrutEventsEnabled.
|
overridevirtual |
Returns the current geometry of a window.
Reimplemented from QPlatformWindow.
Definition at line 238 of file qcocoawindow.mm.
References isEmbedded().
Definition at line 1558 of file qcocoawindow.mm.
void QCocoaWindow::handleGeometryChange | ( | ) |
Definition at line 1512 of file qcocoawindow.mm.
Referenced by setVisible().
void QCocoaWindow::handleWindowStateChanged | ( | HandleFlags | flags = NoHandleFlags | ) |
Definition at line 1013 of file qcocoawindow.mm.
|
overridevirtual |
Called as part of QWindow::create(), after constructing the window.
Platforms should prefer to do initialization here instead of in the constructor, as the platform window object will be fully constructed, and associated to the corresponding QWindow, allowing synchronous event delivery.
Reimplemented from QPlatformWindow.
Definition at line 113 of file qcocoawindow.mm.
References isForeignWindow(), m_initialized, and recreateWindowIfNeeded().
|
overridevirtual |
Reimplement this method return whether the window is in an alert state.
Reimplemented from QPlatformWindow.
Definition at line 1092 of file qcocoawindow.mm.
bool QCocoaWindow::isContentView | ( | ) | const |
Checks if the window is the content view of its immediate NSWindow.
Being the content view of a NSWindow means the QWindow is the highest accessible NSView object in the window's view hierarchy.
This is the case if the QWindow is a top level window.
Definition at line 1607 of file qcocoawindow.mm.
Referenced by normalGeometry(), setCocoaGeometry(), setVisible(), and updateNormalGeometry().
|
overridevirtual |
Returns true
if the window is a child of a non-Qt window.
A embedded window has no parent platform window as reflected though parent(), but will have a native parent window.
Reimplemented from QPlatformWindow.
Definition at line 1139 of file qcocoawindow.mm.
Referenced by geometry(), and setCocoaGeometry().
|
overridevirtual |
Returns if this window is exposed in the windowing system.
An exposeEvent() is sent every time this value changes.
Reimplemented from QPlatformWindow.
Definition at line 1134 of file qcocoawindow.mm.
bool QCocoaWindow::isFixedSize | ( | ) | const |
Definition at line 664 of file qcocoawindow.mm.
|
overridevirtual |
Reimplemented from QPlatformWindow.
Definition at line 233 of file qcocoawindow.mm.
Referenced by ~QCocoaWindow(), initialize(), and setCocoaGeometry().
bool QCocoaWindow::isOpaque | ( | ) | const |
Definition at line 1155 of file qcocoawindow.mm.
|
protected |
Definition at line 936 of file qcocoawindow.mm.
|
overridevirtual |
Reimplement to be able to let Qt lower windows to the bottom of the desktop.
Reimplemented from QPlatformWindow.
Definition at line 1122 of file qcocoawindow.mm.
|
override |
Definition at line 2232 of file qcocoawindow.mm.
QCocoaMenuBar * QCocoaWindow::menubar | ( | ) | const |
Definition at line 1981 of file qcocoawindow.mm.
Referenced by QCocoaMenuBar::updateMenuBarImmediately().
NSWindow * QCocoaWindow::nativeWindow | ( | ) | const |
Definition at line 1261 of file qcocoawindow.mm.
|
overridevirtual |
the geometry of the window as it will appear when shown as a normal (not maximized or full screen) top-level window.
For child windows this property always holds an empty rectangle.
Reimplemented from QPlatformWindow.
Definition at line 263 of file qcocoawindow.mm.
References isContentView().
|
overridevirtual |
Reimplement to propagate the size hints of the QWindow.
The size hints include QWindow::minimumSize(), QWindow::maximumSize(), QWindow::sizeIncrement(), and QWindow::baseSize().
Reimplemented from QPlatformWindow.
Definition at line 1168 of file qcocoawindow.mm.
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSViewFrameDidChangeNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSViewGlobalFrameDidChangeNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowDidBecomeKeyNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowDidChangeOcclusionStateNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowDidChangeScreenNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowDidDeminiaturizeNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowDidEndLiveResizeNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowDidEnterFullScreenNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowDidExitFullScreenNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowDidMiniaturizeNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowDidMoveNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowDidOrderOffScreenNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowDidOrderOnScreenAndFinishAnimatingNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowDidResignKeyNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowDidResizeNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowWillEnterFullScreenNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowWillExitFullScreenNotification | ) |
QCocoaWindow::Q_NOTIFICATION_HANDLER | ( | NSWindowWillStartLiveResizeNotification | ) |
|
overridevirtual |
Reimplement to be able to let Qt raise windows to the top of the desktop.
Reimplemented from QPlatformWindow.
Definition at line 1097 of file qcocoawindow.mm.
|
protected |
Recreates (or removes) the NSWindow for this QWindow, if needed.
A QWindow may need a corresponding NSWindow/NSPanel, depending on whether or not it's a top level or not, window flags, etc.
Definition at line 1618 of file qcocoawindow.mm.
Referenced by initialize(), and setVisible().
Definition at line 2034 of file qcocoawindow.mm.
void QCocoaWindow::registerTouch | ( | bool | enable | ) |
Definition at line 2025 of file qcocoawindow.mm.
|
static |
Definition at line 1774 of file qcocoawindow.mm.
|
overridevirtual |
Reimplement to let Qt be able to request activation/focus for a window.
Some window systems will probably not have callbacks for this functionality, and then calling QWindowSystemInterface::handleFocusWindowChanged(QWindow *w) would be sufficient.
If the window system has some event handling/callbacks then call QWindowSystemInterface::handleFocusWindowChanged(QWindow *w) when the window system gives the notification.
Default implementation calls QWindowSystem::handleFocusWindowChanged(QWindow *w)
Reimplemented from QPlatformWindow.
Definition at line 1757 of file qcocoawindow.mm.
|
overridevirtual |
Requests an QEvent::UpdateRequest event.
The event will be delivered to the QWindow.
QPlatformWindow subclasses can re-implement this function to provide display refresh synchronized updates. The event should be delivered using QPlatformWindow::deliverUpdateRequest() to not get out of sync with the internal state of QWindow.
The default implementation posts an UpdateRequest event to the window after an interval that is at most 5 ms. If the window's associated screen reports a \l{QPlatformScreen::refreshRate()}{refresh rate} higher than 60 Hz, the interval is scaled down to a valid smaller than 5. The additional time is there to give the event loop a bit of idle time to gather system events.
Reimplemented from QPlatformWindow.
Definition at line 1712 of file qcocoawindow.mm.
|
overridevirtual |
The safe area margins of a window represent the area that is safe to place content within, without intersecting areas of the screen where system UI is placed, or where a screen bezel may cover the content.
Reimplemented from QPlatformWindow.
Definition at line 313 of file qcocoawindow.mm.
|
overridevirtual |
Reimplement this method to set whether the window demands attention (for example, by flashing the taskbar icon) depending on enabled.
Reimplemented from QPlatformWindow.
Definition at line 1082 of file qcocoawindow.mm.
Definition at line 289 of file qcocoawindow.mm.
References isContentView(), isEmbedded(), and isForeignWindow().
Definition at line 2040 of file qcocoawindow.mm.
|
override |
Definition at line 2046 of file qcocoawindow.mm.
void QCocoaWindow::setEmbeddedInForeignView | ( | ) |
Definition at line 1266 of file qcocoawindow.mm.
|
overridevirtual |
Reimplement this method to set whether frame strut events should be sent to enabled.
Reimplemented from QPlatformWindow.
Definition at line 2219 of file qcocoawindow.mm.
This function is called by Qt whenever a window is moved or resized using the QWindow API.
Unless you also override QPlatformWindow::geometry(), you need to call the baseclass implementation of this function in any override of QPlatformWindow::setGeometry(), as QWindow::geometry() is expected to report back the set geometry until a confirmation (or rejection) of the new geometry comes back from the window manager and is reported via QWindowSystemInterface::handleGeometryChange().
Window move/resizes can also be triggered spontaneously by the window manager, or as a response to an earlier requested move/resize via the Qt APIs. There is no need to call this function from the window manager callback, instead call QWindowSystemInterface::handleGeometryChange().
The position(x, y) part of the rect might be inclusive or exclusive of the window frame as returned by frameMargins(). You can detect this in the plugin by checking qt_window_private(window())->positionPolicy.
Reimplemented from QPlatformWindow.
Definition at line 215 of file qcocoawindow.mm.
References m_inSetGeometry.
|
overridevirtual |
Reimplemented from QPlatformWindow.
Definition at line 1231 of file qcocoawindow.mm.
Reimplement to be able to let Qt set the mask of a window.
Reimplemented from QPlatformWindow.
Definition at line 1215 of file qcocoawindow.mm.
void QCocoaWindow::setMenubar | ( | QCocoaMenuBar * | mb | ) |
Definition at line 1976 of file qcocoawindow.mm.
|
overridevirtual |
Reimplemented from QPlatformWindow.
Definition at line 1236 of file qcocoawindow.mm.
Reimplement to be able to let Qt set the opacity level of a window.
Reimplemented from QPlatformWindow.
Definition at line 1206 of file qcocoawindow.mm.
|
overridevirtual |
This function is called to enable native child window in QPA.
It is common not to support this feature in Window systems, but can be faked. When this function is called all geometry of this platform window will be relative to the parent.
Reimplemented from QPlatformWindow.
Definition at line 1246 of file qcocoawindow.mm.
|
static |
Definition at line 1786 of file qcocoawindow.mm.
|
overridevirtual |
Reimplemented in subclasses to show the surface if visible is true
, and hide it if visible is false
.
The default implementation sends a synchronous expose event.
Reimplemented from QPlatformWindow.
Definition at line 388 of file qcocoawindow.mm.
References handleGeometryChange(), isContentView(), m_initialized, m_inSetVisible, and recreateWindowIfNeeded().
void QCocoaWindow::setWindowCursor | ( | NSCursor * | cursor | ) |
Definition at line 1986 of file qcocoawindow.mm.
Reimplement to set the window file path to filePath.
Reimplemented from QPlatformWindow.
Definition at line 1043 of file qcocoawindow.mm.
|
overridevirtual |
Requests setting the window flags of this surface to flags.
Reimplemented from QPlatformWindow.
Definition at line 717 of file qcocoawindow.mm.
Reimplement to set the window icon to icon.
Reimplemented from QPlatformWindow.
Definition at line 1059 of file qcocoawindow.mm.
|
overridevirtual |
Reimplement to be able to let Qt indicate that the window has been modified.
Return true if the native window supports setting the modified flag, false otherwise.
Reimplemented from QPlatformWindow.
Definition at line 1967 of file qcocoawindow.mm.
|
overridevirtual |
Changes the state of the NSWindow, going in/out of minimize/zoomed/fullscreen.
When this is called from QWindow::setWindowState(), the QWindow state has not been updated yet, so window()->windowState() will reflect the previous state that was reported to QtGui.
Reimplemented from QPlatformWindow.
Definition at line 786 of file qcocoawindow.mm.
Reimplement to set the window title to title.
The implementation might want to append the application display name to the window title, like Windows and Linux do.
\l QPlatformWindow::windowTitle() can be used to retrieve the actual window title.
Reimplemented from QPlatformWindow.
Definition at line 1029 of file qcocoawindow.mm.
bool QCocoaWindow::shouldRefuseKeyWindowAndFirstResponder | ( | ) |
Definition at line 2147 of file qcocoawindow.mm.
|
overrideprotectedvirtual |
Reimplement this method to start a system move operation if the system supports it and return true to indicate success.
The default implementation is empty and does nothing.
Reimplemented from QPlatformWindow.
Definition at line 369 of file qcocoawindow.mm.
bool QCocoaWindow::testContentBorderAreaPosition | ( | int | position | ) | const |
Definition at line 2109 of file qcocoawindow.mm.
|
protected |
Definition at line 910 of file qcocoawindow.mm.
|
protected |
Definition at line 889 of file qcocoawindow.mm.
void QCocoaWindow::updateNormalGeometry | ( | ) |
Definition at line 278 of file qcocoawindow.mm.
References isContentView().
void QCocoaWindow::updateSafeAreaMarginsIfNeeded | ( | ) |
Definition at line 361 of file qcocoawindow.mm.
References QPainter::window().
bool QCocoaWindow::updatesWithDisplayLink | ( | ) | const |
Definition at line 1728 of file qcocoawindow.mm.
void QCocoaWindow::updateTitleBarButtons | ( | Qt::WindowFlags | flags | ) |
Definition at line 670 of file qcocoawindow.mm.
NSView * QCocoaWindow::view | ( | ) | const |
Definition at line 1256 of file qcocoawindow.mm.
|
overridevirtual |
Reimplement this method to be able to do any platform specific event handling.
All non-synthetic events for window() are passed to this function before being sent to QWindow::event().
Return true if the event should not be passed on to the QWindow.
Subclasses should always call the base class implementation.
Reimplemented from QPlatformWindow.
Definition at line 2180 of file qcocoawindow.mm.
bool QCocoaWindow::windowIsPopupType | ( | Qt::WindowType | type = Qt::Widget | ) | const |
Definition at line 1588 of file qcocoawindow.mm.
NSInteger QCocoaWindow::windowLevel | ( | Qt::WindowFlags | flags | ) |
Definition at line 551 of file qcocoawindow.mm.
bool QCocoaWindow::windowShouldClose | ( | ) |
Definition at line 1491 of file qcocoawindow.mm.
|
protected |
Definition at line 866 of file qcocoawindow.mm.
NSUInteger QCocoaWindow::windowStyleMask | ( | Qt::WindowFlags | flags | ) |
Definition at line 603 of file qcocoawindow.mm.
void QCocoaWindow::windowWillZoom | ( | ) |
Definition at line 905 of file qcocoawindow.mm.
|
overridevirtual |
Reimplement in subclasses to return a handle to the native window.
Reimplemented from QPlatformWindow.
Definition at line 1241 of file qcocoawindow.mm.
|
friend |
Definition at line 211 of file qcocoawindow.h.
|
friend |
Definition at line 212 of file qcocoawindow.h.
NSInteger QCocoaWindow::m_alertRequest = NoAlertRequest |
Definition at line 265 of file qcocoawindow.h.
QHash<quintptr, BorderRange> QCocoaWindow::m_contentBorderAreas |
Definition at line 278 of file qcocoawindow.h.
bool QCocoaWindow::m_drawContentBorderGradient = false |
Definition at line 267 of file qcocoawindow.h.
Definition at line 236 of file qcocoawindow.h.
Definition at line 279 of file qcocoawindow.h.
QRect QCocoaWindow::m_exposedRect |
Definition at line 255 of file qcocoawindow.h.
bool QCocoaWindow::m_frameStrutEventsEnabled = false |
Definition at line 254 of file qcocoawindow.h.
Referenced by frameStrutEventsEnabled().
bool QCocoaWindow::m_initialized = false |
Definition at line 246 of file qcocoawindow.h.
Referenced by initialize(), and setVisible().
bool QCocoaWindow::m_inLiveResize = false |
Definition at line 250 of file qcocoawindow.h.
bool QCocoaWindow::m_inSetGeometry = false |
Definition at line 248 of file qcocoawindow.h.
Referenced by setGeometry().
bool QCocoaWindow::m_inSetStyleMask = false |
Definition at line 249 of file qcocoawindow.h.
bool QCocoaWindow::m_inSetVisible = false |
Definition at line 247 of file qcocoawindow.h.
Referenced by setVisible().
QMargins QCocoaWindow::m_lastReportedSafeAreaMargins |
Definition at line 262 of file qcocoawindow.h.
Qt::WindowStates QCocoaWindow::m_lastReportedWindowState = Qt::WindowNoState |
Definition at line 241 of file qcocoawindow.h.
QCocoaMenuBar* QCocoaWindow::m_menubar = nullptr |
Definition at line 252 of file qcocoawindow.h.
QRect QCocoaWindow::m_normalGeometry |
Definition at line 256 of file qcocoawindow.h.
QCocoaNSWindow* QCocoaWindow::m_nsWindow = nil |
Definition at line 239 of file qcocoawindow.h.
int QCocoaWindow::m_registerTouchCount = 0 |
Definition at line 257 of file qcocoawindow.h.
bool QCocoaWindow::m_resizableTransientParent = false |
Definition at line 258 of file qcocoawindow.h.
QMacKeyValueObserver QCocoaWindow::m_safeAreaInsetsObserver |
Definition at line 260 of file qcocoawindow.h.
NSView* QCocoaWindow::m_view = nil |
Definition at line 238 of file qcocoawindow.h.
Qt::WindowModality QCocoaWindow::m_windowModality = Qt::NonModal |
Definition at line 242 of file qcocoawindow.h.
|
static |
Definition at line 264 of file qcocoawindow.h.
|
inlinestatic |
Definition at line 282 of file qcocoawindow.h.
|
inlinestatic |
Definition at line 281 of file qcocoawindow.h.
|
static |
Definition at line 244 of file qcocoawindow.h.