이 페이지에서

Dialog QML Type

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

Import Statement: import Qt.labs.platform
Inherits:

QtObject

Inherited By:

ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog

Status: Deprecated since 6.11

이 유형은 Qt Labs Platform 6.11부터 더 이상 권장되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않을 것을 강력히 권장합니다.

속성

신호

방법

상세 설명

대신 ` QtQuick.Dialogs Dialog `를 사용하십시오.

Dialog 타입은 네이티브 플랫폼 대화 상자를 위한 공통 QML API를 제공합니다.

네이티브 대화 상자를 표시하려면 구체적인 Dialog 구현체 중 하나의 인스턴스를 생성하고, 원하는 속성을 설정한 다음 open()를 호출하십시오. 사용자가 대화 상자 사용을 마치면 Dialog는 accepted() 또는 rejected()를 발생시킵니다.

참고: Qt.labs 모듈의 타입은 향후 버전에서 호환성이 보장되지 않습니다.

속성 문서

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 상위 객체를 순회하여 창이 자동으로 결정됩니다.

result : int

이 속성은 결과 코드를 포함합니다.

표준 결과 코드:

상수설명
Dialog.Accepted 
Dialog.Rejected

참고: MessageDialog는 표준 결과 코드를 사용하는 대신, 클릭된 표준 버튼의 값을 결과로 설정합니다.

title : string

이 속성은 대화 상자의 제목을 나타냅니다.

visible : bool

이 속성은 대화 상자의 표시 여부를 지정합니다. 기본값은 false 입니다.

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

신호 문서

void accepted()

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

참고: close()을 사용하여 대화 상자를 닫을 때는이 신호가 발생하지 않습니다.

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

참조: rejected().

void rejected()

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

참고: close()를 사용하여 대화 상자를 닫을 때는이 신호가 발생하지 않습니다.

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

accepted()도 참조하십시오 .

메서드 문서

void accept()

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

reject()도 참조하십시오 .

void close()

대화 상자를 닫습니다.

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.