QDialog Class Reference

#include <qdialog.h>

Inheritance diagram for QDialog:

[legend]Collaboration diagram for QDialog:

[legend]List of all members.

---

Detailed Description

The QDialog class is the base class of dialog windows.

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 return value, and they can have default buttons. QDialogs can also have a QSizeGrip in their lower-right corner, using setSizeGripEnabled().

Note that QDialog (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.

Use the overload of the QWidget::setParent() 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 Qt::Dialog flag).

A \bold{modal} 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. The most common way to display a modal dialog is to call its exec() function. When the user closes the dialog, exec() will provide a useful \link #return return value\endlink. Typically, to get the dialog to close and return the appropriate value, we connect a default button, e.g. \gui OK, to the accept() slot and a \gui Cancel button to the reject() slot. Alternatively you can call the done() slot with \c Accepted or \c Rejected. An alternative is to call setModal(true) or setWindowModality(), then show(). Unlike exec(), show() 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 show() and setModal(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 QProgressDialog.) @section Modeless Dialogs A \bold{modeless} 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. Modeless dialogs are displayed using show(), which returns control to the caller immediately. \target default @section Default Button A dialog's \e default 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. \target escapekey @section Escape Key If the user presses the Esc key in a dialog, QDialog::reject() will be called. This will cause the window to close: The \link QCloseEvent close event \endlink cannot be \link QCloseEvent::ignore() ignored \endlink. @section Extensibility 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 \gui More toggle button. If the user presses the \gui More button down, the dialog is expanded. The \l{Extension Example} shows how to achieve extensible dialogs using Qt. \target return @section Return Value (Modal Dialogs) Modal dialogs are often used in situations where a return value is required, e.g. to indicate whether the user pressed \gui OK or \gui Cancel. A dialog can be closed by calling the accept() or the reject() slots, and exec() will return \c Accepted or \c Rejected as appropriate. The exec() call returns the result of the dialog. The result is also available from result() if the dialog has not been destroyed. \target examples @section Code Examples A modal dialog: \quotefunction snippets/dialogs/dialogs.cpp void EditorWindow::countWords() A modeless dialog: \quotefunction snippets/dialogs/dialogs.cpp void EditorWindow::find() \sa QDialogButtonBox, QTabDialog, QWidget, QProgressDialog, {fowler}{GUI Design Handbook: Dialogs, Standard}, {Extension Example}, {Standard Dialogs Example} Definition at line 36 of file qdialog.h.

Public Types
enum	DialogCode
Public Slots
int	exec ()
virtual void	done (int)
virtual void	accept ()
virtual void	reject ()
void	showExtension (bool)
Signals
void	finished (int result)
void	accepted ()
void	rejected ()
Public Member Functions
	QDialog (QWidget *parent=0, Qt::WindowFlags f=0)
	~QDialog ()
int	result () const
void	setVisible (bool visible)
void	setOrientation (Qt::Orientation orientation)
Qt::Orientation	orientation () const
void	setExtension (QWidget *extension)
QWidget *	extension () const
QSize	sizeHint () const
QSize	minimumSizeHint () const
void	setSizeGripEnabled (bool)
bool	isSizeGripEnabled () const
void	setModal (bool modal)
void	setResult (int r)
Protected Member Functions
	QDialog (QDialogPrivate &, QWidget *parent, Qt::WindowFlags f=0)
void	keyPressEvent (QKeyEvent *)
void	closeEvent (QCloseEvent *)
void	showEvent (QShowEvent *)
void	resizeEvent (QResizeEvent *)
void	contextMenuEvent (QContextMenuEvent *)
bool	eventFilter (QObject *, QEvent *)
void	adjustPosition (QWidget *)
Friends
class	QPushButton

---

Member Enumeration Documentation

enum QDialog::DialogCode

The value returned by a modal dialog.

Accepted Rejected

Definition at line 53 of file qdialog.h.

{ Rejected, Accepted };

---

Constructor & Destructor Documentation

QDialog::QDialog	(	QWidget *	parent = 0,
		Qt::WindowFlags	f = 0
	)			[explicit]

Constructs a dialog with parent parent.

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.

The widget flags f are passed on to the QWidget 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 f.

See also:

QWidget::setWindowFlags()

Definition at line 201 of file qdialog.cpp.

    : QWidget(*new QDialogPrivate, parent,
              f | QFlag((f & Qt::WindowType_Mask) == 0 ? Qt::Dialog : 0))
{
}

QDialog::~QDialog

(

)

Destroys the QDialog, deleting all its children.

Definition at line 236 of file qdialog.cpp.

References QWidget::hide().

{
    // Need to hide() here, as our (to-be) overridden hide()
    // will not be called in ~QWidget.
    hide();
}

QDialog::QDialog	(	QDialogPrivate &	dd,
		QWidget *	parent,
		Qt::WindowFlags	f = 0
	)			[protected]

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 227 of file qdialog.cpp.

    : QWidget(dd, parent, f | QFlag((f & Qt::WindowType_Mask) == 0 ? Qt::Dialog : 0))
{
}

---

Member Function Documentation

