<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/reggie/tmp/qt-3.1-reggie-23625/qt-x11-free-3.1.1/src/kernel/qevent.cpp:1240 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>QPaintEvent Class</title>
<style type="text/css"><!--
h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">Home</font></a>
| <a href="classes.html">
<font color="#004faf">All Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped Classes</font></a>
| <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>QPaintEvent Class Reference</h1>
<p>The QPaintEvent class contains event parameters for paint events.
<a href="#details">More...</a>
<p><tt>#include <<a href="qevent-h.html">qevent.h</a>></tt>
<p>Inherits <a href="qevent.html">QEvent</a>.
<p><a href="qpaintevent-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li><div class=fn><a href="#QPaintEvent"><b>QPaintEvent</b></a> ( const QRegion & paintRegion, bool erased = TRUE )</div></li>
<li><div class=fn><a href="#QPaintEvent-2"><b>QPaintEvent</b></a> ( const QRect & paintRect, bool erased = TRUE )</div></li>
<li><div class=fn>const QRect & <a href="#rect"><b>rect</b></a> () const</div></li>
<li><div class=fn>const QRegion & <a href="#region"><b>region</b></a> () const</div></li>
<li><div class=fn>bool <a href="#erased"><b>erased</b></a> () const</div></li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
The QPaintEvent class contains event parameters for paint events.
<p>
<p> Paint events are sent to widgets that need to update themselves,
for instance when part of a widget is exposed because a covering
widget is moved.
<p> The event contains a <a href="#region">region</a>() that needs to be updated, and a
<a href="#rect">rect</a>() 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(). Painting
is clipped to region() during processing of a paint event.
<p> The <a href="#erased">erased</a>() function returns TRUE if the region() has been
cleared to the widget's background (see
<a href="qwidget.html#backgroundMode">QWidget::backgroundMode</a>()), and FALSE if the region's contents are
arbitrary.
<p> <p>See also <a href="qpainter.html">QPainter</a>, <a href="qwidget.html#update">QWidget::update</a>(), <a href="qwidget.html#repaint">QWidget::repaint</a>(), <a href="qwidget.html#paintEvent">QWidget::paintEvent</a>(), <a href="qwidget.html#backgroundMode-prop">QWidget::backgroundMode</a>, <a href="qregion.html">QRegion</a>, and <a href="events.html">Event Classes</a>.
<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="QPaintEvent"></a>QPaintEvent::QPaintEvent ( const <a href="qregion.html">QRegion</a> & paintRegion, bool erased = TRUE )
</h3>
<p> Constructs a paint event object with the region that should be
updated. The region is given by <em>paintRegion</em>. If <em>erased</em> is
TRUE the region will be cleared before repainting.
<h3 class=fn><a name="QPaintEvent-2"></a>QPaintEvent::QPaintEvent ( const <a href="qrect.html">QRect</a> & paintRect, bool erased = TRUE )
</h3>
<p> Constructs a paint event object with the rectangle that should be
updated. The region is given by <em>paintRect</em>. If <em>erased</em> is TRUE
the region will be cleared before repainting.
<h3 class=fn>bool <a name="erased"></a>QPaintEvent::erased () const
</h3>
<p> Returns TRUE if the paint event region (or rectangle) has been
erased with the widget's background; otherwise returns FALSE.
<h3 class=fn>const <a href="qrect.html">QRect</a> & <a name="rect"></a>QPaintEvent::rect () const
</h3>
<p> Returns the rectangle that should be updated.
<p> <p>See also <a href="#region">region</a>() and <a href="qpainter.html#setClipRect">QPainter::setClipRect</a>().
<p>Examples: <a href="life-example.html#x1839">life/life.cpp</a>, <a href="qfd-example.html#x1944">qfd/fontdisplayer.cpp</a>, <a href="showimg-example.html#x1213">showimg/showimg.cpp</a>, <a href="tutorial1-10.html#x2288">t10/cannon.cpp</a>, <a href="tutorial1-11.html#x2300">t11/cannon.cpp</a>, <a href="tutorial1-13.html#x2336">t13/cannon.cpp</a>, and <a href="tooltip-example.html#x444">tooltip/tooltip.cpp</a>.
<h3 class=fn>const <a href="qregion.html">QRegion</a> & <a name="region"></a>QPaintEvent::region () const
</h3>
<p> Returns the region that should be updated.
<p> <p>See also <a href="#rect">rect</a>() and <a href="qpainter.html#setClipRegion">QPainter::setClipRegion</a>().
<p>Examples: <a href="qfd-example.html#x1945">qfd/fontdisplayer.cpp</a> and <a href="scribble-example.html#x937">scribble/scribble.cpp</a>.
<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>.
Copyright © 1995-2002
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright © 2002
<a href="http://www.trolltech.com">Trolltech</a><td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt version 3.1.1</div>
</table></div></address></body>
</html>
