이 페이지에서

MessageDialog QML Type

기본 메시지 대화 상자. 더 보기...

Import Statement: import Qt.labs.platform
Inherits:

Dialog

Status: Deprecated since 6.9

이 유형은 Qt Labs Platform 6.9부터 더 이상 권장되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않을 것을 강력히 권장합니다.

속성

신호

상세 설명

대신 ` QtQuick.Dialogs MessageDialog `을 사용하십시오.

MessageDialog 유형은 네이티브 플랫폼 메시지 대화 상자를 위한 QML API를 제공합니다.

네이티브 메시지 대화상자

메시지 대화 상자는 사용자에게 정보를 알리거나 질문을 하는 데 사용됩니다. 메시지 대화 상자는 사용자에게 상황을 알리기 위한 기본 text, 경고를 자세히 설명하거나 사용자에게 질문을 하기 위한 informative text, 그리고 사용자가 요청할 경우 더 많은 데이터를 제공하기 위한 선택적 detailed text 를 표시합니다. 메시지 상자는 또한 사용자의 응답을 수락하기 위해 구성 가능한 일련의 buttons 를 표시할 수도 있습니다.

메시지 대화 상자를 표시하려면 MessageDialog 인스턴스를 생성하고, 원하는 속성을 설정한 다음 open()를 호출합니다.

MessageDialog {
    buttons: MessageDialog.Ok
    text: "The document has been modified."
}

사용자는 메시지 대화 상자를 닫으려면 OK 버튼을 클릭해야 합니다. 모달 메시지 대화 상자는 메시지가 닫힐 때까지 나머지 GUI의 작동을 차단합니다.

단순히 사용자에게 이벤트를 알리는 것보다 더 정교한 접근 방식은 사용자에게 해당 이벤트에 대해 어떻게 처리할지 묻는 것입니다. 질문을 informative text 속성에 저장하고, buttons 속성을 사용자의 응답으로 원하는 버튼 집합으로 지정합니다. 버튼은 비트별 OR 연산자를 사용하여 값을 조합하여 지정합니다. 버튼의 표시 순서는 플랫폼에 따라 다릅니다.

MessageDialog {
    text: "The document has been modified."
    informativeText: "Do you want to save your changes?"
    buttons: MessageDialog.Ok | MessageDialog.Cancel

    onAccepted: document.save()
}

기본 정보 메시지 대화 상자

clicked() 신호는 어떤 버튼이 클릭되었는지에 대한 정보를 전달합니다.

현재 다음 플랫폼에서 네이티브 플랫폼 메시지 대화 상자를 사용할 수 있습니다:

  • Android
  • iOS
  • macOS

Qt Labs Platform 모듈은 네이티브 구현이 제공되지 않는 플랫폼에서 Qt Widgets 를 대체 수단으로 사용합니다. 따라서 Qt Labs Platform 모듈의 타입을 사용하는 애플리케이션은 QtWidgets 에 링크하고, QGuiApplication 대신 QApplication 를 사용해야 합니다.

QtWidgets 라이브러리에 링크하려면 qmake 프로젝트 파일에 다음을 추가하십시오:

QT += widgets

main() 에서 QApplication 의 인스턴스를 생성하십시오:

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

참고: Qt.labs 모듈의 타입은 향후 버전에서 호환성이 보장되지 않습니다.

QtQuick.Dialogs::MessageDialog도 참조하십시오 .

속성 문서

buttons : flags

이 속성은 메시지 대화 상자에서 사용되는 버튼 조합을 포함합니다. 기본값은 ‘ MessageDialog.NoButton ’입니다.

사용 가능한 플래그:

상수설명
MessageDialog.OkAcceptRole 로 정의된 "OK" 버튼입니다.
MessageDialog.OpenAcceptRole 로 정의된 "열기" 버튼.
MessageDialog.SaveAcceptRole 로 정의된 "Save" 버튼.
MessageDialog.CancelRejectRole 로 정의된 "Cancel" 버튼.
MessageDialog.CloseRejectRole 로 정의된 "닫기" 버튼.
MessageDialog.Discard플랫폼에 따라 "취소" 또는 "저장하지 않음" 버튼으로, DestructiveRole 로 정의됩니다.
MessageDialog.ApplyApplyRole 로 정의된 "적용" 버튼.
MessageDialog.ResetResetRole 로 정의된 "Reset" 버튼.
MessageDialog.RestoreDefaultsResetRole 로 정의된 "기본값 복원" 버튼.
MessageDialog.HelpHelpRole 로 정의된 "도움말" 버튼.
MessageDialog.SaveAllAcceptRole 로 정의된 "모두 저장" 버튼.
MessageDialog.YesYesRole 로 정의된 "예" 버튼.
MessageDialog.YesToAllYesRole 로 정의된 "모두 예" 버튼.
MessageDialog.NoNoRole 로 정의된 "아니요" 버튼.
MessageDialog.NoToAllNoRole 로 정의된 "모두 아니오" 버튼.
MessageDialog.AbortRejectRole 로 정의된 "중단" 버튼.
MessageDialog.RetryAcceptRole 로 정의된 "다시 시도" 버튼.
MessageDialog.IgnoreAcceptRole 로 정의된 "Ignore" 버튼.
MessageDialog.NoButton이 대화 상자에는 버튼이 없습니다.

