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 enum で各属性をさらに説明します。

QWebEnginePage オブジェクトはそれ自身の QWebEngineSettings オブジェクトを持ち、そのページの設定を構成します。ウェブ・エンジン・ページに対して設定が構成されていない場合、そのページが属するプロファイルの設定で検索されます。

QWebEnginePage::settings() およびQWebEngineView::settings()も参照してください

メンバー・タイプのドキュメント

enum QWebEngineSettings::FontFamily

この列挙型は、CSS 2で定義されている一般的なフォントファミリを記述します。詳細については、CSS標準を参照してください。

定数説明
QWebEngineSettings::StandardFont0
QWebEngineSettings::FixedFont1
QWebEngineSettings::SerifFont2
QWebEngineSettings::SansSerifFont3
QWebEngineSettings::CursiveFont4
QWebEngineSettings::FantasyFont5
QWebEngineSettings::PictographFont6(Qt 5.7で追加、Qt 6.4で非推奨)

enum QWebEngineSettings::FontSize

この列挙型は、QWebEngineSettings を通して設定可能なフォントサイズを記述します:

定数説明
QWebEngineSettings::MinimumFontSize0ハード最小フォントサイズ。
QWebEngineSettings::MinimumLogicalFontSize1拡大時に適用される論理的な最小フォントサイズ。
QWebEngineSettings::DefaultFontSize2通常のテキストのデフォルトのフォントサイズ。
QWebEngineSettings::DefaultFixedFontSize3固定ピッチテキストのデフォルトのフォントサイズ。

[since Qt 6.8] enum class QWebEngineSettings::ImageAnimationPolicy

この列挙型は、画像フレームがアニメーションのためにレンダリングされるときに、画像アニメーションがどのように処理されるべきかを記述します。

定数説明
QWebEngineSettings::ImageAnimationPolicy::Allow1画像フレームがレンダリングされるときに、画像のアニメーションを許可します。
QWebEngineSettings::ImageAnimationPolicy::AnimateOnce2画像フレームがレンダリングされるときに、画像を一度だけアニメーションさせます。
QWebEngineSettings::ImageAnimationPolicy::Disallow3画像フレームがレンダリングされるとき、画像のアニメーションを禁止します。

この列挙型は Qt 6.8 で導入されました。

imageAnimationPolicy,setImageAnimationPolicy,resetImageAnimationPolicyも参照してください

[since Qt 5.11] enum QWebEngineSettings::UnknownUrlSchemePolicy

この列挙型は、不明なスキームを持つURLへのナビゲーションリクエストがどのように処理されるかを記述する。

定数説明
QWebEngineSettings::DisallowUnknownUrlSchemes1不明なスキームを持つ URL へのすべてのナビゲーション要求を許可しない。
QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction2未知のスキームを持つ URL へのナビゲーションリクエストのうち、ユーザー操作 (マウスクリックなど) によるものは許可し、それ以外のナビゲーションリクエスト (JavaScript など) は抑制します。
QWebEngineSettings::AllowAllUnknownUrlSchemes3未知のスキームを持つ URL へのすべてのナビゲーション要求を許可します。

この列挙型は Qt 5.11 で導入されました。

unknownUrlSchemePolicy,setUnknownUrlSchemePolicy,resetUnknownUrlSchemePolicyも参照してください

enum QWebEngineSettings::WebAttribute

この列挙型は、ウェブページの設定を指定します:

