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, SIGNAL(findNext()), this, SLOT(findNext()));
      }

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

成员函数

QDialog::QDialog(QWidget *parent = Q_NULLPTR, Qt::WindowFlags f = Qt::WindowFlags())

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.

参见 QWidget::setWindowFlags().

QDialog::~QDialog()

Destroys the QDialog, deleting all its children.

[virtual slot] void QDialog::accept()

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

参见 reject() and done().

[signal] void QDialog::accepted()

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.

This function was introduced in Qt 4.1.

参见 finished() and rejected().

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

重新实现 QWidget::closeEvent().

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

重新实现 QWidget::contextMenuEvent().

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

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.

参见 accept(), reject(), QApplication::activeWindow(), and QCoreApplication::quit().

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

重新实现 QObject::eventFilter().

[virtual slot] int QDialog::exec()

Shows the dialog as a modal dialog, blocking until the user closes it. The function returns a DialogCode result.

If the dialog is application modal, users cannot interact with any other window in the same application until they close the dialog. If the dialog is window modal, only interaction with the parent window is blocked while the dialog is open. By default, the dialog is application modal.

参见 open(), show(), result(), and setWindowModality().

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

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.

This function was introduced in Qt 4.1.

参见 accepted() and rejected().

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

重新实现 QWidget::keyPressEvent().

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

重新实现 QWidget::minimumSizeHint().

[virtual slot] void QDialog::open()

Shows the dialog as a window modal dialog, returning immediately.

This function was introduced in Qt 4.5.

参见 exec(), show(), result(), and setWindowModality().

[virtual slot] void QDialog::reject()

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

参见 accept() and done().

[signal] void QDialog::rejected()

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.

This function was introduced in Qt 4.1.

参见 finished() and accepted().

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

重新实现 QWidget::resizeEvent().

int QDialog::result() const

In general returns the modal dialog's result code, Accepted or Rejected.

Note: When called on a QMessageBox instance, the returned value is a value of the QMessageBox::StandardButton enum.

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

参见 setResult().

void QDialog::setResult(int i)

Sets the modal dialog's result code to i.

Note: We recommend that you use one of the values defined by QDialog::DialogCode.

参见 result().

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

重新实现 QWidget::setVisible().

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

重新实现 QWidget::showEvent().

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

重新实现 QWidget::sizeHint().