FileDialogRequest QML Type

사용자가 (새 파일 또는 기존) 파일 또는 디렉터리를 선택할 수 있도록 하는 요청입니다. 자세히...

Import Statement:	`import QtWebEngine`
Since:	QtWebEngine 1.4

상속된 멤버를 포함한 모든 멤버 목록

속성

accepted : bool
acceptedMimeTypes : stringlist
defaultFileName : string
mode : enumeration

방법

void dialogAccept(stringlist files)
void dialogReject()

상세 설명

FileDialogRequest는 WebEngineView::fileDialogRequested 신호의 인수로 전달됩니다. 입력 요소에서 파일 대화 상자를 요청할 때 생성됩니다. 파일 업로드 상태를 참조하세요.

요청의 accepted 속성은 요청이 사용자 코드에 의해 처리될지 아니면 기본 대화 상자가 표시될지를 나타냅니다. accepted 속성을 true 으로 설정한 경우 dialogAccept() 또는 dialogReject()을 호출해야 합니다.

다음 코드는 사용자 정의 대화 상자를 사용하여 요청을 처리합니다:

WebEngineView {
    // ...
    onFileDialogRequested: function(request) {
        request.accepted = true;
        myDialog.request = request // keep the reference to the request
        myDialog.accept.connect(request.dialogAccept);
        myDialog.reject.connect(request.dialogReject);
        myDialog.visible = true;
    }
    // ...
}

속성 문서

accepted : bool

파일 선택기 대화 상자 요청이 시그널 핸들러에 의해 처리되었는지 여부를 나타냅니다.

WebEngineView::fileDialogRequested 에 대한 시그널 핸들러가 실행된 후 속성이 false 인 경우 기본 파일 선택기 대화 상자가 표시됩니다. 이를 방지하려면 request.accepted 을 true 으로 설정하세요.

기본값은 false 입니다.

acceptedMimeTypes : stringlist [read-only]

입력 요소에 지정된 MIME 유형 목록입니다. 선택 항목은 이러한 유형의 파일로만 제한되어야 합니다.

defaultFileName : string [read-only]

대화 상자에서 선택될 파일의 기본 이름입니다.

mode : enumeration [read-only]

파일 대화 상자의 모드입니다.

상수	설명
`FileDialogRequest.FileModeOpen`	사용자가 기존 파일 하나를 지정할 수 있습니다.
`FileDialogRequest.FileModeOpenMultiple`	사용자가 여러 개의 기존 파일을 지정할 수 있습니다.
`FileDialogRequest.FileModeUploadFolder`	사용자가 업로드할 기존 폴더 하나를 지정할 수 있습니다.
`FileDialogRequest.FileModeSave`	사용자가 존재하지 않는 파일을 지정할 수 있습니다. 기존 파일을 선택하면 파일을 덮어쓸 예정임을 사용자에게 알려야 합니다.

메서드 문서

void dialogAccept(stringlist files)

이 함수는 사용자가 files 로 대화 상자를 수락했을 때 호출해야 합니다.

void dialogReject()

이 함수는 사용자가 대화 상자를 수락하지 않았을 때 호출해야 합니다.

© 2025 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.