Sophie

Sophie

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

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

<class name="QDialog" doc="/**
&lt;p&gt;The &lt;a href=&quot;QDialog.html#QDialog(com.trolltech.qt.gui.QWidget, com.trolltech.qt.core.Qt.WindowFlags)&quot;&gt;&lt;tt&gt;QDialog&lt;/tt&gt;&lt;/a&gt; class is the base class of dialog windows.&lt;/p&gt;
&lt;p&gt;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 can provide a &lt;a href=&quot;QDialog.html#return&quot;&gt;return value&lt;/tt&gt;&lt;/a&gt;, and they can have &lt;a href=&quot;QDialog.html#default&quot;&gt;default buttons&lt;/tt&gt;&lt;/a&gt;. QDialogs can also have a &lt;a href=&quot;QSizeGrip.html&quot;&gt;&lt;tt&gt;QSizeGrip&lt;/tt&gt;&lt;/a&gt; in their lower-right corner, using &lt;a href=&quot;QDialog.html#setSizeGripEnabled(boolean)&quot;&gt;&lt;tt&gt;setSizeGripEnabled&lt;/tt&gt;&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Note that &lt;a href=&quot;QDialog.html#QDialog(com.trolltech.qt.gui.QWidget, com.trolltech.qt.core.Qt.WindowFlags)&quot;&gt;&lt;tt&gt;QDialog&lt;/tt&gt;&lt;/a&gt; (an any other widget that has type Qt::Dialog) 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.&lt;/p&gt;
&lt;p&gt;Use the overload of the QWidget::setParent() function to change the ownership of a &lt;a href=&quot;QDialog.html#QDialog(com.trolltech.qt.gui.QWidget, com.trolltech.qt.core.Qt.WindowFlags)&quot;&gt;&lt;tt&gt;QDialog&lt;/tt&gt;&lt;/a&gt; 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 Qt::Dialog flag).&lt;/p&gt;
&lt;a name=&quot;modal-dialogs&quot;&gt;&lt;/a&gt;
&lt;h3&gt;Modal Dialogs&lt;/h3&gt;
&lt;p&gt;A &lt;b&gt;modal&lt;/b&gt; dialog is a dialog that blocks input to other visible windows in the same application. Dialogs that are used to request a file name from the user or that are used to set application preferences are usually modal. Dialogs can be application modal&lt;/tt&gt; (the default) or window modal&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;When an application modal dialog is opened, the user must finish interacting with the dialog and close it before they can access any other window in the application. Window modal dialogs only block access to the window associated with the dialog, allowing the user to continue to use other windows in an application.&lt;/p&gt;
&lt;p&gt;The most common way to display a modal dialog is to call its &lt;a href=&quot;QDialog.html#exec()&quot;&gt;&lt;tt&gt;exec&lt;/tt&gt;&lt;/a&gt; function. When the user closes the dialog, &lt;a href=&quot;QDialog.html#exec()&quot;&gt;&lt;tt&gt;exec&lt;/tt&gt;&lt;/a&gt; will provide a useful &lt;a href=&quot;QDialog.html#return&quot;&gt;return value&lt;/tt&gt;&lt;/a&gt;. Typically, to get the dialog to close and return the appropriate value, we connect a default button, e.g&amp;#x2e; &lt;b&gt;OK&lt;/b&gt;, to the &lt;a href=&quot;QDialog.html#accept()&quot;&gt;&lt;tt&gt;accept&lt;/tt&gt;&lt;/a&gt; slot and a &lt;b&gt;Cancel&lt;/b&gt; button to the &lt;a href=&quot;QDialog.html#reject()&quot;&gt;&lt;tt&gt;reject&lt;/tt&gt;&lt;/a&gt; slot. Alternatively you can call the &lt;a href=&quot;QDialog.html#done(int)&quot;&gt;&lt;tt&gt;done&lt;/tt&gt;&lt;/a&gt; slot with &lt;tt&gt;Accepted&lt;/tt&gt; or &lt;tt&gt;Rejected&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;An alternative is to call &lt;a href=&quot;QDialog.html#setModal(boolean)&quot;&gt;&lt;tt&gt;setModal&lt;/tt&gt;&lt;/a&gt;(true) or &lt;a href=&quot;QWidget.html#setWindowModality(com.trolltech.qt.core.Qt.WindowModality)&quot;&gt;&lt;tt&gt;setWindowModality&lt;/tt&gt;&lt;/a&gt;, then &lt;a href=&quot;QWidget.html#show()&quot;&gt;&lt;tt&gt;show&lt;/tt&gt;&lt;/a&gt;. Unlike &lt;a href=&quot;QDialog.html#exec()&quot;&gt;&lt;tt&gt;exec&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QWidget.html#show()&quot;&gt;&lt;tt&gt;show&lt;/tt&gt;&lt;/a&gt; returns control to the caller immediately. Calling &lt;a href=&quot;QDialog.html#setModal(boolean)&quot;&gt;&lt;tt&gt;setModal&lt;/tt&gt;&lt;/a&gt;(true) is especially useful for progress dialogs, where the user must have the ability to interact with the dialog, e.g&amp;#x2e; to cancel a long running operation. If you use &lt;a href=&quot;QWidget.html#show()&quot;&gt;&lt;tt&gt;show&lt;/tt&gt;&lt;/a&gt; and &lt;a href=&quot;QDialog.html#setModal(boolean)&quot;&gt;&lt;tt&gt;setModal&lt;/tt&gt;&lt;/a&gt;(true) together to perform a long operation, you must call QApplication::processEvents() periodically during processing to enable the user to interact with the dialog. (See &lt;a href=&quot;QProgressDialog.html&quot;&gt;&lt;tt&gt;QProgressDialog&lt;/tt&gt;&lt;/a&gt;.)&lt;/p&gt;
&lt;a name=&quot;modeless-dialogs&quot;&gt;&lt;/a&gt;
&lt;h3&gt;Modeless Dialogs&lt;/h3&gt;
&lt;p&gt;A &lt;b&gt;modeless&lt;/b&gt; 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.&lt;/p&gt;
&lt;p&gt;Modeless dialogs are displayed using &lt;a href=&quot;QWidget.html#show()&quot;&gt;&lt;tt&gt;show&lt;/tt&gt;&lt;/a&gt;, which returns control to the caller immediately.&lt;/p&gt;
&lt;a name=&quot;default&quot;&gt;&lt;/a&gt;&lt;a name=&quot;default-button&quot;&gt;&lt;/a&gt;
&lt;h3&gt;Default Button&lt;/h3&gt;
&lt;p&gt;A dialog's &lt;i&gt;default&lt;/i&gt; 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 QPushButton::setDefault(), QPushButton::isDefault() and QPushButton::autoDefault() to set and control the dialog's default button.&lt;/p&gt;
&lt;a name=&quot;escapekey&quot;&gt;&lt;/a&gt;&lt;a name=&quot;escape-key&quot;&gt;&lt;/a&gt;
&lt;h3&gt;Escape Key&lt;/h3&gt;
&lt;p&gt;If the user presses the Esc key in a dialog, QDialog::reject() will be called. This will cause the window to close: The &lt;a href=&quot;QCloseEvent.html&quot;&gt;close event&lt;/tt&gt;&lt;/a&gt; cannot be ignored&lt;/tt&gt;.&lt;/p&gt;
&lt;a name=&quot;extensibility&quot;&gt;&lt;/a&gt;
&lt;h3&gt;Extensibility&lt;/h3&gt;
&lt;p&gt;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 &lt;b&gt;More&lt;/b&gt; toggle button. If the user presses the &lt;b&gt;More&lt;/b&gt; button down, the dialog is expanded. The Extension Example&lt;/tt&gt; shows how to achieve extensible dialogs using Qt.&lt;/p&gt;
&lt;a name=&quot;return&quot;&gt;&lt;/a&gt;&lt;a name=&quot;return-value-modal-dialogs&quot;&gt;&lt;/a&gt;
&lt;h3&gt;Return Value (Modal Dialogs)&lt;/h3&gt;
&lt;p&gt;Modal dialogs are often used in situations where a return value is required, e.g&amp;#x2e; to indicate whether the user pressed &lt;b&gt;OK&lt;/b&gt; or &lt;b&gt;Cancel&lt;/b&gt;. A dialog can be closed by calling the &lt;a href=&quot;QDialog.html#accept()&quot;&gt;&lt;tt&gt;accept&lt;/tt&gt;&lt;/a&gt; or the &lt;a href=&quot;QDialog.html#reject()&quot;&gt;&lt;tt&gt;reject&lt;/tt&gt;&lt;/a&gt; slots, and &lt;a href=&quot;QDialog.html#exec()&quot;&gt;&lt;tt&gt;exec&lt;/tt&gt;&lt;/a&gt; will return &lt;tt&gt;Accepted&lt;/tt&gt; or &lt;tt&gt;Rejected&lt;/tt&gt; as appropriate. The &lt;a href=&quot;QDialog.html#exec()&quot;&gt;&lt;tt&gt;exec&lt;/tt&gt;&lt;/a&gt; call returns the result of the dialog. The result is also available from &lt;a href=&quot;QDialog.html#result()&quot;&gt;&lt;tt&gt;result&lt;/tt&gt;&lt;/a&gt; if the dialog has not been destroyed.&lt;/p&gt;
&lt;a name=&quot;examples&quot;&gt;&lt;/a&gt;&lt;a name=&quot;code-examples&quot;&gt;&lt;/a&gt;
&lt;h3&gt;Code Examples&lt;/h3&gt;
&lt;p&gt;A modal dialog:&lt;/p&gt;
&lt;pre&gt;    void EditorWindow::countWords()
    {
        WordCountDialog dialog(this);
        dialog.setWordCount(document().wordCount());
        dialog.exec();
    }&lt;/pre&gt;