int QDialog::result

(

)

const

Returns the modal dialog's result code, Accepted or Rejected.

Do not call this function if the dialog was constructed with the Qt::WA_DeleteOnClose attribute.

Definition at line 345 of file qdialog.cpp.

References d.

Referenced by qdesigner_internal::PromoteToCustomWidgetDialog::accept(), exec(), NewForm::formPreviewIcon(), QColorDialog::getColor(), QFileDialog::getExistingDirectory(), Q3FileDialog::getExistingDirectory(), QFileDialog::getOpenFileName(), Q3FileDialog::getOpenFileName(), Q3FileDialog::getOpenFileNames(), QFileDialog::getOpenFileNames(), qdesigner_internal::PaletteEditor::getPalette(), PaletteEditorAdvanced::getPalette(), QColorDialog::getRgba(), Q3FileDialog::getSaveFileName(), QFileDialog::getSaveFileName(), QInputDialog::getText(), and Calculator::unaryOperatorClicked().

{
    Q_D(const QDialog);
    return d->rescode;
}

void QDialog::setVisible

(

bool

visible

)

[virtual]

Reimplemented from QWidget.

Definition at line 598 of file qdialog.cpp.

References adjustPosition(), QPushButton::autoDefault(), d, QAccessible::DialogEnd, QAccessible::DialogStart, QEvent::FocusIn, QWidget::focusPolicy(), QWidget::focusWidget(), QWidget::hasFocus(), QWidget::isVisible(), QWidget::isWindow(), Qt::NoFocus, QWidget::parentWidget(), QCoreApplication::sendEvent(), QWidget::setAttribute(), QPushButton::setDefault(), QWidget::setVisible(), QWidget::setWindowState(), showExtension(), Qt::TabFocusReason, QWidget::testAttribute(), QAccessible::updateAccessibility(), w, Qt::WA_Moved, QWidget::window(), and QWidget::windowState().

Referenced by ChatMainWindow::ChatMainWindow(), and Q3Wizard::setVisible().

{
    Q_D(QDialog);
    if (visible) {
        if (isVisible())
            return;

#ifdef Q_OS_TEMP
        hideSpecial();
#endif

        if (!testAttribute(Qt::WA_Moved)) {
            Qt::WindowStates state = windowState();
            adjustPosition(parentWidget());
            setAttribute(Qt::WA_Moved, false); // not really an explicit position
            if (state != windowState())
                setWindowState(state);
        }
        QWidget::setVisible(visible);
        showExtension(d->doShowExtension);
        QWidget *fw = window()->focusWidget();
        if (!fw)
            fw = this;

        /*
          The following block is to handle a special case, and does not
          really follow propper logic in concern of autoDefault and TAB
          order. However, it's here to ease usage for the users. If a
          dialog has a default QPushButton, and first widget in the TAB
          order also is a QPushButton, then we give focus to the main
          default QPushButton. This simplifies code for the developers,
          and actually catches most cases... If not, then they simply
          have to use [widget*]->setFocus() themselves...
        */
        if (d->mainDef && fw->focusPolicy() == Qt::NoFocus) {
            QWidget *first = fw;
            while ((first = first->nextInFocusChain()) != fw && first->focusPolicy() == Qt::NoFocus)
                ;
            if (first != d->mainDef && qobject_cast<QPushButton*>(first))
                d->mainDef->setFocus();
        }
        if (!d->mainDef && isWindow()) {
            QWidget *w = fw;
            while ((w = w->nextInFocusChain()) != fw) {
                QPushButton *pb = qobject_cast<QPushButton *>(w);
                if (pb && pb->autoDefault() && pb->focusPolicy() != Qt::NoFocus) {
                    pb->setDefault(true);
                    break;
                }
            }
        }
        if (fw && !fw->hasFocus()) {
            QFocusEvent e(QEvent::FocusIn, Qt::TabFocusReason);
            QApplication::sendEvent(fw, &e);
        }

#ifndef QT_NO_ACCESSIBILITY
        QAccessible::updateAccessibility(this, 0, QAccessible::DialogStart);
#endif

    } else {
        if (!isVisible())
            return;

#ifndef QT_NO_ACCESSIBILITY
        if (isVisible())
            QAccessible::updateAccessibility(this, 0, QAccessible::DialogEnd);
#endif

        // Reimplemented to exit a modal event loop when the dialog is hidden.
        QWidget::setVisible(visible);
        if (d->eventLoop)
            d->eventLoop->exit();
    }
}

Here is the call graph for this function:

void QDialog::setOrientation

(

Qt::Orientation

orientation

)

If orientation is Qt::Horizontal, the extension will be displayed to the right of the dialog's main area. If orientation is Qt::Vertical, the extension will be displayed below the dialog's main area.

Instead of using this functionality, we recommend that you simply call show() or hide() on the part of the dialog that you want to use as an extension. See the {Extension Example} for details.

See also:

setExtension()

Definition at line 779 of file qdialog.cpp.

References d.

{
    Q_D(QDialog);
    d->orientation = orientation;
}

Qt::Orientation QDialog::orientation

