The QQnxWindow is the base class of the various classes used as instances of QPlatformWindow in the QNX QPA plugin. More...

#include <qqnxwindow.h>

Inheritance diagram for QQnxWindow:

Collaboration diagram for QQnxWindow:

Public Member Functions
	QQnxWindow (QWindow *window, screen_context_t context, bool needRootWindow)
	QQnxWindow (QWindow *window, screen_context_t context, screen_window_t screenWindow)
virtual	~QQnxWindow ()
void	setGeometry (const QRect &rect) override
	This function is called by Qt whenever a window is moved or resized using the QWindow API.
void	setVisible (bool visible) override
	Reimplemented in subclasses to show the surface if visible is `true`, and hide it if visible is `false`.
void	setOpacity (qreal level) override
	Reimplement to be able to let Qt set the opacity level of a window.
bool	isExposed () const override
	Returns if this window is exposed in the windowing system.
WId	winId () const override
	Reimplement in subclasses to return a handle to the native window.
screen_window_t	nativeHandle () const
screen_context_t	screenContext () const
void	setBufferSize (const QSize &size)
QSize	bufferSize () const
void	setScreen (QQnxScreen *platformScreen)
void	setParent (const QPlatformWindow *window) override
	This function is called to enable native child window in QPA.
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.
void	requestActivateWindow () override
	Reimplement to let Qt be able to request activation/focus for a window.
void	setWindowState (Qt::WindowStates state) override
	Requests setting the window state of this surface to type.
void	setExposed (bool exposed)
void	propagateSizeHints () override
	Reimplement to propagate the size hints of the QWindow.
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.
const QList< QQnxWindow * > &	children () const
QQnxWindow *	findWindow (screen_window_t windowHandle)
void	minimize ()
void	setRotation (int rotation)
QByteArray	groupName () const
void	joinWindowGroup (const QByteArray &groupName)
bool	shouldMakeFullScreen () const
void	windowPosted ()
void	handleActivationEvent ()
void	setWindowTitle (const QString &title)
	Reimplement to set the window title to title.
void	requestUpdate () override
	Requests an QEvent::UpdateRequest event.
void	handlePostEvent ()
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.
virtual void	initialize ()
	Called as part of QWindow::create(), after constructing the window.
QWindow *	window () const
	Returns the window which belongs to the QPlatformWindow.
QPlatformWindow *	parent () const
	Returns the parent platform window (or \nullptr if orphan).
virtual QSurfaceFormat	format () const override
	Returns the actual surface format of the window.
virtual QRect	geometry () const
	Returns the current geometry of a window.
virtual QRect	normalGeometry () const
	Returns the geometry of a window in 'normal' state (neither maximized, fullscreen nor minimized) for saving geometries to application settings.
virtual QMargins	frameMargins () const
virtual QMargins	safeAreaMargins () const
	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.
virtual void	setWindowFlags (Qt::WindowFlags flags)
	Requests setting the window flags of this surface to flags.
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 void	setWindowFilePath (const QString &title)
	Reimplement to set the window file path to filePath.
virtual void	setWindowIcon (const QIcon &icon)
	Reimplement to set the window icon to icon.
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 bool	isEmbedded () const
	Returns `true` if the window is a child of a non-Qt window.
virtual bool	isForeignWindow () const
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	setMask (const QRegion &region)
	Reimplement to be able to let Qt set the mask of a window.
virtual void	handleContentOrientationChange (Qt::ScreenOrientation orientation)
	Handle changes to the orientation of the platform window's contents.
virtual qreal	devicePixelRatio () const
	Reimplement this function in subclass to return the device pixel ratio for the window.
virtual bool	setKeyboardGrabEnabled (bool grab)
virtual bool	setMouseGrabEnabled (bool grab)
virtual bool	setWindowModified (bool modified)
	Reimplement to be able to let Qt indicate that the window has been modified.
