QDialog 类

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);

成员函数文档

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

使用父级parent构建对话框。

对话框始终是一个顶层小控件，但如果它具有父级，则其默认位置位于父级的顶部中心。它还将共享父级的任务栏项。

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

另请参阅QWidget::setWindowFlags。

[虚函数非异常] QDialog::~QDialog()

销毁QDialog，删除所有其子控件。

[虚槽] void QDialog::accept()

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

另请参阅reject()和done。

[信号] void QDialog::accepted()

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

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

另请参阅finished()和rejected。

[重写虚保护] void QDialog::closeEvent(QCloseEvent *e)

重新实现：QWidget::closeEvent(QCloseEvent *event).

[重载虚拟保护] void QDialog::contextMenuEvent(QContextMenuEvent *e)

重新实现：QWidget::contextMenuEvent(QContextMenuEvent *event).

[虚拟槽] void QDialog::done(int r)

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

如果使用 exec() 显示该对话框，则 done() 也会导致本地事件循环结束，并返回 r。

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

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

[重载虚拟保护] bool QDialog::eventFilter(QObject *o, QEvent *e)

重新实现：QObject::eventFilter(QObject *watched, QEvent *event).

[虚拟槽] int QDialog::exec()

以模态对话框形式显示对话框，阻止用户直到关闭它。函数返回一个 DialogCode 结果。

如果对话框是 应用程序模态，则用户必须关闭对话框后才能与其他应用程序窗口交互。如果对话框是 窗口模态，则只能在对话框打开时阻止与父窗口的交互。默认情况下，对话框是应用程序模态。

另请参阅：open()，show()，result() 以及 setWindowModality()。

[信号] void QDialog::finished(int result)

此信号在对话框的结果码被设置时发出，无论是由用户设置还是通过调用 done()，accept() 或 reject()。

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

另见accepted() 和 rejected。

[重写虚拟受保护] void QDialog::keyPressEvent(QKeyEvent *e)

重新实现: QWidget::keyPressEvent(QKeyEvent *event)。

[重写虚拟] QSize QDialog::minimumSizeHint() const

重写了一个访问属性 QWidget::minimumSizeHint 的函数。

[虚拟槽] void QDialog::open()

以窗口模式对话框的形式显示对话框，立即返回。

另见exec()，show()，result() 和 setWindowModality。

[虚拟槽] void QDialog::reject()

隐藏模式对话框并将其结果码设置为 Rejected。

另见accept() 和 done。

[信号] void QDialog::rejected()

当对话框被用户或通过调用 reject() 或 done() 并传入 QDialog::Rejected 参数时被拒绝时发出此信号。

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

另见finished() 和 accepted。

[重写虚拟受保护] 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。

[重写虚拟] void QDialog::setVisible(bool visible)

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

[重写 虚拟 保护] void QDialog::showEvent(QShowEvent *event)

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

[重写 虚拟] QSize QDialog::sizeHint() const

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