MessageDialog QML Type
메시지 대화상자입니다. 더 보기...
Import Statement: | import QtQuick.Dialogs |
Since: | Qt 6.3 |
Inherits: |
속성
- buttons : flags
- detailedText : string
- informativeText : string
- text : string
신호
- buttonClicked(QPlatformDialogHelper::StandardButton button, QPlatformDialogHelper::ButtonRole role)
상세 설명
메시지 다이얼로그 유형은 메시지 다이얼로그용 QML API를 제공합니다.
메시지 대화 상자는 사용자에게 알리거나 사용자에게 질문하는 데 사용됩니다. 메시지 대화 상자에는 사용자에게 상황을 알리는 기본 text, 경고에 대해 자세히 설명하거나 사용자에게 질문을 하는 informative text, 사용자가 요청하는 경우 더 많은 데이터를 제공하는 detailed text (선택 사항)가 표시됩니다. 메시지 상자는 사용자 응답을 수락하기 위해 구성 가능한 buttons 세트를 표시할 수도 있습니다.
메시지 대화 상자를 표시하려면 MessageDialog의 인스턴스를 만들고 원하는 속성을 설정한 다음 open()를 호출합니다.
MessageDialog { buttons: MessageDialog.Ok text: "The document has been modified." }
사용자가 메시지 대화 상자를 닫으려면 OK 버튼을 클릭해야 합니다.
사용자에게 이벤트를 알리는 것보다 더 정교한 접근 방식은 사용자에게 이벤트에 대해 무엇을 해야 하는지 묻는 것입니다. 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() }
사용 가능성
기본 플랫폼 메시지 대화 상자는 현재 다음 플랫폼에서 사용할 수 있습니다:
- Android
- iOS
- macOS
Qt Quick Dialogs 기본 구현을 사용할 수 없는 플랫폼에서는 Qt Quick 구현을 폴백으로 사용합니다.
속성 문서
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 | 대화 상자에는 버튼이 없습니다. |
buttonClicked()도 참조하세요 .
detailedText : string |
이 속성은 세부 정보 영역에 표시할 텍스트를 보유합니다.
text 및 informativeText도 참조하십시오 .
informativeText : string |
이 속성은 메시지에 대한 자세한 설명을 제공하는 정보 텍스트를 포함합니다.
정보 제공 텍스트는 text 을 확장하여 사용자에게 더 많은 정보를 제공하는 데 사용할 수 있습니다.
text 및 detailedText도 참조 하세요.
text : string |
이 속성에는 메시지 대화 상자에 표시할 텍스트가 저장됩니다.
informativeText 및 detailedText도 참조 하세요.
신호 문서
buttonClicked(QPlatformDialogHelper::StandardButton button, QPlatformDialogHelper::ButtonRole role) |
이 신호는 지정된 role 이 포함된 button 을 클릭할 때 발생합니다.
이 신호에 핸들러를 지정하면 누르는 모든 사용자 지정 버튼에 응답할 수 있습니다. button 인수는 어떤 버튼을 클릭했는지 알려주고 role 인수는 해당 버튼의 기능적 역할을 알려줍니다.
MessageDialog { id: dialog text: qsTr("The document has been modified.") informativeText: qsTr("Do you want to save your changes?") buttons: MessageDialog.Ok | MessageDialog.Cancel onButtonClicked: function (button, role) { switch (button) { case MessageDialog.Ok: document.save() break; } } }
참고: 해당 핸들러는 onButtonClicked
입니다.
buttons도 참조하세요 .
© 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.