&lt;p&gt;A modeless dialog:&lt;/p&gt;
&lt;pre&gt;    void EditorWindow::find()
    {
        if (!findDialog) {
            findDialog = new FindDialog(this);
            connect(findDialog, SIGNAL(findNext()), this, SLOT(findNext()));
        }

        findDialog-&amp;gt;show();
        findDialog-&amp;gt;raise();
        findDialog-&amp;gt;activateWindow();
    }&lt;/pre&gt;

@see &lt;a href=&quot;QDialogButtonBox.html&quot;&gt;&lt;tt&gt;QDialogButtonBox&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;%2E%2E/porting4.html#qtabdialog&quot;&gt;&lt;tt&gt;QTabDialog&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QWidget.html#QWidget(com.trolltech.qt.gui.QWidget, com.trolltech.qt.core.Qt.WindowFlags)&quot;&gt;&lt;tt&gt;QWidget&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QProgressDialog.html&quot;&gt;&lt;tt&gt;QProgressDialog&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;%2E%2E/guibooks.html#fowler&quot;&gt;GUI Design Handbook: Dialogs, Standard&lt;/tt&gt;&lt;/a&gt;
@see Extension Example&lt;/tt&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;QDialog.html#finished(int)&quot;&gt;&lt;tt&gt;finished&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QDialog.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;QDialog.html#accepted()&quot;&gt;&lt;tt&gt;accepted&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QDialog.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;QDialog.html#finished(int)&quot;&gt;&lt;tt&gt;finished&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QDialog.html#accepted()&quot;&gt;&lt;tt&gt;accepted&lt;/tt&gt;&lt;/a&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <method name="public QDialog(com.trolltech.qt.gui.QWidget parent, com.trolltech.qt.core.Qt.WindowFlags f)" doc="/**
&lt;p&gt;Constructs a dialog with parent &lt;tt&gt;parent&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;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.&lt;/p&gt;
&lt;p&gt;The widget flags &lt;tt&gt;f&lt;/tt&gt; are passed on to the &lt;a href=&quot;QWidget.html#QWidget(com.trolltech.qt.gui.QWidget, com.trolltech.qt.core.Qt.WindowFlags)&quot;&gt;&lt;tt&gt;QWidget&lt;/tt&gt;&lt;/a&gt; constructor. If, for example, you don't want a What's This button in the title bar of the dialog, pass Qt::WindowTitleHint | Qt::WindowSystemMenuHint in &lt;tt&gt;f&lt;/tt&gt;.&lt;/p&gt;

