<?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>QInputDialog 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">  </td><td class="postheader" 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="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QInputDialog Class Reference<br /><sup><sup>[<a href="qtgui.html">QtGui</a> module]</sup></sup></h1><p>The QInputDialog class provides a simple convenience dialog to get a single value from the user. <a href="#details">More...</a></p> <p>Inherits <a href="qdialog.html">QDialog</a>.</p><h3>Types</h3><ul><li><div class="fn" />enum <b><a href="qinputdialog.html#InputDialogOption-enum">InputDialogOption</a></b> { NoButtons, UseListViewForComboBoxItems }</li><li><div class="fn" />class <b><a href="qinputdialog-inputdialogoptions.html">InputDialogOptions</a></b></li><li><div class="fn" />enum <b><a href="qinputdialog.html#InputMode-enum">InputMode</a></b> { TextInput, IntInput, DoubleInput }</li></ul><h3>Methods</h3><ul><li><div class="fn" /><b><a href="qinputdialog.html#QInputDialog">__init__</a></b> (<i>self</i>, QWidget <i>parent</i> = None, Qt.WindowFlags <i>flags</i> = 0)</li><li><div class="fn" />QString <b><a href="qinputdialog.html#cancelButtonText">cancelButtonText</a></b> (<i>self</i>)</li><li><div class="fn" />QStringList <b><a href="qinputdialog.html#comboBoxItems">comboBoxItems</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#done">done</a></b> (<i>self</i>, int <i>result</i>)</li><li><div class="fn" />int <b><a href="qinputdialog.html#doubleDecimals">doubleDecimals</a></b> (<i>self</i>)</li><li><div class="fn" />float <b><a href="qinputdialog.html#doubleMaximum">doubleMaximum</a></b> (<i>self</i>)</li><li><div class="fn" />float <b><a href="qinputdialog.html#doubleMinimum">doubleMinimum</a></b> (<i>self</i>)</li><li><div class="fn" />float <b><a href="qinputdialog.html#doubleValue">doubleValue</a></b> (<i>self</i>)</li><li><div class="fn" />InputMode <b><a href="qinputdialog.html#inputMode">inputMode</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qinputdialog.html#intMaximum">intMaximum</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qinputdialog.html#intMinimum">intMinimum</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qinputdialog.html#intStep">intStep</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qinputdialog.html#intValue">intValue</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qinputdialog.html#isComboBoxEditable">isComboBoxEditable</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qinputdialog.html#labelText">labelText</a></b> (<i>self</i>)</li><li><div class="fn" />QSize <b><a href="qinputdialog.html#minimumSizeHint">minimumSizeHint</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qinputdialog.html#okButtonText">okButtonText</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#open">open</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#open-2">open</a></b> (<i>self</i>, QObject <i>receiver</i>, SLOT()SLOT() <i>member</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#open-3">open</a></b> (<i>self</i>, callable <i>receiver</i>)</li><li><div class="fn" />InputDialogOptions <b><a href="qinputdialog.html#options">options</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setCancelButtonText">setCancelButtonText</a></b> (<i>self</i>, QString <i>text</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setComboBoxEditable">setComboBoxEditable</a></b> (<i>self</i>, bool <i>editable</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setComboBoxItems">setComboBoxItems</a></b> (<i>self</i>, QStringList <i>items</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setDoubleDecimals">setDoubleDecimals</a></b> (<i>self</i>, int <i>decimals</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setDoubleMaximum">setDoubleMaximum</a></b> (<i>self</i>, float <i>max</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setDoubleMinimum">setDoubleMinimum</a></b> (<i>self</i>, float <i>min</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setDoubleRange">setDoubleRange</a></b> (<i>self</i>, float <i>min</i>, float <i>max</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setDoubleValue">setDoubleValue</a></b> (<i>self</i>, float <i>value</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setInputMode">setInputMode</a></b> (<i>self</i>, InputMode <i>mode</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setIntMaximum">setIntMaximum</a></b> (<i>self</i>, int <i>max</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setIntMinimum">setIntMinimum</a></b> (<i>self</i>, int <i>min</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setIntRange">setIntRange</a></b> (<i>self</i>, int <i>min</i>, int <i>max</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setIntStep">setIntStep</a></b> (<i>self</i>, int <i>step</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setIntValue">setIntValue</a></b> (<i>self</i>, int <i>value</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setLabelText">setLabelText</a></b> (<i>self</i>, QString <i>text</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setOkButtonText">setOkButtonText</a></b> (<i>self</i>, QString <i>text</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setOption">setOption</a></b> (<i>self</i>, InputDialogOption <i>option</i>, bool <i>on</i> = True)</li><li><div class="fn" /><b><a href="qinputdialog.html#setOptions">setOptions</a></b> (<i>self</i>, InputDialogOptions <i>options</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setTextEchoMode">setTextEchoMode</a></b> (<i>self</i>, QLineEdit.EchoMode <i>mode</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setTextValue">setTextValue</a></b> (<i>self</i>, QString <i>text</i>)</li><li><div class="fn" /><b><a href="qinputdialog.html#setVisible">setVisible</a></b> (<i>self</i>, bool <i>visible</i>)</li><li><div class="fn" />QSize <b><a href="qinputdialog.html#sizeHint">sizeHint</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qinputdialog.html#testOption">testOption</a></b> (<i>self</i>, InputDialogOption <i>option</i>)</li><li><div class="fn" />QLineEdit.EchoMode <b><a href="qinputdialog.html#textEchoMode">textEchoMode</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qinputdialog.html#textValue">textValue</a></b> (<i>self</i>)</li></ul><h3>Static Methods</h3><ul><li><div class="fn" />(float, bool <i>ok</i>) <b><a href="qinputdialog.html#getDouble">getDouble</a></b> (QWidget <i>parent</i>, QString <i>title</i>, QString <i>label</i>, float <i>value</i> = 0, float <i>min</i> = -2147483647, float <i>max</i> = 2147483647, int <i>decimals</i> = 1, Qt.WindowFlags <i>flags</i> = 0)</li><li><div class="fn" />(int, bool <i>ok</i>) <b><a href="qinputdialog.html#getInt">getInt</a></b> (QWidget <i>parent</i>, QString <i>title</i>, QString <i>label</i>, int <i>value</i> = 0, int <i>min</i> = -2147483647, int <i>max</i> = 2147483647, int <i>step</i> = 1, Qt.WindowFlags <i>flags</i> = 0)</li><li><div class="fn" />(int, bool <i>ok</i>) <b><a href="qinputdialog.html#getInteger">getInteger</a></b> (QWidget <i>parent</i>, QString <i>title</i>, QString <i>label</i>, int <i>value</i> = 0, int <i>min</i> = -2147483647, int <i>max</i> = 2147483647, int <i>step</i> = 1, Qt.WindowFlags <i>flags</i> = 0)</li><li><div class="fn" />(QString, bool <i>ok</i>) <b><a href="qinputdialog.html#getItem">getItem</a></b> (QWidget <i>parent</i>, QString <i>title</i>, QString <i>label</i>, QStringList <i>list</i>, int <i>current</i> = 0, bool <i>editable</i> = True, Qt.WindowFlags <i>flags</i> = 0)</li><li><div class="fn" />(QString, bool <i>ok</i>) <b><a href="qinputdialog.html#getItem-2">getItem</a></b> (QWidget <i>parent</i>, QString <i>title</i>, QString <i>label</i>, QStringList <i>list</i>, int <i>current</i>, bool <i>editable</i>, Qt.WindowFlags <i>flags</i>, Qt.InputMethodHints <i>inputMethodHints</i>)</li><li><div class="fn" />(QString, bool <i>ok</i>) <b><a href="qinputdialog.html#getText">getText</a></b> (QWidget <i>parent</i>, QString <i>title</i>, QString <i>label</i>, QLineEdit.EchoMode <i>mode</i> = QLineEdit.Normal, QString <i>text</i> = QString(), Qt.WindowFlags <i>flags</i> = 0)</li><li><div class="fn" />(QString, bool <i>ok</i>) <b><a href="qinputdialog.html#getText-2">getText</a></b> (QWidget <i>parent</i>, QString <i>title</i>, QString <i>label</i>, QLineEdit.EchoMode <i>mode</i>, QString <i>text</i>, Qt.WindowFlags <i>flags</i>, Qt.InputMethodHints <i>inputMethodHints</i>)</li></ul><h3>Qt Signals</h3><ul><li><div class="fn" />void <b><a href="qinputdialog.html#doubleValueChanged">doubleValueChanged</a></b> (double)</li><li><div class="fn" />void <b><a href="qinputdialog.html#doubleValueSelected">doubleValueSelected</a></b> (double)</li><li><div class="fn" />void <b><a href="qinputdialog.html#intValueChanged">intValueChanged</a></b> (int)</li><li><div class="fn" />void <b><a href="qinputdialog.html#intValueSelected">intValueSelected</a></b> (int)</li><li><div class="fn" />void <b><a href="qinputdialog.html#textValueChanged">textValueChanged</a></b> (const QString&)</li><li><div class="fn" />void <b><a href="qinputdialog.html#textValueSelected">textValueSelected</a></b> (const QString&)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>The QInputDialog class provides a simple convenience dialog to get a single value from the user.</p> <p>The input value can be a string, a number or an item from a list. A label must be set to tell the user what they should enter.</p> <p>Four static convenience functions are provided: <a href="qinputdialog.html#getText">getText</a>(), <a href="qinputdialog.html#getInt">getInt</a>(), <a href="qinputdialog.html#getDouble">getDouble</a>(), and <a href="qinputdialog.html#getItem">getItem</a>(). All the functions can be used in a similar way, for example:</p> <pre class="cpp"> <span class="type">bool</span> ok; <span class="type"><a href="qstring.html">QString</a></span> text <span class="operator">=</span> <span class="type">QInputDialog</span><span class="operator">.</span>getText(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"QInputDialog.getText()"</span>)<span class="operator">,</span> tr(<span class="string">"User name:"</span>)<span class="operator">,</span> <span class="type"><a href="qlineedit.html">QLineEdit</a></span><span class="operator">.</span>Normal<span class="operator">,</span> <span class="type"><a href="qdir.html">QDir</a></span><span class="operator">.</span>home()<span class="operator">.</span>dirName()<span class="operator">,</span> <span class="operator">&</span>ok); <span class="keyword">if</span> (ok <span class="operator">&</span><span class="operator">&</span> <span class="operator">!</span>text<span class="operator">.</span>isEmpty()) textLabel<span class="operator">-</span><span class="operator">></span>setText(text); </pre> <p>The <tt>ok</tt> variable is set to true if the user clicks <b>OK</b>; otherwise it is set to false.</p> <p class="centerAlign"><img alt="Input Dialogs" src="images/inputdialogs.png" /></p> <p>The <a href="dialogs-standarddialogs.html">Standard Dialogs</a> example shows how to use QInputDialog as well as other built-in Qt dialogs.</p> <hr /><h2>Type Documentation</h2><h3 class="fn"><a name="InputDialogOption-enum" />QInputDialog.InputDialogOption</h3><p>This enum specifies various options that affect the look and feel of an input dialog.</p> <table class="valuelist"> <tr class="odd" valign="top"> <th class="tblConst">Constant</th> <th class="tblval">Value</th> <th class="tbldscr">Description</th> </tr> <tr> <td class="topAlign"><tt>QInputDialog.NoButtons</tt></td> <td class="topAlign"><tt>0x00000001</tt></td> <td class="topAlign">Don't display <b>OK</b> and <b>Cancel</b> buttons. (Useful for "live dialogs".)</td> </tr> <tr> <td class="topAlign"> <tt>QInputDialog.UseListViewForComboBoxItems</tt></td> <td class="topAlign"><tt>0x00000002</tt></td> <td class="topAlign">Use a <a href="qlistview.html">QListView</a> rather than a non-editable <a href="qcombobox.html">QComboBox</a> for displaying the items set with <a href="qinputdialog.html#comboBoxItems-prop">setComboBoxItems</a>().</td> </tr> </table> <p>This enum was introduced or modified in Qt 4.5.</p> <p>The InputDialogOptions type is a typedef for <a href="qflags.html">QFlags</a><InputDialogOption>. It stores an OR combination of InputDialogOption values.</p> <p><b>See also</b> <a href="qinputdialog.html#options-prop">options</a>, <a href="qinputdialog.html#setOption">setOption</a>(), and <a href="qinputdialog.html#testOption">testOption</a>().</p> <h3 class="fn"><a name="InputMode-enum" />QInputDialog.InputMode</h3><p>This enum describes the different modes of input that can be selected for the dialog.</p> <table class="valuelist"> <tr class="odd" valign="top"> <th class="tblConst">Constant</th> <th class="tblval">Value</th> <th class="tbldscr">Description</th> </tr> <tr> <td class="topAlign"><tt>QInputDialog.TextInput</tt></td> <td class="topAlign"><tt>0</tt></td> <td class="topAlign">Used to input text strings.</td> </tr> <tr> <td class="topAlign"><tt>QInputDialog.IntInput</tt></td> <td class="topAlign"><tt>1</tt></td> <td class="topAlign">Used to input integers.</td> </tr> <tr> <td class="topAlign"><tt>QInputDialog.DoubleInput</tt></td> <td class="topAlign"><tt>2</tt></td> <td class="topAlign">Used to input floating point numbers with double precision accuracy.</td> </tr> </table> <p>This enum was introduced or modified in Qt 4.5.</p> <p><b>See also</b> <a href="qinputdialog.html#inputMode-prop">inputMode</a>.</p> <hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QInputDialog" />QInputDialog.__init__ (<i>self</i>, <a href="qwidget.html">QWidget</a> <i>parent</i> = None, <a href="qt-windowflags.html">Qt.WindowFlags</a> <i>flags</i> = 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 new input dialog with the given <i>parent</i> and window <i>flags</i>.</p> <p>This function was introduced in Qt 4.5.</p> <h3 class="fn"><a name="cancelButtonText" />QString QInputDialog.cancelButtonText (<i>self</i>)</h3><h3 class="fn"><a name="comboBoxItems" />QStringList QInputDialog.comboBoxItems (<i>self</i>)</h3><h3 class="fn"><a name="done" />QInputDialog.done (<i>self</i>, int <i>result</i>)</h3><p>Reimplemented from <a href="qdialog.html#done">QDialog.done</a>().</p> <p>Closes the dialog and sets its result code to <i>result</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>result</i>.</p> <p><b>See also</b> <a href="qdialog.html#done">QDialog.done</a>().</p> <h3 class="fn"><a name="doubleDecimals" />int QInputDialog.doubleDecimals (<i>self</i>)</h3><h3 class="fn"><a name="doubleMaximum" />float QInputDialog.doubleMaximum (<i>self</i>)</h3><h3 class="fn"><a name="doubleMinimum" />float QInputDialog.doubleMinimum (<i>self</i>)</h3><h3 class="fn"><a name="doubleValue" />float QInputDialog.doubleValue (<i>self</i>)</h3><h3 class="fn"><a name="getDouble" />(float, bool <i>ok</i>) QInputDialog.getDouble (<a href="qwidget.html">QWidget</a> <i>parent</i>, QString <i>title</i>, QString <i>label</i>, float <i>value</i> = 0, float <i>min</i> = -2147483647, float <i>max</i> = 2147483647, int <i>decimals</i> = 1, <a href="qt-windowflags.html">Qt.WindowFlags</a> <i>flags</i> = 0)</h3><p>Static convenience function to get a floating point number from the user.</p> <p><i>title</i> is the text which is displayed in the title bar of the dialog. <i>label</i> is the text which is shown to the user (it should say what should be entered). <i>value</i> is the default floating point number that the line edit will be set to. <i>min</i> and <i>max</i> are the minimum and maximum values the user may choose. <i>decimals</i> is the maximum number of decimal places the number may have.</p> <p>If <i>ok</i> is nonnull, *<i>ok</i> will be set to true if the user pressed <b>OK</b> and to false if the user pressed <b>Cancel</b>. The dialog's parent is <i>parent</i>. The dialog will be modal and uses the widget <i>flags</i>.</p> <p>This function returns the floating point number which has been entered by the user.</p> <p>Use this static function like this:</p> <pre class="cpp"> <span class="type">bool</span> ok; <span class="type">double</span> d <span class="operator">=</span> <span class="type"><a href="qinputdialog.html">QInputDialog</a></span><span class="operator">.</span>getDouble(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"QInputDialog.getDouble()"</span>)<span class="operator">,</span> tr(<span class="string">"Amount:"</span>)<span class="operator">,</span> <span class="number">37.56</span><span class="operator">,</span> <span class="operator">-</span><span class="number">10000</span><span class="operator">,</span> <span class="number">10000</span><span class="operator">,</span> <span class="number">2</span><span class="operator">,</span> <span class="operator">&</span>ok); <span class="keyword">if</span> (ok) doubleLabel<span class="operator">-</span><span class="operator">></span>setText(<span class="type"><a href="qstring.html">QString</a></span>(<span class="string">"$%1"</span>)<span class="operator">.</span>arg(d)); </pre> <p><b>Warning:</b> Do not delete <i>parent</i> during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of the <a href="qinputdialog.html">QInputDialog</a> constructors.</p> <p><b>See also</b> <a href="qinputdialog.html#getText">getText</a>(), <a href="qinputdialog.html#getInt">getInt</a>(), and <a href="qinputdialog.html#getItem">getItem</a>().</p> <h3 class="fn"><a name="getInt" />(int, bool <i>ok</i>) QInputDialog.getInt (<a href="qwidget.html">QWidget</a> <i>parent</i>, QString <i>title</i>, QString <i>label</i>, int <i>value</i> = 0, int <i>min</i> = -2147483647, int <i>max</i> = 2147483647, int <i>step</i> = 1, <a href="qt-windowflags.html">Qt.WindowFlags</a> <i>flags</i> = 0)</h3><p>Static convenience function to get an integer input from the user.</p> <p><i>title</i> is the text which is displayed in the title bar of the dialog. <i>label</i> is the text which is shown to the user (it should say what should be entered). <i>value</i> is the default integer which the spinbox will be set to. <i>min</i> and <i>max</i> are the minimum and maximum values the user may choose. <i>step</i> is the amount by which the values change as the user presses the arrow buttons to increment or decrement the value.</p> <p>If <i>ok</i> is nonnull *<i>ok</i> will be set to true if the user pressed <b>OK</b> and to false if the user pressed <b>Cancel</b>. The dialog's parent is <i>parent</i>. The dialog will be modal and uses the widget <i>flags</i>.</p> <p>On success, this function returns the integer which has been entered by the user; on failure, it returns the initial <i>value</i>.</p> <p>Use this static function like this:</p> <pre class="cpp"> <span class="type">bool</span> ok; <span class="type">int</span> i <span class="operator">=</span> <span class="type"><a href="qinputdialog.html">QInputDialog</a></span><span class="operator">.</span>getInt(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"QInputDialog.getInteger()"</span>)<span class="operator">,</span> tr(<span class="string">"Percentage:"</span>)<span class="operator">,</span> <span class="number">25</span><span class="operator">,</span> <span class="number">0</span><span class="operator">,</span> <span class="number">100</span><span class="operator">,</span> <span class="number">1</span><span class="operator">,</span> <span class="operator">&</span>ok); <span class="keyword">if</span> (ok) integerLabel<span class="operator">-</span><span class="operator">></span>setText(tr(<span class="string">"%1%"</span>)<span class="operator">.</span>arg(i)); </pre> <p><b>Warning:</b> Do not delete <i>parent</i> during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of the <a href="qinputdialog.html">QInputDialog</a> constructors.</p> <p>This function was introduced in Qt 4.5.</p> <p><b>See also</b> <a href="qinputdialog.html#getText">getText</a>(), <a href="qinputdialog.html#getDouble">getDouble</a>(), and <a href="qinputdialog.html#getItem">getItem</a>().</p> <h3 class="fn"><a name="getInteger" />(int, bool <i>ok</i>) QInputDialog.getInteger (<a href="qwidget.html">QWidget</a> <i>parent</i>, QString <i>title</i>, QString <i>label</i>, int <i>value</i> = 0, int <i>min</i> = -2147483647, int <i>max</i> = 2147483647, int <i>step</i> = 1, <a href="qt-windowflags.html">Qt.WindowFlags</a> <i>flags</i> = 0)</h3><h3 class="fn"><a name="getItem" />(QString, bool <i>ok</i>) QInputDialog.getItem (<a href="qwidget.html">QWidget</a> <i>parent</i>, QString <i>title</i>, QString <i>label</i>, QStringList <i>list</i>, int <i>current</i> = 0, bool <i>editable</i> = True, <a href="qt-windowflags.html">Qt.WindowFlags</a> <i>flags</i> = 0)</h3><p>Static convenience function to let the user select an item from a string list.</p> <p><i>title</i> is the text which is displayed in the title bar of the dialog. <i>label</i> is the text which is shown to the user (it should say what should be entered). <i>items</i> is the string list which is inserted into the combobox. <i>current</i> is the number of the item which should be the current item. <i>inputMethodHints</i> is the input method hints that will be used if the combobox is editable and an input method is active.</p> <p>If <i>editable</i> is true the user can enter their own text; otherwise the user may only select one of the existing items.</p> <p>If <i>ok</i> is nonnull <i>*a</i> ok will be set to true if the user pressed <b>OK</b> and to false if the user pressed <b>Cancel</b>. The dialog's parent is <i>parent</i>. The dialog will be modal and uses the widget <i>flags</i>.</p> <p>This function returns the text of the current item, or if <i>editable</i> is true, the current text of the combobox.</p> <p>Use this static function like this:</p> <pre class="cpp"> <span class="type"><a href="qstringlist.html">QStringList</a></span> items; items <span class="operator"><</span><span class="operator"><</span> tr(<span class="string">"Spring"</span>) <span class="operator"><</span><span class="operator"><</span> tr(<span class="string">"Summer"</span>) <span class="operator"><</span><span class="operator"><</span> tr(<span class="string">"Fall"</span>) <span class="operator"><</span><span class="operator"><</span> tr(<span class="string">"Winter"</span>); <span class="type">bool</span> ok; <span class="type"><a href="qstring.html">QString</a></span> item <span class="operator">=</span> <span class="type"><a href="qinputdialog.html">QInputDialog</a></span><span class="operator">.</span>getItem(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"QInputDialog.getItem()"</span>)<span class="operator">,</span> tr(<span class="string">"Season:"</span>)<span class="operator">,</span> items<span class="operator">,</span> <span class="number">0</span><span class="operator">,</span> <span class="keyword">false</span><span class="operator">,</span> <span class="operator">&</span>ok); <span class="keyword">if</span> (ok <span class="operator">&</span><span class="operator">&</span> <span class="operator">!</span>item<span class="operator">.</span>isEmpty()) itemLabel<span class="operator">-</span><span class="operator">></span>setText(item); </pre> <p><b>Warning:</b> Do not delete <i>parent</i> during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of the <a href="qinputdialog.html">QInputDialog</a> constructors.</p> <p><b>See also</b> <a href="qinputdialog.html#getText">getText</a>(), <a href="qinputdialog.html#getInt">getInt</a>(), and <a href="qinputdialog.html#getDouble">getDouble</a>().</p> <h3 class="fn"><a name="getItem-2" />(QString, bool <i>ok</i>) QInputDialog.getItem (<a href="qwidget.html">QWidget</a> <i>parent</i>, QString <i>title</i>, QString <i>label</i>, QStringList <i>list</i>, int <i>current</i>, bool <i>editable</i>, <a href="qt-windowflags.html">Qt.WindowFlags</a> <i>flags</i>, <a href="qt-inputmethodhints.html">Qt.InputMethodHints</a> <i>inputMethodHints</i>)</h3><h3 class="fn"><a name="getText" />(QString, bool <i>ok</i>) QInputDialog.getText (<a href="qwidget.html">QWidget</a> <i>parent</i>, QString <i>title</i>, QString <i>label</i>, <a href="qlineedit.html#EchoMode-enum">QLineEdit.EchoMode</a> <i>mode</i> = QLineEdit.Normal, QString <i>text</i> = QString(), <a href="qt-windowflags.html">Qt.WindowFlags</a> <i>flags</i> = 0)</h3><p>Static convenience function to get a string from the user.</p> <p><i>title</i> is the text which is displayed in the title bar of the dialog. <i>label</i> is the text which is shown to the user (it should say what should be entered). <i>text</i> is the default text which is placed in the line edit. <i>mode</i> is the echo mode the line edit will use. <i>inputMethodHints</i> is the input method hints that will be used in the edit widget if an input method is active.</p> <p>If <i>ok</i> is nonnull <i>*a</i> ok will be set to true if the user pressed <b>OK</b> and to false if the user pressed <b>Cancel</b>. The dialog's parent is <i>parent</i>. The dialog will be modal and uses the specified widget <i>flags</i>.</p> <p>If the dialog is accepted, this function returns the text in the dialog's line edit. If the dialog is rejected, a null <a href="qstring.html">QString</a> is returned.</p> <p>Use this static function like this:</p> <pre class="cpp"> <span class="type">bool</span> ok; <span class="type"><a href="qstring.html">QString</a></span> text <span class="operator">=</span> <span class="type"><a href="qinputdialog.html">QInputDialog</a></span><span class="operator">.</span>getText(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"QInputDialog.getText()"</span>)<span class="operator">,</span> tr(<span class="string">"User name:"</span>)<span class="operator">,</span> <span class="type"><a href="qlineedit.html">QLineEdit</a></span><span class="operator">.</span>Normal<span class="operator">,</span> <span class="type"><a href="qdir.html">QDir</a></span><span class="operator">.</span>home()<span class="operator">.</span>dirName()<span class="operator">,</span> <span class="operator">&</span>ok); <span class="keyword">if</span> (ok <span class="operator">&</span><span class="operator">&</span> <span class="operator">!</span>text<span class="operator">.</span>isEmpty()) textLabel<span class="operator">-</span><span class="operator">></span>setText(text); </pre> <p><b>Warning:</b> Do not delete <i>parent</i> during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of the <a href="qinputdialog.html">QInputDialog</a> constructors.</p> <p><b>See also</b> <a href="qinputdialog.html#getInt">getInt</a>(), <a href="qinputdialog.html#getDouble">getDouble</a>(), and <a href="qinputdialog.html#getItem">getItem</a>().</p> <h3 class="fn"><a name="getText-2" />(QString, bool <i>ok</i>) QInputDialog.getText (<a href="qwidget.html">QWidget</a> <i>parent</i>, QString <i>title</i>, QString <i>label</i>, <a href="qlineedit.html#EchoMode-enum">QLineEdit.EchoMode</a> <i>mode</i>, QString <i>text</i>, <a href="qt-windowflags.html">Qt.WindowFlags</a> <i>flags</i>, <a href="qt-inputmethodhints.html">Qt.InputMethodHints</a> <i>inputMethodHints</i>)</h3><h3 class="fn"><a name="inputMode" /><a href="qinputdialog.html#InputMode-enum">InputMode</a> QInputDialog.inputMode (<i>self</i>)</h3><h3 class="fn"><a name="intMaximum" />int QInputDialog.intMaximum (<i>self</i>)</h3><h3 class="fn"><a name="intMinimum" />int QInputDialog.intMinimum (<i>self</i>)</h3><h3 class="fn"><a name="intStep" />int QInputDialog.intStep (<i>self</i>)</h3><h3 class="fn"><a name="intValue" />int QInputDialog.intValue (<i>self</i>)</h3><h3 class="fn"><a name="isComboBoxEditable" />bool QInputDialog.isComboBoxEditable (<i>self</i>)</h3><h3 class="fn"><a name="labelText" />QString QInputDialog.labelText (<i>self</i>)</h3><h3 class="fn"><a name="minimumSizeHint" /><a href="qsize.html">QSize</a> QInputDialog.minimumSizeHint (<i>self</i>)</h3><p>Reimplemented from <a href="qwidget.html#minimumSizeHint-prop">QWidget.minimumSizeHint</a>().</p> <h3 class="fn"><a name="okButtonText" />QString QInputDialog.okButtonText (<i>self</i>)</h3><h3 class="fn"><a name="open" />QInputDialog.open (<i>self</i>)</h3><p>This is an overloaded function.</p> <p>This function connects one of its signals to the slot specified by <i>receiver</i> and <i>member</i>. The specific signal depends on the arguments that are specified in <i>member</i>. These are:</p> <ul> <li><a href="qinputdialog.html#textValueSelected">textValueSelected</a>() if <i>member</i> has a <a href="qstring.html">QString</a> for its first argument.</li> <li><a href="qinputdialog.html#intValueSelected">intValueSelected</a>() if <i>member</i> has an int for its first argument.</li> <li><a href="qinputdialog.html#doubleValueSelected">doubleValueSelected</a>() if <i>member</i> has a double for its first argument.</li> <li><a href="qdialog.html#accepted">accepted</a>() if <i>member</i> has NO arguments.</li> </ul> <p>The signal will be disconnected from the slot when the dialog is closed.</p> <p>This function was introduced in Qt 4.5.</p> <h3 class="fn"><a name="open-2" />QInputDialog.open (<i>self</i>, <a href="qobject.html">QObject</a> <i>receiver</i>, SLOT()SLOT() <i>member</i>)</h3><h3 class="fn"><a name="open-3" />QInputDialog.open (<i>self</i>, callable <i>receiver</i>)</h3><h3 class="fn"><a name="options" /><a href="qinputdialog-inputdialogoptions.html">InputDialogOptions</a> QInputDialog.options (<i>self</i>)</h3><h3 class="fn"><a name="setCancelButtonText" />QInputDialog.setCancelButtonText (<i>self</i>, QString <i>text</i>)</h3><h3 class="fn"><a name="setComboBoxEditable" />QInputDialog.setComboBoxEditable (<i>self</i>, bool <i>editable</i>)</h3><h3 class="fn"><a name="setComboBoxItems" />QInputDialog.setComboBoxItems (<i>self</i>, QStringList <i>items</i>)</h3><h3 class="fn"><a name="setDoubleDecimals" />QInputDialog.setDoubleDecimals (<i>self</i>, int <i>decimals</i>)</h3><h3 class="fn"><a name="setDoubleMaximum" />QInputDialog.setDoubleMaximum (<i>self</i>, float <i>max</i>)</h3><h3 class="fn"><a name="setDoubleMinimum" />QInputDialog.setDoubleMinimum (<i>self</i>, float <i>min</i>)</h3><h3 class="fn"><a name="setDoubleRange" />QInputDialog.setDoubleRange (<i>self</i>, float <i>min</i>, float <i>max</i>)</h3><p>Sets the range of double precision floating point values accepted by the dialog when used in <a href="qinputdialog.html#InputMode-enum">DoubleInput</a> mode, with minimum and maximum values specified by <i>min</i> and <i>max</i> respectively.</p> <h3 class="fn"><a name="setDoubleValue" />QInputDialog.setDoubleValue (<i>self</i>, float <i>value</i>)</h3><h3 class="fn"><a name="setInputMode" />QInputDialog.setInputMode (<i>self</i>, <a href="qinputdialog.html#InputMode-enum">InputMode</a> <i>mode</i>)</h3><h3 class="fn"><a name="setIntMaximum" />QInputDialog.setIntMaximum (<i>self</i>, int <i>max</i>)</h3><h3 class="fn"><a name="setIntMinimum" />QInputDialog.setIntMinimum (<i>self</i>, int <i>min</i>)</h3><h3 class="fn"><a name="setIntRange" />QInputDialog.setIntRange (<i>self</i>, int <i>min</i>, int <i>max</i>)</h3><p>Sets the range of integer values accepted by the dialog when used in <a href="qinputdialog.html#InputMode-enum">IntInput</a> mode, with minimum and maximum values specified by <i>min</i> and <i>max</i> respectively.</p> <h3 class="fn"><a name="setIntStep" />QInputDialog.setIntStep (<i>self</i>, int <i>step</i>)</h3><h3 class="fn"><a name="setIntValue" />QInputDialog.setIntValue (<i>self</i>, int <i>value</i>)</h3><h3 class="fn"><a name="setLabelText" />QInputDialog.setLabelText (<i>self</i>, QString <i>text</i>)</h3><h3 class="fn"><a name="setOkButtonText" />QInputDialog.setOkButtonText (<i>self</i>, QString <i>text</i>)</h3><h3 class="fn"><a name="setOption" />QInputDialog.setOption (<i>self</i>, <a href="qinputdialog.html#InputDialogOption-enum">InputDialogOption</a> <i>option</i>, bool <i>on</i> = True)</h3><p>Sets the given <i>option</i> to be enabled if <i>on</i> is true; otherwise, clears the given <i>option</i>.</p> <p><b>See also</b> <a href="qinputdialog.html#options-prop">options</a> and <a href="qinputdialog.html#testOption">testOption</a>().</p> <h3 class="fn"><a name="setOptions" />QInputDialog.setOptions (<i>self</i>, <a href="qinputdialog-inputdialogoptions.html">InputDialogOptions</a> <i>options</i>)</h3><h3 class="fn"><a name="setTextEchoMode" />QInputDialog.setTextEchoMode (<i>self</i>, <a href="qlineedit.html#EchoMode-enum">QLineEdit.EchoMode</a> <i>mode</i>)</h3><h3 class="fn"><a name="setTextValue" />QInputDialog.setTextValue (<i>self</i>, QString <i>text</i>)</h3><h3 class="fn"><a name="setVisible" />QInputDialog.setVisible (<i>self</i>, bool <i>visible</i>)</h3><p>Reimplemented from <a href="qwidget.html#visible-prop">QWidget.setVisible</a>().</p> <h3 class="fn"><a name="sizeHint" /><a href="qsize.html">QSize</a> QInputDialog.sizeHint (<i>self</i>)</h3><p>Reimplemented from <a href="qwidget.html#sizeHint-prop">QWidget.sizeHint</a>().</p> <h3 class="fn"><a name="testOption" />bool QInputDialog.testOption (<i>self</i>, <a href="qinputdialog.html#InputDialogOption-enum">InputDialogOption</a> <i>option</i>)</h3><p>Returns true if the given <i>option</i> is enabled; otherwise, returns false.</p> <p><b>See also</b> <a href="qinputdialog.html#options-prop">options</a> and <a href="qinputdialog.html#setOption">setOption</a>().</p> <h3 class="fn"><a name="textEchoMode" /><a href="qlineedit.html#EchoMode-enum">QLineEdit.EchoMode</a> QInputDialog.textEchoMode (<i>self</i>)</h3><h3 class="fn"><a name="textValue" />QString QInputDialog.textValue (<i>self</i>)</h3><hr /><h2>Qt Signal Documentation</h2><h3 class="fn"><a name="doubleValueChanged" />void doubleValueChanged (double)</h3><p>This is the default overload of this signal.</p><p>This signal is emitted whenever the double value changes in the dialog. The current value is specified by <i>value</i>.</p> <p>This signal is only relevant when the input dialog is used in <a href="qinputdialog.html#InputMode-enum">DoubleInput</a> mode.</p> <h3 class="fn"><a name="doubleValueSelected" />void doubleValueSelected (double)</h3><p>This is the default overload of this signal.</p><p>This signal is emitted whenever the user selects a double value by accepting the dialog; for example, by clicking the <b>OK</b> button. The selected value is specified by <i>value</i>.</p> <p>This signal is only relevant when the input dialog is used in <a href="qinputdialog.html#InputMode-enum">DoubleInput</a> mode.</p> <h3 class="fn"><a name="intValueChanged" />void intValueChanged (int)</h3><p>This is the default overload of this signal.</p><p>This signal is emitted whenever the integer value changes in the dialog. The current value is specified by <i>value</i>.</p> <p>This signal is only relevant when the input dialog is used in <a href="qinputdialog.html#InputMode-enum">IntInput</a> mode.</p> <h3 class="fn"><a name="intValueSelected" />void intValueSelected (int)</h3><p>This is the default overload of this signal.</p><p>This signal is emitted whenever the user selects a integer value by accepting the dialog; for example, by clicking the <b>OK</b> button. The selected value is specified by <i>value</i>.</p> <p>This signal is only relevant when the input dialog is used in <a href="qinputdialog.html#InputMode-enum">IntInput</a> mode.</p> <h3 class="fn"><a name="textValueChanged" />void textValueChanged (const QString&)</h3><p>This is the default overload of this signal.</p><p>This signal is emitted whenever the text string changes in the dialog. The current string is specified by <i>text</i>.</p> <p>This signal is only relevant when the input dialog is used in <a href="qinputdialog.html#InputMode-enum">TextInput</a> mode.</p> <h3 class="fn"><a name="textValueSelected" />void textValueSelected (const QString&)</h3><p>This is the default overload of this signal.</p><p>This signal is emitted whenever the user selects a text string by accepting the dialog; for example, by clicking the <b>OK</b> button. The selected string is specified by <i>text</i>.</p> <p>This signal is only relevant when the input dialog is used in <a href="qinputdialog.html#InputMode-enum">TextInput</a> mode.</p> <address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt 4.10.3 for X11</td><td align="center" width="50%">Copyright © <a href="http://www.riverbankcomputing.com">Riverbank Computing Ltd</a> and <a href="http://www.qtsoftware.com">Nokia</a> 2012</td><td align="right" width="25%">Qt 4.8.5</td></tr></table></div></address></body></html>