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 ”라는 텍스트가 포함된 간단한 정보 상자를 표시합니다. 이 정보 상자의 상위 요소는 parent 입니다.

about()은 다음 네 곳에서 적합한 아이콘을 찾습니다:

1. parent->icon()가 존재하면 이를 우선적으로 사용합니다.
2. 존재하지 않으면, parent 를 포함하는 최상위 위젯을 시도합니다.
3. 이 방법도 실패하면 active window.
4. 최후의 수단으로 정보 아이콘을 사용합니다.

정보 상자에는 “OK”라고 표시된 버튼이 하나 있습니다.

macOS에서는 정보 상자가 비모달 창으로 팝업되며, 다른 플랫폼에서는 현재 애플리케이션 모달로 표시됩니다.

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 는 자동으로 적절한 기본값을 선택합니다.

클릭된 표준 버튼의 식별자를 반환합니다. 대신 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. 버튼이 하나뿐인 경우, 해당 버튼을 이스케이프 버튼으로 지정합니다.
2. Cancel 역할의 버튼이 하나 있다면, 해당 버튼이 escape 버튼으로 지정됩니다.
3. macOS에서만, 역할이 ' QMessageBox::RejectRole'인 버튼이 정확히 하나 있는 경우, 해당 버튼을 Esc 버튼으로 지정합니다.

탈출 버튼을 자동으로 감지할 수 없는 경우, ` 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 는 자동으로 적절한 기본값을 선택합니다.

클릭된 표준 버튼의 식별자를 반환합니다. 대신 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()도 참조하십시오 .