(

)

const

Returns the dialog's extension orientation.

Instead of using this functionality, we recommend that you simply call show() or hide() on the part of the dialog that you want to use as an extension. See the {Extension Example} for details.

See also:

extension()

Definition at line 796 of file qdialog.cpp.

References d.

Referenced by Dialog::buttonsOrientationChanged(), and updateLastSize().

{
    Q_D(const QDialog);
    return d->orientation;
}

void QDialog::setExtension

(

QWidget *

extension

)

Sets the widget, extension, 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. This function must only be called while the dialog is hidden.

Instead of using this functionality, we recommend that you simply call show() or hide() on the part of the dialog that you want to use as an extension. See the {Extension Example} for details.

See also:

showExtension(), setOrientation()

Definition at line 816 of file qdialog.cpp.

References d, extension(), QWidget::hide(), QWidget::parentWidget(), and QWidget::setParent().

{
    Q_D(QDialog);
    delete d->extension;
    d->extension = extension;

    if (!extension)
        return;

    if (extension->parentWidget() != this)
        extension->setParent(this);
    extension->hide();
}

Here is the call graph for this function:

QWidget * QDialog::extension

(

)

const

Returns the dialog's extension or 0 if no extension has been defined.

Instead of using this functionality, we recommend that you simply call show() or hide() on the part of the dialog that you want to use as an extension. See the {Extension Example} for details.

See also:

showExtension(), setOrientation()

Definition at line 842 of file qdialog.cpp.

References d.

Referenced by setExtension(), and updateLastSize().

{
    Q_D(const QDialog);
    return d->extension;
}

QSize QDialog::sizeHint

(

)

const [virtual]

Reimplemented from QWidget.

Definition at line 904 of file qdialog.cpp.

References d, QWidget::height(), Qt::Horizontal, qMax(), QWidget::sizeHint(), and QWidget::width().

Referenced by RegExpDialog::RegExpDialog(), and QMessageBox::sizeHint().

{
    Q_D(const QDialog);
    if (d->extension)
        if (d->orientation == Qt::Horizontal)
            return QSize(QWidget::sizeHint().width(),
                        qMax(QWidget::sizeHint().height(),d->extension->sizeHint().height()));
        else
            return QSize(qMax(QWidget::sizeHint().width(), d->extension->sizeHint().width()),
                        QWidget::sizeHint().height());

    return QWidget::sizeHint();
}

Here is the call graph for this function:

QSize QDialog::minimumSizeHint

(

)

const [virtual]

Reimplemented from QWidget.

Definition at line 920 of file qdialog.cpp.

References d, QWidget::height(), Qt::Horizontal, QWidget::minimumSizeHint(), qMax(), and QWidget::width().

{
    Q_D(const QDialog);
    if (d->extension)
        if (d->orientation == Qt::Horizontal)
            return QSize(QWidget::minimumSizeHint().width(),
                        qMax(QWidget::minimumSizeHint().height(), d->extension->minimumSizeHint().height()));
        else
            return QSize(qMax(QWidget::minimumSizeHint().width(), d->extension->minimumSizeHint().width()),
                        QWidget::minimumSizeHint().height());

    return QWidget::minimumSizeHint();
}

Here is the call graph for this function:

void QDialog::setSizeGripEnabled

(

bool

)

Definition at line 965 of file qdialog.cpp.

References d, QWidget::isRightToLeft(), and QWidget::rect().

Referenced by Q3FileDialog::init(), QColorDialog::QColorDialog(), and QFontDialog::QFontDialog().

{
#ifdef QT_NO_SIZEGRIP
    Q_UNUSED(enabled);
#else
    Q_D(QDialog);
    if (!enabled != !d->resizer) {
        if (enabled) {
            d->resizer = new QSizeGrip(this);
            // adjustSize() processes all events, which is suboptimal
            d->resizer->resize(d->resizer->sizeHint());
            if (isRightToLeft())
                d->resizer->move(rect().bottomLeft() -d->resizer->rect().bottomLeft());
            else
                d->resizer->move(rect().bottomRight() -d->resizer->rect().bottomRight());
            d->resizer->lower();
            d->resizer->show();
        } else {
            delete d->resizer;
            d->resizer = 0;
        }
    }
#endif //QT_NO_SIZEGRIP
}

Here is the call graph for this function:

bool QDialog::isSizeGripEnabled

(

)

const

Definition at line 954 of file qdialog.cpp.

References d.

{
#ifndef QT_NO_SIZEGRIP
    Q_D(const QDialog);
    return !!d->resizer;
#else
    return false;
#endif
}

void QDialog::setModal

(

bool

modal

)

Definition at line 948 of file qdialog.cpp.

References QWidget::setAttribute(), and Qt::WA_ShowModal.

Referenced by Config::Config(), QFileDialog::getExistingDirectory(), QFileDialog::getOpenFileName(), QFileDialog::getOpenFileNames(), QFileDialog::getSaveFileName(), PhraseBookBox::PhraseBookBox(), qdesigner_internal::PromoteToCustomWidgetDialog::PromoteToCustomWidgetDialog(), Q3ProgressDialog::Q3ProgressDialog(), QColorDialog::QColorDialog(), and QFontDialog::QFontDialog().