@see &lt;tt&gt;QWidget::setWindowFlags&lt;/tt&gt; */"/>
    <method name="public QDialog(com.trolltech.qt.gui.QWidget parent)" doc="/**
&lt;p&gt;Equivalent to &lt;a href=&quot;QDialog.html#QDialog(com.trolltech.qt.gui.QWidget, com.trolltech.qt.core.Qt.WindowFlags)&quot;&gt;&lt;tt&gt;QDialog&lt;/tt&gt;&lt;/a&gt;(&lt;tt&gt;parent&lt;/tt&gt;, 0). */"/>
    <method name="public QDialog()" doc="/**
&lt;p&gt;Equivalent to &lt;a href=&quot;QDialog.html#QDialog(com.trolltech.qt.gui.QWidget, com.trolltech.qt.core.Qt.WindowFlags)&quot;&gt;&lt;tt&gt;QDialog&lt;/tt&gt;&lt;/a&gt;(0, 0). */"/>
    <method name="protected final void adjustPosition(com.trolltech.qt.gui.QWidget arg__1)" doc="/**
&lt;p&gt;This method is used internally by Qt Jambi.
Do not use it in your applications.&lt;/p&gt;
 */"/>
    <method name="public int exec()" doc="/**
&lt;p&gt;Shows the dialog as a modal dialog&lt;/tt&gt;, blocking until the user closes it. The function returns a &lt;a href=&quot;QDialog.html#DialogCode-enum&quot;&gt;&lt;tt&gt;DialogCode&lt;/tt&gt;&lt;/a&gt; result.&lt;/p&gt;
&lt;p&gt;If the dialog is application modal&lt;/tt&gt;, users cannot interact with any other window in the same application until they close the dialog. If the dialog is window modal&lt;/tt&gt;, only interaction with the parent window is blocked while the dialog is open.&lt;/p&gt;
&lt;p&gt;By default, the dialog is application modal.&lt;/p&gt;

