Back to Qt.io
Contact Us Blog Download Qt

WebEngineSettings QML Type

브라우저 속성 및 속성을 구성할 수 있습니다. 더 보기...

Import Statement: import QtWebEngine
Since: QtWebEngine 1.1

속성

상세 설명

WebEngineSettings 유형은 JavaScript 지원, 포커스 동작, 원격 콘텐츠 액세스 등의 브라우저 속성 및 일반 속성을 구성하는 데 사용할 수 있습니다. 이 유형은 만들 수 없지만 WebEngine.settings 속성을 사용하여 모든 웹 엔진 보기의 기본 설정에 액세스할 수 있습니다.

각 웹 엔진 보기에는 WebEngineView.settings 속성을 사용하여 액세스할 수 있는 개별 설정이 있을 수 있습니다.

속성 문서

accelerated2dCanvasEnabled : bool [since QtWebEngine 1.3]

HTML 5 2D 캔버스를 OpenGL 프레임버퍼로 사용할지 여부를 지정합니다. 이 옵션을 사용하면 많은 페인팅 작업이 빨라지지만 픽셀 액세스 속도가 느려집니다.

사용 가능한 경우 기본적으로 활성화됩니다.

이 프로퍼티는 QtWebEngine 1.3에 도입되었습니다.


allowGeolocationOnInsecureOrigins : bool [since QtWebEngine 1.5]

Qt 5.7부터는 HTTPS와 같은 보안 오리진만 지리적 위치 기능을 요청할 수 있습니다. 이것은 보안되지 않은 출처가 지리적 위치에 다시 액세스하도록 허용하는 재정의 기능을 제공합니다.

기본적으로 비활성화되어 있습니다.

이 속성은 QtWebEngine 1.5에 도입되었습니다.


allowRunningInsecureContent : bool [since QtWebEngine 1.4]

기본적으로 HTTPS 페이지는 HTTP URL에서 JavaScript, CSS, 플러그인 또는 웹 소켓을 실행할 수 없습니다. 이전에는 가능했지만 이전 동작을 가져오기 위한 재정의가 제공됩니다.

기본적으로 비활성화되어 있습니다.

이 속성은 QtWebEngine 1.4에 도입되었습니다.


allowWindowActivationFromJavaScript : bool [since QtWebEngine 1.6]

자바스크립트에서 window.focus() 메서드를 허용합니다. 기본적으로 허용되지 않습니다.

이 속성은 QtWebEngine 1.6에 도입되었습니다.


autoLoadIconsForPage : bool [since QtWebEngine 1.3]

웹 페이지의 아이콘을 자동으로 다운로드합니다.

기본적으로 활성화됩니다.

이 속성은 QtWebEngine 1.3에 도입되었습니다.


autoLoadImages : bool

웹 페이지의 이미지를 자동으로 로드합니다.

기본적으로 활성화되어 있습니다.


defaultTextEncoding : string [since QtWebEngine 1.2]

기본 인코딩을 설정합니다. 값은 "utf-8" 또는 "iso-8859-1"과 같은 인코딩을 설명하는 문자열이어야 합니다.

비워두면 기본값이 사용됩니다.

이 속성은 QtWebEngine 1.2에 도입되었습니다.


dnsPrefetchEnabled : bool [since QtWebEngine 1.8]

활성화되기 전에 HTML 링크에 대한 DNS 레코드의 추측적 프리페칭을 활성화합니다.

기본적으로 비활성화되어 있습니다.

이 속성은 QtWebEngine 1.8에 도입되었습니다.


errorPageEnabled : bool

Chromium의 기본 제공 오류 페이지를 표시합니다.

기본적으로 활성화됩니다.


focusOnNavigationEnabled : bool [since QtWebEngine 1.4]

탐색 작업(로드, 중지, 다시 로드, 캐시 다시 로드 및 우회, 앞으로, 뒤로, 콘텐츠 설정 등)이 발생할 때마다 뷰에 포커스가 지정됩니다.

기본적으로 비활성화되어 있습니다.

이 속성은 QtWebEngine 1.4에 도입되었습니다.


forceDarkMode : bool [since QtWebEngine 6.7]

어두운 테마를 사용하여 모든 웹 콘텐츠를 자동으로 렌더링합니다.

기본적으로 비활성화되어 있습니다.

이 속성은 QtWebEngine 6.7에 도입되었습니다.


fullscreenSupportEnabled : bool [since QtWebEngine 1.2]

이 응용 프로그램에서 전체 화면이 지원되는지 여부를 웹 엔진에 알려줍니다.

기본적으로 비활성화되어 있습니다.

