Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > a6711891ce757817bba854bf3f25205a > files > 2082

qtjambi-doc-4.3.3-3mdv2008.1.i586.rpm

<class name="QInputDialog" doc="/**
&lt;p&gt;The &lt;a href=&quot;QInputDialog.html&quot;&gt;&lt;tt&gt;QInputDialog&lt;/tt&gt;&lt;/a&gt; class provides a simple convenience dialog to get a single value from the user.&lt;/p&gt;
&lt;p&gt;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.&lt;/p&gt;
&lt;p&gt;Four static convenience functions are provided: getText(), getInteger(), getDouble() and getItem(). All the functions can be used in a similar way, for example:&lt;/p&gt;
&lt;pre&gt;        bool ok;
        QString text = QInputDialog::getText(this, tr(&amp;quot;QInputDialog::getText()&amp;quot;),
                                             tr(&amp;quot;User name:&amp;quot;), QLineEdit::Normal,
                                             QDir::home().dirName(), &amp;amp;ok);
        if (ok &amp;amp;&amp;amp; !text.isEmpty())
            textLabel-&amp;gt;setText(text);&lt;/pre&gt;
&lt;p&gt;The &lt;tt&gt;ok&lt;/tt&gt; variable is set to true if the user clicks &lt;b&gt;OK&lt;/b&gt;; otherwise it is set to false.&lt;/p&gt;
&lt;p align=&quot;center&quot;&gt;&lt;img src=&quot;%2E%2E/images/inputdialogs.png&quot; alt=&quot;Input Dialogs&quot; /&gt;&lt;/p&gt;&lt;p&gt;The Standard Dialogs&lt;/tt&gt; example shows how to use &lt;a href=&quot;QInputDialog.html&quot;&gt;&lt;tt&gt;QInputDialog&lt;/tt&gt;&lt;/a&gt; as well as other built-in Qt dialogs.&lt;/p&gt;

@see &lt;a href=&quot;QMessageBox.html&quot;&gt;&lt;tt&gt;QMessageBox&lt;/tt&gt;&lt;/a&gt;
@see Standard Dialogs Example&lt;/tt&gt; */">
    <signal name="protected final void accepted()" doc="/**
&lt;p&gt;This signal is emitted when the dialog has been accepted either by the user or by calling &lt;a href=&quot;QDialog.html#accept()&quot;&gt;&lt;tt&gt;accept&lt;/tt&gt;&lt;/a&gt; or &lt;a href=&quot;QDialog.html#done(int)&quot;&gt;&lt;tt&gt;done&lt;/tt&gt;&lt;/a&gt; with the QDialog::Accepted argument.&lt;/p&gt;
&lt;p&gt;Note that this signal is &lt;i&gt;not&lt;/i&gt; emitted when hiding the dialog with &lt;a href=&quot;QWidget.html#hide()&quot;&gt;&lt;tt&gt;hide&lt;/tt&gt;&lt;/a&gt; or &lt;a href=&quot;QDialog.html#setVisible(boolean)&quot;&gt;&lt;tt&gt;setVisible&lt;/tt&gt;&lt;/a&gt;(false). This includes deleting the dialog while it is visible.&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signature:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;a href=&quot;QInputDialog.html#finished(int)&quot;&gt;&lt;tt&gt;finished&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QInputDialog.html#rejected()&quot;&gt;&lt;tt&gt;rejected&lt;/tt&gt;&lt;/a&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <signal name="protected final void customContextMenuRequested(com.trolltech.qt.core.QPoint pos)" doc="/**
&lt;p&gt;This signal is emitted when the widget's &lt;a href=&quot;QWidget.html#contextMenuPolicy()&quot;&gt;&lt;tt&gt;contextMenuPolicy&lt;/tt&gt;&lt;/a&gt; is Qt::CustomContextMenu, and the user has requested a context menu on the widget. The position &lt;tt&gt;pos&lt;/tt&gt; is the position of the context menu event that the widget receives. Normally this is in widget coordinates. The exception to this rule is &lt;a href=&quot;QAbstractScrollArea.html&quot;&gt;&lt;tt&gt;QAbstractScrollArea&lt;/tt&gt;&lt;/a&gt; and its subclasses that map the context menu event to coordinates of the viewport()&lt;/tt&gt; .&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signatures:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot(com.trolltech.qt.core.QPoint pos)&lt;/tt&gt;&lt;/dd&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;a href=&quot;QWidget.html#mapToGlobal(com.trolltech.qt.core.QPoint)&quot;&gt;&lt;tt&gt;mapToGlobal&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QMenu.html&quot;&gt;&lt;tt&gt;QMenu&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QWidget.html#contextMenuPolicy()&quot;&gt;&lt;tt&gt;contextMenuPolicy&lt;/tt&gt;&lt;/a&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <signal name="protected final void finished(int result)" doc="/**
&lt;p&gt;This signal is emitted when the dialog's &lt;tt&gt;result&lt;/tt&gt; code has been set, either by the user or by calling &lt;a href=&quot;QDialog.html#done(int)&quot;&gt;&lt;tt&gt;done&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QDialog.html#accept()&quot;&gt;&lt;tt&gt;accept&lt;/tt&gt;&lt;/a&gt;, or &lt;a href=&quot;QDialog.html#reject()&quot;&gt;&lt;tt&gt;reject&lt;/tt&gt;&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Note that this signal is &lt;i&gt;not&lt;/i&gt; emitted when hiding the dialog with &lt;a href=&quot;QWidget.html#hide()&quot;&gt;&lt;tt&gt;hide&lt;/tt&gt;&lt;/a&gt; or &lt;a href=&quot;QDialog.html#setVisible(boolean)&quot;&gt;&lt;tt&gt;setVisible&lt;/tt&gt;&lt;/a&gt;(false). This includes deleting the dialog while it is visible.&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signatures:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot(int result)&lt;/tt&gt;&lt;/dd&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;a href=&quot;QInputDialog.html#accepted()&quot;&gt;&lt;tt&gt;accepted&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QInputDialog.html#rejected()&quot;&gt;&lt;tt&gt;rejected&lt;/tt&gt;&lt;/a&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <signal name="protected final void rejected()" doc="/**
&lt;p&gt;This signal is emitted when the dialog has been rejected either by the user or by calling &lt;a href=&quot;QDialog.html#reject()&quot;&gt;&lt;tt&gt;reject&lt;/tt&gt;&lt;/a&gt; or &lt;a href=&quot;QDialog.html#done(int)&quot;&gt;&lt;tt&gt;done&lt;/tt&gt;&lt;/a&gt; with the QDialog::Rejected argument.&lt;/p&gt;
&lt;p&gt;Note that this signal is &lt;i&gt;not&lt;/i&gt; emitted when hiding the dialog with &lt;a href=&quot;QWidget.html#hide()&quot;&gt;&lt;tt&gt;hide&lt;/tt&gt;&lt;/a&gt; or &lt;a href=&quot;QDialog.html#setVisible(boolean)&quot;&gt;&lt;tt&gt;setVisible&lt;/tt&gt;&lt;/a&gt;(false). This includes deleting the dialog while it is visible.&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signature:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;a href=&quot;QInputDialog.html#finished(int)&quot;&gt;&lt;tt&gt;finished&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QInputDialog.html#accepted()&quot;&gt;&lt;tt&gt;accepted&lt;/tt&gt;&lt;/a&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
</class>