이 페이지에서

Dialog QML Type

네이티브 대화 상자의 기본 클래스입니다. 더 보기...

Import Statement: import QtQuick.Dialogs
Since: Qt 6.2
Inherits:

QtObject

Inherited By:

ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog

속성

신호

방법

상세 설명

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 입니다.

open() 및 close()도 참조하십시오 .

신호 문서

void accepted()

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

참고: 이에 대응하는핸들러는 onAccepted 입니다.

rejected()도 참조하십시오 .

void rejected()

이 신호는 대화 상자가 사용자 상호 작용을 통해 또는 ` reject()`를 호출하여 닫혔을 때 발생합니다.

이 신호는 close()을 호출하여 대화 상자를 닫을 때도 발생합니다.

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

accepted()도 참조하십시오 .

메서드 문서

void accept()

대화 상자를 닫고 accepted() 신호를 발생시킵니다.

reject()도 참조하십시오 .

void close()

대화 상자를 닫고 accepted() 또는 rejected() 신호를 발생시킵니다.

visible 및 open()도 참조하십시오 .

void done(int result)

대화 상자를 닫고 ` result`를 설정합니다.

accept(), reject() 및 result도 참조하십시오 .

void open()

대화 상자를 엽니다.

visible 및 close()도 참조하십시오 .

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.