Clarify that QExposeEvent/exposeEvent handles any invalidation of the window

Change-Id: Ib6f649213e3268c6946c7fa973ce970e896a46a0
Reviewed-by: Laszlo Agocs <laszlo.agocs@qt.io>
This commit is contained in:
Tor Arne Vestbø 2018-03-20 13:53:02 +01:00
parent 941aea658f
commit ea60b4eb9a
2 changed files with 9 additions and 7 deletions

View File

@ -1533,8 +1533,8 @@ QMoveEvent::~QMoveEvent()
\ingroup events \ingroup events
Expose events are sent to windows when an area of the window is invalidated Expose events are sent to windows when an area of the window is invalidated,
or window exposure in the windowing system changes. for example when window exposure in the windowing system changes.
A Window with a client area that is completely covered by another window, or A Window with a client area that is completely covered by another window, or
is otherwise not visible may be considered obscured by Qt and may in such is otherwise not visible may be considered obscured by Qt and may in such

View File

@ -113,9 +113,10 @@ QT_BEGIN_NAMESPACE
physical area of the screen. On windowing systems that have exposure physical area of the screen. On windowing systems that have exposure
notifications, the isExposed() accessor describes whether the window should notifications, the isExposed() accessor describes whether the window should
be treated as directly visible on screen. The exposeEvent() function is be treated as directly visible on screen. The exposeEvent() function is
called whenever the windows exposure in the windowing system changes. On called whenever an area of the window is invalidated, for example due to the
windowing systems that do not make this information visible to the exposure in the windowing system changing. On windowing systems that do not
application, isExposed() will simply return the same value as isVisible(). make this information visible to the application, isExposed() will simply
return the same value as isVisible().
QWindow::Visibility queried through visibility() is a convenience API QWindow::Visibility queried through visibility() is a convenience API
combining the functions of visible() and windowStates(). combining the functions of visible() and windowStates().
@ -2148,8 +2149,9 @@ bool QWindow::close()
} }
/*! /*!
The expose event (\a ev) is sent by the window system whenever the window's The expose event (\a ev) is sent by the window system whenever an area of
exposure on screen changes. the window is invalidated, for example due to the exposure in the windowing
system changing.
The application can start rendering into the window with QBackingStore The application can start rendering into the window with QBackingStore
and QOpenGLContext as soon as it gets an exposeEvent() such that and QOpenGLContext as soon as it gets an exposeEvent() such that