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

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

デフォルトでは、QMessageBox は次のようにEscキーに対応するボタンを自動的に検出しようとします：

1. ボタンが1つしかない場合は、そのボタンがエスケープボタンとして設定されます。
2. 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 は自動的に適切なデフォルトを選択します。

クリックされた標準ボタンの識別子を返します。代わりに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 は自動的に適切なデフォルトを選択します。

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

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

関連項目： question()、information()、およびcritical()。