定数説明
QWebEngineSettings::AutoLoadImages0ウェブページの画像を自動的にダウンロードします。この設定が無効の場合、画像はキャッシュから読み込まれます。デフォルトで有効。
QWebEngineSettings::JavascriptEnabled1MainWorld で JavaScript プログラムを実行できるようにします。 デフォルトで有効になっています。
QWebEngineSettings::JavascriptCanOpenWindows2JavaScript プログラムがユーザーの操作なしでポップアップ ウィンドウを開くことを許可します。デフォルトで有効。
QWebEngineSettings::JavascriptCanAccessClipboard3JavaScript プログラムがサニタイズされたコンテンツをクリップボードに書き込む (コピーする) ことを許可します。サニタイズされた書き込みは、write およびwriteText JavaScript Clipboard API 呼び出しで行われ、ユーザーアクションを伴わなければなりません。サニタイズされていない書き込みとクリップボードからの読み取りは、JavascriptCanPasteによって有効になります。Chromiumバージョン81以前では、この設定によってすべてのクリップボード書き込みが有効になっていました。クリップボードへの無制限なアクセスはセキュリティ上の懸念となる可能性があるため、アプリケーションではこの設定を無効にしておき、代わりにClipboardReadWrite 機能の許可要求に応答することをお勧めします。デフォルトでは無効になっています。
QWebEngineSettings::LinksIncludedInFocusChain4キーボードフォーカスチェーンにハイパーリンクを含める。デフォルトで有効。
QWebEngineSettings::LocalStorageEnabled5HTML 5 ローカルストレージ機能のサポートを有効にします。デフォルトで有効。
QWebEngineSettings::LocalContentCanAccessRemoteUrls6通常ブロックされるリモートリソースへのローカルオリジン文書のアクセスを許可する。デフォルトでは無効。以下のDnsPrefetchEnabledは、この設定とは独立して動作し、有効にするとローカルコンテンツからのリモートアクセスを引き起こす可能性があることに注意してください。
QWebEngineSettings::XSSAuditingEnabled7この設定は廃止され、何の効果もありません。
QWebEngineSettings::SpatialNavigationEnabled8これは、左、右、上、下の矢印キーを使用して、Web ページ上のハイパーリンクやフォームコントロールなどのフォーカス可能な要素間を移動する機能を意味します。たとえば、ユーザーが Right キーを押した場合、ヒューリスティック機能により、ユーザーが右方向に到達しようとしている要素があるかどうか、また、おそらくどの要素を望んでいるかが判断されます。デフォルトでは無効になっています。
QWebEngineSettings::LocalContentCanAccessFileUrls9ローカルに読み込まれたドキュメントが他のローカルURLにアクセスすることを許可します。これを無効にすると、QtWebEngine の動作がより Chrome や Firefox に近くなります(デフォルト)。デフォルトで有効。
QWebEngineSettings::HyperlinkAuditingEnabled10ハイパーリンクのping 属性のサポートを有効にします。デフォルトでは無効です。
QWebEngineSettings::ScrollAnimatorEnabled11アニメーションスクロールを有効にします。デフォルトでは無効。
QWebEngineSettings::ErrorPageEnabled12Chromium 組み込みのエラーページの表示を有効にします。デフォルトで有効です。
QWebEngineSettings::PluginsEnabled13Flash Player などの Pepper プラグインのサポートを有効にします。デフォルトでは無効です。
QWebEngineSettings::FullScreenSupportEnabled14アプリケーションのフルスクリーンサポートを有効にします。デフォルトでは無効です。(Qt 5.6 で追加)。
QWebEngineSettings::ScreenCaptureEnabled15アプリケーションでスクリーンキャプチャを有効にします。デフォルトでは無効。(Qt 5.7 で追加)。
QWebEngineSettings::WebGLEnabled16HTML 5 WebGL のサポートを有効にします。利用可能であればデフォルトで有効。(Qt 5.7 で追加)。
QWebEngineSettings::Accelerated2dCanvasEnabled17HTML5 2D canvas を OpenGL フレームバッファにするかどうかを指定します。これにより、多くの描画操作が速くなりますが、ピクセルへのアクセスが遅くなります。利用可能ならデフォルトで有効。(Qt 5.7 で追加)
QWebEngineSettings::AutoLoadIconsForPage18ウェブページ用のアイコンを自動的にダウンロードします。デフォルトで有効。(Qt 5.7 で追加)
QWebEngineSettings::TouchIconsEnabled19タッチアイコンと合成済みタッチアイコンのサポートを有効にします。 デフォルトでは無効です。(Qt 5.7 で追加)。
QWebEngineSettings::FocusOnNavigationEnabled20ナビゲーション操作(load, stop, reload, reload and bypass cache, forward, backward, set content, and so on)が発生するたびに、ページに関連付けられたビューにフォーカスを与える。デフォルトでは無効です。(Qt 5.8 で追加)
QWebEngineSettings::PrintElementBackgrounds21Web ページを印刷するときに CSS 背景の印刷をオンにします。デフォルトで有効。(Qt 5.8 で追加)。
QWebEngineSettings::AllowRunningInsecureContent22デフォルトでは、HTTPSページはHTTP URLからJavaScript、CSS、プラグイン、Webソケットを実行できません。これは、古い安全でない動作を取得するためのオーバーライドを提供します。デフォルトでは無効です。(Qt 5.8 で追加)
QWebEngineSettings::AllowGeolocationOnInsecureOrigins23Qt 5.7 以降、HTTPS のような安全なオリジンのみが Geolocation 機能を要求することができます。これは、非セキュアなオリジンが再び Geolocation にアクセスできるようにするためのオーバーライドです。デフォルトでは無効になっています。(Qt 5.9 で追加)
QWebEngineSettings::AllowWindowActivationFromJavaScript24JavaScriptのwindow.focus()メソッドでウィンドウをアクティブにできるようになりました。デフォルトでは無効。(Qt 5.10 で追加)。
QWebEngineSettings::ShowScrollBars25スクロールバーを表示します。デフォルトで有効。(Qt 5.10 で追加)。
QWebEngineSettings::PlaybackRequiresUserGesture26ユーザーがページとインタラクトするまで、メディアコンテンツの再生を禁止する。デフォルトでは、WebEngineAutoplay Policy Changes で説明されているように、Chromium の設定が使用されます。これは、Android の Chrome の動作に似ています。一方、無効にした場合のデフォルトの動作は、デスクトップの Chrome に似ています。デフォルトの動作を上書きするには、この設定を無効にしてください。(Qt 5.11 で追加)
QWebEngineSettings::JavascriptCanPaste28JavaScript プログラムによるクリップボードからの読み込み(貼り付け)と、サニタイズされていないコンテンツの書き込みを許可します。サニタイズされた書き込みは、write およびwriteText JavaScript Clipboard API 呼び出しで行われ、ユーザーアクションを伴わなければなりません。サニタイズされていない書き込みは、これらの条件を満たさない書き込みです。この設定を有効にするには、JavascriptCanAccessClipboardも有効にする必要があります。クリップボードへの無制限のアクセスはセキュリティ上の懸念となる可能性があるため、アプリケーションはこの設定を無効のままにしておき、代わりにClipboardReadWrite 機能の許可リクエストに応答することをお勧めします。デフォルトでは無効です。(Qt 5.11 で追加)
QWebEngineSettings::WebRTCPublicInterfacesOnly27WebRTC をパブリック IP アドレスのみに制限します。無効にすると、WebRTC はローカルネットワークの IP アドレスも使用できますが、リモートホストはローカルネットワークの IP アドレスも見ることができます。デフォルトでは無効です。(Qt 5.11 で追加)
QWebEngineSettings::DnsPrefetchEnabled29ブラウジングを高速化するためにWebEngine が DNS エントリのプリフェッチを試みるかどうかを指定します。デフォルトでは無効です。(Qt 5.12 で追加)
QWebEngineSettings::PdfViewerEnabled30PDF ドキュメントをダウンロードする代わりに、内部の PDF ビューアで開くかどうかを指定します。デフォルトで有効。(Qt 5.13 で追加)。
QWebEngineSettings::NavigateOnDropEnabled31URL をビューにドロップすることでナビゲーションをトリガーできるように指定します。デフォルトで有効。(Qt 6.4 で追加)。
QWebEngineSettings::ReadingFromCanvasEnabled32すべての canvas 要素からの読み込みを有効にします。この設定は、オリジンに関係なくすべての HTML5 canvas 要素に影響し、canvas フィンガープリンティングを防ぐために無効にすることができます。デフォルトでは有効です。(Qt 6.6 で追加)
QWebEngineSettings::ForceDarkMode33すべてのウェブコンテンツがダークテーマを使ってレンダリングされるように指定します。詳細はAuto dark theme を参照してください。デフォルトでは無効。(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 で導入されました。

imageAnimationPolicysetImageAnimationPolicyも参照してください

[since Qt 5.11] void QWebEngineSettings::resetUnknownUrlSchemePolicy()

不明なスキームを持つ URL へのナビゲーション要求を処理するためのポリシーを削除します。

この関数は Qt 5.11 で導入されました。

unknownUrlSchemePolicysetUnknownUrlSchemePolicyも参照してください

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.