virtual bool	windowEvent (QEvent *event)
	Reimplement this method to be able to do any platform specific event handling.
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 bool	startSystemMove ()
	Reimplement this method to start a system move operation if the system supports it and return true to indicate success.
virtual void	setFrameStrutEventsEnabled (bool enabled)
	Reimplement this method to set whether frame strut events should be sent to enabled.
virtual bool	frameStrutEventsEnabled () const
	Reimplement this method to return whether frame strut events are enabled.
virtual void	setAlertState (bool enabled)
	Reimplement this method to set whether the window demands attention (for example, by flashing the taskbar icon) depending on enabled.
virtual bool	isAlertState () const
	Reimplement this method return whether the window is in an alert state.
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.
virtual void	deliverUpdateRequest ()
	Delivers an QEvent::UpdateRequest event to the window.
virtual bool	allowsIndependentThreadedRendering () const
	Returns whether applications can render new frames from any thread without co-ordination with the main thread.
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

Protected Member Functions
virtual int	pixelFormat () const =0
virtual void	resetBuffers ()=0
void	initWindow ()
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.

Protected Attributes
screen_context_t	m_screenContext
Protected Attributes inherited from QPlatformWindow
QScopedPointer< QPlatformWindowPrivate >	d_ptr

Friends
class	QQnxScreen

Additional Inherited Members
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().
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].

Detailed Description

The QQnxWindow is the base class of the various classes used as instances of QPlatformWindow in the QNX QPA plugin.

The standard properties and methods available in Qt are not a perfect match for the features provided by the QNX screen service. While for the majority of applications the default behavior suffices, some circumstances require greater control over the interaction with screen.

Definition at line 31 of file qqnxwindow.h.

Constructor & Destructor Documentation

◆ QQnxWindow() [1/2]

QQnxWindow::QQnxWindow	(	QWindow *	window,
		screen_context_t	context,
		bool	needRootWindow )

explicit

Definition at line 115 of file qqnxwindow.cpp.

References QQnxWindow(), QQnxIntegration::Desktop, QQnxIntegration::instance(), QQnxScreen::rootWindow(), and QQnxScreen::setRootWindow().

Referenced by QQnxWindow().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ QQnxWindow() [2/2]

QQnxWindow::QQnxWindow	(	QWindow *	window,
		screen_context_t	context,
		screen_window_t	screenWindow )

explicit

Definition at line 255 of file qqnxwindow.cpp.

References QQnxWindow().

Referenced by QQnxWindow().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ~QQnxWindow()

QQnxWindow::~QQnxWindow ( )

virtual

Definition at line 287 of file qqnxwindow.cpp.

References QQnxIntegration::instance(), and QQnxScreen::updateHierarchy().

Here is the call graph for this function:

Member Function Documentation

◆ bufferSize()

QSize QQnxWindow::bufferSize ( ) const

inline

Definition at line 50 of file qqnxwindow.h.

◆ children()

const QList< QQnxWindow * > & QQnxWindow::children ( ) const

inline

Definition at line 64 of file qqnxwindow.h.

◆ findWindow()

QQnxWindow * QQnxWindow::findWindow ( screen_window_t windowHandle )

Definition at line 792 of file qqnxwindow.cpp.

◆ groupName()

QByteArray QQnxWindow::groupName ( ) const

inline

Definition at line 72 of file qqnxwindow.h.

◆ handleActivationEvent()

void QQnxWindow::handleActivationEvent ( )

Definition at line 988 of file qqnxwindow.cpp.

References requestActivateWindow().

Here is the call graph for this function:

◆ handlePostEvent()

void QQnxWindow::handlePostEvent ( )

Definition at line 1053 of file qqnxwindow.cpp.

References isExposed().

Here is the call graph for this function:

◆ initWindow()

void QQnxWindow::initWindow ( )

protected

Definition at line 819 of file qqnxwindow.cpp.

References QQnxIntegration::instance(), and setScreen().

Referenced by QQnxEglWindow::QQnxEglWindow().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isExposed()

