![]() |
Qt 6.x
The Qt SDK
|
\inmodule QtGui More...
#include <qwindow.h>
Public Slots | |
Q_REVISION (2, 1) void requestActivate() | |
void | setVisible (bool visible) |
void | show () |
Shows the window. | |
void | hide () |
Hides the window. | |
void | showMinimized () |
Shows the window as minimized. | |
void | showMaximized () |
Shows the window as maximized. | |
void | showFullScreen () |
Shows the window as fullscreen. | |
void | showNormal () |
Shows the window as normal, i.e. | |
bool | close () |
Close the window. | |
void | raise () |
Raise the window in the windowing system. | |
void | lower () |
Lower the window in the windowing system. | |
bool | startSystemResize (Qt::Edges edges) |
Start a system-specific resize operation. | |
bool | startSystemMove () |
Start a system-specific move operation. | |
void | setTitle (const QString &) |
void | setX (int arg) |
void | setY (int arg) |
void | setWidth (int arg) |
void | setHeight (int arg) |
void | setGeometry (int posx, int posy, int w, int h) |
Sets the geometry of the window, excluding its window frame, to a rectangle constructed from posx, posy, w and h. | |
void | setGeometry (const QRect &rect) |
Sets the geometry of the window, excluding its window frame, to rect. | |
void | setMinimumWidth (int w) |
void | setMinimumHeight (int h) |
void | setMaximumWidth (int w) |
void | setMaximumHeight (int h) |
Q_REVISION (2, 1) void alert(int msec) | |
Q_REVISION (2, 3) void requestUpdate() | |
![]() | |
void | deleteLater () |
\threadsafe | |
Signals | |
void | screenChanged (QScreen *screen) |
This signal is emitted when a window's screen changes, either by being set explicitly with setScreen(), or automatically when the window's screen is removed. | |
void | modalityChanged (Qt::WindowModality modality) |
This signal is emitted when the Qwindow::modality property changes to modality. | |
void | windowStateChanged (Qt::WindowState windowState) |
This signal is emitted when the windowState changes, either by being set explicitly with setWindowStates(), or automatically when the user clicks one of the titlebar buttons or by other means. | |
Q_REVISION (2, 2) void windowTitleChanged(const QString &title) | |
void | xChanged (int arg) |
void | yChanged (int arg) |
void | widthChanged (int arg) |
void | heightChanged (int arg) |
void | minimumWidthChanged (int arg) |
void | minimumHeightChanged (int arg) |
void | maximumWidthChanged (int arg) |
void | maximumHeightChanged (int arg) |
void | visibleChanged (bool arg) |
Q_REVISION(2, 1) void visibilityChanged(QWindow | Q_REVISION (2, 1) void activeChanged() |
void | contentOrientationChanged (Qt::ScreenOrientation orientation) |
void | focusObjectChanged (QObject *object) |
This signal is emitted when the final receiver of events tied to focus is changed to object. | |
Q_REVISION (2, 1) void opacityChanged(qreal opacity) | |
Q_REVISION (2, 13) void transientParentChanged(QWindow *transientParent) | |
![]() | |
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. | |
Protected Member Functions | |
virtual void | exposeEvent (QExposeEvent *) |
The expose event (ev) is sent by the window system when a window moves between the un-exposed and exposed states. | |
virtual void | resizeEvent (QResizeEvent *) |
Override this to handle resize events (ev). | |
virtual void | paintEvent (QPaintEvent *) |
The paint event (ev) is sent by the window system whenever an area of the window needs a repaint, for example when initially showing the window, or due to parts of the window being uncovered by moving another window. | |
virtual void | moveEvent (QMoveEvent *) |
Override this to handle window move events (ev). | |
virtual void | focusInEvent (QFocusEvent *) |
Override this to handle focus in events (ev). | |
virtual void | focusOutEvent (QFocusEvent *) |
Override this to handle focus out events (ev). | |
virtual void | showEvent (QShowEvent *) |
Override this to handle show events (ev). | |
virtual void | hideEvent (QHideEvent *) |
Override this to handle hide events (ev). | |
virtual void | closeEvent (QCloseEvent *) |
Override this to handle close events (ev). | |
virtual bool | event (QEvent *) override |
Override this to handle any event (ev) sent to the window. | |
virtual void | keyPressEvent (QKeyEvent *) |
Override this to handle key press events (ev). | |
virtual void | keyReleaseEvent (QKeyEvent *) |
Override this to handle key release events (ev). | |
virtual void | mousePressEvent (QMouseEvent *) |
Override this to handle mouse press events (ev). | |
virtual void | mouseReleaseEvent (QMouseEvent *) |
Override this to handle mouse release events (ev). | |
virtual void | mouseDoubleClickEvent (QMouseEvent *) |
Override this to handle mouse double click events (ev). | |
virtual void | mouseMoveEvent (QMouseEvent *) |
Override this to handle mouse move events (ev). | |
virtual void | touchEvent (QTouchEvent *) |
Override this to handle touch events (ev). | |
virtual bool | nativeEvent (const QByteArray &eventType, void *message, qintptr *result) |
Override this to handle platform dependent events. | |
QWindow (QWindowPrivate &dd, QWindow *parent) | |
Creates a window as a child of the given parent window with the dd private implementation. | |
![]() | |
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) | |
![]() | |
QSurface (SurfaceClass type) | |
Creates a surface with the given type. | |
Properties | |
QString | title |
the window's title in the windowing system | |
Qt::WindowModality | modality |
the modality of the window | |
Qt::WindowFlags | flags |
the window flags of the window | |
int | x |
the x position of the window's geometry | |
int | y |
the y position of the window's geometry | |
int | width |
the width of the window's geometry | |
int | height |
the height of the window's geometry | |
int | minimumWidth |
the minimum width of the window's geometry | |
int | minimumHeight |
the minimum height of the window's geometry | |
int | maximumWidth |
the maximum width of the window's geometry | |
int | maximumHeight |
the maximum height of the window's geometry | |
bool | visible |
whether the window is visible or not | |
bool | active |
the active status of the window | |
Visibility | visibility |
the screen-occupation state of the window | |
Qt::ScreenOrientation | contentOrientation |
the orientation of the window's contents | |
qreal | opacity |
The opacity of the window in the windowing system. | |
![]() | |
QString | objectName |
the name of this object | |
Private Member Functions | |
SurfaceType | surfaceType () const override |
Returns the surface type of the window. | |
QSurfaceFormat | format () const override |
Returns the actual format of this window. | |
QSize | size () const override |
Returns the size of the window excluding any window frame. | |
virtual QAccessibleInterface * | accessibleRoot () const |
Returns the accessibility interface for the object that the window represents. | |
virtual QObject * | focusObject () const |
Returns the QObject that will be the final receiver of events tied focus, such as key events. | |
Q_PRIVATE_SLOT (d_func(), void _q_clearAlert()) QPlatformSurface *surfaceHandle() const override | |
Friends | |
class | QGuiApplication |
class | QGuiApplicationPrivate |
class | QWindowContainer |
Q_GUI_EXPORT QWindowPrivate * | qt_window_private (QWindow *window) |
Additional Inherited Members | |
![]() | |
enum | SurfaceClass { Window , Offscreen } |
The SurfaceClass enum describes the actual subclass of the surface. More... | |
enum | SurfaceType { RasterSurface , OpenGLSurface , RasterGLSurface , OpenVGSurface , VulkanSurface , MetalSurface , Direct3DSurface } |
The SurfaceType enum describes what type of surface this is. More... | |
![]() | |
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 | 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. | |
void | moveToThread (QThread *thread) |
Changes the thread affinity for this object and its children. | |
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::milliseconds time, Qt::TimerType timerType=Qt::CoarseTimer) |
void | killTimer (int id) |
Kills the timer with timer identifier, id. | |
template<typename T > | |
T | findChild (const QString &aName=QString(), 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 (const QString &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 > | |
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 . | |
![]() | |
virtual | ~QSurface () |
Destroys the surface. | |
SurfaceClass | surfaceClass () const |
Returns the surface class of this surface. | |
virtual QSurfaceFormat | format () const =0 |
Returns the format of the surface. | |
virtual QPlatformSurface * | surfaceHandle () const =0 |
Returns a handle to the platform-specific implementation of the surface. | |
virtual SurfaceType | surfaceType () const =0 |
Returns the type of the surface. | |
bool | supportsOpenGL () const |
Returns true if the surface is OpenGL compatible and can be used in conjunction with QOpenGLContext; otherwise returns false. | |
virtual QSize | size () const =0 |
Returns the size of the surface in pixels. | |
![]() | |
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) |
![]() | |
QScopedPointer< QObjectData > | d_ptr |
![]() | |
SurfaceClass | m_type |
QSurfacePrivate * | m_reserved |
![]() | |
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) | |
\inmodule QtGui
The QWindow class represents a window in the underlying windowing system.
A window that is supplied a parent becomes a native child window of their parent window.
An application will typically use QWidget or QQuickView for its UI, and not QWindow directly. Still, it is possible to render directly to a QWindow with QBackingStore or QOpenGLContext, when wanting to keep dependencies to a minimum or when wanting to use OpenGL directly. The \l{Raster Window Example} and \l{OpenGL Window Example} are useful reference examples for how to render to a QWindow using either approach.
|
protected |
Creates a window as a child of the given parent window with the dd private implementation.
The window will be embedded inside the parent window, its coordinates relative to the parent.
The screen is inherited from the parent.
Definition at line 171 of file qwindow.cpp.
References d.
|
privatevirtual |
Returns the accessibility interface for the object that the window represents.
Definition at line 2150 of file qwindow.cpp.
|
slot |
Close the window.
This closes the window, effectively calling destroy(), and potentially quitting the application. Returns true
on success, false if it has a parent window (in which case the top level window should be closed instead).
Definition at line 2276 of file qwindow.cpp.
References d.
Referenced by QQuick3DLightmapBaker::~QQuick3DLightmapBaker(), QQuick3DLightmapBaker::bake(), QWasmWindow::onCloseClicked(), and QtWaylandClient::QWaylandQtSurface::zqt_shell_surface_v1_close().
|
protectedvirtual |
Override this to handle close events (ev).
The function is called when the window is requested to close. Call \l{QEvent::ignore()} on the event if you want to prevent the window from being closed.
Reimplemented in QWidgetWindow, and QQuickWindow.
Definition at line 2421 of file qwindow.cpp.
References Q_UNUSED.
Referenced by event().
|
signal |
|
overrideprotectedvirtual |
Override this to handle any event (ev) sent to the window.
Return true
if the event was recognized and processed.
Remember to call the base class version if you wish for mouse events, key events, resize events, etc to be dispatched as usual.
Reimplemented from QObject.
Reimplemented in QWidgetWindow, QQuickWindow, src_gui_vulkan_qvulkaninstance2::VulkanWindow, QVideoWindow, and QPaintDeviceWindow.
Definition at line 2433 of file qwindow.cpp.
References QEvent::ApplicationWindowIconChange, QEvent::Close, closeEvent(), context, QPlatformTheme::ContextMenuOnMouseRelease, QOpenGLContext::currentContext(), d, e, QObject::event(), QEvent::Expose, exposeEvent(), QEvent::FocusIn, focusInEvent(), QEvent::FocusOut, focusOutEvent(), QEvent::Hide, hideEvent(), icon, QGuiApplicationPrivate::instance(), QEvent::isAccepted(), QEvent::KeyPress, keyPressEvent(), QEvent::KeyRelease, keyReleaseEvent(), QGuiApplicationPrivate::maybeLastWindowClosed(), QContextMenuEvent::Mouse, QEvent::MouseButtonDblClick, QEvent::MouseButtonPress, QEvent::MouseButtonRelease, mouseDoubleClickEvent(), QEvent::MouseMove, mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), QEvent::Move, moveEvent(), nullptr, QEvent::Paint, paintEvent(), QEvent::PlatformSurface, QGuiApplicationPrivate::platformTheme(), QEvent::Resize, resizeEvent(), Qt::RightButton, QCoreApplication::sendEvent(), QEvent::Show, showEvent(), state, QPlatformSurfaceEvent::SurfaceAboutToBeDestroyed, QEvent::TabletMove, QEvent::TabletPress, QEvent::TabletRelease, QPlatformTheme::themeHint(), QVariant::toBool(), QEvent::TouchBegin, QEvent::TouchCancel, QEvent::TouchEnd, touchEvent(), QEvent::TouchUpdate, QEvent::type(), and QEvent::Wheel.
Referenced by QWidgetWindow::event(), QQuickWindow::event(), src_gui_vulkan_qvulkaninstance2::VulkanWindow::event(), QVideoWindow::event(), and QPaintDeviceWindow::event().
|
protectedvirtual |
The expose event (ev) is sent by the window system when a window moves between the un-exposed and exposed states.
An exposed window is potentially visible to the user. If the window is moved off screen, is made totally obscured by another window, is minimized, or similar, this function might be called and the value of isExposed() might change to false. You may use this event to limit expensive operations such as animations to only run when the window is exposed.
This event should not be used to paint. To handle painting implement paintEvent() instead.
A resize event will always be sent before the expose event the first time a window is shown.
Reimplemented in src_gui_vulkan_qvulkaninstance2::VulkanWindow, QPaintDeviceWindow, and QQuickWindow.
Definition at line 2345 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event(), and QPaintDeviceWindow::exposeEvent().
|
protectedvirtual |
Override this to handle focus in events (ev).
Focus in events are sent when the window receives keyboard focus.
Reimplemented in QQuickWindow.
Definition at line 2663 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event().
|
privatevirtual |
Returns the QObject that will be the final receiver of events tied focus, such as key events.
Reimplemented in QWidgetWindow, and QQuickWindow.
Definition at line 2168 of file qwindow.cpp.
Referenced by QGuiApplication::focusObject(), and QGuiApplicationPrivate::processActivatedEvent().
|
signal |
This signal is emitted when the final receiver of events tied to focus is changed to object.
Referenced by QWidget::clearFocus(), QQuickDeliveryAgentPrivate::clearFocusInScope(), QQuickWindowPrivate::init(), QQuickWidgetPrivate::initOffscreenWindow(), and QQuickDeliveryAgentPrivate::setFocusInScope().
|
protectedvirtual |
Override this to handle focus out events (ev).
Focus out events are sent when the window loses keyboard focus.
Reimplemented in QQuickWindow.
Definition at line 2675 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event().
|
overrideprivatevirtual |
Returns the actual format of this window.
After the window has been created, this function will return the actual surface format of the window. It might differ from the requested format if the requested format could not be fulfilled by the platform. It might also be a superset, for example certain buffer sizes may be larger than requested.
Implements QSurface.
Definition at line 888 of file qwindow.cpp.
References d.
Referenced by QCALayerBackingStore::QCALayerBackingStore(), QShapedPixmapWindow::QShapedPixmapWindow(), QWindowsDragCursorWindow::QWindowsDragCursorWindow(), QBackingStoreRhiSupport::create(), QEglFSWindow::create(), QGles2SwapChain::createOrResize(), QBackingStoreDefaultCompositor::flush(), QCALayerBackingStore::flush(), QOpenGLWindow::grabFramebuffer(), QOpenGLWidgetPrivate::initialize(), QCocoaWindow::isOpaque(), QWindowsBackingStore::resize(), QPlatformBackingStore::setRhiConfig(), and QWindowsDirect2DWindow::setWindowFlags().
|
signal |
Referenced by QWaylandOutput::initialize(), setGeometry(), and QQuickWindowAttached::windowChange().
|
slot |
Hides the window.
Equivalent to calling setVisible(false).
Definition at line 2199 of file qwindow.cpp.
References setVisible().
|
protectedvirtual |
Override this to handle hide events (ev).
The function is called when the window has requested being hidden in the windowing system.
Reimplemented in QQuickWindow.
Definition at line 2408 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event(), and QWidgetWindow::handleExposeEvent().
Override this to handle key press events (ev).
Reimplemented in QQuickView, and QQuickWindow.
Definition at line 2641 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event().
Override this to handle key release events (ev).
Reimplemented in QQuickView, and QQuickWindow.
Definition at line 2651 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event().
|
slot |
Lower the window in the windowing system.
Requests that the window be lowered to appear below other windows.
Definition at line 1072 of file qwindow.cpp.
References d, and QWindowPrivate::PositionBottom.
|
signal |
|
signal |
|
signal |
|
signal |
|
signal |
This signal is emitted when the Qwindow::modality property changes to modality.
|
protectedvirtual |
Override this to handle mouse double click events (ev).
Reimplemented in QQuickWindow.
Definition at line 2705 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event().
|
protectedvirtual |
Override this to handle mouse move events (ev).
Reimplemented in QQuickView, and QQuickWindow.
Definition at line 2713 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event().
|
protectedvirtual |
Override this to handle mouse press events (ev).
Reimplemented in QQuickView, and QQuickWindow.
Definition at line 2685 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event().
|
protectedvirtual |
Override this to handle mouse release events (ev).
Reimplemented in QQuickView, and QQuickWindow.
Definition at line 2695 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event().
|
protectedvirtual |
Override this to handle window move events (ev).
Definition at line 2372 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event().
|
protectedvirtual |
Override this to handle platform dependent events.
Will be given eventType, message and result.
This might make your application non-portable.
Should return true only if the event was handled.
Reimplemented in QWidgetWindow.
Definition at line 2758 of file qwindow.cpp.
References Q_UNUSED.
|
protectedvirtual |
The paint event (ev) is sent by the window system whenever an area of the window needs a repaint, for example when initially showing the window, or due to parts of the window being uncovered by moving another window.
The application is expected to render into the window in response to the paint event, regardless of the exposed state of the window. For example, a paint event may be sent before the window is exposed, to prepare it for showing to the user.
Reimplemented in QShapedPixmapWindow, QWindowsDragCursorWindow, QPaintDeviceWindow, and QOpenGLWindow.
Definition at line 2364 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event().
|
overrideprivate |
|
slot |
|
signal |
|
slot |
|
signal |
|
signal |
|
slot |
|
slot |
Raise the window in the windowing system.
Requests that the window be raised to appear above other windows.
Definition at line 1057 of file qwindow.cpp.
References d, and QWindowPrivate::PositionTop.
|
protectedvirtual |
Override this to handle resize events (ev).
The resize event is called whenever the window is resized in the windowing system, either directly through the windowing system acknowledging a setGeometry() or resize() request, or indirectly through the user resizing the window manually.
Reimplemented in QQuickView, QQuickWindow, QVideoWindow, QOpenGLWindow, and QQuickApplicationWindow.
Definition at line 2384 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event(), and QQuickApplicationWindow::resizeEvent().
|
signal |
This signal is emitted when a window's screen changes, either by being set explicitly with setScreen(), or automatically when the window's screen is removed.
Referenced by QQuickWindowQmlImpl::QQuickWindowQmlImpl(), QWidgetWindow::QWidgetWindow(), QQuickWindowPrivate::init(), and QWaylandOutput::initialize().
Sets the geometry of the window, excluding its window frame, to rect.
The geometry is in relation to the virtualGeometry() of its screen.
Definition at line 1756 of file qwindow.cpp.
References d, emit, QRect::height(), heightChanged(), rect, QHighDpi::toNativeWindowGeometry(), QRect::width(), widthChanged(), QWindowPrivate::WindowFrameExclusive, QRect::x(), xChanged(), QRect::y(), and yChanged().
|
slot |
Sets the geometry of the window, excluding its window frame, to a rectangle constructed from posx, posy, w and h.
The geometry is in relation to the virtualGeometry() of its screen.
Definition at line 1744 of file qwindow.cpp.
References setGeometry().
Referenced by AndroidSurfaceView::AndroidSurfaceView(), QDirectFbWindow::createDirectFBWindow(), setGeometry(), AndroidSurfaceView::setGeometry(), setX(), setY(), QWindowContainerPrivate::updateGeometry(), and QShapedPixmapWindow::updateGeometry().
|
slot |
Definition at line 1637 of file qwindow.cpp.
References arg, height, and width.
Referenced by QQuickTest::initView(), and QQuickWidgetPrivate::updateSize().
|
slot |
Definition at line 1689 of file qwindow.cpp.
References maximumWidth.
|
slot |
Definition at line 1680 of file qwindow.cpp.
References maximumHeight.
|
slot |
Definition at line 1656 of file qwindow.cpp.
References minimumWidth.
|
slot |
Definition at line 1647 of file qwindow.cpp.
References minimumHeight.
Definition at line 972 of file qwindow.cpp.
References d, Qt::Desktop, emit, and title.
Referenced by QQuickWidgetOffscreenWindow::QQuickWidgetOffscreenWindow(), and quick_test_main_with_setup().
|
slot |
Definition at line 652 of file qwindow.cpp.
Referenced by AndroidSurfaceView::AndroidSurfaceView(), QBasicDrag::cancel(), QWindowPrivate::create(), QBasicDrag::drop(), hide(), QtWaylandClient::QWaylandIviSurface::ivi_controller_surface_visibility(), QBasicDrag::recreateShapedPixmapWindow(), AndroidSurfaceView::setVisible(), QQuickWindowQmlImpl::setVisible(), showFullScreen(), showMaximized(), showMinimized(), and showNormal().
|
slot |
Definition at line 1627 of file qwindow.cpp.
References arg, height, and width.
Referenced by QQuickTest::initView(), and QQuickWidgetPrivate::updateSize().
|
slot |
Definition at line 1601 of file qwindow.cpp.
References arg, d, height, setGeometry(), width, x, and y.
|
slot |
Definition at line 1614 of file qwindow.cpp.
References arg, d, height, setGeometry(), width, x, and y.
|
slot |
Shows the window.
This is equivalent to calling showFullScreen(), showMaximized(), or showNormal(), depending on the platform's default behavior for the window type and flags.
Definition at line 2181 of file qwindow.cpp.
References QPlatformIntegration::defaultWindowState(), QGuiApplicationPrivate::platformIntegration(), showFullScreen(), showMaximized(), showNormal(), Qt::WindowFullScreen, and Qt::WindowMaximized.
Referenced by QQuick3DLightmapBaker::bake(), QWindowsOleDropSource::GiveFeedback(), main(), main(), main(), makeDocTeamHappyByKeepingExampleCompilable(), quick_test_main_with_setup(), QQuickTest::showView(), and snippetThatUsesMyPopulateScene().
|
protectedvirtual |
Override this to handle show events (ev).
The function is called when the window has requested becoming visible.
If the window is successfully shown by the windowing system, this will be followed by a resize and an expose event.
Reimplemented in QQuickWindow.
Definition at line 2397 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event(), and QWidgetWindow::handleExposeEvent().
|
slot |
Shows the window as fullscreen.
Equivalent to calling setWindowStates(Qt::WindowFullScreen) and then setVisible(true).
See the \l{QWidget::showFullScreen()} documentation for platform-specific considerations and limitations.
Definition at line 2243 of file qwindow.cpp.
References setVisible(), and Qt::WindowFullScreen.
Referenced by show().
|
slot |
Shows the window as maximized.
Equivalent to calling setWindowStates(Qt::WindowMaximized) and then setVisible(true).
Definition at line 2226 of file qwindow.cpp.
References setVisible(), and Qt::WindowMaximized.
Referenced by show().
|
slot |
Shows the window as minimized.
Equivalent to calling setWindowStates(Qt::WindowMinimized) and then setVisible(true).
Definition at line 2212 of file qwindow.cpp.
References setVisible(), and Qt::WindowMinimized.
|
slot |
Shows the window as normal, i.e.
neither maximized, minimized, nor fullscreen.
Equivalent to calling setWindowStates(Qt::WindowNoState) and then setVisible(true).
Definition at line 2261 of file qwindow.cpp.
References setVisible(), and Qt::WindowNoState.
Referenced by show().
|
inlineoverrideprivatevirtual |
Returns the size of the window excluding any window frame.
Implements QSurface.
Definition at line 210 of file qwindow.h.
References QRect::size().
Referenced by QDirectFbBackingStore::QDirectFbBackingStore(), QQnxWindow::QQnxWindow(), QQnxWindow::QQnxWindow(), QQnxRasterWindow::adjustBufferSize(), QCocoaWindow::applyContentBorderThickness(), QPaintDeviceWindow::event(), QXcbNativeBackingStore::flush(), QXcbBackingStore::flush(), QOpenGLWindow::grabFramebuffer(), QShapedPixmapWindow::paintEvent(), QQuickView::sizeHint(), QD3D11SwapChain::surfacePixelSize(), QGles2SwapChain::surfacePixelSize(), QVkSwapChain::surfacePixelSize(), QPaintDeviceWindow::update(), and QShapedPixmapWindow::updateGeometry().
|
slot |
Start a system-specific move operation.
Calling this will start an interactive move operation on the window by platforms that support it. The actual behavior may vary depending on the platform. Usually, it will make the window follow the mouse cursor until a mouse button is released.
On platforms that support it, this method of moving windows is preferred over setPosition
, because it allows a more native look-and-feel of moving windows, e.g. letting the window manager snap this window against other windows, or special tiling or resizing behavior with animations when dragged to the edge of the screen. Furthermore, on some platforms such as Wayland, setPosition
is not supported, so this is the only way the application can influence its position.
Returns true if the operation was supported by the system.
Definition at line 1138 of file qwindow.cpp.
References d, and Q_UNLIKELY.
|
slot |
Start a system-specific resize operation.
Calling this will start an interactive resize operation on the window by platforms that support it. The actual behavior may vary depending on the platform. Usually, it will make the window resize so that its edge follows the mouse cursor.
On platforms that support it, this method of resizing windows is preferred over setGeometry
, because it allows a more native look and feel of resizing windows, e.g. letting the window manager snap this window against other windows, or special resizing behavior with animations when dragged to the edge of the screen.
edges should either be a single edge, or two adjacent edges (a corner). Other values are not allowed.
Returns true if the operation was supported by the system.
Definition at line 1100 of file qwindow.cpp.
References Qt::BottomEdge, d, Qt::LeftEdge, Q_UNLIKELY, qWarning, Qt::RightEdge, and Qt::TopEdge.
|
overrideprivatevirtual |
Returns the surface type of the window.
Implements QSurface.
Definition at line 628 of file qwindow.cpp.
References d.
Referenced by QIOSWindow::QIOSWindow(), QWindowsWindow::QWindowsWindow(), QMetalSwapChain::createOrResize(), QRhiBackingStore::flush(), QAndroidPlatformWindow::isRaster(), QEglFSWindow::isRaster(), and QAndroidPlatformBackingStore::setBackingStore().
|
protectedvirtual |
Override this to handle touch events (ev).
Definition at line 2731 of file qwindow.cpp.
References QEvent::ignore().
Referenced by event().
|
signal |
Referenced by QQuickWindowQmlImpl::QQuickWindowQmlImpl(), and QQuickWindowQmlImpl::componentComplete().
|
signal |
Referenced by QWaylandOutput::initialize(), setGeometry(), and QQuickWindowAttached::windowChange().
|
signal |
This signal is emitted when the windowState changes, either by being set explicitly with setWindowStates(), or automatically when the user clicks one of the titlebar buttons or by other means.
|
signal |
|
signal |
|
friend |
|
friend |
|
friend |
Definition at line 2864 of file qwindow.cpp.
|
friend |
|
read |
|
readwrite |
the orientation of the 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.
The recommended orientation is QScreen::orientation() but an application doesn't have to support all possible orientations, and thus can opt to ignore the current screen orientation.
The difference between the window and the content orientation determines how much to rotate the content by. QScreen::angleBetween(), QScreen::transformBetween(), and QScreen::mapBetween() can be used to compute the necessary transform.
The default value is Qt::PrimaryOrientation
Definition at line 383 of file qwindow.h.
Referenced by QIOSWindow::QIOSWindow(), and QQuickOverlayPrivate::updateGeometry().
|
readwrite |
the window flags of the window
The window flags control the window's appearance in the windowing system, whether it's a dialog, popup, or a regular window, and whether it should have a title bar, etc.
The actual window flags might differ from the flags set with setFlags() if the requested flags could not be fulfilled.
Definition at line 383 of file qwindow.h.
Referenced by QHaikuWindow::QHaikuWindow(), QWasmWindow::QWasmWindow(), QXcbWindow::create(), QCocoaWindow::createNSWindow(), QWindowsBackingStore::flush(), getWindowUnderPointer(), QWindowsWindow::handleGeometryChangingMessage(), QWasmWindow::initialize(), QGuiApplicationPrivate::processActivatedEvent(), redirectWheelEvent(), QXcbWindow::setNetWmStateOnUnmappedWindow(), QmlJSDebugger::QQuickWindowInspector::setShowAppOnTop(), QXcbWindow::setWindowFlags(), QIOSWindow::setWindowState(), showSystemMenu(), QWindowsMouseHandler::translateMouseEvent(), and QAndroidPlatformWindow::updateSystemUiVisibility().
|
readwrite |
the height of the window's geometry
Definition at line 383 of file qwindow.h.
Referenced by QDialog::adjustPosition(), QOffscreenBackingStore::flush(), QIOSScreen::grabWindow(), QQuickWindowAttached::height(), QQuickTest::initView(), QQuickDrawerPrivate::positionAt(), QQuickPopupPrivate::resizeOverlay(), QQuickDrawerPrivate::resizeOverlay(), setHeight(), setWidth(), setX(), setY(), and QQuickWindowAttached::windowChange().
|
readwrite |
the maximum height of the window's geometry
Definition at line 383 of file qwindow.h.
Referenced by setMaximumWidth().
|
readwrite |
the maximum width of the window's geometry
Definition at line 383 of file qwindow.h.
Referenced by setMaximumHeight().
|
readwrite |
the minimum height of the window's geometry
Definition at line 383 of file qwindow.h.
Referenced by setMinimumWidth().
|
readwrite |
the minimum width of the window's geometry
Definition at line 383 of file qwindow.h.
Referenced by setMinimumHeight().
|
readwrite |
the modality of the window
A modal window prevents other windows from receiving input events. Qt supports two types of modality: Qt::WindowModal and Qt::ApplicationModal.
By default, this property is Qt::NonModal
Definition at line 383 of file qwindow.h.
Referenced by QCocoaWindow::createNSWindow(), QGuiApplicationPrivate::isWindowBlocked(), and QHaikuWindow::setWindowFlags().
|
readwrite |
The opacity of the window in the windowing system.
If the windowing system supports window opacity, this can be used to fade the window in and out, or to make it semitransparent.
A value of 1.0 or above is treated as fully opaque, whereas a value of 0.0 or below is treated as fully transparent. Values inbetween represent varying levels of translucency between the two extremes.
The default value is 1.0.
Definition at line 383 of file qwindow.h.
Referenced by QIOSWindow::QIOSWindow(), and QCocoaWindow::isOpaque().
|
readwrite |
the window's title in the windowing system
The window title might appear in the title area of the window decorations, depending on the windowing system and the window flags. It might also be used by the windowing system to identify the window in other contexts, such as in the task switcher.
Definition at line 383 of file qwindow.h.
Referenced by QDockWidget::changeEvent(), QQuickWindowQmlImpl::componentComplete(), QtWaylandClient::QWaylandBradientDecoration::paint(), setTitle(), and QCocoaWindow::setWindowFlags().
|
readwrite |
the screen-occupation state of the window
Visibility is whether the window should appear in the windowing system as normal, minimized, maximized, fullscreen or hidden.
To set the visibility to AutomaticVisibility means to give the window a default visible state, which might be fullscreen or windowed depending on the platform. When reading the visibility property you will always get the actual state, never AutomaticVisibility.
Definition at line 383 of file qwindow.h.
Referenced by QQuickWindowAttached::visibility(), and QQuickWindowAttached::windowChange().
|
readwrite |
whether the window is visible or not
This property controls the visibility of the window in the windowing system.
By default, the window is not visible, you must call setVisible(true), or show() or similar to make it visible.
Definition at line 383 of file qwindow.h.
Referenced by QWidgetWindow::setNativeWindowVisibility(), and setVisible().
|
readwrite |
the width of the window's geometry
Definition at line 383 of file qwindow.h.
Referenced by QDialog::adjustPosition(), QOffscreenBackingStore::flush(), QIOSScreen::grabWindow(), QQuickTest::initView(), QComboBoxDelegate::paint(), QQuickDrawerPrivate::positionAt(), QQuickPopupPrivate::resizeOverlay(), QQuickDrawerPrivate::resizeOverlay(), setHeight(), setWidth(), setX(), setY(), QQuickWindowAttached::width(), and QQuickWindowAttached::windowChange().
|
readwrite |
the x position of the window's geometry
Definition at line 383 of file qwindow.h.
Referenced by QDirectFbWindowEGL::createDirectFBWindow(), QDirectFbWindow::createDirectFBWindow(), QXcbSystemTrayBackingStore::render(), setX(), and setY().
|
readwrite |
the y position of the window's geometry
Definition at line 383 of file qwindow.h.
Referenced by QDirectFbWindowEGL::createDirectFBWindow(), QDirectFbWindow::createDirectFBWindow(), setX(), and setY().