Dialog QML Type

사용자와의 단기적인 상호 작용에 사용되는 표준 버튼과 제목이 있는 팝업 대화상자입니다. 더 보기...

• 상속된 구성원을 포함한 모든 구성원 목록

속성

• footer : Item
• header : Item
• implicitFooterHeight : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitFooterWidth : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitHeaderHeight : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitHeaderWidth : real (since QtQuick.Controls 2.5 (Qt 5.12))
• result : int (since QtQuick.Controls 2.3 (Qt 5.10))
• standardButtons : enumeration
• title : string

신호

• accepted()
• applied() (since QtQuick.Controls 2.3 (Qt 5.10))
• discarded() (since QtQuick.Controls 2.3 (Qt 5.10))
• helpRequested() (since QtQuick.Controls 2.3 (Qt 5.10))
• rejected()
• reset() (since QtQuick.Controls 2.3 (Qt 5.10))

방법

• void accept()
• void done(int result) (since QtQuick.Controls 2.3 (Qt 5.10))
• void reject()
• AbstractButton standardButton(StandardButton button) (since QtQuick.Controls 2.3 (Qt 5.10))

상세 설명

대화창은 주로 단기 작업 및 사용자와의 간단한 커뮤니케이션에 사용되는 팝업입니다. ApplicationWindow 및 Page 과 유사하게 대화 상자는 세 개의 섹션으로 구성됩니다: header, contentItem, footer 의 세 섹션으로 구성됩니다.

padding 속성은 contentItem에만 영향을 줍니다. spacing 속성을 사용하여 머리글, contentItem 및 바닥글 사이의 공간에 영향을 줍니다.

기본적으로 대화 상자에는 focus.

대화 상자 제목 및 버튼

대화 상자의 title 은 기본적으로 header 대화 상자로 할당된 스타일별 제목 표시줄로 표시됩니다.

대화 상자의 표준 버튼은 기본적으로 footer 대화 상자로 할당된 DialogButtonBox 에 의해 관리됩니다. 대화 상자의 standardButtons 속성은 버튼 상자의 각 속성으로 전달됩니다. 또한 버튼 상자의 accepted() 및 rejected() 신호는 Dialog의 각 신호에 연결됩니다.