{
    setAttribute(Qt::WA_ShowModal, modal);
}

Here is the call graph for this function:

void QDialog::setResult

(

int

i

)

Sets the modal dialog's result code to i.

Definition at line 356 of file qdialog.cpp.

References d.

Referenced by QMessageBox::closeEvent(), done(), and exec().

{
    Q_D(QDialog);
    d->rescode = r;
}

void QDialog::finished

(

int

result

)

[signal]

Since:

4.1

This signal is emitted when the dialog's result code has been set, either by the user or by calling done(), accept(), or reject().

Note that this signal is not emitted when hiding the dialog with hide() or setVisible(false). This includes deleting the dialog while it is visible.

See also:

accepted(), rejected()

Referenced by done(), and Q3FileDialog::init().

void QDialog::accepted

(

)

[signal]

Since:

4.1

This signal is emitted when the dialog has been accepted either by the user or by calling accept() or done() with the QDialog::Accepted argument.

Note that this signal is not emitted when hiding the dialog with hide() or setVisible(false). This includes deleting the dialog while it is visible.

See also:

finished(), rejected()

Referenced by FindFileDialog::createButtons(), DetailsDialog::DetailsDialog(), Dialog::Dialog(), done(), QInputDialog::getDouble(), QInputDialog::getInteger(), QInputDialog::getItem(), QInputDialog::getText(), LocationDialog::LocationDialog(), qdesigner_internal::OldSignalSlotDialog::OldSignalSlotDialog(), PreviewForm::PreviewForm(), QFontDialog::QFontDialog(), qdesigner_internal::StyleSheetEditorDialog::StyleSheetEditorDialog(), TabDialog::TabDialog(), and TicTacToeDialog::TicTacToeDialog().

void QDialog::rejected

(

)

[signal]

Since:

4.1

This signal is emitted when the dialog has been rejected either by the user or by calling reject() or done() with the QDialog::Rejected argument.

Note that this signal is not emitted when hiding the dialog with hide() or setVisible(false). This includes deleting the dialog while it is visible.

See also:

finished(), accepted()

Referenced by FindFileDialog::createButtons(), DetailsDialog::DetailsDialog(), Dialog::Dialog(), done(), LocationDialog::LocationDialog(), qdesigner_internal::OldSignalSlotDialog::OldSignalSlotDialog(), PreviewForm::PreviewForm(), QFontDialog::QFontDialog(), qdesigner_internal::StyleSheetEditorDialog::StyleSheetEditorDialog(), TabDialog::TabDialog(), and TicTacToeDialog::TicTacToeDialog().

int QDialog::exec

(

)

[slot]

Shows the dialog as a {QDialog::Modal Dialogs}{modal dialog}, blocking until the user closes it. The function returns a DialogCode result.

Users cannot interact with any other window in the same application until they close the dialog.

See also:

show(), result()

Definition at line 374 of file qdialog.cpp.

References d, QEventLoop::exec(), qWarning(), result(), QWidget::setAttribute(), setResult(), QWidget::show(), QWidget::testAttribute(), Qt::WA_DeleteOnClose, and Qt::WA_ShowModal.

Referenced by QPrintDialogPrivate::_q_btnPropertiesClicked(), MainWindow::about(), TrWindow::about(), QMessageBox::about(), QDesignerActions::aboutDesigner(), QDesignerActions::aboutPlugins(), QMessageBox::aboutQt(), MainWindow::acceptFileDrop(), Browser::addConnection(), MainWindow::addTorrent(), ChatMainWindow::changeNickname(), QDesignerToolBox::changeOrder(), QDesignerStackedWidget::changeOrder(), qdesigner_internal::QDesignerTaskMenu::changeRichTextProperty(), ColorDock::changeSizeHints(), qdesigner_internal::QDesignerTaskMenu::changeStyleSheet(), ChatMainWindow::ChatMainWindow(), QDesignerFormWindow::closeEvent(), QVFb::configure(), FtpWindow::downloadFile(), qdesigner_internal::ActionEditor::editAction(), TicTacToeTaskMenu::editState(), QPrintDialog::exec(), QPageSetupDialog::exec(), QColorDialog::getColor(), QInputDialog::getDouble(), QFileDialog::getExistingDirectory(), Q3FileDialog::getExistingDirectory(), QFontDialogPrivate::getFont(), QInputDialog::getInteger(), QInputDialog::getItem(), TopicChooser::getLink(), QFileDialog::getOpenFileName(), Q3FileDialog::getOpenFileNames(), QFileDialog::getOpenFileNames(), qdesigner_internal::PaletteEditor::getPalette(), PaletteEditorAdvanced::getPalette(), QColorDialog::getRgba(), Q3FileDialog::getSaveFileName(), QFileDialog::getSaveFileName(), qdesigner_internal::StringListEditor::getStringList(), QInputDialog::getText(), QDesignerWorkbench::handleClose(), MainWindow::helpAbout(), main(), MainWindow::on_actionAboutApplication_triggered(), qdesigner_internal::NewActionDialog::on_iconButton_clicked(), qdesigner_internal::TreeWidgetEditor::on_previewPixmapColumnButton_clicked(), qdesigner_internal::TableWidgetEditor::on_previewPixmapColumnButton_clicked(), qdesigner_internal::TableWidgetEditor::on_previewPixmapItemButton_clicked(), qdesigner_internal::TreeWidgetEditor::on_previewPixmapItemButton_clicked(), qdesigner_internal::ListWidgetEditor::on_previewPixmapItemButton_clicked(), qdesigner_internal::TableWidgetEditor::on_previewPixmapRowButton_clicked(), MainWindow::on_printPreviewAction_triggered(), MainWindow::open(), MainWindow::openDialog(), MainWindow::openSettings(), qdesigner_internal::QDesignerTaskMenu::promoteToCustomWidget(), SpreadSheet::runInputDialog(), TrWindow::showBatchTranslateDialog(), qdesigner_internal::GraphicsPropertyEditor::showDialog(), QDesignerActions::showFormSettings(), Oubliette::showInventoryItem(), showNewMessageBox(), QMessageBoxPrivate::showOldMessageBox(), TrWindow::showTranslationSettings(), qdesigner_internal::QtBrushEditorPrivate::slotGradientChooserClicked(), qdesigner_internal::ActionEditor::slotNewAction(), qdesigner_internal::QtBrushEditorPrivate::slotPatternChooserClicked(), and Dialog::warningMessage().

