WebEngineDownloadRequest QML Type
다운로드에 대한 정보를 제공합니다. 더 보기...
| Import Statement: | import QtWebEngine |
| In C++: | QWebEngineDownloadRequest |
속성
- downloadDirectory : string
- downloadFileName : string
- id : int
- interruptReason : enumeration
- interruptReasonString : string
- isFinished : bool
- isPaused : bool
- isSavePageDownload : bool
- mimeType : string
- receivedBytes : int
- savePageFormat : enumeration
- state : enumeration
- suggestedFileName : string
- totalBytes : int
- url : url
- view : WebEngineView
방법
상세 설명
WebEngineDownloadRequest는 보류 중인 다운로드 요청으로 시작하여 다운로드가 완료될 때까지 전체 수명 주기 동안 다운로드를 모델링합니다. 예를 들어 새 다운로드에 대한 정보를 얻고, 진행 상황을 모니터링하고, 다운로드를 일시 중지, 재개 및 취소하는 데 사용할 수 있습니다.
다운로드는 일반적으로 웹 페이지에서 사용자 상호 작용에 의해 트리거됩니다. 새 다운로드 요청을 애플리케이션에 알리는 것은 WebEngineProfile 의 책임이며, 새로 생성된 WebEngineDownloadRequest와 함께 downloadRequested 신호를 전송하여 이를 수행합니다. 그러면 애플리케이션은 이 항목을 검토하고 수락 여부를 결정할 수 있습니다. 신호 처리기는 Qt WebEngine 항목에서 accept()를 명시적으로 호출해야 실제로 데이터를 다운로드하고 디스크에 쓰기 시작할 수 있습니다. accept ()를 호출하는 신호 처리기가 없으면 다운로드 요청이 자동으로 거부되고 아무 것도 디스크에 기록되지 않습니다.
객체 수명 주기
모든 항목은 downloadRequested 신호가 전송되는 동안 유효합니다. accept ()가 신호 처리기에 의해 호출되지 않으면 해당 항목은 신호가 방출된 직후 삭제됩니다. 즉, 애플리케이션이 거부된 다운로드 항목에 대한 참조를 보관해서는 안 됩니다.
웹 페이지 다운로드
Qt WebEngine 은 단순히 네트워크에서 원시 바이트를 검색하여 디스크에 쓰는 일반적인 파일 다운로드 외에도 페이지의 HTML을 파싱하고, 종속 리소스를 다운로드하고, 모든 것을 특수 파일 형식으로 패키징하는 전체 웹 페이지 저장도 지원합니다(savePageFormat). 다운로드가 파일인지 웹 페이지인지 확인하려면 isSavePageDownload 을 사용하세요.
WebEngineProfile, WebEngineProfile::downloadRequested, WebEngineProfile::downloadFinished 를참조하세요 .
속성 문서
downloadDirectory : string |
데이터가 다운로드되는 파일 이름 없이 전체 대상 경로를 보유합니다.
다운로드 디렉터리는 다운로드가 허용되기 전에 downloadRequested 핸들러에서만 설정할 수 있습니다.
WebEngineProfile::downloadRequested() 및 accept()도 참조하세요 .
downloadFileName : string |
데이터를 다운로드할 파일의 이름을 보유합니다.
다운로드 파일 이름은 다운로드가 허용되기 전에 downloadRequested 핸들러에서만 설정할 수 있습니다.
WebEngineProfile::downloadRequested() 및 accept()도 참조하세요 .
id : int |
다운로드 항목의 ID를 보유합니다.
interruptReason : enumeration |
다운로드가 중단된 이유를 반환합니다:
| 상수 | 설명 |
|---|---|
WebEngineDownloadRequest.NoReason | 이유를 알 수 없거나 중단되지 않았습니다. |
WebEngineDownloadRequest.FileFailed | 일반적인 파일 작동 실패. |
WebEngineDownloadRequest.FileAccessDenied | 액세스 제한으로 인해 파일을 로컬에 쓸 수 없습니다. |
WebEngineDownloadRequest.FileNoSpace | 대상 드라이브에 공간이 부족합니다. |
WebEngineDownloadRequest.FileNameTooLong | 디렉터리 또는 파일 이름이 너무 깁니다. |
WebEngineDownloadRequest.FileTooLarge | 파일 크기가 파일 시스템 제한을 초과합니다. |
WebEngineDownloadRequest.FileVirusInfected | 파일이 바이러스에 감염된 경우. |
WebEngineDownloadRequest.FileTransientError | 일시적인 문제(예: 파일이 사용 중이거나 메모리가 부족하거나 한 번에 너무 많은 파일을 연 경우). |
WebEngineDownloadRequest.FileBlocked | 로컬 정책으로 인해 파일이 차단되었습니다. |
WebEngineDownloadRequest.FileSecurityCheckFailed | 예기치 않은 이유로 다운로드의 안전성을 확인하려고 시도했지만 실패했습니다. |
WebEngineDownloadRequest.FileTooShort | 파일을 열 때 파일의 끝 부분을 지나서 찾으려고 시도했습니다(이전에 중단된 다운로드를 다시 시작하기 위해). |
WebEngineDownloadRequest.FileHashMismatch | 일부 파일이 예상 해시와 일치하지 않습니다. |
WebEngineDownloadRequest.NetworkFailed | 일반적인 네트워크 오류입니다. |
WebEngineDownloadRequest.NetworkTimeout | 네트워크 작업이 시간 초과되었습니다. |
WebEngineDownloadRequest.NetworkDisconnected | 네트워크 연결이 종료되었습니다. |
WebEngineDownloadRequest.NetworkServerDown | 서버가 다운되었습니다. |
WebEngineDownloadRequest.NetworkInvalidRequest | 네트워크 요청이 유효하지 않습니다(예: 원본 또는 리디렉션된 URL이 유효하지 않거나, 지원되지 않는 체계가 있거나, 정책에 의해 허용되지 않는 경우). |
WebEngineDownloadRequest.ServerFailed | 일반 서버 장애. |
WebEngineDownloadRequest.ServerBadContent | 서버에 요청된 데이터가 없습니다. |
WebEngineDownloadRequest.ServerUnauthorized | 서버가 리소스에 대한 액세스 권한을 부여하지 않았습니다. |
WebEngineDownloadRequest.ServerCertProblem | 서버 인증서에 문제가 발생했습니다. |
WebEngineDownloadRequest.ServerForbidden | 서버에서 액세스를 금지했습니다. |
WebEngineDownloadRequest.ServerUnreachable | 예기치 않은 서버 응답(응답하는 서버가 의도한 서버가 아닐 수 있음). |
WebEngineDownloadRequest.UserCanceled | 사용자가 다운로드를 취소했습니다. |
interruptReasonString 를참조하세요 .
interruptReasonString : string |
다운로드 중단 이유에 대한 사람이 읽을 수 있는 설명을 반환합니다.
interruptReason도 참조 하세요.
isFinished : bool |
다운로드가 완료되었는지 여부(완료, 취소 또는 재개할 수 없는 중단 상태).
isSavePageDownload : bool |
웹 페이지 또는 파일 저장을 위한 다운로드 요청인지 여부입니다.
savePageFormat도 참조 하세요.
mimeType : string |
다운로드의 MIME 유형을 보유합니다.
receivedBytes : int |
지금까지 다운로드된 데이터의 양(바이트)을 보유합니다.
savePageFormat : enumeration |
웹 페이지를 저장하는 데 사용되는 형식을 설명합니다.
| 상수 | 설명 |
|---|---|
WebEngineDownloadRequest.UnknownSaveFormat | 전체 웹 페이지를 다운로드하는 요청이 아닙니다. |
WebEngineDownloadRequest.SingleHtmlSaveFormat | 페이지가 단일 HTML 페이지로 저장됩니다. 이미지와 같은 리소스는 저장되지 않습니다. |
WebEngineDownloadRequest.CompleteHtmlSaveFormat | 페이지가 전체 HTML 페이지로 저장됩니다(예: 단일 HTML 페이지와 리소스가 포함된 디렉토리). |
WebEngineDownloadRequest.MimeHtmlSaveFormat | 페이지가 MIME HTML 형식의 전체 웹 페이지로 저장됩니다. |
state : enumeration |
다운로드 상태를 설명합니다:
| 상수 | 설명 |
|---|---|
WebEngineDownloadRequest.DownloadRequested | 다운로드가 요청되었지만 아직 수락되지 않았습니다. |
WebEngineDownloadRequest.DownloadInProgress | 다운로드가 진행 중입니다. |
WebEngineDownloadRequest.DownloadCompleted | 다운로드가 성공적으로 완료되었습니다. |
WebEngineDownloadRequest.DownloadCancelled | 사용자가 다운로드를 취소했습니다. |
WebEngineDownloadRequest.DownloadInterrupted | 다운로드가 중단되었습니다(서버에 의해 또는 연결이 끊어져서). |
suggestedFileName : string |
제안된 파일 이름을 반환합니다.
totalBytes : int |
다운로드할 총 데이터 양을 바이트 단위로 보유합니다.
-1 는 총 크기를 알 수 없음을 의미합니다.
url : url |
다운로드의 원본 URL을 반환합니다.
view : WebEngineView |
다운로드가 요청된 보기를 반환합니다. 뷰의 콘텐츠에 의해 다운로드가 트리거되지 않은 경우 nullptr 이 반환됩니다.
WebEngineView도 참조하세요 .
메서드 문서
void accept() |
다운로드 요청을 수락하여 다운로드를 시작합니다.
항목이 DownloadRequested 상태인 경우 DownloadInProgress 상태로 전환되고 다운로드가 시작됩니다. 항목이 다른 상태이면 아무 일도 일어나지 않습니다.
state도 참조하세요 .
void cancel() |
다운로드를 취소합니다.
항목이 DownloadInProgress 상태인 경우 DownloadCancelled 상태로 전환되고 다운로드가 중지되며 부분적으로 다운로드된 파일이 디스크에서 삭제됩니다.
항목이 DownloadCompleted 상태인 경우에는 아무 일도 일어나지 않습니다. 항목이 다른 상태인 경우에는 추가 효과 없이 DownloadCancelled 상태로 전환됩니다.
state도 참조하세요 .
void pause() |
void resume() |
© 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.