이 속성은 QtWebEngine 1.2에 도입되었습니다.


hyperlinkAuditingEnabled : bool

하이퍼링크에 대한 ping 속성을 지원합니다.

기본적으로 비활성화되어 있습니다.


imageAnimationPolicy : enumeration [since QtWebEngine 6.8]

애니메이션을 위해 이미지 프레임을 렌더링할 때 이미지 애니메이션을 처리하는 방법을 지정합니다.

Constant설명
WebEngineSettings.ImageAnimationPolicy.Allow이미지 프레임이 렌더링될 때 모든 이미지 애니메이션을 허용합니다.
WebEngineSettings.ImageAnimationPolicy.AnimateOnce이미지 프레임이 렌더링될 때 이미지에 한 번 애니메이션을 적용합니다.
WebEngineSettings.ImageAnimationPolicy.Disallow이미지 프레임이 렌더링될 때 모든 이미지 애니메이션을 허용하지 않습니다.

기본값은 WebEngineSettings.ImageAnimationPolicy.Allow 입니다.

이 속성은 QtWebEngine 6.8에 도입되었습니다.


javascriptCanAccessClipboard : bool

JavaScript 프로그램이 위생 처리된 콘텐츠를 클립보드에 쓰기(복사)할 수 있도록 허용합니다. 위생 처리된 쓰기는 write 및 writeText JavaScript 클립보드 API 호출을 통해 수행되며 사용자 작업이 수반되어야 합니다.

위생 처리되지 않은 쓰기 및 클립보드에서 읽기는 javascriptCanPaste 을 통해 활성화됩니다.

Chromium 버전 81 이전에는 이 설정으로 모든 클립보드 쓰기가 활성화되었습니다.

제한되지 않은 클립보드 액세스는 잠재적인 보안 문제가 될 수 있으므로 애플리케이션에서는 이 설정을 비활성화하고 대신 ClipboardReadWrite 기능 권한 요청에 응답하는 것이 좋습니다.

기본적으로 비활성화되어 있습니다.


javascriptCanOpenWindows : bool

JavaScript 프로그램이 사용자 상호 작용 없이 팝업 창을 열 수 있도록 허용합니다.

기본적으로 활성화됩니다.


javascriptCanPaste : bool [since QtWebEngine 1.7]

JavaScript 프로그램이 클립보드에서 읽기(붙여넣기)를 하고 위생 처리되지 않은 콘텐츠를 쓸 수 있도록 허용합니다. 위생 처리된 쓰기는 write 및 writeText JavaScript 클립보드 API 호출을 통해 수행되며 사용자 작업이 수반되어야 하며, 위생 처리되지 않은 쓰기는 이러한 기준을 충족하지 않는 모든 쓰기입니다.

이 설정이 적용되려면 javascriptCanAccessClipboard 도 활성화되어 있어야 합니다.

제한 없는 클립보드 액세스는 잠재적인 보안 문제가 될 수 있으므로 애플리케이션에서는 이 설정을 비활성화한 상태로 두고 대신 ClipboardReadWrite 기능 권한 요청에 응답하는 것이 좋습니다.

기본적으로 비활성화되어 있습니다.

이 속성은 QtWebEngine 1.7에 도입되었습니다.


javascriptEnabled : bool

JavaScript 프로그램 실행을 활성화합니다.

기본적으로 활성화됩니다.


linksIncludedInFocusChain : bool

키보드 포커스 체인에 하이퍼링크를 포함합니다.

기본적으로 활성화됩니다.


localContentCanAccessFileUrls : bool

로컬로 로드된 문서가 다른 로컬 URL에 액세스할 수 있도록 허용합니다.

기본적으로 활성화됩니다.


localContentCanAccessRemoteUrls : bool

로컬로 로드된 문서가 원격 URL에 액세스할 수 있도록 허용합니다.

기본적으로 비활성화되어 있습니다.


localStorageEnabled : bool

HTML 5 로컬 저장소 기능을 지원합니다.

기본적으로 활성화됩니다.


뷰에 URL을 끌어 놓아 탐색을 트리거할 수 있도록 지정합니다.

기본적으로 사용하도록 설정됩니다.

이 속성은 QtWebEngine 6.4에 도입되었습니다.


pdfViewerEnabled : bool [since QtWebEngine 1.9]

PDF 문서를 다운로드하는 대신 내부 PDF 뷰어에서 열도록 지정합니다.

기본적으로 활성화됩니다.

이 속성은 QtWebEngine 1.9에 도입되었습니다.


playbackRequiresUserGesture : bool [since QtWebEngine 1.7]

사용자가 페이지와 상호 작용할 때까지 미디어 콘텐츠의 재생을 금지합니다.