{
    Q_D(QDialog);
    if (d->eventLoop) {
        qWarning("QDialog::exec: Recursive call detected");
        return -1;
    }

    bool deleteOnClose = testAttribute(Qt::WA_DeleteOnClose);
    setAttribute(Qt::WA_DeleteOnClose, false);

    bool wasShowModal = testAttribute(Qt::WA_ShowModal);
    setAttribute(Qt::WA_ShowModal, true);
    setResult(0);

    show();

    QEventLoop eventLoop;
    d->eventLoop = &eventLoop;
    (void) eventLoop.exec();
    d->eventLoop = 0;

    setAttribute(Qt::WA_ShowModal, wasShowModal);

    int res = result();
    if (deleteOnClose)
        delete this;
    return res;
}

void QDialog::done

(

int

r

)

[virtual, slot]

Closes the dialog and sets its result code to r. If this dialog is shown with exec(), done() causes the local event loop to finish, and exec() to return r.

As with QWidget::close(), done() 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.

See also:

accept(), reject(), QApplication::activeWindow(), QApplication::quit()

Definition at line 418 of file qdialog.cpp.

References Accepted, accepted(), QWidgetPrivate::CloseNoEvent, d, emit, finished(), QWidget::hide(), rejected(), Rejected, and setResult().

Referenced by accept(), QErrorMessage::done(), QFileDialog::done(), Q3FileDialog::done(), and reject().

{
    Q_D(QDialog);
    hide();
    setResult(r);
    d->close_helper(QWidgetPrivate::CloseNoEvent);
    emit finished(r);
    if (r == Accepted)
        emit accepted();
    else if (r == Rejected)
        emit rejected();
}

void QDialog::accept

(

)

[virtual, slot]

Hides the modal dialog and sets the result code to Accepted.

See also:

reject() done()

Definition at line 437 of file qdialog.cpp.

References Accepted, and done().

Referenced by qdesigner_internal::FindIconDialog::accept(), QFileDialog::accept(), FormWindowSettings::accept(), qdesigner_internal::OrderDialog::accept(), qdesigner_internal::PromoteToCustomWidgetDialog::accept(), qdesigner_internal::NewActionDialog::accept(), PreviewDialog::accept(), SaveFormAsTemplate::accept(), Config::Config(), Dialog::createMenu(), Dialog::Dialog(), QFontDialog::eventFilter(), Q3FileDialog::fileNameEditReturnPressed(), LocationDialog::LocationDialog(), QVFbRateDialog::ok(), Q3FileDialog::okClicked(), qdesigner_internal::OldSignalSlotDialog::OldSignalSlotDialog(), TranslationSettingsDialog::on_buttonBox_accepted(), TopicChooser::on_buttonDisplay_clicked(), TopicChooser::on_listbox_itemActivated(), QSqlConnectionDialog::on_okButton_clicked(), PaletteEditorAdvancedBase::PaletteEditorAdvancedBase(), PhraseBookBox::PhraseBookBox(), PreviewForm::PreviewForm(), Q3TabDialog::Q3TabDialog(), Q3Wizard::Q3Wizard(), QErrorMessage::QErrorMessage(), QFontDialog::QFontDialog(), QPageSetupDialog::QPageSetupDialog(), qdesigner_internal::RichTextEditorDialog::RichTextEditorDialog(), TicTacToeDialog::saveState(), Q3FileDialog::selectDirectoryOrFile(), qdesigner_internal::StyleSheetEditorDialog::StyleSheetEditorDialog(), TabDialog::TabDialog(), DetailsDialog::verify(), and VersionDialog::VersionDialog().

