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))

상세 설명

대화 상자(Dialog)는 주로 단기적인 작업이나 사용자와의 간단한 의사소통에 사용되는 팝업 창입니다. ApplicationWindow 및 Page 와 마찬가지로, Dialog는 header, contentItem, footer 의 세 섹션으로 구성됩니다.

padding 속성은 contentItem에만 영향을 미칩니다. 헤더, contentItem 및 푸터 사이의 간격을 조정하려면 spacing 속성을 사용하십시오.

기본적으로 대화 상자에는 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도 참조하십시오 .