File: qdialog.html

package info (click to toggle)
python-qt4 4.0.1-5
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 18,632 kB
  • ctags: 2,639
  • sloc: python: 29,409; sh: 5,646; cpp: 3,168; xml: 149; makefile: 109
file content (122 lines) | stat: -rw-r--r-- 22,860 bytes parent folder | download
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
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html><head><title>QDialog Class Reference</title><style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
td.postheader { font-family: sans-serif }
tr.address { font-family: sans-serif }
body { background: #ffffff; color: black; }
</style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr /><td align="left" valign="top" width="32"><img align="left" border="0" height="32" src="images/rb-logo.png" width="32" /></td><td width="1">&#160;&#160;</td><td class="postheader" valign="center"><a href="../pyqt4ref.html"><font color="#004faf">Home</font></a>&#160;&#183; <a href="classes.html"><font color="#004faf">All Classes</font></a>&#160;&#183; <a href="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QDialog Class Reference<br /><sup><sup>[<a href="qtgui.html">QtGui</a> module]</sup></sup></h1><p>The QDialog class is the base class of dialog windows. <a href="#details">More...</a></p>
<p>Inherits <a href="qwidget.html">QWidget</a>.</p><p>Inherited by <a href="qabstractprintdialog.html">QAbstractPrintDialog</a>, <a href="qcolordialog.html">QColorDialog</a>, <a href="qerrormessage.html">QErrorMessage</a>, <a href="qfiledialog.html">QFileDialog</a>, <a href="qfontdialog.html">QFontDialog</a>, <a href="qinputdialog.html">QInputDialog</a>, <a href="qmessagebox.html">QMessageBox</a>, <a href="qpagesetupdialog.html">QPageSetupDialog</a> and <a href="qprogressdialog.html">QProgressDialog</a>.</p><h3>Types</h3><ul><li><div class="fn" />enum <b><a href="qdialog.html#DialogCode-enum">DialogCode</a></b> { Rejected, Accepted }</li></ul><h3>Methods</h3><ul><li><div class="fn" /><b><a href="qdialog.html#QDialog">__init__</a></b> (<i>self</i>, QWidget&#160;<i>parent</i>&#160;=&#160;None, Qt.WindowFlags&#160;<i>f</i>&#160;=&#160;0)</li><li><div class="fn" /><b><a href="qdialog.html#accept">accept</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qdialog.html#closeEvent">closeEvent</a></b> (<i>self</i>, QCloseEvent)</li><li><div class="fn" /><b><a href="qdialog.html#contextMenuEvent">contextMenuEvent</a></b> (<i>self</i>, QContextMenuEvent)</li><li><div class="fn" /><b><a href="qdialog.html#done">done</a></b> (<i>self</i>, int)</li><li><div class="fn" />bool <b><a href="qdialog.html#eventFilter">eventFilter</a></b> (<i>self</i>, QObject, QEvent)</li><li><div class="fn" />int <b><a href="qdialog.html#exec">exec_</a></b> (<i>self</i>)</li><li><div class="fn" />QWidget <b><a href="qdialog.html#extension">extension</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qdialog.html#isSizeGripEnabled">isSizeGripEnabled</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qdialog.html#keyPressEvent">keyPressEvent</a></b> (<i>self</i>, QKeyEvent)</li><li><div class="fn" />QSize <b><a href="qdialog.html#minimumSizeHint">minimumSizeHint</a></b> (<i>self</i>)</li><li><div class="fn" />Qt.Orientation <b><a href="qdialog.html#orientation">orientation</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qdialog.html#reject">reject</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qdialog.html#resizeEvent">resizeEvent</a></b> (<i>self</i>, QResizeEvent)</li><li><div class="fn" />int <b><a href="qdialog.html#result">result</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qdialog.html#setExtension">setExtension</a></b> (<i>self</i>, QWidget&#160;<i>extension</i>)</li><li><div class="fn" /><b><a href="qdialog.html#setModal">setModal</a></b> (<i>self</i>, bool&#160;<i>modal</i>)</li><li><div class="fn" /><b><a href="qdialog.html#setOrientation">setOrientation</a></b> (<i>self</i>, Qt.Orientation&#160;<i>orientation</i>)</li><li><div class="fn" /><b><a href="qdialog.html#setResult">setResult</a></b> (<i>self</i>, int&#160;<i>r</i>)</li><li><div class="fn" /><b><a href="qdialog.html#setSizeGripEnabled">setSizeGripEnabled</a></b> (<i>self</i>, bool)</li><li><div class="fn" /><b><a href="qdialog.html#setVisible">setVisible</a></b> (<i>self</i>, bool&#160;<i>visible</i>)</li><li><div class="fn" /><b><a href="qdialog.html#showEvent">showEvent</a></b> (<i>self</i>, QShowEvent)</li><li><div class="fn" /><b><a href="qdialog.html#showExtension">showExtension</a></b> (<i>self</i>, bool)</li><li><div class="fn" />QSize <b><a href="qdialog.html#sizeHint">sizeHint</a></b> (<i>self</i>)</li></ul><h3>Qt Signals</h3><ul><li><div class="fn" />void <b><a href="qdialog.html#accepted">accepted</a></b> ()</li><li><div class="fn" />void <b><a href="qdialog.html#finished">finished</a></b> (int)</li><li><div class="fn" />void <b><a href="qdialog.html#rejected">rejected</a></b> ()</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>The QDialog class is the base class of dialog windows.</p>
<p>A dialog window is a top-level window mostly used for short-term tasks and brief communications with the user. QDialogs may be modal or modeless. QDialogs support <a href="#extensibility">extensibility</a> and can provide a <a href="#return">return value</a>. They can have <a href="#default">default buttons</a>. QDialogs can also have a <a href="qsizegrip.html">QSizeGrip</a> in their lower-right corner, using <a href="qdialog.html#sizeGripEnabled-prop">setSizeGripEnabled</a>().</p>
<p>Note that QDialog uses the parent widget slightly differently from other classes in Qt. A dialog is always a top-level widget, but if it has a parent, its default location is centered on top of the parent's top-level widget (if it is not top-level itself). It will also share the parent's taskbar entry.</p>
<p>Use the overload of the <a href="qwidget.html#setParent">QWidget.setParent</a>() function to change the ownership of a QDialog widget. This function allows you to explicitly set the window flags of the reparented widget; using the overloaded function will clear the window flags specifying the window-system properties for the widget (in particular it will reset the <a href="qt.html#WindowType-enum">Qt.Dialog</a> flag).</p>
<a id="modal-dialogs" name="modal-dialogs" />
<h3>Modal Dialogs</h3>
<p>A <b>modal</b> dialog is a dialog that blocks input to other visible windows in the same application. Users must finish interacting with the dialog and close it before they can access any other window in the application. Dialogs that are used to request a file name from the user or that are used to set application preferences are usually modal.</p>
<p>The most common way to display a modal dialog is to call its <a href="qdialog.html#exec">exec_</a>() function. When the user closes the dialog, <a href="qdialog.html#exec">exec_</a>() will provide a useful <a href="#return">return value</a>. Typically, to get the dialog to close and return the appropriate value, we connect a default button, e.g. "OK", to the <a href="qdialog.html#accept">accept</a>() slot and a "Cancel" button to the <a href="qdialog.html#reject">reject</a>() slot. Alternatively you can call the <a href="qdialog.html#done">done</a>() slot with <tt>Accepted</tt> or <tt>Rejected</tt>.</p>
<p>An alternative is to call setModal(true) or <a href="qwidget.html#windowModality-prop">setWindowModality</a>(), then <a href="qwidget.html#show">show</a>(). Unlike <a href="qdialog.html#exec">exec_</a>(), <a href="qwidget.html#show">show</a>() returns control to the caller immediately. Calling setModal(true) is especially useful for progress dialogs, where the user must have the ability to interact with the dialog, e.g. to cancel a long running operation. If you use <a href="qwidget.html#show">show</a>() and setModal(true) together to perform a long operation, you must call <a href="qcoreapplication.html#processEvents">QApplication.processEvents</a>() periodically during processing to enable the user to interact with the dialog. (See <a href="qprogressdialog.html">QProgressDialog</a>.)</p>
<a id="modeless-dialogs" name="modeless-dialogs" />
<h3>Modeless Dialogs</h3>
<p>A <b>modeless</b> dialog is a dialog that operates independently of other windows in the same application. Find and replace dialogs in word-processors are often modeless to allow the user to interact with both the application's main window and with the dialog.</p>
<p>Modeless dialogs are displayed using <a href="qwidget.html#show">show</a>(), which returns control to the caller immediately.</p>
<a id="default" name="default" /><a id="default-button" name="default-button" />
<h3>Default Button</h3>
<p>A dialog's <i>default</i> button is the button that's pressed when the user presses Enter (Return). This button is used to signify that the user accepts the dialog's settings and wants to close the dialog. Use <a href="qpushbutton.html#default-prop">QPushButton.setDefault</a>(), <a href="qpushbutton.html#default-prop">QPushButton.isDefault</a>() and <a href="qpushbutton.html#autoDefault-prop">QPushButton.autoDefault</a>() to set and control the dialog's default button.</p>
<a id="escapekey" name="escapekey" /><a id="escape-key" name="escape-key" />
<h3>Escape Key</h3>
<p>If the user presses the Esc key in a dialog, <a href="qdialog.html#reject">QDialog.reject</a>() will be called. This will cause the window to close: The <a href="qcloseevent.html">close event</a> cannot be <a href="qevent.html#ignore">ignored</a>.</p>
<a id="extensibility" name="extensibility" />
<h3>Extensibility</h3>
<p>Extensibility is the ability to show the dialog in two ways: a partial dialog that shows the most commonly used options, and a full dialog that shows all the options. Typically an extensible dialog will initially appear as a partial dialog, but with a "More" toggle button. If the user presses the "More" button down, the full dialog will appear. The extension widget will be resized to its <a href="qwidget.html#sizeHint-prop">sizeHint</a>(). If orientation is <a href="qt.html#Orientation-enum">Qt.Horizontal</a> the extension widget's <a href="qwidget.html#height-prop">height</a>() will be expanded to the <a href="qwidget.html#height-prop">height</a>() of the dialog. If the orientation is <a href="qt.html#Orientation-enum">Qt.Vertical</a> the extension widget's <a href="qwidget.html#width-prop">width</a>() will be expanded to the <a href="qwidget.html#width-prop">width</a>() of the dialog. Extensibility is controlled with <a href="qdialog.html#setExtension">setExtension</a>(), <a href="qdialog.html#setOrientation">setOrientation</a>() and <a href="qdialog.html#showExtension">showExtension</a>().</p>
<a id="return" name="return" /><a id="return-value-modal-dialogs" name="return-value-modal-dialogs" />
<h3>Return Value (Modal Dialogs)</h3>
<p>Modal dialogs are often used in situations where a return value is required, e.g. to indicate whether the user pressed "OK" or "Cancel". A dialog can be closed by calling the <a href="qdialog.html#accept">accept</a>() or the <a href="qdialog.html#reject">reject</a>() slots, and <a href="qdialog.html#exec">exec_</a>() will return <tt>Accepted</tt> or <tt>Rejected</tt> as appropriate. The <a href="qdialog.html#exec">exec_</a>() call returns the result of the dialog. The result is also available from <a href="qdialog.html#result">result</a>() if the dialog has not been destroyed.</p>
<a id="examples" name="examples" /><a id="code-examples" name="code-examples" />
<h3>Code Examples</h3>
<p>A modal dialog:</p>
<pre>
    void EditorWindow.countWords()
    {
        WordCountDialog dialog(this);
        dialog.setWordCount(document().wordCount());
        dialog.exec();
    }
</pre>
<p>A modeless dialog:</p>
<pre>
    void EditorWindow.find()
    {
        if (!findDialog) {
            findDialog = new FindDialog(this);
            connect(findDialog, SIGNAL(findNext()), this, SLOT(findNext()));
        }

        findDialog-&gt;show();
        findDialog-&gt;raise();
        findDialog-&gt;activateWindow();
    }
</pre>
<p>See also <a href="porting4.html#qtabdialog">QTabDialog</a>, <a href="qwidget.html">QWidget</a>, <a href="qprogressdialog.html">QProgressDialog</a>, and <a href="guibooks.html#fowler">GUI Design Handbook: Dialogs, Standard</a>.</p>
<hr /><h2>Type Documentation</h2><h3 class="fn"><a name="DialogCode-enum" />QDialog.DialogCode</h3><p>The value returned by a modal dialog.</p>
<table border="1" cellpadding="2" cellspacing="1" width="40%">
<tr>
<th width="60%">Constant</th>
<th width="40%">Value</th>
</tr>
<tr>
<td valign="top"><tt>QDialog.Accepted</tt></td>
<td align="center" valign="top"><tt>1</tt></td>
</tr>
<tr>
<td valign="top"><tt>QDialog.Rejected</tt></td>
<td align="center" valign="top"><tt>0</tt></td>
</tr>
</table>
<br />
<br />
<hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QDialog" />QDialog.__init__ (<i>self</i>, <a href="qwidget.html">QWidget</a>&#160;<i>parent</i>&#160;=&#160;None, <a href="qt-windowflags.html">Qt.WindowFlags</a>&#160;<i>f</i>&#160;=&#160;0)</h3><p>The <i>parent</i> argument, if not None, causes <i>self</i> to be owned by Qt instead of PyQt.</p><p>Constructs a dialog with parent <i>parent</i>.</p>
<p>A dialog is always a top-level widget, but if it has a parent, its default location is centered on top of the parent. It will also share the parent's taskbar entry.</p>
<p>The widget flags <i>f</i> are passed on to the <a href="qwidget.html">QWidget</a> constructor. If, for example, you don't want a What's This button in the title bar of the dialog, pass <a href="qt.html#WindowType-enum">Qt.WindowTitleHint</a> | <a href="qt.html#WindowType-enum">Qt.WindowSystemMenuHint</a> in <i>f</i>.</p>
<p>See also <a href="qwidget.html#windowFlags-prop">QWidget.setWindowFlags</a>().</p>
<h3 class="fn"><a name="accept" />QDialog.accept (<i>self</i>)</h3><p>This method is also a Qt slot with the C++ signature <tt>void accept()</tt>.</p><p>Hides the modal dialog and sets the result code to <tt>Accepted</tt>.</p>
<p>See also <a href="qdialog.html#reject">reject</a>() and <a href="qdialog.html#done">done</a>().</p>
<h3 class="fn"><a name="closeEvent" />QDialog.closeEvent (<i>self</i>, <a href="qcloseevent.html">QCloseEvent</a>)</h3><h3 class="fn"><a name="contextMenuEvent" />QDialog.contextMenuEvent (<i>self</i>, <a href="qcontextmenuevent.html">QContextMenuEvent</a>)</h3><h3 class="fn"><a name="done" />QDialog.done (<i>self</i>, int)</h3><p>This method is also a Qt slot with the C++ signature <tt>void done(int)</tt>.</p><p>Closes the dialog and sets its result code to <i>r</i>. If this dialog is shown with <a href="qdialog.html#exec">exec_</a>(), done() causes the local event loop to finish, and <a href="qdialog.html#exec">exec_</a>() to return <i>r</i>.</p>
<p>As with <a href="qwidget.html#close">QWidget.close</a>(), done() deletes the dialog if the <a href="qt.html#WidgetAttribute-enum">Qt.WA_DeleteOnClose</a> flag is set. If the dialog is the application's main widget, the application terminates. If the dialog is the last window closed, the <a href="qapplication.html#lastWindowClosed">QApplication.lastWindowClosed</a>() signal is emitted.</p>
<p>See also <a href="qdialog.html#accept">accept</a>(), <a href="qdialog.html#reject">reject</a>(), <a href="qapplication.html#activeWindow">QApplication.activeWindow</a>(), and <a href="qcoreapplication.html#quit">QApplication.quit</a>().</p>
<h3 class="fn"><a name="eventFilter" />bool QDialog.eventFilter (<i>self</i>, <a href="qobject.html">QObject</a>, <a href="qevent.html">QEvent</a>)</h3><h3 class="fn"><a name="exec" />int QDialog.exec_ (<i>self</i>)</h3><p>This method is also a Qt slot with the C++ signature <tt>int exec()</tt>.</p><p>Shows the dialog as a <a href="qdialog.html#modal-dialogs">modal dialog</a>, blocking until the user closes it. The function returns a <a href="qdialog.html#DialogCode-enum">DialogCode</a> result.</p>
<p>Users cannot interact with any other window in the same application until they close the dialog.</p>
<p>See also <a href="qwidget.html#show">show</a>() and <a href="qdialog.html#result">result</a>().</p>
<h3 class="fn"><a name="extension" /><a href="qwidget.html">QWidget</a> QDialog.extension (<i>self</i>)</h3><p>Returns the dialog's extension or 0 if no extension has been defined.</p>
<p>See also <a href="qdialog.html#setExtension">setExtension</a>().</p>
<h3 class="fn"><a name="isSizeGripEnabled" />bool QDialog.isSizeGripEnabled (<i>self</i>)</h3><h3 class="fn"><a name="keyPressEvent" />QDialog.keyPressEvent (<i>self</i>, <a href="qkeyevent.html">QKeyEvent</a>)</h3><h3 class="fn"><a name="minimumSizeHint" /><a href="qsize.html">QSize</a> QDialog.minimumSizeHint (<i>self</i>)</h3><h3 class="fn"><a name="orientation" /><a href="qt.html#Orientation-enum">Qt.Orientation</a> QDialog.orientation (<i>self</i>)</h3><p>Returns the dialog's extension orientation.</p>
<p>See also <a href="qdialog.html#setOrientation">setOrientation</a>().</p>
<h3 class="fn"><a name="reject" />QDialog.reject (<i>self</i>)</h3><p>This method is also a Qt slot with the C++ signature <tt>void reject()</tt>.</p><p>Hides the modal dialog and sets the result code to <tt>Rejected</tt>.</p>
<p>See also <a href="qdialog.html#accept">accept</a>() and <a href="qdialog.html#done">done</a>().</p>
<h3 class="fn"><a name="resizeEvent" />QDialog.resizeEvent (<i>self</i>, <a href="qresizeevent.html">QResizeEvent</a>)</h3><h3 class="fn"><a name="result" />int QDialog.result (<i>self</i>)</h3><p>Returns the modal dialog's result code, <tt>Accepted</tt> or <tt>Rejected</tt>.</p>
<p>Do not call this function if the dialog was constructed with the <a href="qt.html#WidgetAttribute-enum">Qt.WA_DeleteOnClose</a> attribute.</p>
<p>See also <a href="qdialog.html#setResult">setResult</a>().</p>
<h3 class="fn"><a name="setExtension" />QDialog.setExtension (<i>self</i>, <a href="qwidget.html">QWidget</a>&#160;<i>extension</i>)</h3><p>Sets the widget, <i>extension</i>, to be the dialog's extension, deleting any previous extension. The dialog takes ownership of the extension. Note that if 0 is passed any existing extension will be deleted.</p>
<p>This function must only be called while the dialog is hidden.</p>
<p>See also <a href="qdialog.html#showExtension">showExtension</a>(), <a href="qdialog.html#setOrientation">setOrientation</a>(), and <a href="qdialog.html#extension">extension</a>().</p>
<h3 class="fn"><a name="setModal" />QDialog.setModal (<i>self</i>, bool&#160;<i>modal</i>)</h3><h3 class="fn"><a name="setOrientation" />QDialog.setOrientation (<i>self</i>, <a href="qt.html#Orientation-enum">Qt.Orientation</a>&#160;<i>orientation</i>)</h3><p>If <i>orientation</i> is <a href="qt.html#Orientation-enum">Qt.Horizontal</a>, the extension will be displayed to the right of the dialog's main area. If <i>orientation</i> is <a href="qt.html#Orientation-enum">Qt.Vertical</a>, the extension will be displayed below the dialog's main area.</p>
<p>See also <a href="qdialog.html#orientation">orientation</a>() and <a href="qdialog.html#setExtension">setExtension</a>().</p>
<h3 class="fn"><a name="setResult" />QDialog.setResult (<i>self</i>, int&#160;<i>r</i>)</h3><p>Sets the modal dialog's result code to <i>i</i>.</p>
<p>See also <a href="qdialog.html#result">result</a>().</p>
<h3 class="fn"><a name="setSizeGripEnabled" />QDialog.setSizeGripEnabled (<i>self</i>, bool)</h3><h3 class="fn"><a name="setVisible" />QDialog.setVisible (<i>self</i>, bool&#160;<i>visible</i>)</h3><h3 class="fn"><a name="showEvent" />QDialog.showEvent (<i>self</i>, <a href="qshowevent.html">QShowEvent</a>)</h3><h3 class="fn"><a name="showExtension" />QDialog.showExtension (<i>self</i>, bool)</h3><p>This method is also a Qt slot with the C++ signature <tt>void showExtension(bool)</tt>.</p><p>If <i>showIt</i> is true, the dialog's extension is shown; otherwise the extension is hidden.</p>
<p>This slot is usually connected to the <a href="qabstractbutton.html#toggled">QPushButton.toggled</a>() signal of a <a href="qpushbutton.html">QPushButton</a>.</p>
<p>A dialog with a visible extension is not resizeable.</p>
<p>See also <a href="qwidget.html#show">show</a>(), <a href="qdialog.html#setExtension">setExtension</a>(), and <a href="qdialog.html#setOrientation">setOrientation</a>().</p>
<h3 class="fn"><a name="sizeHint" /><a href="qsize.html">QSize</a> QDialog.sizeHint (<i>self</i>)</h3><hr /><h2>Qt Signal Documentation</h2><h3 class="fn"><a name="accepted" />void accepted ()</h3><p>This signal is emitted when the dialog has been accepted either by the user or by calling <a href="qdialog.html#accept">accept</a>() or <a href="qdialog.html#done">done</a>() with the <a href="qdialog.html#DialogCode-enum">QDialog.Accepted</a> argument.</p>
<p>Note that this signal is <i>not</i> emitted when hiding the dialog with <a href="qwidget.html#hide">hide</a>() or setVisible(false). This includes deleting the dialog while it is visible.</p>
<p>This function was introduced in Qt 4.1.</p>
<p>See also <a href="qdialog.html#finished">finished</a>() and <a href="qdialog.html#rejected">rejected</a>().</p>
<h3 class="fn"><a name="finished" />void finished (int)</h3><p>This signal is emitted when the dialog's <i>result</i> code has been set, either by the user or by calling <a href="qdialog.html#done">done</a>(), <a href="qdialog.html#accept">accept</a>(), or <a href="qdialog.html#reject">reject</a>().</p>
<p>Note that this signal is <i>not</i> emitted when hiding the dialog with <a href="qwidget.html#hide">hide</a>() or setVisible(false). This includes deleting the dialog while it is visible.</p>
<p>This function was introduced in Qt 4.1.</p>
<p>See also <a href="qdialog.html#accepted">accepted</a>() and <a href="qdialog.html#rejected">rejected</a>().</p>
<h3 class="fn"><a name="rejected" />void rejected ()</h3><p>This signal is emitted when the dialog has been rejected either by the user or by calling <a href="qdialog.html#reject">reject</a>() or <a href="qdialog.html#done">done</a>() with the <a href="qdialog.html#DialogCode-enum">QDialog.Rejected</a> argument.</p>
<p>Note that this signal is <i>not</i> emitted when hiding the dialog with <a href="qwidget.html#hide">hide</a>() or setVisible(false). This includes deleting the dialog while it is visible.</p>
<p>This function was introduced in Qt 4.1.</p>
<p>See also <a href="qdialog.html#finished">finished</a>() and <a href="qdialog.html#accepted">accepted</a>().</p>
<address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td width="25%">PyQt&#160;4.0.1 for X11</td><td align="center" width="50%">Copyright &#169; <a href="http://www.riverbankcomputing.com">Riverbank&#160;Computing&#160;Ltd</a> and <a href="http://www.trolltech.com">Trolltech&#160;AS</a> 2006</td><td align="right" width="25%">Qt&#160;4.1.4</td></tr></table></div></address></body></html>