{
    done(Accepted);
}

void QDialog::reject

(

)

[virtual, slot]

Hides the modal dialog and sets the result code to Rejected.

See also:

accept() done()

Definition at line 448 of file qdialog.cpp.

References done(), and Rejected.

Referenced by BatchTranslationDialog::BatchTranslationDialog(), QVFbRateDialog::cancel(), Q3FileDialog::cancelClicked(), closeEvent(), Config::Config(), FindFileDialog::createButtons(), DetailsDialog::DetailsDialog(), Dialog::Dialog(), keyPressEvent(), LocationDialog::LocationDialog(), qdesigner_internal::OldSignalSlotDialog::OldSignalSlotDialog(), TopicChooser::on_buttonCancel_clicked(), QSqlConnectionDialog::on_cancelButton_clicked(), PaletteEditorAdvancedBase::PaletteEditorAdvancedBase(), PreviewForm::PreviewForm(), Q3Wizard::Q3Wizard(), QFontDialog::QFontDialog(), QPageSetupDialog::QPageSetupDialog(), PreviewDialog::reject(), qdesigner_internal::RichTextEditorDialog::RichTextEditorDialog(), Q3TabDialog::setCancelButton(), qdesigner_internal::StyleSheetEditorDialog::StyleSheetEditorDialog(), TabDialog::TabDialog(), TicTacToeDialog::TicTacToeDialog(), DetailsDialog::verify(), and VersionDialog::VersionDialog().

{
    done(Rejected);
}

void QDialog::showExtension

(

bool

showIt

)

[slot]

If showIt is true, the dialog's extension is shown; otherwise the extension is hidden.

Instead of using this functionality, we recommend that you simply call show() or hide() on the part of the dialog that you want to use as an extension. See the {Extension Example} for details.

See also:

show(), setExtension(), setOrientation()

Definition at line 861 of file qdialog.cpp.

References d, h, QWidget::height(), Qt::Horizontal, QWidget::layout(), QWidget::maximumSize(), QWidget::minimumSize(), qMax(), QWidget::resize(), s, QLayout::setEnabled(), QWidget::setFixedSize(), QWidget::setMaximumSize(), QWidget::setMinimumSize(), QWidget::size(), QWidget::testAttribute(), w, Qt::WA_WState_Visible, and QWidget::width().

Referenced by setVisible().

{
    Q_D(QDialog);
    d->doShowExtension = showIt;
    if (!d->extension)
        return;
    if (!testAttribute(Qt::WA_WState_Visible))
        return;
    if (d->extension->isVisible() == showIt)
        return;

    if (showIt) {
        d->size = size();
        d->min = minimumSize();
        d->max = maximumSize();
        if (layout())
            layout()->setEnabled(false);
        QSize s(d->extension->sizeHint()
                 .expandedTo(d->extension->minimumSize())
                 .boundedTo(d->extension->maximumSize()));
        if (d->orientation == Qt::Horizontal) {
            int h = qMax(height(), s.height());
            d->extension->setGeometry(width(), 0, s.width(), h);
            setFixedSize(width() + s.width(), h);
        } else {
            int w = qMax(width(), s.width());
            d->extension->setGeometry(0, height(), w, s.height());
            setFixedSize(w, height() + s.height());
        }
        d->extension->show();
    } else {
        d->extension->hide();
        // workaround for CDE window manager that won't shrink with (-1,-1)
        setMinimumSize(d->min.expandedTo(QSize(1, 1)));
        setMaximumSize(d->max);
        resize(d->size);
        if (layout())
            layout()->setEnabled(true);
    }
}

void QDialog::keyPressEvent

