summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDavid Boddie <dboddie@trolltech.com>2009-08-28 13:01:10 (GMT)
committerDavid Boddie <dboddie@trolltech.com>2009-08-28 13:01:10 (GMT)
commit9725ab222ffceb34b93af01631b273404ab784a9 (patch)
tree91765bf18be03e52b860c0b56f1c8fd242ea4d81
parent81fc91183fd12cff512ac20ed265b6c0b44b2f30 (diff)
downloadQt-9725ab222ffceb34b93af01631b273404ab784a9.zip
Qt-9725ab222ffceb34b93af01631b273404ab784a9.tar.gz
Qt-9725ab222ffceb34b93af01631b273404ab784a9.tar.bz2
Doc: Added some information about the clipping applied in paint events.
Task-number: 203483 Reviewed-by: Trust Me
-rw-r--r--src/gui/kernel/qevent.cpp11
1 files changed, 10 insertions, 1 deletions
diff --git a/src/gui/kernel/qevent.cpp b/src/gui/kernel/qevent.cpp
index 9626193..8d98223 100644
--- a/src/gui/kernel/qevent.cpp
+++ b/src/gui/kernel/qevent.cpp
@@ -1080,8 +1080,17 @@ Qt::FocusReason QFocusEvent::reason() const
rect() that is the bounding rectangle of that region. Both are
provided because many widgets can't make much use of region(),
and rect() can be much faster than region().boundingRect().
+
+ \section1 Automatic Clipping
+
Painting is clipped to region() during the processing of a paint
- event.
+ event. This clipping is performed by Qt's paint system and is
+ independent of any clipping that may be applied to a QPainter used to
+ draw on the paint device.
+
+ As a result, the value returned by QPainter::clipRegion() on
+ a newly-constructed QPainter will not reflect the clip region that is
+ used by the paint system.
\sa QPainter, QWidget::update(), QWidget::repaint(),
QWidget::paintEvent()