QDialog Class

void EditorWindow::countWords()
{
    WordCountDialog dialog(this);
    dialog.setWordCount(document().wordCount());
    dialog.exec();
}

void EditorWindow::find()
{
    if (!findDialog) {
        findDialog = new FindDialog(this);
        connect(findDialog, &FindDialog::findNext,
                this, &EditorWindow::findNext);
    }

    findDialog->show();
    findDialog->raise();
    findDialog->activateWindow();
}

mainLayout->setSizeConstraint(QLayout::SetFixedSize);

findButton = new QPushButton(tr("&Find"));
moreButton = new QPushButton(tr("&More..."));
moreButton->setCheckable(true);

extension = new ExtendedControls;
mainLayout->addWidget(extension);
extension->hide();

connect(moreButton, &QAbstractButton::toggled, extension, &QWidget::setVisible);

成员函数文档

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

创建一个父窗口为parent 的对话框。

对话框始终是顶级控件，但如果它有父控件，则其默认位置会居中显示在父控件上方。它还将与父控件共享任务栏条目。

对话框的控件标志f 将传递给QWidget 构造函数。例如，若不希望在对话框的标题栏中显示“这是什么”按钮，请在f 中传入Qt::WindowTitleHint |Qt::WindowSystemMenuHint 。

另请参阅 QWidget::setWindowFlags()。

[virtual noexcept] QDialog::~QDialog()

销毁QDialog ，并删除其所有子节点。

[virtual slot] void QDialog::accept()

隐藏模态对话框，并将结果代码设置为Accepted 。

另请参阅 reject() 和done()。

[signal] void QDialog::accepted()

当对话框被用户接受，或者通过调用accept()或done()并传入QDialog::Accepted 参数时，会发出此信号。

请注意，当使用hide() 或setVisible(false) 隐藏对话框时，不会发出此信号。这包括在对话框可见时将其删除的情况。

另请参阅 finished() 和rejected()。

[override virtual protected] void QDialog::closeEvent(QCloseEvent *e)

重写了：QWidget::closeEvent(QCloseEvent *event)。

[override virtual protected] void QDialog::contextMenuEvent(QContextMenuEvent *e)

重写了：QWidget::contextMenuEvent(QContextMenuEvent *event)。

[virtual slot] void QDialog::done(int r)

关闭对话框，并将结果代码设置为r 。finished()信号将发出r ；如果r 为QDialog::Accepted 或QDialog::Rejected ，则分别还会发出accepted()或rejected()信号。

如果该对话框是通过 `exec()` 显示的，则 `done()` 还会导致本地事件循环结束，并且 `exec()` 会返回 `r`。

与QWidget::close()类似，如果设置了Qt::WA_DeleteOnClose 标志，done()会删除该对话框。如果该对话框是应用程序的主控件，则应用程序终止。如果该对话框是最后关闭的窗口，则会发出QGuiApplication::lastWindowClosed()信号。

另请参阅 accept()、reject()、QApplication::activeWindow() 以及QCoreApplication::quit()。

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

重写了：QObject::eventFilter(QObject *watched, QEvent *event)。

[virtual slot] int QDialog::exec()

将对话框显示为modal dialog ，并阻塞程序直至用户关闭该对话框。该函数返回DialogCode 结果。

如果对话框为application modal ，则用户在关闭对话框之前无法与同一应用程序中的任何其他窗口进行交互。如果对话框为window modal ，则在对话框打开期间，仅阻止与父窗口的交互。默认情况下，对话框为应用程序模态。

另请参阅 open()、show()、result() 和setWindowModality()。

[signal] void QDialog::finished(int result)

当对话框的result 属性被设置时（无论是用户设置的，还是通过调用done()、accept()或reject()设置的），都会触发此信号。

请注意，当使用hide()或setVisible(false)隐藏对话框时，不会发出此信号。这包括在对话框可见时将其删除的情况。

另请参阅 accepted() 和rejected()。

[override virtual protected] void QDialog::keyPressEvent(QKeyEvent *e)

重写了：QWidget::keyPressEvent(QKeyEvent *event)。

[override virtual] QSize QDialog::minimumSizeHint() const

重新实现了属性QWidget::minimumSizeHint 的访问函数。

[virtual slot] void QDialog::open()

以window modal dialog 的形式显示对话框，并立即返回。

另请参阅 exec()、show()、result() 以及setWindowModality()。

[virtual slot] void QDialog::reject()

隐藏模态对话框，并将结果代码设置为Rejected 。

另请参阅 accept() 和done()。

[signal] void QDialog::rejected()

当对话框被用户关闭，或者通过调用reject()或done()并传入QDialog::Rejected 参数时，会触发此信号。

请注意，当使用hide() 或setVisible(false) 隐藏对话框时，不会发出此信号。这包括在对话框可见时将其删除的情况。

另请参阅 finished() 和accepted()。

[override virtual protected] void QDialog::resizeEvent(QResizeEvent *)

重写了：QWidget::resizeEvent(QResizeEvent *event)。

int QDialog::result() const

通常返回模态对话框的结果代码，即Accepted 或Rejected 。

如果对话框是在Qt::WA_DeleteOnClose 属性下创建的，请勿调用此函数。

另请参阅 setResult()。

void QDialog::setResult(int i)

将模态对话框的结果代码设置为i 。

另请参阅 result()。

[override virtual] void QDialog::setVisible(bool visible)

重新实现了属性QWidget::visible 的访问函数。

[override virtual protected] void QDialog::showEvent(QShowEvent *event)

重写了：QWidget::showEvent(QShowEvent *event)。

[override virtual] QSize QDialog::sizeHint() const

重新实现了属性QWidget::sizeHint 的访问函数。