(

QKeyEvent *

e

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 490 of file qdialog.cpp.

References QList< T >::at(), QAbstractButton::click(), Qt::ControlModifier, QWidget::focusNextPrevChild(), QWidget::focusPolicy(), QWidget::focusWidget(), i, QEvent::ignore(), QKeyEvent::key(), Qt::Key_Down, Qt::Key_Enter, Qt::Key_Escape, Qt::Key_Left, Qt::Key_Period, Qt::Key_Return, Qt::Key_Right, Qt::Key_Up, Qt::KeypadModifier, QKeyEvent::modifiers(), reject(), QList< T >::size(), Qt::StrongFocus, and Qt::WheelFocus.

Referenced by PhraseBookBox::keyPressEvent(), QMessageBox::keyPressEvent(), and Q3FileDialog::keyPressEvent().

{
    //   Calls reject() if Escape is pressed. Simulates a button
    //   click for the default button if Enter is pressed. Move focus
    //   for the arrow keys. Ignore the rest.
#ifdef Q_WS_MAC
    if(e->modifiers() == Qt::ControlModifier && e->key() == Qt::Key_Period) {
        reject();
    } else
#endif
    if (!e->modifiers() || (e->modifiers() & Qt::KeypadModifier && e->key() == Qt::Key_Enter)) {
        switch (e->key()) {
        case Qt::Key_Enter:
        case Qt::Key_Return: {
            QList<QPushButton*> list = qFindChildren<QPushButton*>(this);
            for (int i=0; i<list.size(); ++i) {
                QPushButton *pb = list.at(i);
                if (pb->isDefault() && pb->isVisible()) {
                    if (pb->isEnabled())
                        pb->click();
                    return;
                }
            }
        }
        break;
        case Qt::Key_Escape:
            reject();
            break;
        case Qt::Key_Up:
        case Qt::Key_Left:
            if (focusWidget() &&
                 (focusWidget()->focusPolicy() == Qt::StrongFocus ||
                   focusWidget()->focusPolicy() == Qt::WheelFocus)) {
                e->ignore();
                break;
            }
            // call ours, since c++ blocks us from calling the one
            // belonging to focusWidget().
            focusNextPrevChild(false);
            break;
        case Qt::Key_Down:
        case Qt::Key_Right:
            if (focusWidget() &&
                 (focusWidget()->focusPolicy() == Qt::StrongFocus ||
                   focusWidget()->focusPolicy() == Qt::WheelFocus)) {
                e->ignore();
                break;
            }
            focusNextPrevChild(true);
            break;
        default:
            e->ignore();
            return;
        }
    } else {
        e->ignore();
    }
}

Here is the call graph for this function:

void QDialog::closeEvent

(

QCloseEvent *

e

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 550 of file qdialog.cpp.

References QEvent::accept(), QWhatsThis::inWhatsThisMode(), QWidget::isModal(), QWidget::isVisible(), QWhatsThis::leaveWhatsThisMode(), and reject().

Referenced by ItemDialog::closeEvent(), QMessageBox::closeEvent(), Q3ProgressDialog::closeEvent(), and QProgressDialog::closeEvent().

{
#ifndef QT_NO_WHATSTHIS
    if (isModal() && QWhatsThis::inWhatsThisMode())
        QWhatsThis::leaveWhatsThisMode();
#endif
    if (isVisible())
        reject();
    else
        e->accept();
}

Here is the call graph for this function:

void QDialog::showEvent

(

QShowEvent *

event

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 675 of file qdialog.cpp.

References adjustPosition(), QWidget::event(), QWidget::parentWidget(), QWidget::setAttribute(), QWidget::setWindowState(), QWidget::testAttribute(), Qt::WA_Moved, and QWidget::windowState().

Referenced by QMessageBox::showEvent(), Q3ProgressDialog::showEvent(), and QProgressDialog::showEvent().

{
    if (!event->spontaneous() && !testAttribute(Qt::WA_Moved)) {
  Qt::WindowStates  state = windowState();
        adjustPosition(parentWidget());
        setAttribute(Qt::WA_Moved, false); // not really an explicit position
  if (state != windowState())
      setWindowState(state);
    }
}

Here is the call graph for this function:

void QDialog::resizeEvent

(

QResizeEvent *

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 993 of file qdialog.cpp.

References d, QWidget::isRightToLeft(), and QWidget::rect().

Referenced by Q3TabDialog::resizeEvent(), QMessageBox::resizeEvent(), and Q3FileDialog::resizeEvent().

{
#ifndef QT_NO_SIZEGRIP
    Q_D(QDialog);
    if (d->resizer) {
        if (isRightToLeft())
            d->resizer->move(rect().bottomLeft() -d->resizer->rect().bottomLeft());
        else
            d->resizer->move(rect().bottomRight() -d->resizer->rect().bottomRight());
        d->resizer->lower();
    }
#endif
}

Here is the call graph for this function:

void QDialog::contextMenuEvent

(

QContextMenuEvent *

e

)

[protected, virtual]

Reimplemented from QWidget.

Definition at line 464 of file qdialog.cpp.

References QWidget::childAt(), QRect::contains(), QContextMenuEvent::globalPos(), p, QContextMenuEvent::pos(), QWidget::rect(), QCoreApplication::sendEvent(), w, Qt::WA_CustomWhatsThis, and QEvent::WhatsThis.

{
#if defined(QT_NO_WHATSTHIS) || defined(QT_NO_MENU)
    Q_UNUSED(e);
#else
    QWidget *w = childAt(e->pos());
    if (!w) {
        w = rect().contains(e->pos()) ? this : 0;
        if (!w)
            return;
    }
    while (w && w->whatsThis().size() == 0 && !w->testAttribute(Qt::WA_CustomWhatsThis))
        w = w->isWindow() ? 0 : w->parentWidget();
    if (w) {
        QMenu p;
        QAction *wt = p.addAction(tr("What's This?"));
        if (p.exec(e->globalPos()) == wt) {
            QHelpEvent e(QEvent::WhatsThis, w->rect().center(),
                         w->mapToGlobal(w->rect().center()));
            QApplication::sendEvent(w, &e);
        }
    }
#endif
}

Here is the call graph for this function:

bool QDialog::eventFilter	(	QObject *	o,
		QEvent *	e
	)			[protected, virtual]

Reimplemented from QObject.

Definition at line 454 of file qdialog.cpp.

References QObject::eventFilter(), and o.

Referenced by Q3FileDialog::eventFilter(), Q3Wizard::eventFilter(), Calculator::eventFilter(), and QFontDialog::eventFilter().

{
    return QWidget::eventFilter(o, e);
}

Here is the call graph for this function:

void QDialog::adjustPosition

(

QWidget *

)

[protected]

Definition at line 687 of file qdialog.cpp.

References QList< T >::at(), ATOM, QDesktopWidget::availableGeometry(), QApplication::desktop(), QWidget::geometry(), QWidget::height(), QRect::height(), i, QWidget::move(), p, QCursor::pos(), qMax(), qt_net_supports(), QDesktopWidget::screenNumber(), QList< T >::size(), QApplication::topLevelWidgets(), w, QRect::width(), QWidget::width(), QRect::x(), QPoint::x(), QRect::y(), and QPoint::y().

Referenced by setVisible(), and showEvent().

{
#ifdef Q_WS_X11
    // defined in qapplication_x11.cpp
    extern bool qt_net_supports(Atom atom);

    // if the WM advertises that it will place the windows properly for us, let it do it :)
    if (qt_net_supports(ATOM(_NET_WM_FULL_PLACEMENT)))
        return;
#endif

    QPoint p(0, 0);
    int extraw = 0, extrah = 0, scrn = 0;
    if (w)
        w = w->window();
    QRect desk;
    if (w) {
        scrn = QApplication::desktop()->screenNumber(w);
    } else if (QApplication::desktop()->isVirtualDesktop()) {
        scrn = QApplication::desktop()->screenNumber(QCursor::pos());
    } else {
        scrn = QApplication::desktop()->screenNumber(this);
    }
    desk = QApplication::desktop()->availableGeometry(scrn);

    QWidgetList list = QApplication::topLevelWidgets();
    for (int i = 0; (extraw == 0 || extrah == 0) && i < list.size(); ++i) {
        QWidget * current = list.at(i);
        if (current->isVisible()) {
            int framew = current->geometry().x() - current->x();
            int frameh = current->geometry().y() - current->y();

            extraw = qMax(extraw, framew);
            extrah = qMax(extrah, frameh);
        }
    }

    // sanity check for decoration frames. With embedding, we
    // might get extraordinary values
    if (extraw == 0 || extrah == 0 || extraw >= 10 || extrah >= 40) {
        extrah = 40;
        extraw = 10;
    }

#ifndef Q_OS_TEMP
    if (w) {
        // Use mapToGlobal rather than geometry() in case w might
        // be embedded in another application
        QPoint pp = w->mapToGlobal(QPoint(0,0));
        p = QPoint(pp.x() + w->width()/2,
                    pp.y() + w->height()/ 2);
    } else {
        // p = middle of the desktop
        p = QPoint(desk.x() + desk.width()/2, desk.y() + desk.height()/2);
    }
#else
    p = QPoint(desk.x() + desk.width()/2, desk.y() + desk.height()/2);
#endif

    // p = origin of this
    p = QPoint(p.x()-width()/2 - extraw,
                p.y()-height()/2 - extrah);


    if (p.x() + extraw + width() > desk.x() + desk.width())
        p.setX(desk.x() + desk.width() - width() - extraw);
    if (p.x() < desk.x())
        p.setX(desk.x());

    if (p.y() + extrah + height() > desk.y() + desk.height())
        p.setY(desk.y() + desk.height() - height() - extrah);
    if (p.y() < desk.y())
        p.setY(desk.y());

    move(p);
}

Here is the call graph for this function:

---

Friends And Related Function Documentation

friend class QPushButton [friend]

Definition at line 40 of file qdialog.h.

Referenced by QMessageBox::addButton(), BlockingClient::BlockingClient(), Client::Client(), ConfigDialog::ConfigDialog(), Window::createButton(), Dialog::createHorizontalGroupBox(), Window::createMessageGroupBox(), Window::createPushButtonGroup(), WidgetGallery::createTopRightGroupBox(), Dialog::Dialog(), FtpWindow::FtpWindow(), HttpWindow::HttpWindow(), Q3FileDialog::init(), ItemDialog::ItemDialog(), PluginDialog::PluginDialog(), Q3TabDialog::Q3TabDialog(), Q3Wizard::Q3Wizard(), QErrorMessage::QErrorMessage(), QFDProgressDialog::QFDProgressDialog(), QPageSetupDialog::QPageSetupDialog(), QVFbRateDialog::QVFbRateDialog(), Receiver::Receiver(), qdesigner_internal::RichTextEditorDialog::RichTextEditorDialog(), Sender::Sender(), Server::Server(), Q3TabDialog::setApplyButton(), Q3TabDialog::setCancelButton(), Q3ProgressDialog::setCancelButtonText(), QProgressDialog::setCancelButtonText(), Q3TabDialog::setDefaultButton(), QMessageBox::setDetailedText(), Q3TabDialog::setHelpButton(), Q3TabDialog::setOkButton(), TableEditor::TableEditor(), and VersionDialog::VersionDialog().

---

The documentation for this class was generated from the following files:

• src/gui/dialogs/qdialog.h
• src/gui/dialogs/qdialog.cpp

---