기본적으로 Qt WebEngine 는 자동 재생 정책 변경에 설명된 대로 Chromium 설정을 사용합니다. 기본 동작을 덮어쓰려면 이 속성을 false 으로 설정해야 합니다.

참고: 이 동작은 활성화된 경우 Android의 Chrome과 유사하며, 비활성화된 경우 데스크톱의 Chrome과 유사합니다.

이 속성은 QtWebEngine 1.7에 도입되었습니다.


pluginsEnabled : bool

Flash 플레이어와 같은 Pepper 플러그인에 대한 지원을 활성화합니다.

기본적으로 비활성화되어 있습니다.


printElementBackgrounds : bool [since QtWebEngine 1.4]

웹 페이지를 인쇄할 때 CSS 배경 인쇄를 켭니다.

기본적으로 활성화됩니다.

이 속성은 QtWebEngine 1.4에 도입되었습니다.


readingFromCanvasEnabled : bool [since QtWebEngine 6.6]

모든 캔버스 요소에서 읽기를 활성화하도록 지정합니다.

이 설정은 출처에 관계없이 모든 HTML5 캔버스 요소에 영향을 미치며, 캔버스 핑거프린팅을 방지하기 위해 비활성화할 수 있습니다.

기본적으로 활성화됩니다.

이 속성은 QtWebEngine 6.6에 도입되었습니다.


screenCaptureEnabled : bool [since QtWebEngine 1.3]

이 애플리케이션에서 화면 캡처가 지원되는지 여부를 웹 엔진에 알려줍니다.

기본적으로 비활성화되어 있습니다.

이 속성은 QtWebEngine 1.3에 도입되었습니다.


scrollAnimatorEnabled : bool [since QtWebEngine 6.8]

애니메이션 스크롤을 활성화합니다.

기본적으로 비활성화되어 있습니다.

이 속성은 QtWebEngine 6.8에 도입되었습니다.


showScrollBars : bool [since QtWebEngine 1.6]

스크롤 막대를 표시합니다. 기본적으로 활성화됩니다.

이 속성은 QtWebEngine 1.6에 도입되었습니다.


spatialNavigationEnabled : bool

왼쪽, 오른쪽, 위, 아래 화살표 키를 사용하여 웹 페이지에서 하이퍼링크 및 양식 컨트롤과 같은 포커스 가능한 요소 사이를 이동하는 기능인 공간 탐색 기능을 활성화합니다.

예를 들어 사용자가 오른쪽 키를 누르면 휴리스틱을 통해 오른쪽에 도달하려고 하는 요소가 있는지, 어떤 요소를 원하는지 판단합니다.

기본적으로 비활성화되어 있습니다.


touchIconsEnabled : bool [since QtWebEngine 1.3]

터치 아이콘 및 미리 구성된 터치 아이콘 지원을 활성화합니다.

기본적으로 비활성화되어 있습니다.

이 속성은 QtWebEngine 1.3에 도입되었습니다.


unknownUrlSchemePolicy : enumeration [since QtWebEngine 1.7]

알 수 없는 스키마를 가진 URL에 대한 탐색 요청을 처리하는 방법을 지정합니다.

Constant설명
WebEngineSettings.DisallowUnknownUrlSchemes알 수 없는 스키마를 가진 URL에 대한 모든 탐색 요청을 허용하지 않습니다.
WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction마우스 클릭과 같은 사용자 상호 작용에서 발생하는 알 수 없는 스키마의 URL에 대한 탐색 요청은 허용하고, 다른 탐색 요청(예: 자바스크립트에서 발생하는)은 억제합니다.
WebEngineSettings.AllowAllUnknownUrlSchemes알 수 없는 스키마를 가진 URL에 대한 모든 탐색 요청을 허용합니다.

기본값은 WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction 입니다.

이 속성은 QtWebEngine 1.7에 도입되었습니다.


webGLEnabled : bool [since QtWebEngine 1.3]

HTML 5 WebGL 지원을 활성화합니다.

사용 가능한 경우 기본적으로 활성화됩니다.

이 속성은 QtWebEngine 1.3에 도입되었습니다.


webRTCPublicInterfacesOnly : bool [since QtWebEngine 1.7]

WebRTC를 공용 IP 주소로만 제한합니다. 비활성화하면 WebRTC는 로컬 네트워크 IP 주소도 사용할 수 있지만 원격 호스트는 로컬 네트워크 IP 주소도 볼 수 있습니다.

기본적으로 비활성화되어 있습니다.

이 속성은 QtWebEngine 1.7에 도입되었습니다.


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