MessageDialog QML Type
기본 메시지 대화상자입니다. 더 보기...
Import Statement: | import Qt.labs.platform |
Inherits: |
속성
- buttons : flags
- detailedText : string
- informativeText : string
- text : string
신호
- abortClicked()
- applyClicked()
- cancelClicked()
- clicked(button)
- closeClicked()
- discardClicked()
- helpClicked()
- ignoreClicked()
- noClicked()
- noToAllClicked()
- okClicked()
- openClicked()
- resetClicked()
- restoreDefaultsClicked()
- retryClicked()
- saveAllClicked()
- saveClicked()
- yesClicked()
- yesToAllClicked()
상세 설명
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.Ok | AcceptRole 로 정의된 "확인" 버튼입니다. |
MessageDialog.Open | 와 함께 정의된 "열기" 버튼 AcceptRole . |
MessageDialog.Save | 와 함께 정의된 "저장" 버튼 AcceptRole . |
MessageDialog.Cancel | 를 사용하여 정의된 "취소" 버튼 RejectRole . |
MessageDialog.Close | RejectRole 로 정의된 "닫기" 버튼. |
MessageDialog.Discard | 플랫폼에 따라 DestructiveRole 로 정의된 "삭제" 또는 "저장 안 함" 버튼. |
MessageDialog.Apply | ApplyRole 로 정의된 "적용" 버튼. |
MessageDialog.Reset | ResetRole 로 정의된 "재설정" 버튼. |
MessageDialog.RestoreDefaults | ResetRole 로 정의된 "기본값 복원" 버튼. |
MessageDialog.Help | HelpRole 로 정의된 "도움말" 버튼. |
MessageDialog.SaveAll | AcceptRole 로 정의된 "모두 저장" 버튼. |
MessageDialog.Yes | YesRole 로 정의된 "예" 버튼. |
MessageDialog.YesToAll | 와 함께 정의된 "예, 모두" 버튼 YesRole . |
MessageDialog.No | 와 함께 정의된 "아니요" 버튼 NoRole . |
MessageDialog.NoToAll | 와 함께 정의된 "아니요 - 모두" 버튼 NoRole . |
MessageDialog.Abort | 와 함께 정의된 "중단" 버튼 RejectRole . |
MessageDialog.Retry | AcceptRole 로 정의된 "재시도" 버튼. |
MessageDialog.Ignore | 와 함께 정의된 "무시" 버튼 AcceptRole . |
MessageDialog.NoButton | 대화 상자에는 버튼이 없습니다. |
clicked()도 참조하세요 .
detailedText : string |
이 속성은 세부 정보 영역에 표시할 텍스트를 보유합니다.
text 및 informativeText도 참조하십시오 .
informativeText : string |
이 속성은 메시지에 대한 자세한 설명을 제공하는 정보 텍스트를 포함합니다.
정보 제공 텍스트는 text 을 확장하여 사용자에게 더 많은 정보를 제공하는 데 사용할 수 있습니다.
text 및 detailedText도 참조 하세요.
text : string |
이 속성에는 메시지 대화 상자에 표시할 텍스트가 저장됩니다.
informativeText 및 detailedText도 참조 하세요.
신호 문서
abortClicked() |
Abort 을 클릭하면 이 신호가 발생합니다.
참고: 해당 핸들러는 onAbortClicked
입니다.
applyClicked() |
Apply 을 클릭하면 이 신호가 발생합니다.
참고: 해당 핸들러는 onApplyClicked
입니다.
cancelClicked() |
Cancel 을 클릭하면 이 신호가 발생합니다.
참고: 해당 핸들러는 onCancelClicked
입니다.
clicked(button) |
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.