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)

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

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

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

デフォルトでは、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()

再実装：（QEvent *event）：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 に対応する標準ボタンの enum 値、または与えられた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()も参照してください 。