MessageDialog QML Type

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

Import Statement: import QtQuick.Dialogs
Since: Qt 6.3
Inherits:

Dialog

속성

신호

  • 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.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대화 상자에는 버튼이 없습니다.

buttonClicked()도 참조하세요 .


detailedText : string

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

textinformativeText도 참조하십시오 .


informativeText : string

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

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

textdetailedText도 참조 하세요.


text : string

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

informativeTextdetailedText도 참조 하세요.


신호 문서

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.