@see &lt;a href=&quot;QWidget.html#show()&quot;&gt;&lt;tt&gt;show&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QDialog.html#result()&quot;&gt;&lt;tt&gt;result&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QWidget.html#setWindowModality(com.trolltech.qt.core.Qt.WindowModality)&quot;&gt;&lt;tt&gt;setWindowModality&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final boolean isSizeGripEnabled()" doc="/**
&lt;p&gt;Returns whether the size grip is enabled.&lt;/p&gt;
&lt;p&gt;A &lt;a href=&quot;QSizeGrip.html&quot;&gt;&lt;tt&gt;QSizeGrip&lt;/tt&gt;&lt;/a&gt; is placed in the bottom-right corner of the dialog when this property is enabled. By default, the size grip is disabled.&lt;/p&gt;
 */"/>
    <method name="public final int result()" doc="/**
&lt;p&gt;Returns the modal dialog's result code, &lt;tt&gt;Accepted&lt;/tt&gt; or &lt;tt&gt;Rejected&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;Do not call this function if the dialog was constructed with the Qt::WA_DeleteOnClose attribute.&lt;/p&gt;

@see &lt;a href=&quot;QDialog.html#setResult(int)&quot;&gt;&lt;tt&gt;setResult&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setModal(boolean modal)" doc="/**
&lt;p&gt;Sets whether &lt;a href=&quot;QWidget.html#show()&quot;&gt;&lt;tt&gt;show&lt;/tt&gt;&lt;/a&gt; should pop up the dialog as modal or modeless to &lt;tt&gt;modal&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;By default, this property is false and &lt;a href=&quot;QWidget.html#show()&quot;&gt;&lt;tt&gt;show&lt;/tt&gt;&lt;/a&gt; pops up the dialog as modeless. Setting his property to true is equivalent to setting QWidget::windowModality to Qt::ApplicationModal.&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;QDialog.html#exec()&quot;&gt;&lt;tt&gt;exec&lt;/tt&gt;&lt;/a&gt; ignores the value of this property and always pops up the dialog as modal.&lt;/p&gt;

@see &lt;tt&gt;QWidget::windowModality&lt;/tt&gt;
@see &lt;a href=&quot;QWidget.html#show()&quot;&gt;&lt;tt&gt;show&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QDialog.html#exec()&quot;&gt;&lt;tt&gt;exec&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setResult(int r)" doc="/**
&lt;p&gt;Sets the modal dialog's result code to &lt;tt&gt;r&lt;/tt&gt;.&lt;/p&gt;

