Back to Qt.io
Contact Us Blog Download Qt

Dialog QML Type

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

Import Statement: import QtQuick.Controls
Inherits:

Popup

속성

신호

방법

  • 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 및 팝업 컨트롤도참조하세요 .

속성 문서

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

참고: DialogButtonBox 을 대화 상자 바닥글로 지정하면 accepted() 및 rejected() 신호가 대화 상자의 각 신호에 자동으로 연결됩니다.

참고: DialogButtonBox, ToolBar 또는 TabBar 를 대화 상자 바닥글로 지정하면 해당 DialogButtonBox::position, ToolBar::position 또는 TabBar::position 속성이 자동으로 Footer 로 설정됩니다.

header 를참조하세요 .


header : Item

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

참고: DialogButtonBox 을 대화 상자 헤더로 지정하면 해당 accepted() 및 rejected() 신호가 대화 상자의 각 신호에 자동으로 연결됩니다.

참고: DialogButtonBox, ToolBar 또는 TabBar 를 대화 상자 헤더로 지정하면 해당 DialogButtonBox::position, ToolBar::position 또는 TabBar::position 속성이 자동으로 Header 로 설정됩니다.

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

이 속성은 결과 코드를 보유합니다.

표준 결과 코드:

Constant설명
Dialog.Accepted대화 상자가 수락되었습니다.
Dialog.Rejected대화 상자가 거부되었습니다.

이 속성은 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")
}

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

사용 가능한 플래그

Constant설명
Dialog.OkAcceptRole 로 정의된 "확인" 버튼입니다.
Dialog.OpenAcceptRole 로 정의된 "열기" 버튼.
Dialog.Save와 함께 정의된 "저장" 버튼 AcceptRole.
Dialog.Cancel를 사용하여 정의된 "취소" 버튼 RejectRole.
Dialog.CloseRejectRole 로 정의된 "닫기" 버튼.
Dialog.Discard플랫폼에 따라 DestructiveRole 로 정의된 "삭제" 또는 "저장 안 함" 버튼.
Dialog.ApplyApplyRole 로 정의된 "적용" 버튼.
Dialog.ResetResetRole 로 정의된 "재설정" 버튼.
Dialog.RestoreDefaultsResetRole 로 정의된 "기본값 복원" 버튼.
Dialog.HelpHelpRole 로 정의된 "도움말" 버튼.
Dialog.SaveAllAcceptRole 로 정의된 "모두 저장" 버튼.
Dialog.YesYesRole 로 정의된 "예" 버튼.
Dialog.YesToAll와 함께 정의된 "예, 모두" 버튼 YesRole.
Dialog.No와 함께 정의된 "아니요" 버튼 NoRole.
Dialog.NoToAll와 함께 정의된 "아니요 - 모두" 버튼 NoRole.
Dialog.Abort와 함께 정의된 "중단" 버튼 RejectRole.
Dialog.RetryAcceptRole 로 정의된 "재시도" 버튼.
Dialog.Ignore와 함께 정의된 "무시" 버튼 AcceptRole.
Dialog.NoButton유효하지 않은 버튼입니다.

DialogButtonBox 를참조하세요 .


title : string

이 속성은 대화 상자 제목을 보유합니다.

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

Dialog {
    title: qsTr("About")

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

문서 신호

accepted()

이 신호는 대화형 또는 accept()를 호출하여 대화 상자가 수락되었을 때 발생합니다.

참고: close()로 대화 상자를 닫거나 visible 을 false 으로 설정할 때는 이 신호가 발생하지 않습니다.

참고: 해당 핸들러는 onAccepted 입니다.

rejected()도 참조하세요 .


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

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

참고: 해당 핸들러는 onApplied 입니다.

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

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


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

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

참고: 해당 핸들러는 onDiscarded 입니다.

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

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


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

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

참고: 해당 핸들러는 onHelpRequested 입니다.

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

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


rejected()

이 신호는 대화형 또는 reject()를 호출하여 대화 상자가 거부되었을 때 발생합니다.

참고: close()로 대화 상자를 닫거나 visible 을 false 으로 설정할 때는 이 신호가 발생하지 않습니다.

참고: 해당 핸들러는 onRejected 입니다.

accepted()도 참조하세요 .


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

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

참고: 해당 핸들러는 onReset 입니다.

이 신호는 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 를참조하십시오 .


© 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.