Dialog {
    id: dialog
    title: "Title"
    standardButtons: Dialog.Ok | Dialog.Cancel

    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

모달 대화 상자

modal 대화 상자는 대화 상자 아래의 다른 콘텐츠에 대한 입력을 차단합니다. 모달 대화 상자가 열리면 사용자는 대화 상자와의 상호 작용을 완료하고 대화 상자를 닫아야 같은 창에 있는 다른 콘텐츠에 액세스할 수 있습니다.

Dialog {
    id: dialog
    modal: true
    standardButtons: Dialog.Ok
}

모델리스 대화 상자

모델리스 대화 상자는 대화 상자 주변의 다른 콘텐츠와 독립적으로 작동하는 대화 상자입니다. 모델 없는 대화 상자가 열리면 사용자는 동일한 창에서 대화 상자와 다른 콘텐츠 모두와 상호 작용할 수 있습니다.

Dialog {
    id: dialog
    modal: false
    standardButtons: Dialog.Ok
}

DialogButtonBox 및 팝업 컨트롤도참조하세요 .

속성 문서

footer : Item

이 속성은 대화 상자 바닥글 항목을 보유합니다. 바닥글 항목은 하단에 위치하며 대화 상자의 너비에 맞게 크기가 조정됩니다. 기본값은 null 입니다.

header 를참조하세요 .

header : Item

이 속성은 대화 상자 헤더 항목을 보유합니다. 헤더 항목은 상단에 위치하며 대화 상자의 너비에 맞게 크기가 조정됩니다. 기본값은 null 입니다.

footer 를참조하세요 .

implicitFooterHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

이 속성은 암시적 바닥글 높이를 보유합니다.

값은 footer && footer.visible ? footer.implicitHeight : 0 입니다.

이 프로퍼티는 QtQuick.Controls 2.5(Qt 5.12)에 도입되었습니다.

implicitFooterWidth 및 implicitHeaderHeight 을참조하십시오 .

implicitFooterWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

이 속성은 암시적 바닥글 너비를 보유합니다.

값은 footer && footer.visible ? footer.implicitWidth : 0 입니다.

이 프로퍼티는 QtQuick.Controls 2.5 (Qt 5.12)에 도입되었습니다.

implicitFooterHeight 와 implicitHeaderWidth 를참조하십시오 .

implicitHeaderHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

이 속성은 암시적 헤더 높이를 보유합니다.

값은 header && header.visible ? header.implicitHeight : 0 입니다.

이 프로퍼티는 QtQuick.Controls 2.5(Qt 5.12)에 도입되었습니다.

implicitHeaderWidth 및 implicitFooterHeight 을참조하십시오 .

implicitHeaderWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

이 속성은 암시적 헤더 너비를 보유합니다.

값은 header && header.visible ? header.implicitWidth : 0 입니다.

이 프로퍼티는 QtQuick.Controls 2.5 (Qt 5.12)에 도입되었습니다.

implicitHeaderHeight 와 implicitFooterWidth 를참조하십시오 .

result : int [since QtQuick.Controls 2.3 (Qt 5.10)]

이 속성에는 결과 코드가 저장됩니다.

표준 결과 코드입니다:

이 속성은 QtQuick.Controls 2.3 (Qt 5.10)에 도입되었습니다.

accept(), reject() 및 done()도 참조하십시오 .

standardButtons : enumeration

이 속성에는 대화 상자에서 사용되는 표준 버튼의 조합이 들어 있습니다.

Dialog {
    id: dialog
    title: "Title"
    standardButtons: Dialog.Ok | Dialog.Cancel

    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

버튼은 사용자의 플랫폼에 따라 적절한 순서로 배치됩니다.

가능한 플래그는 다음과 같습니다:

DialogButtonBox 를참조하세요 .

title : string

이 속성은 대화 상자 제목을 저장합니다.

제목은 대화 상자 헤더에 표시됩니다.

Dialog {
    title: qsTr("About")

    Label {
        text: "Lorem ipsum..."
    }
}

신호 문서

accepted()

이 신호는 대화형 또는 accept()를 호출하여 대화 상자가 수락된 경우에 발생합니다.

rejected()도 참조하세요 .

[since QtQuick.Controls 2.3 (Qt 5.10)] applied()

이 신호는 Dialog.Apply 표준 버튼이 클릭될 때 발생합니다.

이 신호는 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.

discarded() 및 reset()도 참조하십시오 .

[since QtQuick.Controls 2.3 (Qt 5.10)] discarded()

이 신호는 Dialog.Discard 표준 버튼이 클릭될 때 발생합니다.

이 신호는 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.

reset() 및 applied()도 참조하십시오 .

[since QtQuick.Controls 2.3 (Qt 5.10)] helpRequested()

이 신호는 Dialog.Help 표준 버튼이 클릭될 때 발생합니다.

이 신호는 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.

accepted() 및 rejected()도 참조하십시오 .

rejected()

이 신호는 대화형 또는 reject()를 호출하여 대화 상자가 거부된 경우에 발생합니다.

accepted()도 참조하세요 .

[since QtQuick.Controls 2.3 (Qt 5.10)] reset()

이 신호는 Dialog.Reset 표준 버튼이 클릭될 때 발생합니다.

이 신호는 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.

discarded() 및 applied()도 참조하십시오 .

메서드 문서

void accept()

accepted() 신호를 내보내고 대화 상자를 닫습니다.

reject() 및 done()도 참조하세요 .

[since QtQuick.Controls 2.3 (Qt 5.10)] void done(int result)

1. result.
2. 결과가 Dialog.Accepted 또는 Dialog.Rejected 인지 여부에 따라 각각 accepted() 또는 rejected()을 출력합니다.
3. closed()를 반환합니다.

이 메서드는 QtQuick.Controls 2.3 (Qt 5.10)에 도입되었습니다.

accept(), reject() 및 result 를참조하십시오 .

void reject()

rejected() 신호를 내보내고 대화 상자를 닫습니다.

accept() 및 done()도 참조하세요 .

[since QtQuick.Controls 2.3 (Qt 5.10)] AbstractButton standardButton(StandardButton button)

지정된 표준 button, 또는 존재하지 않으면 null 을 반환합니다.

이 메서드는 QtQuick.Controls 2.3 (Qt 5.10)에 도입되었습니다.

standardButtons 를참조하십시오 .