Dialog QML Type
기본 대화 상자의 기본 클래스입니다. 더 보기...
| Import Statement: | import QtQuick.Dialogs |
| Since: | Qt 6.2 |
| Inherits: | |
| Inherited By: | ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog |
속성
- data : list<QtObject>
- flags : Qt::WindowFlags
- modality : Qt::WindowModality
- parentWindow : Window
- popupType : enumeration
(since 6.10) - result : int
- title : string
- visible : bool
신호
방법
상세 설명
대화 상자 유형은 네이티브 플랫폼 대화 상자를 위한 일반적인 QML API를 제공합니다. 네이티브가 아닌 대화 상자의 경우 Dialog 을 참조하세요.
기본 대화 상자를 표시하려면 구체적인 Dialog 구현 중 하나의 인스턴스를 구성하고 원하는 속성을 설정한 다음 open()를 호출합니다. 사용자가 대화 상자를 완료하면 accepted() 또는 rejected()를 반환합니다.
참고: 이것은 QML에서 생성할 수 없는 내부 유형입니다.
속성 문서
data : list<QtObject> [default]
이 기본 속성에는 대화 상자의 자식으로 선언된 모든 객체의 목록이 저장됩니다.
flags : Qt::WindowFlags
이 속성은 대화 상자의 창 플래그를 저장합니다. 기본값은 Qt.Dialog 입니다.
modality : Qt::WindowModality
이 속성은 대화 상자의 모달리티를 저장합니다. 기본값은 Qt.WindowModal 입니다.
사용 가능한 값
| Constant | 설명 |
|---|---|
Qt.NonModal | 대화 상자가 모달이 아니며 다른 창에 대한 입력을 차단하지 않습니다. |
Qt.WindowModal | 대화 상자는 단일 창 계층 구조에 대한 모달이며 부모 창, 모든 상위 창, 부모 및 상위 창의 모든 형제 자매 창에 대한 입력을 차단합니다. |
Qt.ApplicationModal | 대화 상자가 애플리케이션에 대한 모달이며 모든 창에 대한 입력을 차단합니다. |
parentWindow : Window
이 속성은 대화 상자의 상위 창을 보유합니다.
명시적으로 설정하지 않는 한 창이 있는 Window 또는 Item 을 찾을 때까지 QML 부모 개체를 반복하여 창을 자동으로 확인합니다.
popupType : enumeration [since 6.10]
이 속성은 기본이 아닌 빠른 대화 상자의 popupType 을 변경하는 데 사용할 수 있습니다.
사용 가능한 값은 다음과 같습니다:
| Constant | 설명 |
|---|---|
Popup.Item | 대화 상자가 가장 가까운 상위 항목의 창에 항목으로 표시됩니다. |
Popup.Window | 대화 상자가 자체 창 안에 나타납니다. |
Popup.Native | 이 값은 지원되지 않습니다. Popup.Window 대신 사용됩니다. |
참고: 기본 대화 상자를 사용할 때는 이 속성이 적용되지 않습니다.
이 속성은 Qt 6.10에 도입되었습니다.
result : int
이 속성에는 결과 코드가 저장됩니다.
표준 결과 코드입니다:
| 상수 | 값 |
|---|---|
Dialog.Accepted | |
Dialog.Rejected |
참고: MessageDialog 는 표준 결과 코드를 사용하는 대신 클릭한 표준 버튼의 값으로 결과를 설정합니다.
title : string
이 속성은 대화 상자의 제목을 나타냅니다.
visible : bool
이 속성은 대화 상자의 표시 여부를 결정합니다. 기본값은 false 입니다.
신호 문서
void accepted()
이 신호는 대화형 또는 accept()를 호출하여 대화 상자가 수락된 경우에 발생합니다.
참고: 해당 핸들러는 onAccepted 입니다.
rejected()도 참조하세요 .
void rejected()
이 신호는 대화형 또는 reject()를 호출하여 대화 상자가 거부되었을 때 발생합니다.
close()로 대화 상자를 닫을 때도 이 신호가 전송됩니다.
참고: 해당 핸들러는 onRejected 입니다.
accepted()도 참조하세요 .
메서드 문서
void accept()
대화 상자를 닫고 accepted() 신호를 내보냅니다.
reject()도 참조하세요 .
void close()
대화 상자를 닫고 accepted() 또는 rejected() 신호를 내보냅니다.
void done(int result)
대화 상자를 닫고 result.
accept(), reject() 및 result도 참조하세요 .
void open()
대화 상자를 엽니다.
void reject()
대화 상자를 닫고 rejected() 신호를 내보냅니다.
accept()도 참조하세요 .
© 2026 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.