QWebEngineSettings Class
QWebEngineSettings 클래스는 QWebEnginePage 에서 사용하는 설정을 저장하는 객체를 제공합니다. 더 보기...
| 헤더: | #include <QWebEngineSettings> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
공용 타입
| enum | FontFamily { StandardFont, FixedFont, SerifFont, SansSerifFont, CursiveFont, …, PictographFont } |
| enum | FontSize { MinimumFontSize, MinimumLogicalFontSize, DefaultFontSize, DefaultFixedFontSize } |
(since Qt 6.8) enum class | ImageAnimationPolicy { Allow, AnimateOnce, Disallow } |
(since Qt 5.11) enum | UnknownUrlSchemePolicy { DisallowUnknownUrlSchemes, AllowUnknownUrlSchemesFromUserInteraction, AllowAllUnknownUrlSchemes } |
| enum | WebAttribute { AutoLoadImages, JavascriptEnabled, JavascriptCanOpenWindows, JavascriptCanAccessClipboard, LinksIncludedInFocusChain, …, ForceDarkMode } |
공용 함수
| QString | defaultTextEncoding() const |
| QString | fontFamily(QWebEngineSettings::FontFamily which) const |
| int | fontSize(QWebEngineSettings::FontSize type) const |
(since Qt 6.8) QWebEngineSettings::ImageAnimationPolicy | imageAnimationPolicy() const |
| void | resetAttribute(QWebEngineSettings::WebAttribute attribute) |
| void | resetFontFamily(QWebEngineSettings::FontFamily which) |
| void | resetFontSize(QWebEngineSettings::FontSize type) |
(since Qt 6.8) void | resetImageAnimationPolicy() |
(since Qt 5.11) void | resetUnknownUrlSchemePolicy() |
| void | setAttribute(QWebEngineSettings::WebAttribute attribute, bool on) |
| void | setDefaultTextEncoding(const QString &encoding) |
| void | setFontSize(QWebEngineSettings::FontSize type, int size) |
(since Qt 6.8) void | setImageAnimationPolicy(QWebEngineSettings::ImageAnimationPolicy policy) |
(since Qt 5.11) void | setUnknownUrlSchemePolicy(QWebEngineSettings::UnknownUrlSchemePolicy policy) |
| bool | testAttribute(QWebEngineSettings::WebAttribute attribute) const |
(since Qt 5.11) QWebEngineSettings::UnknownUrlSchemePolicy | unknownUrlSchemePolicy() const |
상세 설명
QWebEngineSettings를 사용하면 글꼴 크기 및 패밀리 같은 브라우저 속성과 JavaScript 지원과 같은 일반 속성을 구성할 수 있습니다. 개별 속성은 setAttribute() 함수를 사용하여 설정합니다. WebAttribute 열거형은 각 속성을 자세히 설명합니다.
각 QWebEnginePage 객체에는 해당 페이지의 설정을 구성하는 자체 QWebEngineSettings 객체가 있습니다. 웹 엔진 페이지에 대한 설정이 구성되지 않은 경우 해당 페이지가 속한 프로필의 설정에서 해당 설정을 찾습니다.
QWebEnginePage::settings() 및 QWebEngineView::settings()도 참조하세요 .
회원 유형 문서
enum QWebEngineSettings::FontFamily
이 열거형은 CSS 2에서 정의한 일반 글꼴 패밀리를 설명합니다. 자세한 내용은 CSS 표준을 참조하세요.
| Constant | 값 | 설명 |
|---|---|---|
QWebEngineSettings::StandardFont | 0 | |
QWebEngineSettings::FixedFont | 1 | |
QWebEngineSettings::SerifFont | 2 | |
QWebEngineSettings::SansSerifFont | 3 | |
QWebEngineSettings::CursiveFont | 4 | |
QWebEngineSettings::FantasyFont | 5 | |
QWebEngineSettings::PictographFont | 6 | (Qt 5.7에 추가, Qt 6.4에서 폐지) |
enum QWebEngineSettings::FontSize
이 열거형은 QWebEngineSettings 을 통해 구성할 수 있는 글꼴 크기를 설명합니다:
| 상수 | 값 | 설명 |
|---|---|---|
QWebEngineSettings::MinimumFontSize | 0 | 하드 최소 글꼴 크기입니다. |
QWebEngineSettings::MinimumLogicalFontSize | 1 | 축소할 때 적용되는 최소 논리적 글꼴 크기입니다. |
QWebEngineSettings::DefaultFontSize | 2 | 일반 텍스트의 기본 글꼴 크기입니다. |
QWebEngineSettings::DefaultFixedFontSize | 3 | 고정 피치 텍스트의 기본 글꼴 크기입니다. |
[since Qt 6.8] enum class QWebEngineSettings::ImageAnimationPolicy
이 열거형은 이미지 프레임이 애니메이션으로 렌더링될 때 이미지 애니메이션을 처리하는 방법을 설명합니다.
| Constant | 값 | 설명 |
|---|---|---|
QWebEngineSettings::ImageAnimationPolicy::Allow | 1 | 이미지 프레임이 렌더링될 때 이미지 애니메이션을 허용합니다. |
QWebEngineSettings::ImageAnimationPolicy::AnimateOnce | 2 | 이미지 프레임이 렌더링될 때 이미지에 애니메이션을 한 번 적용합니다. |
QWebEngineSettings::ImageAnimationPolicy::Disallow | 3 | 이미지 프레임이 렌더링될 때 이미지 애니메이션을 허용하지 않습니다. |
이 열거형은 Qt 6.8에 도입되었습니다.
imageAnimationPolicy, setImageAnimationPolicy, resetImageAnimationPolicy 를참조하세요 .
[since Qt 5.11] enum QWebEngineSettings::UnknownUrlSchemePolicy
이 열거형은 알 수 없는 체계의 URL에 대한 탐색 요청이 처리되는 방식을 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QWebEngineSettings::DisallowUnknownUrlSchemes | 1 | 스키마를 알 수 없는 URL에 대한 모든 탐색 요청을 허용하지 않습니다. |
QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction | 2 | 마우스 클릭과 같은 사용자 상호 작용에서 발생하는 알 수 없는 스키마의 URL에 대한 탐색 요청은 허용하고, 그 외의 탐색 요청(예: JavaScript에서 발생하는)은 억제합니다. |
QWebEngineSettings::AllowAllUnknownUrlSchemes | 3 | 알 수 없는 스키마를 가진 URL에 대한 모든 탐색 요청을 허용합니다. |
이 열거형은 Qt 5.11에 도입되었습니다.
unknownUrlSchemePolicy, setUnknownUrlSchemePolicy, resetUnknownUrlSchemePolicy 를참조하세요 .
enum QWebEngineSettings::WebAttribute
이 열거형 유형은 웹 페이지에 대한 설정을 지정합니다:
| 상수 | 값 | 설명 |
|---|---|---|
QWebEngineSettings::AutoLoadImages | 0 | 웹 페이지의 이미지를 자동으로 다운로드합니다. 이 설정을 비활성화하면 캐시에서 이미지가 로드됩니다. 기본적으로 활성화됩니다. |
QWebEngineSettings::JavascriptEnabled | 1 | MainWorld 에서 JavaScript 프로그램을 실행할 수 있도록 합니다. 기본적으로 활성화되어 있습니다. |
QWebEngineSettings::JavascriptCanOpenWindows | 2 | JavaScript 프로그램이 사용자 상호 작용 없이 팝업 창을 열 수 있도록 허용합니다. 기본적으로 활성화되어 있습니다. |
QWebEngineSettings::JavascriptCanAccessClipboard | 3 | JavaScript 프로그램이 위생 처리된 콘텐츠를 클립보드에 쓰기(복사)할 수 있도록 허용합니다. 위생 처리된 쓰기는 write 및 writeText JavaScript 클립보드 API 호출을 통해 수행되며 사용자 동작이 수반되어야 합니다. 위생 처리되지 않은 쓰기와 클립보드에서 읽기는 JavascriptCanPaste를 통해 활성화됩니다. Chromium 버전 81 이전에는 이 설정으로 모든 클립보드 쓰기가 활성화되었습니다. 제한 없는 클립보드 액세스는 잠재적인 보안 문제가 될 수 있으므로 애플리케이션에서는 이 설정을 비활성화한 상태로 두고 대신 ClipboardReadWrite 기능 권한 요청에 응답하는 것이 좋습니다. 기본적으로 비활성화되어 있습니다. |
QWebEngineSettings::LinksIncludedInFocusChain | 4 | 키보드 포커스 체인에 하이퍼링크 포함. 기본적으로 활성화됩니다. |
QWebEngineSettings::LocalStorageEnabled | 5 | HTML 5 로컬 저장소 기능을 지원합니다. 기본적으로 활성화됩니다. |
QWebEngineSettings::LocalContentCanAccessRemoteUrls | 6 | 로컬 원본 문서가 일반적으로 차단되는 원격 리소스에 액세스할 수 있도록 허용합니다. 기본적으로 비활성화되어 있습니다. 참고 아래의 DnsPrefetchEnabled는 이 설정과 독립적으로 작동하며, 활성화하면 로컬 콘텐츠에서 원격 액세스가 발생할 수 있습니다. |
QWebEngineSettings::XSSAuditingEnabled | 7 | 더 이상 사용되지 않으며 효과가 없습니다. |
QWebEngineSettings::SpatialNavigationEnabled | 8 | 왼쪽, 오른쪽, 위쪽 및 아래쪽 화살표 키를 사용하여 웹 페이지에서 하이퍼링크 및 양식 컨트롤과 같은 포커스 가능한 요소 사이를 탐색하는 기능인 공간 탐색 기능을 활성화합니다. 예를 들어 사용자가 오른쪽 키를 누르면 휴리스틱을 통해 오른쪽에 도달하려는 요소가 있는지, 어떤 요소를 원하는지 판단합니다. 기본적으로 비활성화되어 있습니다. |
QWebEngineSettings::LocalContentCanAccessFileUrls | 9 | 로컬로 로드된 문서가 다른 로컬 URL에 액세스할 수 있도록 허용합니다. 이 옵션을 비활성화하면 QtWebEngine 이 기본적으로 Chrome 및 Firefox와 비슷하게 작동합니다. 기본적으로 사용 설정됩니다. |
QWebEngineSettings::HyperlinkAuditingEnabled | 10 | 하이퍼링크에 대한 ping 속성을 지원합니다. 기본적으로 비활성화되어 있습니다. |
QWebEngineSettings::ScrollAnimatorEnabled | 11 | 애니메이션 스크롤을 활성화합니다. 기본적으로 비활성화되어 있습니다. |
QWebEngineSettings::ErrorPageEnabled | 12 | Chromium의 기본 제공 오류 페이지를 표시합니다. 기본적으로 활성화됩니다. |
QWebEngineSettings::PluginsEnabled | 13 | Flash 플레이어와 같은 Pepper 플러그인 지원을 활성화합니다. 기본적으로 비활성화되어 있습니다. |
QWebEngineSettings::FullScreenSupportEnabled | 14 | 애플리케이션에서 전체 화면 지원을 활성화합니다. 기본적으로 비활성화되어 있습니다. (Qt 5.6에 추가됨) |
QWebEngineSettings::ScreenCaptureEnabled | 15 | 애플리케이션에서 화면 캡처를 활성화합니다. 기본적으로 비활성화되어 있습니다. (Qt 5.7에 추가됨) |
QWebEngineSettings::WebGLEnabled | 16 | HTML 5 WebGL 지원을 활성화합니다. 가능한 경우 기본적으로 활성화됩니다. (Qt 5.7에 추가됨) |
QWebEngineSettings::Accelerated2dCanvasEnabled | 17 | HTML5 2D 캔버스를 OpenGL 프레임버퍼로 사용할지 여부를 지정합니다. 이 옵션을 사용하면 많은 페인팅 작업이 빨라지지만 픽셀 액세스 속도가 느려집니다. 가능한 경우 기본적으로 활성화됩니다. (Qt 5.7에 추가됨) |
QWebEngineSettings::AutoLoadIconsForPage | 18 | 웹 페이지의 아이콘을 자동으로 다운로드합니다. 기본적으로 활성화됩니다. (Qt 5.7에 추가됨) |
QWebEngineSettings::TouchIconsEnabled | 19 | 터치 아이콘 및 미리 구성된 터치 아이콘을 지원합니다. 기본적으로 비활성화되어 있습니다. (Qt 5.7에 추가됨) |
QWebEngineSettings::FocusOnNavigationEnabled | 20 | 탐색 작업(로드, 중지, 다시 로드, 다시 로드 및 캐시 우회, 앞으로, 뒤로, 콘텐츠 설정 등)이 발생할 때마다 페이지와 연결된 보기에 초점을 맞춥니다. 기본적으로 비활성화되어 있습니다. (Qt 5.8에 추가됨) |
QWebEngineSettings::PrintElementBackgrounds | 21 | 웹 페이지를 인쇄할 때 CSS 배경 인쇄를 켭니다. 기본적으로 활성화됩니다. (Qt 5.8에 추가됨) |
QWebEngineSettings::AllowRunningInsecureContent | 22 | 기본적으로 HTTPS 페이지는 HTTP URL에서 자바스크립트, CSS, 플러그인 또는 웹 소켓을 실행할 수 없습니다. 이것은 기존의 안전하지 않은 동작을 재정의할 수 있는 기능을 제공합니다. 기본적으로 비활성화되어 있습니다. (Qt 5.8에 추가됨) |
QWebEngineSettings::AllowGeolocationOnInsecureOrigins | 23 | Qt 5.7부터는 HTTPS와 같은 보안 출처만 위치 정보 기능을 요청할 수 있습니다. 이 기능은 보안되지 않은 출처가 지리적 위치에 다시 액세스하도록 허용하는 재정의 기능을 제공합니다. 기본적으로 비활성화되어 있습니다. (Qt 5.9에 추가됨) |
QWebEngineSettings::AllowWindowActivationFromJavaScript | 24 | window.focus() 자바스크립트 메서드를 사용하여 창을 활성화할 수 있습니다. 기본적으로 비활성화되어 있습니다. (Qt 5.10에 추가됨) |
QWebEngineSettings::ShowScrollBars | 25 | 스크롤 막대를 표시합니다. 기본적으로 활성화됩니다. (Qt 5.10에 추가됨) |
QWebEngineSettings::PlaybackRequiresUserGesture | 26 | 사용자가 페이지와 상호 작용할 때까지 미디어 콘텐츠 재생을 금지합니다. 기본적으로 WebEngine 은 자동 재생 정책 변경에 설명된 대로 Chromium 설정을 사용합니다. 이는 Android의 Chrome이 작동하는 방식과 유사하며, 비활성화했을 때의 기본 동작은 데스크톱의 Chrome과 유사합니다. 기본 동작을 덮어쓰려면 이 설정을 비활성화하세요. (Qt 5.11에 추가됨) |
QWebEngineSettings::JavascriptCanPaste | 28 | JavaScript 프로그램이 클립보드에서 읽기(붙여넣기)하고 위생 처리되지 않은 콘텐츠를 쓸 수 있도록 허용합니다. 위생 처리된 쓰기는 write 및 writeText JavaScript 클립보드 API 호출을 통해 수행되며 사용자 작업이 수반되어야 하며, 위생 처리되지 않은 쓰기는 이러한 기준을 충족하지 않는 모든 쓰기입니다. 이 설정이 효과를 발휘하려면 JavascriptCanAccessClipboard도 활성화해야 합니다. 제한 없는 클립보드 액세스는 잠재적인 보안 문제가 될 수 있으므로 애플리케이션에서는 이 설정을 비활성화한 상태로 두고 대신 ClipboardReadWrite 기능 권한 요청에 응답하는 것이 좋습니다. 기본적으로 비활성화되어 있습니다. (Qt 5.11에 추가됨) |
QWebEngineSettings::WebRTCPublicInterfacesOnly | 27 | WebRTC를 공용 IP 주소로만 제한합니다. 비활성화하면 WebRTC가 로컬 네트워크 IP 주소도 사용할 수 있지만 원격 호스트도 사용자의 로컬 네트워크 IP 주소를 볼 수 있습니다. 기본적으로 비활성화되어 있습니다. (Qt 5.11에 추가됨) |
QWebEngineSettings::DnsPrefetchEnabled | 29 | 검색 속도를 높이기 위해 WebEngine 에서 DNS 항목을 미리 가져올지 여부를 지정합니다. 기본적으로 비활성화되어 있습니다. (Qt 5.12에 추가됨) |
QWebEngineSettings::PdfViewerEnabled | 30 | PDF 문서를 다운로드하는 대신 내부 PDF 뷰어에서 열도록 지정합니다. 기본적으로 활성화되어 있습니다. (Qt 5.13에 추가됨) |
QWebEngineSettings::NavigateOnDropEnabled | 31 | 뷰에 URL을 놓아 탐색을 트리거할 수 있도록 지정합니다. 기본적으로 활성화되어 있습니다. (Qt 6.4에 추가됨) |
QWebEngineSettings::ReadingFromCanvasEnabled | 32 | 모든 캔버스 요소에서 읽기를 사용하도록 지정합니다. 이 설정은 출처에 관계없이 모든 HTML5 캔버스 요소에 영향을 미치며, 캔버스 핑거프린팅을 방지하기 위해 비활성화할 수 있습니다. 기본적으로 활성화됩니다. (Qt 6.6에 추가됨) |
QWebEngineSettings::ForceDarkMode | 33 | 모든 웹 콘텐츠가 어두운 테마를 사용하여 렌더링되도록 지정합니다. 자세한 내용은 자동 어두운 테마를 참조하십시오. 기본적으로 비활성화됩니다. (Qt 6.7에 추가됨) |
멤버 함수 문서
QString QWebEngineSettings::defaultTextEncoding() const
기본 텍스트 인코딩을 반환합니다.
setDefaultTextEncoding()도 참조하세요 .
QString QWebEngineSettings::fontFamily(QWebEngineSettings::FontFamily which) const
지정된 일반 글꼴 패밀리에 대한 실제 글꼴 패밀리를 반환합니다( which).
int QWebEngineSettings::fontSize(QWebEngineSettings::FontSize type) const
type 의 기본 글꼴 크기를 픽셀 단위로 반환합니다.
setFontSize()도 참조하세요 .
[since Qt 6.8] QWebEngineSettings::ImageAnimationPolicy QWebEngineSettings::imageAnimationPolicy() const
이미지 프레임이 렌더링될 때 이미지 애니메이션 처리를 위해 현재 선택된 정책을 반환합니다. 기본값은 QWebEngineSettings::ImageAnimationPolicy::Allow 입니다.
이 함수는 Qt 6.8에 도입되었습니다.
setImageAnimationPolicy 와 resetImageAnimationPolicy도 참조하십시오 .
void QWebEngineSettings::resetAttribute(QWebEngineSettings::WebAttribute attribute)
attribute 설정을 페이지가 속한 프로필에 지정된 값으로 재설정합니다.
void QWebEngineSettings::resetFontFamily(QWebEngineSettings::FontFamily which)
which 에서 지정한 실제 서체를 페이지가 속한 프로필에 지정된 서체로 재설정합니다.
void QWebEngineSettings::resetFontSize(QWebEngineSettings::FontSize type)
type 의 글꼴 크기를 페이지가 속한 프로필에 지정된 크기로 재설정합니다.
[since Qt 6.8] void QWebEngineSettings::resetImageAnimationPolicy()
이미지 애니메이션 처리 정책을 제거합니다.
이 함수는 Qt 6.8에 도입되었습니다.
imageAnimationPolicy 및 setImageAnimationPolicy 을참조하십시오 .
[since Qt 5.11] void QWebEngineSettings::resetUnknownUrlSchemePolicy()
알 수 없는 체계의 URL에 대한 탐색 요청을 처리하는 정책을 제거합니다.
이 기능은 Qt 5.11에 도입되었습니다.
unknownUrlSchemePolicy 및 setUnknownUrlSchemePolicy 을참조하세요 .
void QWebEngineSettings::setAttribute(QWebEngineSettings::WebAttribute attribute, bool on)
on 의 값에 따라 지정된 attribute 기능을 활성화 또는 비활성화합니다.
void QWebEngineSettings::setDefaultTextEncoding(const QString &encoding)
기본 텍스트 인코딩 시스템을 지정합니다.
encoding 값은 "utf-8" 또는 "iso-8859-1"과 같은 인코딩을 설명하는 문자열이어야 합니다. 비워두면 기본값이 사용됩니다. 보다 광범위한 인코딩 이름 목록은 QTextCodec 을 참조하세요.
defaultTextEncoding()도 참조하세요 .
void QWebEngineSettings::setFontSize(QWebEngineSettings::FontSize type, int size)
type ~ size 의 글꼴 크기를 픽셀 단위로 설정합니다.
fontSize()도 참조하세요 .
[since Qt 6.8] void QWebEngineSettings::setImageAnimationPolicy(QWebEngineSettings::ImageAnimationPolicy policy)
이미지 프레임이 렌더링될 때 이미지 애니메이션을 처리하는 정책을 policy 으로 설정합니다. 기본값은 QWebEngineSettings::ImageAnimationPolicy::Allow 입니다.
이 함수는 Qt 6.8에 도입되었습니다.
imageAnimationPolicy 와 resetImageAnimationPolicy 를참조하십시오 .
[since Qt 5.11] void QWebEngineSettings::setUnknownUrlSchemePolicy(QWebEngineSettings::UnknownUrlSchemePolicy policy)
알 수 없는 체계의 URL에 대한 탐색 요청을 처리하는 정책을 policy 으로 설정합니다. 기본값은 QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction 입니다.
이 함수는 Qt 5.11에 도입되었습니다.
unknownUrlSchemePolicy 및 resetUnknownUrlSchemePolicy 을참조하십시오 .
bool QWebEngineSettings::testAttribute(QWebEngineSettings::WebAttribute attribute) const
attribute 이 활성화된 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
[since Qt 5.11] QWebEngineSettings::UnknownUrlSchemePolicy QWebEngineSettings::unknownUrlSchemePolicy() const
알 수 없는 체계의 URL에 대한 탐색 요청을 처리하기 위해 현재 선택된 정책을 반환합니다. 기본값은 QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction 입니다.
이 함수는 Qt 5.11에 도입되었습니다.
setUnknownUrlSchemePolicy 및 resetUnknownUrlSchemePolicy 을참조하십시오 .
© 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.
