Dialog QML Type
기본 대화 상자의 기본 클래스입니다. More...
| Import Statement: | import Qt.labs.platform |
| Inherits: | |
| Inherited By: | ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog |
| Status: | Deprecated since 6.11 |
이 유형은 Qt.labs.platform 6.11부터 더 이상 사용되지 않습니다. 새 코드에서 사용하지 않는 것이 좋습니다.
속성
- data : list<QtObject>
- flags : Qt::WindowFlags
- modality : Qt::WindowModality
- parentWindow : Window
- result : int
- title : string
- visible : bool
신호
방법
상세 설명
대신 QtQuick.Dialogs Dialog 을 사용하세요.
Dialog 유형은 네이티브 플랫폼 대화 상자를 위한 일반적인 QML API를 제공합니다.
기본 대화 상자를 표시하려면 구체적인 Dialog 구현 중 하나의 인스턴스를 구성하고 원하는 속성을 설정한 다음 open()를 호출합니다. 사용자가 다이얼로그를 완료하면 accepted() 또는 rejected()을 반환합니다.
참고: Qt.labs 모듈의 유형은 향후 버전에서 호환성을 보장하지 않습니다.
속성 문서
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 부모 개체를 반복하여 창을 자동으로 확인합니다.
result : int
이 속성에는 결과 코드가 저장됩니다.
표준 결과 코드입니다:
| 상수 | 값 |
|---|---|
Dialog.Accepted | |
Dialog.Rejected |
참고: 메시지 다이얼로그는 표준 결과 코드를 사용하는 대신 클릭한 표준 버튼의 값으로 결과를 설정합니다.
title : string
이 속성은 대화 상자의 제목을 나타냅니다.
visible : bool
이 속성은 대화 상자의 표시 여부를 결정합니다. 기본값은 false 입니다.
신호 문서
void accepted()
이 신호는 대화형 또는 accept()를 호출하여 대화 상자가 수락된 경우에 발생합니다.
참고: close()로 대화 상자를 닫을 때는 이 신호가 발생하지 않습니다.
참고: 해당 핸들러는 onAccepted 입니다.
rejected()도 참조하세요 .
void rejected()
이 신호는 대화형 또는 reject()를 호출하여 대화 상자가 거부된 경우에 발생합니다.
참고: close()로 대화 상자를 닫을 때는 이 신호가 발생하지 않습니다.
참고: 해당 핸들러는 onRejected 입니다.
accepted()도 참조하세요 .
메서드 문서
void accept()
대화 상자를 닫고 accepted() 신호를 내보냅니다.
reject()도 참조하세요 .
void close()
대화 상자를 닫습니다.
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.