bool QQnxWindow::isExposed ( ) const

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 464 of file qqnxwindow.cpp.

Referenced by handlePostEvent().

Here is the caller graph for this function:

◆ joinWindowGroup()

void QQnxWindow::joinWindowGroup ( const QByteArray & groupName )

Definition at line 886 of file qqnxwindow.cpp.

◆ lower()

void QQnxWindow::lower ( )

overridevirtual

Reimplement to be able to let Qt lower windows to the bottom of the desktop.

Reimplemented from QPlatformWindow.

Definition at line 641 of file qqnxwindow.cpp.

References QQnxScreen::lowerWindow(), and QQnxScreen::updateHierarchy().

Here is the call graph for this function:

◆ minimize()

void QQnxWindow::minimize ( )

Definition at line 806 of file qqnxwindow.cpp.

◆ nativeHandle()

screen_window_t QQnxWindow::nativeHandle ( ) const

inline

Definition at line 46 of file qqnxwindow.h.

◆ pixelFormat()

virtual int QQnxWindow::pixelFormat ( ) const

protectedpure virtual

Implemented in QQnxEglWindow, QQnxForeignWindow, QQnxRasterWindow, and QQnxVulkanWindow.

Referenced by setBufferSize().

Here is the caller graph for this function:

◆ propagateSizeHints()

void QQnxWindow::propagateSizeHints ( )

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 781 of file qqnxwindow.cpp.

◆ raise()

void QQnxWindow::raise ( )

overridevirtual

Reimplement to be able to let Qt raise windows to the top of the desktop.

Reimplemented from QPlatformWindow.

Definition at line 627 of file qqnxwindow.cpp.

References QQnxScreen::raiseWindow(), and QQnxScreen::updateHierarchy().

Here is the call graph for this function:

◆ requestActivateWindow()

void QQnxWindow::requestActivateWindow ( )

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 655 of file qqnxwindow.cpp.

Referenced by handleActivationEvent(), and setVisible().

Here is the caller graph for this function:

◆ requestUpdate()

void QQnxWindow::requestUpdate ( )

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 1024 of file qqnxwindow.cpp.

◆ resetBuffers()

virtual void QQnxWindow::resetBuffers ( )

protectedpure virtual

Implemented in QQnxEglWindow, QQnxForeignWindow, QQnxRasterWindow, and QQnxVulkanWindow.

Referenced by setBufferSize().

Here is the caller graph for this function:

◆ screen()

QPlatformScreen * QQnxWindow::screen ( ) const

overridevirtual

Returns the platform screen handle corresponding to this platform window, or null if the window is not associated with a screen.

Reimplemented from QPlatformWindow.

Definition at line 787 of file qqnxwindow.cpp.

◆ screenContext()

screen_context_t QQnxWindow::screenContext ( ) const

inline

Definition at line 47 of file qqnxwindow.h.

◆ setBufferSize()

void QQnxWindow::setBufferSize ( const QSize & size )

Definition at line 469 of file qqnxwindow.cpp.

References pixelFormat(), and resetBuffers().

Here is the call graph for this function:

◆ setExposed()

void QQnxWindow::setExposed ( bool exposed )

Definition at line 453 of file qqnxwindow.cpp.

Referenced by QQnxScreen::activateWindowGroup(), and QQnxScreen::deactivateWindowGroup().

Here is the caller graph for this function:

◆ setGeometry()

void QQnxWindow::setGeometry ( const QRect & rect )

overridevirtual

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 313 of file qqnxwindow.cpp.

◆ setOpacity()

void QQnxWindow::setOpacity ( qreal level )

overridevirtual

Reimplement to be able to let Qt set the opacity level of a window.

Reimplemented from QPlatformWindow.

Definition at line 442 of file qqnxwindow.cpp.

◆ setParent()

void QQnxWindow::setParent ( const QPlatformWindow * parent )

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 595 of file qqnxwindow.cpp.

References QQnxScreen::addWindow(), setScreen(), and QQnxScreen::updateHierarchy().