@see &lt;a href=&quot;QDialog.html#result()&quot;&gt;&lt;tt&gt;result&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setSizeGripEnabled(boolean arg__1)" doc="/**
&lt;p&gt;Sets whether the size grip is enabled to &lt;tt&gt;arg__1&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;A &lt;a href=&quot;QSizeGrip.html&quot;&gt;&lt;tt&gt;QSizeGrip&lt;/tt&gt;&lt;/a&gt; is placed in the bottom-right corner of the dialog when this property is enabled. By default, the size grip is disabled.&lt;/p&gt;

@see &lt;a href=&quot;QDialog.html#isSizeGripEnabled()&quot;&gt;&lt;tt&gt;isSizeGripEnabled&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public void accept()" doc="/**
&lt;p&gt;Hides the modal dialog and sets the result code to &lt;tt&gt;Accepted&lt;/tt&gt;.&lt;/p&gt;

@see &lt;a href=&quot;QDialog.html#reject()&quot;&gt;&lt;tt&gt;reject&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QDialog.html#done(int)&quot;&gt;&lt;tt&gt;done&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="protected void closeEvent(com.trolltech.qt.gui.QCloseEvent arg__1)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="protected void contextMenuEvent(com.trolltech.qt.gui.QContextMenuEvent arg__1)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="public void done(int arg__1)" doc="/**
&lt;p&gt;Closes the dialog and sets its result code to &lt;tt&gt;arg__1&lt;/tt&gt;. If this dialog is shown with &lt;a href=&quot;QDialog.html#exec()&quot;&gt;&lt;tt&gt;exec&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QDialog.html#done(int)&quot;&gt;&lt;tt&gt;done&lt;/tt&gt;&lt;/a&gt; causes the local event loop to finish, and &lt;a href=&quot;QDialog.html#exec()&quot;&gt;&lt;tt&gt;exec&lt;/tt&gt;&lt;/a&gt; to return &lt;tt&gt;arg__1&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;As with QWidget::close(), &lt;a href=&quot;QDialog.html#done(int)&quot;&gt;&lt;tt&gt;done&lt;/tt&gt;&lt;/a&gt; deletes the dialog if the Qt::WA_DeleteOnClose flag is set. If the dialog is the application's main widget, the application terminates. If the dialog is the last window closed, the QApplication::lastWindowClosed() signal is emitted.&lt;/p&gt;

@see &lt;a href=&quot;QDialog.html#accept()&quot;&gt;&lt;tt&gt;accept&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QDialog.html#reject()&quot;&gt;&lt;tt&gt;reject&lt;/tt&gt;&lt;/a&gt;
@see &lt;tt&gt;QApplication::activeWindow&lt;/tt&gt;
@see &lt;tt&gt;QApplication::quit&lt;/tt&gt; */"/>
    <method name="public boolean eventFilter(com.trolltech.qt.core.QObject arg__1, com.trolltech.qt.core.QEvent arg__2)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="protected void keyPressEvent(com.trolltech.qt.gui.QKeyEvent arg__1)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="public com.trolltech.qt.core.QSize minimumSizeHint()" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="public void reject()" doc="/**
&lt;p&gt;Hides the modal dialog and sets the result code to &lt;tt&gt;Rejected&lt;/tt&gt;.&lt;/p&gt;

@see &lt;a href=&quot;QDialog.html#accept()&quot;&gt;&lt;tt&gt;accept&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QDialog.html#done(int)&quot;&gt;&lt;tt&gt;done&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="protected void resizeEvent(com.trolltech.qt.gui.QResizeEvent arg__1)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="public void setVisible(boolean visible)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="protected void showEvent(com.trolltech.qt.gui.QShowEvent arg__1)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="public com.trolltech.qt.core.QSize sizeHint()" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <enum name="DialogCode" doc="/**
&lt;p&gt;The value returned by a modal dialog.&lt;/p&gt;
 */">
        <enum-value name="Rejected" doc="/**
Internal. */"/>
        <enum-value name="Accepted" doc="/**
Internal. */"/>
</enum>
</class>