Constructs a platform window with the given top level window.

Virtual destructor does not delete the top level window.

Returns the closest acceptable geometry for a given window before a resize or move event is handled. This is used to implement heightForWidth().

Returns size with both dimensions bounded to [0, QWINDOWSIZE_MAX].

Reimplement in subclasses to return the device pixel ratio for the window. This is the ratio between physical pixels and device-independent pixels.

See also

QPlatformWindow::devicePixelRatio()

Returns the actual surface format of the window.

Implements QPlatformSurface

Call this method to put together a window title composed of a title and a separator for the application display name. If the display name is not set and the title is empty, the raw application name is used.

Additional documentation pending.

Reimplement this method to return whether frame strut events are enabled.

Returns the current geometry of a window.

Handle changes to the orientation of the platform window's contents. This is a hint to the window manager in case it needs to display additional content like popups, dialogs, status bars, or similar in relation to the window.

See also

QWindow::reportContentOrientationChange()

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. its parent. For example this is useful on Windows and Mac OS but not X11, because an X11 window manager typically tries to layout new windows to optimize usage of the available desktop space. However if the given window already has geometry which the application has initialized, it takes priority.

Invalidates the window's surface by releasing its surface buffers. Many platforms do not support releasing the surface memory, and the default implementation does nothing. The platform window is expected to recreate the surface again if it is needed. For instance, if an OpenGL context is made current on this window.

Returns true if the window should be drawn as the active window.

Additional documentation pending.

Returns true if the window is a descendant of an embedded non CopperSpice window. An example of an embedded non CopperSpice window is the parent window of an in process QAxServer. If parentWindow is not a nullptr the method only checks if the window is embedded in the specified parentWindow.

Returns true if this window is exposed in the windowing system. An exposeEvent() is sent every time this value changes.

Reimplement if the platform supports reordering windows.

Translates the global screen coordinate pos to window coordinates using native methods. This is required for embedded windows, where the topmost QWindow coordinates are not global screen coordinates. Returns the value of pos if there is no platform specific implementation.

Translates the window coordinate pos to global screen coordinates using native methods. This is required for embedded windows, where the topmost QWindow coordinates are not global screen coordinates. Returns the value of pos if there is no platform specific implementation.

Returns the geometry of a window in 'normal' state (neither maximized, fullscreen nor minimized) for saving geometries to application settings.

Returns the parent platform window or a nullptr if it is an orphan.

Reimplement to propagate the size hints of the QWindow. The size hints include QWindow::minimumSize(), QWindow::maximumSize(), QWindow::sizeIncrement(), QWindow::baseSize()

Reimplement to support raising windows to the top of the desktop.

Reimplement to request activation focus for a window. Some window systems will probably not have callbacks for this functionality, and then calling QWindowSystemInterface::handleWindowActivated() would be sufficient. If the window system has some event handling/callbacks then call QWindowSystemInterface::handleWindowActivated() when the window system gives the notification.

Default implementation calls QWindowSystem::handleWindowActivated()

Requests a QEvent::UpdateRequest event. The event will be delivered to the corresponding QWindow.

QPlatformWindow subclasses can override this method to provide display refresh synchronized updates. The event should be delivered using QWindowPrivate::deliverUpdateRequest() to stay in sync with the internal state of the QWindow. The default implementation posts an UpdateRequest event to the window after 5 ms. The additional time is there to give the event loop a bit of idle time to gather system events.

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

Helper method determines the new screen for newGeometry in response to a geometry changed event. Returns the new screen if the window was moved to another virtual sibling. If the screen changes, the platform plugin should call QWindowSystemInterface::handleWindowScreenChanged().

The current screen will always be returned for child windows since they should never signal screen changes.

Reimplement this method to set whether the window demands attention (for example, by flashing the taskbar icon) depending on enabled.

See also

isAlertState()

Reimplement this method to set whether frame strut events should be sent to enabled.

See also

frameStrutEventsEnabled

This method is called whenever a window is moved or the window is resized. The resize can happen programmatically or by the window manager. This means there is no need to call this method directly from the window manager callback. Instead call QWindowSystemInterface::handleGeometryChange().

The position(x, y) part of 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.

Sets the value of the property to grab.

Reimplement if the platform supports shaping windows with a mask. Sets the mask of the current windows to region.

Sets the value of the property to grab.

Reimplement if the platform supports transparent windows. Sets the opacity of the current windows to level.

This method is called to enable native child windows. When this method is called all geometry of this platform window will be relative to the parent.

Reimplement this method in subclasses to show the surface if visible is true and hide the surface if visible is false. The default implementation sends a synchronous expose event.

Reimplement to set the window file path to filePath.

Sets the window flags of this surface to flags.

Reimplement to set the window icon to icon.

Returns true if the native window supports setting the modified flag, false otherwise.

Requests setting the window state of this surface to type. Qt::WindowActive can be ignored.

Reimplement to set the window title to title. The implementation might want to append the application display name to the window title.

See also

QApplication::applicationDisplayName()

Reimplement to start a system size grip drag operation if the system supports it and return true to indicate success. It is called from the mouse press event handler of the size grip. The default implementation is empty and does nothing with pos and corner.

Returns the window which belongs to the QPlatformWindow.

Returns the QWindow base size.

Additional documentation pending.

Reimplement this method to be able to do any platform specific event handling. All events for window() are passed to this method before being sent to QWindow::event(). The default implementation does nothing with event.

Returns the QWindow frame geometry.

Returns the QWindow geometry.

Returns the QWindow maximum size.

Returns the QWindow minimum size.

Returns the QWindow size increment.

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