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()를 통해 재정의할 수 있습니다.

parent macOS에서 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. 최후의 수단으로 정보 아이콘을 사용합니다.

정보 상자에는 "확인"이라는 레이블이 붙은 버튼이 하나 있습니다.

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

QWidget::windowIcon() 및 QApplication::activeWindow()도 참조하세요 .

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

지정된 title 및 중앙에 parent ( parent 이 nullptr 이 아닌 경우)이 있는 Qt에 대한 간단한 메시지 상자를 표시합니다. 이 메시지에는 애플리케이션에서 사용 중인 Qt의 버전 번호가 포함됩니다.

이것은 메뉴 예제와 같이 애플리케이션의 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 * 이벤트).

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. Cancel 버튼이 있는 경우 해당 버튼이 이스케이프 버튼이 됩니다.
3. macOS에서만 역할이 QMessageBox::RejectRole 인 버튼이 정확히 하나만 있으면 이 버튼이 이스케이프 버튼으로 만들어집니다.

이스케이프 버튼을 자동으로 감지할 수 없는 경우 Esc 을 눌러도 아무런 효과가 없습니다.

setEscapeButton() 및 addButton()도 참조하세요 .

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

다시 구현합니다: QWidget::event(QEvent * 이벤트).

[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 이 참이면 지정된 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 * 이벤트).

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()도 참조하세요 .