<class name="QInputDialog" doc="/** <p>The <a href="QInputDialog.html"><tt>QInputDialog</tt></a> 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: getText(), getInteger(), getDouble() and getItem(). All the functions can be used in a similar way, for example:</p> <pre> bool ok; QString text = QInputDialog::getText(this, tr(&quot;QInputDialog::getText()&quot;), tr(&quot;User name:&quot;), QLineEdit::Normal, QDir::home().dirName(), &amp;ok); if (ok &amp;&amp; !text.isEmpty()) textLabel-&gt;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 align="center"><img src="%2E%2E/images/inputdialogs.png" alt="Input Dialogs" /></p><p>The Standard Dialogs</tt> example shows how to use <a href="QInputDialog.html"><tt>QInputDialog</tt></a> as well as other built-in Qt dialogs.</p> @see <a href="QMessageBox.html"><tt>QMessageBox</tt></a> @see Standard Dialogs Example</tt> */"> <signal name="protected final void accepted()" doc="/** <p>This signal is emitted when the dialog has been accepted either by the user or by calling <a href="QDialog.html#accept()"><tt>accept</tt></a> or <a href="QDialog.html#done(int)"><tt>done</tt></a> with the QDialog::Accepted argument.</p> <p>Note that this signal is <i>not</i> emitted when hiding the dialog with <a href="QWidget.html#hide()"><tt>hide</tt></a> or <a href="QDialog.html#setVisible(boolean)"><tt>setVisible</tt></a>(false). This includes deleting the dialog while it is visible.</p> <dl> <dt><b>Compatible Slot Signature:</b></dt> <dd><tt>void mySlot()</tt></dd> </dl> <dl> <dt><b>See Also:</b></dt> <dd><a href="QInputDialog.html#finished(int)"><tt>finished</tt></a>, <a href="QInputDialog.html#rejected()"><tt>rejected</tt></a></dd> </dl> */"/> <signal name="protected final void customContextMenuRequested(com.trolltech.qt.core.QPoint pos)" doc="/** <p>This signal is emitted when the widget's <a href="QWidget.html#contextMenuPolicy()"><tt>contextMenuPolicy</tt></a> is Qt::CustomContextMenu, and the user has requested a context menu on the widget. The position <tt>pos</tt> is the position of the context menu event that the widget receives. Normally this is in widget coordinates. The exception to this rule is <a href="QAbstractScrollArea.html"><tt>QAbstractScrollArea</tt></a> and its subclasses that map the context menu event to coordinates of the viewport()</tt> .</p> <dl> <dt><b>Compatible Slot Signatures:</b></dt> <dd><tt>void mySlot(com.trolltech.qt.core.QPoint pos)</tt></dd> <dd><tt>void mySlot()</tt></dd> </dl> <dl> <dt><b>See Also:</b></dt> <dd><a href="QWidget.html#mapToGlobal(com.trolltech.qt.core.QPoint)"><tt>mapToGlobal</tt></a>, <a href="QMenu.html"><tt>QMenu</tt></a>, <a href="QWidget.html#contextMenuPolicy()"><tt>contextMenuPolicy</tt></a></dd> </dl> */"/> <signal name="protected final void finished(int result)" doc="/** <p>This signal is emitted when the dialog's <tt>result</tt> code has been set, either by the user or by calling <a href="QDialog.html#done(int)"><tt>done</tt></a>, <a href="QDialog.html#accept()"><tt>accept</tt></a>, or <a href="QDialog.html#reject()"><tt>reject</tt></a>.</p> <p>Note that this signal is <i>not</i> emitted when hiding the dialog with <a href="QWidget.html#hide()"><tt>hide</tt></a> or <a href="QDialog.html#setVisible(boolean)"><tt>setVisible</tt></a>(false). This includes deleting the dialog while it is visible.</p> <dl> <dt><b>Compatible Slot Signatures:</b></dt> <dd><tt>void mySlot(int result)</tt></dd> <dd><tt>void mySlot()</tt></dd> </dl> <dl> <dt><b>See Also:</b></dt> <dd><a href="QInputDialog.html#accepted()"><tt>accepted</tt></a>, <a href="QInputDialog.html#rejected()"><tt>rejected</tt></a></dd> </dl> */"/> <signal name="protected final void rejected()" doc="/** <p>This signal is emitted when the dialog has been rejected either by the user or by calling <a href="QDialog.html#reject()"><tt>reject</tt></a> or <a href="QDialog.html#done(int)"><tt>done</tt></a> with the QDialog::Rejected argument.</p> <p>Note that this signal is <i>not</i> emitted when hiding the dialog with <a href="QWidget.html#hide()"><tt>hide</tt></a> or <a href="QDialog.html#setVisible(boolean)"><tt>setVisible</tt></a>(false). This includes deleting the dialog while it is visible.</p> <dl> <dt><b>Compatible Slot Signature:</b></dt> <dd><tt>void mySlot()</tt></dd> </dl> <dl> <dt><b>See Also:</b></dt> <dd><a href="QInputDialog.html#finished(int)"><tt>finished</tt></a>, <a href="QInputDialog.html#accepted()"><tt>accepted</tt></a></dd> </dl> */"/> </class>