Here is the call graph for this function:

◆ setRotation()

void QQnxWindow::setRotation ( int rotation )

Definition at line 811 of file qqnxwindow.cpp.

Referenced by QQnxScreen::setRotation().

Here is the caller graph for this function:

◆ setScreen()

void QQnxWindow::setScreen ( QQnxScreen * platformScreen )

Definition at line 536 of file qqnxwindow.cpp.

References QQnxScreen::addWindow(), QQnxIntegration::instance(), QQnxScreen::removeWindow(), QQnxIntegration::RootWindow, and QQnxScreen::updateHierarchy().

Referenced by QQnxScreen::~QQnxScreen(), initWindow(), QQnxIntegration::moveToScreen(), and setParent().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setVisible()

void QQnxWindow::setVisible ( bool visible )

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 360 of file qqnxwindow.cpp.

References requestActivateWindow().

Here is the call graph for this function:

◆ setWindowState()

void QQnxWindow::setWindowState ( Qt::WindowStates state )

overridevirtual

Requests setting the window state of this surface to type.

Qt::WindowActive can be ignored.

Reimplemented from QPlatformWindow.

Definition at line 767 of file qqnxwindow.cpp.

◆ setWindowTitle()

void QQnxWindow::setWindowTitle ( const QString & title )

virtual

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.

See also: QGuiApplication::applicationDisplayName(); QPlatformWindow::windowTitle()

Reimplemented from QPlatformWindow.

Definition at line 1016 of file qqnxwindow.cpp.

◆ shouldMakeFullScreen()

bool QQnxWindow::shouldMakeFullScreen ( ) const

Definition at line 975 of file qqnxwindow.cpp.

References QQnxIntegration::FullScreenApplication, and QQnxIntegration::instance().

Here is the call graph for this function:

◆ windowPosted()

void QQnxWindow::windowPosted ( )

Definition at line 961 of file qqnxwindow.cpp.

References qqnxLgmonFramePosted().

Referenced by QQnxRasterWindow::post(), and QQnxGLContext::swapBuffers().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ winId()

WId QQnxWindow::winId ( ) const

inlineoverridevirtual

Reimplement in subclasses to return a handle to the native window.

Reimplemented from QPlatformWindow.

Definition at line 45 of file qqnxwindow.h.

◆ QQnxScreen

friend class QQnxScreen

friend

Definition at line 33 of file qqnxwindow.h.

Member Data Documentation

◆ m_screenContext

screen_context_t QQnxWindow::m_screenContext

protected

Definition at line 91 of file qqnxwindow.h.

The documentation for this class was generated from the following files:

qtbase/src/plugins/platforms/qnx/qqnxwindow.h (2c332f650812283fba6ad324453895140d7f73a6)
qtbase/src/plugins/platforms/qnx/qqnxwindow.cpp (2c332f650812283fba6ad324453895140d7f73a6)

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ QQnxWindow() [1/2]

◆ QQnxWindow() [2/2]

◆ ~QQnxWindow()

Member Function Documentation

◆ bufferSize()

◆ children()

◆ findWindow()

◆ groupName()

◆ handleActivationEvent()

◆ handlePostEvent()

◆ initWindow()

◆ isExposed()

◆ joinWindowGroup()

◆ lower()

◆ minimize()

◆ nativeHandle()

◆ pixelFormat()

◆ propagateSizeHints()

◆ raise()

◆ requestActivateWindow()

◆ requestUpdate()

◆ resetBuffers()

◆ screen()

◆ screenContext()

◆ setBufferSize()

◆ setExposed()

◆ setGeometry()

◆ setOpacity()

◆ setParent()

◆ setRotation()

◆ setScreen()

◆ setVisible()

◆ setWindowState()

◆ setWindowTitle()

◆ shouldMakeFullScreen()

◆ windowPosted()

◆ winId()

Friends And Related Symbol Documentation

◆ QQnxScreen

Member Data Documentation

◆ m_screenContext