QMessageBox Class

メンバ関数ドキュメント

[explicit] QMessageBox::QMessageBox(QWidget *parent = nullptr)

application modal parent は コンストラクタに渡されます。QDialog

ウィンドウのモダリティは、show() を呼び出す前に、setWindowModality() でオーバーライドできます。

macOS では、メッセージ・ボックスをparent のQt::Sheet として表示したい場合は、メッセージ・ボックスのwindow modality をQt::WindowModal に設定するか、open() を使用します。そうしないと、メッセージ・ボックスは標準のダイアログになります。

setWindowTitle()、setText()、setIcon()、setStandardButtons()、setWindowModality()も参照してください 。

QMessageBox::QMessageBox(QMessageBox::Icon icon, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = NoButton, QWidget *parent = nullptr, Qt::WindowFlags f = Qt::Dialog | Qt::MSWindowsFixedSizeDialogHint)

与えられたicon 、title 、text 、および標準buttons を用いてapplication modal メッセージ・ボックスを構築します。標準ボタンやカスタムボタンはaddButton() を使っていつでも追加できます。parent とf の引数はQDialog コンストラクタに渡されます。

ウィンドウのモダリティは、show() を呼び出す前に、setWindowModality() でオーバーライドできます。

macOSでは、parent がnullptr でなく、メッセージ・ボックスをその親のQt::Sheet として表示したい場合は、メッセージ・ボックスのwindow modality をQt::WindowModal に設定します（デフォルト）。そうしないと、メッセージ・ボックスは標準のダイアログになります。

setWindowTitle()、setText()、setIcon()、setStandardButtons()、setWindowModality()も参照してください 。

[virtual noexcept] QMessageBox::~QMessageBox()

メッセージボックスを破棄する。

[static] void QMessageBox::about(QWidget *parent, const QString &title, const QString &text)

タイトルtitle とテキストtext を持つシンプルな about ボックスを表示する。aboutボックスの親はparent である。

about()は、4つの場所で適切なアイコンを探す：

1. 存在する場合はparent->icon() を優先する。
2. 存在しない場合、parent を含むトップ・レベル・ウィジェットを試す。
3. それがなければ、 を含むトップ・レベル・ウィジェットを試す。active window.
4. 最後の手段として、情報アイコンを使う。

aboutボックスには、「OK」と書かれたボタンが1つあります。

macOSでは、aboutボックスはモードレスウィンドウとしてポップアップ表示されます。

QWidget::windowIcon() とQApplication::activeWindow()も参照 。

[static] void QMessageBox::aboutQt(QWidget *parent, const QString &title = QString())

Qt に関するシンプルなメッセージボックスを、指定されたtitle で、parent の中央に表示します（parent がnullptr でない場合）。メッセージには、アプリケーションで使用されている Qt のバージョン番号が含まれます。

これは、Menus の例で示したように、アプリケーションのHelp メニューに含めるのに便利です。

QApplication は、この機能をスロットとして提供します。

macOSでは、aboutQtボックスはモードレスウィンドウとしてポップアップします。

QApplication::aboutQt()も参照してください 。

void QMessageBox::addButton(QAbstractButton *button, QMessageBox::ButtonRole role)

指定されたrole で、指定されたbutton をメッセージ・ボックスに追加します。

removeButton(),button(),setStandardButtons()も参照 。

QPushButton *QMessageBox::addButton(QMessageBox::StandardButton button)

これはオーバーロードされた関数である。

メッセージ・ボックスに標準のbutton を追加し、それが有効であれば、プッシュ・ボタンを返します。

setStandardButtons()も参照 。

QPushButton *QMessageBox::addButton(const QString &text, QMessageBox::ButtonRole role)

これはオーバーロードされた関数です。

与えられたtext を持つボタンを作成し、指定されたrole のメッセージボックスに追加し、それを返します。

QAbstractButton *QMessageBox::button(QMessageBox::StandardButton which) const

標準ボタンwhich に対応するポインタを返し、標準ボタンがこのメッセージボックスに存在しない場合はnullptr を返します。

standardButtons およびstandardButton()も参照してください 。

[signal] void QMessageBox::buttonClicked(QAbstractButton *button)

このシグナルは、QMessageBox 内でボタンがクリックされるたびに発せられる。 クリックされたボタンはbutton 内で返される。

QMessageBox::ButtonRole QMessageBox::buttonRole(QAbstractButton *button) const

指定されたbutton のボタンの役割を返す。button がnullptr であるか、メッセージ・ボックスに追加されていない場合、この関数はInvalidRole を返す。

buttons() およびaddButton()も参照してください 。

QList<QAbstractButton *> QMessageBox::buttons() const

メッセージ・ボックスに追加されたすべてのボタンのリストを返します。

buttonRole()、addButton()、removeButton()も参照 。

