summaryrefslogtreecommitdiffstats
path: root/doc/html/tqerrormessage.html
blob: d965c907896dbde115ee82de5f97b72351e0af98 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>TQErrorMessage 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>TQErrorMessage Class Reference</h1>

<p>The TQErrorMessage class provides an error message display dialog.
<a href="#details">More...</a>
<p><tt>#include &lt;<a href="tqerrormessage-h.html">tqerrormessage.h</a>&gt;</tt>
<p>Inherits <a href="tqdialog.html">TQDialog</a>.
<p><a href="tqerrormessage-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li class=fn><a href="#TQErrorMessage"><b>TQErrorMessage</b></a> ( TQWidget&nbsp;*&nbsp;parent, const&nbsp;char&nbsp;*&nbsp;name = 0 )</li>
<li class=fn><a href="#~TQErrorMessage"><b>~TQErrorMessage</b></a> ()</li>
</ul>
<h2>Public Slots</h2>
<ul>
<li class=fn>void <a href="#message"><b>message</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;m )</li>
</ul>
<h2>Static Public Members</h2>
<ul>
<li class=fn>TQErrorMessage * <a href="#qtHandler"><b>qtHandler</b></a> ()</li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
 
<p> The TQErrorMessage class provides an error message display dialog.
<p> 

<p> This is basically a <a href="tqlabel.html">TQLabel</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
TQErrorMessage 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="ntqapplication.html#qInstallMsgHandler">qInstallMsgHandler</a>() and creates a TQErrorMessage
that displays <a href="ntqapplication.html#qDebug">tqDebug</a>(), <a href="ntqapplication.html#qWarning">tqWarning</a>() and <a href="ntqapplication.html#qFatal">tqFatal</a>() messages.
</ol>
<p> In both cases TQErrorMessage 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="tqerrormessage.png"></center> 
<p> <p>See also <a href="tqmessagebox.html">TQMessageBox</a>, <a href="tqstatusbar.html#message">TQStatusBar::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="TQErrorMessage"></a>TQErrorMessage::TQErrorMessage ( <a href="tqwidget.html">TQWidget</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="tqdialog.html">TQDialog</a>
constructor.

<h3 class=fn><a name="~TQErrorMessage"></a>TQErrorMessage::~TQErrorMessage ()
</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>TQErrorMessage::message ( const&nbsp;<a href="tqstring.html">TQString</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="tqerrormessage.html">TQErrorMessage</a>&nbsp;* <a name="qtHandler"></a>TQErrorMessage::qtHandler ()<tt> [static]</tt>
</h3>  Returns a pointer to a TQErrorMessage object that outputs the
default TQt 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">TQt 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>TQt 3.3.8</div>
</table></div></address></body>
</html>