clicked()도 참조하십시오 .

detailedText : string

이 속성은 상세 정보 영역에 표시될 텍스트를 저장합니다.

text 및 informativeText도 참조하십시오 .

informativeText : string

이 속성은 메시지에 대한 보다 자세한 설명을 제공하는 설명 텍스트를 포함합니다.

설명 텍스트는 text 를 보충하여 사용자에게 더 많은 정보를 제공하는 데 사용할 수 있습니다.

‘ text ’ 및 ‘ detailedText ’항목도 참조하십시오 .

text : string

이 속성은 메시지 대화 상자에 표시될 텍스트를 저장합니다.

informativeText 및 detailedText도 참조하십시오 .

Signal 문서

abortClicked()

Abort 를 클릭하면 이 신호가 발생합니다.

참고: 해당 핸들러는 onAbortClicked 입니다.

applyClicked()

Apply 를 클릭하면 이 신호가 발생합니다.

참고: 해당 핸들러는 onApplyClicked 입니다.

cancelClicked()

Cancel 를 클릭하면 이 신호가 발생합니다.

참고: 해당 핸들러는 onCancelClicked 입니다.

clicked(button)

이 신호는 대화 상자 button 가 클릭될 때 발생합니다.

참고: 해당 핸들러는 onClicked 입니다.

buttons도 참조하십시오 .

closeClicked()

Close 를 클릭하면 이 신호가 발생합니다.

참고: 해당 핸들러는 onCloseClicked 입니다.

discardClicked()

Discard 를 클릭하면 이 신호가 발생합니다.

참고: 해당 핸들러는 onDiscardClicked 입니다.

helpClicked()

Help 를 클릭하면 이 신호가 발생합니다.

참고: 해당 핸들러는 onHelpClicked 입니다.

ignoreClicked()

Ignore 를 클릭하면 이 신호가 발생합니다.

참고: 이에 해당하는핸들러는 onIgnoreClicked 입니다.

noClicked()

No 가 클릭되면 이 신호가 발생합니다.

참고: 이에 해당하는핸들러는 onNoClicked 입니다.

noToAllClicked()

No To All 를 클릭하면 이 신호가 발생합니다.

참고: 해당 핸들러는 onNoToAllClicked 입니다.

okClicked()

Ok 를 클릭하면 이 신호가 발생합니다.

참고: 해당 핸들러는 onOkClicked 입니다.

openClicked()

Open 를 클릭하면 이 신호가 발생합니다.

참고: 해당 핸들러는 onOpenClicked 입니다.

resetClicked()

Reset 를 클릭하면 이 신호가 발생합니다.

참고: 해당 핸들러는 onResetClicked 입니다.

restoreDefaultsClicked()

Restore Defaults 를 클릭하면 이 신호가 발생합니다.

참고: 해당 핸들러는 onRestoreDefaultsClicked 입니다.

retryClicked()

Retry 을 클릭하면 이 신호가 발생합니다.

참고: 이에 해당하는핸들러는 onRetryClicked 입니다.

saveAllClicked()

Save All 를 클릭하면 이 신호가 발생합니다.

참고: 해당 핸들러는 onSaveAllClicked 입니다.

saveClicked()

Save 를 클릭하면 이 신호가 발생합니다.

참고: 해당 핸들러는 onSaveClicked 입니다.

yesClicked()

Yes 가 클릭되면 이 신호가 발생합니다.

참고: 이에 해당하는핸들러는 onYesClicked 입니다.

yesToAllClicked()

Yes To All 가 클릭되면 이 신호가 발생합니다.

참고: 해당 핸들러는 onYesToAllClicked 입니다.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.