[override virtual protected] void QMessageBox::changeEvent(QEvent *ev)

再実装：QWidget::changeEvent(QEvent *event)。

QCheckBox *QMessageBox::checkBox() const

ダイアログに表示されているチェックボックスを返します。チェックボックスが設定されていない場合は、nullptr 。

setCheckBox()も参照してください 。

QAbstractButton *QMessageBox::clickedButton() const

ユーザーがクリックしたボタン、またはユーザーがEsc キーを押したがescape button が設定されていない場合はnullptr を返す。

exec()がまだ呼び出されていない場合は、nullptrを返す。

例

QMessageBox messageBox(this);
QAbstractButton *disconnectButton =
      messageBox.addButton(tr("Disconnect"), QMessageBox::ActionRole);
...
messageBox.exec();
if (messageBox.clickedButton() == disconnectButton) {
    ...
}

standardButton() およびbutton()も参照 。

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

再インプリメント：QDialog::closeEvent(QCloseEvent *e).

[static] QMessageBox::StandardButton QMessageBox::critical(QWidget *parent, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = Ok, QMessageBox::StandardButton defaultButton = NoButton)

指定されたparent ウィジェットの前に、指定されたtitle とtext を持つクリティカルメッセージボックスを開きます。

標準のbuttons がメッセージボックスに追加されます。defaultButton はEnter が押されたときに使われるボタンを指定します。defaultButton はbuttons で指定されたボタンを参照しなければなりません。defaultButton がQMessageBox::NoButton の場合、QMessageBox は自動的に適切なデフォルトを選択します。

クリックされた標準ボタンの ID を返します。代わりにEsc が押された場合は、escape button が返されます。

メッセージボックスはapplication modal ダイアログボックスである。

question()、warning()、information()も参照してください 。

QPushButton *QMessageBox::defaultButton() const

メッセージボックスのdefault button となるべきボタンを返します。デフォルトのボタンが設定されていない場合は nullptr を返します。

setDefaultButton()、addButton() およびQPushButton::setDefault()も参照して ください。

QAbstractButton *QMessageBox::escapeButton() const

エスケープが押されたときにアクティブになるボタンを返します。

デフォルトでは、QMessageBox は以下のようにエスケープボタンを自動的に検出しようとします：

1. ボタンが一つしかない場合、そのボタンをエスケープボタンとする。
2. ボタンが1つしかない場合、それをエスケープ・ボタンとします。Cancel ボタンがある場合、それをエスケープ・ボタンとします。
3. macOSのみ、QMessageBox::RejectRole の役割を持つボタンが1つだけあれば、それをエスケープ・ボタンとします。

エスケープボタンが自動的に検出されなかった場合、Esc を押しても効果はありません。

setEscapeButton() およびaddButton()も参照 。

[override virtual protected] bool QMessageBox::event(QEvent *e)

再実装：QWidget::event(QEvent *event)。

[override virtual slot] int QMessageBox::exec()

再インプリメント：QDialog::exec().

メッセージボックスをmodal dialog として表示し、ユーザが閉じるまでブロックします。

標準ボタンでQMessageBox を使用する場合、この関数は、クリックされた標準ボタンを示すStandardButton 値を返します。カスタム・ボタンでQMessageBox を使用する場合、この関数は不透明な値を返します。どのボタンがクリックされたかを判別するには、clickedButton() を使用します。

ユーザは、ボタンをクリックするか、ウィンドウ・システムが提供するメカニズムを使用して、ダイアログを閉じるまで、同じアプリケーション内の他のウィンドウと対話することはできません。

show() およびresult()も参照してください 。

[static] QMessageBox::StandardButton QMessageBox::information(QWidget *parent, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = Ok, QMessageBox::StandardButton defaultButton = NoButton)

指定されたparent ウィジェットの前に、指定されたtitle とtext を持つ情報メッセージボックスを開きます。

buttons defaultButton は、 が押されたときに使われるボタンを指定します。 は、 で指定されたボタンを参照しなければなりません。 が の場合、 は自動的に適切なデフォルトを選択します。Enter defaultButton buttons defaultButton QMessageBox::NoButton QMessageBox

クリックされた標準ボタンの ID を返します。代わりにEsc が押された場合は、escape button が返されます。

メッセージボックスはapplication modal ダイアログボックスである。

question()、warning()、critical()も参照してください 。

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

再実装：QDialog::keyPressEvent(QKeyEvent *e).

void QMessageBox::open(QObject *receiver, const char *member)

ダイアログを開き、そのfinished() またはbuttonClicked() シグナルをreceiver とmember で指定されたスロットに接続します。member のスロットの最初のパラメータがポインタの場合、接続先はbuttonClicked() となり、そうでない場合はfinished() となります。

ダイアログが閉じられると、シグナルはスロットから切断されます。

