MessageDialog QML Type

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

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• buttons : flags
• detailedText : string
• informativeText : string
• text : string

신호

• buttonClicked(QPlatformDialogHelper::StandardButton button, QPlatformDialogHelper::ButtonRole role)

상세 설명

MessageDialog 유형은 메시지 대화 상자를 위한 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 ’입니다.

사용 가능한 플래그:

buttonClicked()도 참조하십시오 .

detailedText : string

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

text 및 informativeText도 참조하십시오 .

informativeText : string

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

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

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

text : string

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

informativeText 및 detailedText도 참조하십시오 .

Signal 문서

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;
        }
    }
}

buttons도 참조하십시오 .