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
신호
방법
상세 설명
Dialog 타입은 네이티브 플랫폼 대화 상자를 위한 공통 QML API를 제공합니다. 비네이티브 대화 상자에 대해서는 Dialog 를 참조하십시오.
네이티브 대화 상자를 표시하려면 구체적인 Dialog 구현체 중 하나의 인스턴스를 생성하고, 원하는 속성을 설정한 다음 open()을 호출하십시오. 사용자가 대화 상자 사용을 마치면 Dialog는 accepted() 또는 rejected()를 발생시킵니다.
참고: 이는 QML에서 생성할 수 없는 내부 유형입니다.
속성 문서
data : list<QtObject> [default]
이 기본 속성에는 대화 상자의 자식 요소로 선언된 모든 객체의 목록이 포함됩니다.
flags : Qt::WindowFlags
이 속성은 대화 상자의 창 플래그를 저장합니다. 기본값은 ` Qt.Dialog`입니다.
modality : Qt::WindowModality
이 속성은 대화 상자의 모달성을 나타냅니다. 기본값은 ‘ Qt.WindowModal ’입니다.
사용 가능한 값:
| 상수 | 설명 |
|---|---|
Qt.NonModal | 대화 상자는 모달이 아니며 다른 창에 대한 입력을 차단하지 않습니다. |
Qt.WindowModal | 대화 상자는 단일 창 계층 구조에 대해 모달이며, 상위 창, 모든 상위 창, 그리고 상위 창 및 상위 창들의 모든 형제 창에 대한 입력을 차단합니다. |
Qt.ApplicationModal | 이 대화 상자는 애플리케이션에 대해 모달 상태이며, 모든 창에 대한 입력을 차단합니다. |
parentWindow : Window
이 속성은 대화 상자의 상위 창을 보관합니다.
명시적으로 설정되지 않은 경우, 창을 갖는 ` Window ` 또는 ` Item ` 객체가 발견될 때까지 QML 상위 객체를 순차적으로 탐색하여 창을 자동으로 결정합니다.
popupType : enumeration [since 6.10]
이 속성을 사용하면 비네이티브 퀵 대화 상자의 popupType 을 변경할 수 있습니다.
사용 가능한 값은 다음과 같습니다:
| 상수 | 설명 |
|---|---|
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.