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)

当用户或通过调用done() 、accept() 或reject() 设置了对话框的result 代码时，将发出此信号。

请注意，使用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() 或带有QDialog::Rejected 参数的done() 拒绝对话框时，将发出此信号。

请注意，使用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 。