<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /tmp/qt-3.0-reggie-28534/qt-x11-free-3.0.2/src/kernel/qevent.cpp:1226 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>QCloseEvent 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>QCloseEvent Class Reference</h1>
<p>The QCloseEvent class contains parameters that describe a close event.
<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="qcloseevent-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li><div class=fn><a href="#QCloseEvent"><b>QCloseEvent</b></a> ()</div></li>
<li><div class=fn>bool <a href="#isAccepted"><b>isAccepted</b></a> () const</div></li>
<li><div class=fn>void <a href="#accept"><b>accept</b></a> ()</div></li>
<li><div class=fn>void <a href="#ignore"><b>ignore</b></a> ()</div></li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
The QCloseEvent class contains parameters that describe a close event.
<p> Close events are sent to widgets that the user wants to close, usually
by choosing "Close" from the window menu. They are also sent when you
call <a href="qwidget.html#close">QWidget::close</a>() to close a widget programmatically.
<p> Close events contain a flag that indicates whether the receiver wants
the widget to be closed or not. When a widget accepts the close
event, it is hidden (and destroyed if it was created with the <a href="qt.html#WidgetFlags-enum">WDestructiveClose</a> flag). If it refuses to accept the close event
nothing happens. (Under X11 it is possible that the window manager
will forcibly close the window; but at the time of writing we are not
aware of any window manager that does this.)
<p> The main widget of the application - <a href="qapplication.html#mainWidget">QApplication::mainWidget</a>() - is
a special case. When it accepts the close event, Qt leaves the main
event loop and the application is immediately terminated (i.e., it
returns from the call to <a href="qapplication.html#exec">QApplication::exec</a>() in the main()
function).
<p> The event handler <a href="qwidget.html#closeEvent">QWidget::closeEvent</a>() receives close events. The
default implementation of this event handler accepts the close
event. If you do not want your widget to be hidden, or want some
special handing, you should reimplement the event handler.
<p> The <a href="simple-application.html#closeEvent">closeEvent() in the
Application Walkthrough</a> shows a close event handler that asks
whether to save a document before closing.
<p> If you want the widget to be deleted when it is closed, simply
create it with the <a href="qt.html#WidgetFlags-enum">WDestructiveClose</a> widget flag. This is very
useful for independent top-level windows in a multi-window
application.
<p> <a href="qobject.html">QObject</a> emits the <a href="qobject.html#destroyed">destroyed()</a> signal
when it is deleted.
<p> If the last top-level window is closed, the
<a href="qapplication.html#lastWindowClosed">QApplication::lastWindowClosed</a>() signal is emitted.
<p> The <a href="#isAccepted">isAccepted</a>() function returns TRUE if the event's receiver has
agreed to close the widget; call <a href="#accept">accept</a>() to agree to close the widget
and call <a href="#ignore">ignore</a>() if the receiver of this event does not want the
widget to be closed.
<p> <p>See also <a href="qwidget.html#close">QWidget::close</a>(), <a href="qwidget.html#hide">QWidget::hide</a>(), <a href="qobject.html#destroyed">QObject::destroyed</a>(), <a href="qapplication.html#setMainWidget">QApplication::setMainWidget</a>(), <a href="qapplication.html#lastWindowClosed">QApplication::lastWindowClosed</a>(), <a href="qapplication.html#exec">QApplication::exec</a>(), <a href="qapplication.html#quit">QApplication::quit</a>() and <a href="events.html">Event Classes</a>.
<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="QCloseEvent"></a>QCloseEvent::QCloseEvent ()
</h3>
Constructs a close event object with the accept parameter flag set to FALSE.
<p>See also <a href="#accept">accept</a>().
<h3 class=fn>void <a name="accept"></a>QCloseEvent::accept ()
</h3>
Sets the accept flag of the close event object.
<p> Setting the accept flag indicates that the receiver of this event agrees
to close the widget.
<p> The accept flag is <em>not</em> set by default.
<p> If you choose to accept in <a href="qwidget.html#closeEvent">QWidget::closeEvent</a>(), the widget will be
hidden. If the widget's WDestructiveClose flag is set, it will also
be destroyed.
<p> <p>See also <a href="#ignore">ignore</a>() and <a href="qwidget.html#hide">QWidget::hide</a>().
<p>Examples: <a href="qaction-application-example.html#x2016">action/application.cpp</a>, <a href="simple-application-example.html#x1913">application/application.cpp</a>, <a href="popup-example.html#x881">popup/popup.cpp</a> and <a href="qwerty-example.html#x622">qwerty/qwerty.cpp</a>.
<h3 class=fn>void <a name="ignore"></a>QCloseEvent::ignore ()
</h3>
Clears the accept flag of the close event object.
<p> Clearing the accept flag indicates that the receiver of this event does not
want the widget to be closed.
<p> The close event is constructed with the accept flag cleared.
<p> <p>See also <a href="#accept">accept</a>().
<p>Examples: <a href="qaction-application-example.html#x2017">action/application.cpp</a>, <a href="simple-application-example.html#x1914">application/application.cpp</a> and <a href="qwerty-example.html#x623">qwerty/qwerty.cpp</a>.
<h3 class=fn>bool <a name="isAccepted"></a>QCloseEvent::isAccepted () const
</h3>
Returns TRUE if the receiver of the event has agreed to close the
widget; otherwise returns FALSE.
<p>See also <a href="#accept">accept</a>() and <a href="#ignore">ignore</a>().
<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>.
Copyright © 1995-2001
<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 © 2001
<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.0.2</div>
</table></div></address></body>
</html>
distrib
>
Mandriva
>
8.2
>
i586
>
media
>
contrib
>
by-pkgid
>
112b0974ad288f6cd55bf971ee6026a9
>
files
>
967
