MessageDialog QML Type

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

Import Statement: import Qt.labs.platform
Inherits:

Dialog

속성

신호

상세 설명

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 모듈의 유형은 향후 버전에서 호환성을 보장하지 않습니다.

속성 문서

buttons : flags

이 속성에는 메시지 대화 상자에 사용되는 버튼의 조합이 저장됩니다. 기본값은 MessageDialog.NoButton 입니다.

가능한 플래그

Constant설명
MessageDialog.OkAcceptRole 로 정의된 "확인" 버튼입니다.
MessageDialog.Open와 함께 정의된 "열기" 버튼 AcceptRole.
MessageDialog.Save와 함께 정의된 "저장" 버튼 AcceptRole.
MessageDialog.Cancel를 사용하여 정의된 "취소" 버튼 RejectRole.
MessageDialog.CloseRejectRole 로 정의된 "닫기" 버튼.
MessageDialog.Discard플랫폼에 따라 DestructiveRole 로 정의된 "삭제" 또는 "저장 안 함" 버튼.
MessageDialog.ApplyApplyRole 로 정의된 "적용" 버튼.
MessageDialog.ResetResetRole 로 정의된 "재설정" 버튼.
MessageDialog.RestoreDefaultsResetRole 로 정의된 "기본값 복원" 버튼.
MessageDialog.HelpHelpRole 로 정의된 "도움말" 버튼.
MessageDialog.SaveAllAcceptRole 로 정의된 "모두 저장" 버튼.
MessageDialog.YesYesRole 로 정의된 "예" 버튼.
MessageDialog.YesToAll와 함께 정의된 "예, 모두" 버튼 YesRole.
MessageDialog.No와 함께 정의된 "아니요" 버튼 NoRole.
MessageDialog.NoToAll와 함께 정의된 "아니요 - 모두" 버튼 NoRole.
MessageDialog.Abort와 함께 정의된 "중단" 버튼 RejectRole.
MessageDialog.RetryAcceptRole 로 정의된 "재시도" 버튼.
MessageDialog.Ignore와 함께 정의된 "무시" 버튼 AcceptRole.
MessageDialog.NoButton대화 상자에는 버튼이 없습니다.

clicked()도 참조하세요 .


detailedText : string

이 속성은 세부 정보 영역에 표시할 텍스트를 보유합니다.

textinformativeText도 참조하십시오 .


informativeText : string

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

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

textdetailedText도 참조 하세요.


text : string

이 속성에는 메시지 대화 상자에 표시할 텍스트가 저장됩니다.

informativeTextdetailedText도 참조 하세요.


신호 문서

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 입니다.


© 2025 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.