[static] QMessageBox::StandardButton QMessageBox::question(QWidget *parent, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = StandardButtons(Yes | No), QMessageBox::StandardButton defaultButton = NoButton)

指定されたparent ウィジェットの前に、与えられたtitle とtext で質問メッセージボックスを開きます。

標準のbuttons がメッセージボックスに追加されます。defaultButton は、Enter が押されたときに使われるボタンを指定します。defaultButton は、buttons で指定されたボタンを参照しなければなりません。defaultButton がQMessageBox::NoButton の場合、QMessageBox は自動的に適切なデフォルトを選択します。

クリックされた標準ボタンの ID を返します。代わりにEsc が押された場合は、escape button が返されます。

メッセージボックスはapplication modal ダイアログボックスである。

information()、warning()、critical()も参照してください 。

void QMessageBox::removeButton(QAbstractButton *button)

button を削除せずにボタン・ボックスから取り除く。

addButton() およびsetStandardButtons()も参照してください 。

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

再実装：QDialog::resizeEvent(QResizeEvent *).

void QMessageBox::setCheckBox(QCheckBox *cb)

メッセージダイアログのチェックボックスcb を設定します。チェックボックスの所有権はメッセージ・ボックスにあります。引数cb にnullptr を指定すると、メッセージ・ボックスから既存のチェックボックスを削除することができます。

checkBox()も参照してください 。

void QMessageBox::setDefaultButton(QMessageBox::StandardButton button)

メッセージ・ボックスのdefault button をbutton に設定する。

defaultButton()、addButton()、QPushButton::setDefault()も参照 。

void QMessageBox::setDefaultButton(QPushButton *button)

メッセージ・ボックスのdefault button をbutton に設定する。

addButton() およびQPushButton::setDefault()も参照 。

void QMessageBox::setEscapeButton(QAbstractButton *button)

Escape キーが押されたときにアクティブになるボタンをbutton に設定する。

escapeButton(),addButton(),clickedButton()も参照のこと 。

void QMessageBox::setEscapeButton(QMessageBox::StandardButton button)

Escape キーが押されたときにアクティブになるボタンをbutton に設定する。

addButton() およびclickedButton()も参照 。

[since 6.6] void QMessageBox::setOption(QMessageBox::Option option, bool on = true)

on が true ならば、与えられたoption を有効にする。そうでなければ、与えられたoption をクリアする。

オプション（特にOption::DontUseNativeDialog オプション）は、ダイアログを表示する前に設定する必要があります。

ダイアログが表示されている間にオプションを設定しても、ダイアログに即座に影響を与えることは保証されません。

他のプロパティを変更した後にオプションを設定すると、これらの値が効果を持たない可能性があります。

この関数は Qt 6.6 で導入されました。

options およびtestOption()も参照してください 。

void QMessageBox::setWindowModality(Qt::WindowModality windowModality)

この関数はQWidget::setWindowModality() をシャドウする。

メッセージ・ボックスのモダリティをwindowModality に設定します。

macOS では、モダリティがQt::WindowModal に設定され、メッセージボックスに親がある場合、メッセージボックスはQt::Sheet になり、そうでない場合、メッセージボックスは標準ダイアログになります。

void QMessageBox::setWindowTitle(const QString &title)

この関数はQWidget::setWindowTitle() をシャドウする。

メッセージボックスのタイトルをtitle に設定します。macOSでは、ウィンドウ・タイトルは無視されます（macOSガイドラインで要求されています）。

[override virtual protected] void QMessageBox::showEvent(QShowEvent *e)

再実装：QDialog::showEvent(QShowEvent *event)。

QMessageBox::StandardButton QMessageBox::standardButton(QAbstractButton *button) const

与えられたbutton に対応する標準ボタンの列挙値を返します。与えられたbutton が標準ボタンでない場合はNoButton を返します。

button() およびstandardButtons()も参照 。

[since 6.6] bool QMessageBox::testOption(QMessageBox::Option option) const

与えられたoption が有効であればtrue を返し、そうでなければ false を返す。

この関数は Qt 6.6 で導入されました。

options およびsetOption()も参照してください 。

[static] QMessageBox::StandardButton QMessageBox::warning(QWidget *parent, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = Ok, QMessageBox::StandardButton defaultButton = NoButton)

指定されたparent ウィジェットの前に、与えられたtitle とtext を持つ警告メッセージボックスを開きます。

標準のbuttons がメッセージボックスに追加されます。defaultButton はEnter が押されたときに使われるボタンを指定します。defaultButton はbuttons で指定されたボタンを参照しなければなりません。defaultButton がQMessageBox::NoButton の場合、QMessageBox は自動的に適切なデフォルトを選択します。

クリックされた標準ボタンの ID を返します。代わりにEsc が押された場合は、escape button が返されます。

メッセージボックスはapplication modal ダイアログボックスである。

question()、information()、critical()も参照してください 。