You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
qt3/doc/html/qerrormessage.html

106 lines
5.2 KiB

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/dialogs/qerrormessage.cpp:76 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>QErrorMessage Class</title>
<style type="text/css"><!--
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&nbsp;Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped&nbsp;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>QErrorMessage Class Reference</h1>
<p>The QErrorMessage class provides an error message display dialog.
<a href="#details">More...</a>
<p><tt>#include &lt;<a href="qerrormessage-h.html">qerrormessage.h</a>&gt;</tt>
<p>Inherits <a href="qdialog.html">QDialog</a>.
<p><a href="qerrormessage-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li class=fn><a href="#QErrorMessage"><b>QErrorMessage</b></a> ( QWidget&nbsp;*&nbsp;parent, const&nbsp;char&nbsp;*&nbsp;name = 0 )</li>
<li class=fn><a href="#~QErrorMessage"><b>~QErrorMessage</b></a> ()</li>
</ul>
<h2>Public Slots</h2>
<ul>
<li class=fn>void <a href="#message"><b>message</b></a> ( const&nbsp;QString&nbsp;&amp;&nbsp;m )</li>
</ul>
<h2>Static Public Members</h2>
<ul>
<li class=fn>QErrorMessage * <a href="#qtHandler"><b>qtHandler</b></a> ()</li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
<p> The QErrorMessage class provides an error message display dialog.
<p>
<p> This is basically a <a href="qlabel.html">QLabel</a> and a "show this message again" checkbox which
remembers what not to show.
<p> There are two ways to use this class:
<ol type=1>
<li> For production applications. In this context the class can be used to
display messages which you don't need the user to see more than once. To use
QErrorMessage like this, you create the dialog in the usual way and call the
<a href="#message">message</a>() slot, or connect signals to it.
<p> <li> For developers. In this context the static <a href="#qtHandler">qtHandler</a>() installs
a message handler using <a href="qapplication.html#qInstallMsgHandler">qInstallMsgHandler</a>() and creates a QErrorMessage
that displays <a href="qapplication.html#qDebug">qDebug</a>(), <a href="qapplication.html#qWarning">qWarning</a>() and <a href="qapplication.html#qFatal">qFatal</a>() messages.
</ol>
<p> In both cases QErrorMessage will queue pending messages, and display
them (or not) in order, as soon as the user presses Enter or clicks OK
after seeing each message.
<p> <center><img src="qerrormessage.png"></center>
<p> <p>See also <a href="qmessagebox.html">QMessageBox</a>, <a href="qstatusbar.html#message">QStatusBar::message</a>(), <a href="dialogs.html">Dialog Classes</a>, and <a href="misc.html">Miscellaneous Classes</a>.
<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="QErrorMessage"></a>QErrorMessage::QErrorMessage ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;parent, const&nbsp;char&nbsp;*&nbsp;name = 0 )
</h3> Constructs and installs an error handler window.
The parent <em>parent</em> and name <em>name</em> are passed on to the <a href="qdialog.html">QDialog</a>
constructor.
<h3 class=fn><a name="~QErrorMessage"></a>QErrorMessage::~QErrorMessage ()
</h3> Destroys the object and frees any allocated resources. Notably,
the list of "do not show again" messages is deleted.
<h3 class=fn>void <a name="message"></a>QErrorMessage::message ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;m )<tt> [slot]</tt>
</h3> Shows message <em>m</em> and returns immediately. If the user has requested
that <em>m</em> not be shown, this function does nothing.
<p> Normally, <em>m</em> is shown at once, but if there are pending messages,
<em>m</em> is queued for later display.
<h3 class=fn><a href="qerrormessage.html">QErrorMessage</a>&nbsp;* <a name="qtHandler"></a>QErrorMessage::qtHandler ()<tt> [static]</tt>
</h3> Returns a pointer to a QErrorMessage object that outputs the
default Qt messages. This function creates such an object, if there
isn't one already.
<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>.
Copyright &copy; 1995-2007
<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 &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt 3.3.8</div>
</table></div></address></body>
</html>