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::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
この列挙型は、画像フレームがアニメーションのためにレンダリングされるときに、画像アニメーションがどのように処理されるべきかを記述します。
定数 | 値 | 説明 |
---|---|---|
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 Clipboard API 呼び出しで行われ、ユーザーアクションを伴わなければなりません。サニタイズされていない書き込みとクリップボードからの読み取りは、JavascriptCanPasteによって有効になります。Chromiumバージョン81以前では、この設定によってすべてのクリップボード書き込みが有効になっていました。クリップボードへの無制限なアクセスはセキュリティ上の懸念となる可能性があるため、アプリケーションではこの設定を無効にしておき、代わりにClipboardReadWrite 機能の許可要求に応答することをお勧めします。デフォルトでは無効になっています。 |
QWebEngineSettings::LinksIncludedInFocusChain | 4 | キーボードフォーカスチェーンにハイパーリンクを含める。デフォルトで有効。 |
QWebEngineSettings::LocalStorageEnabled | 5 | HTML 5 ローカルストレージ機能のサポートを有効にします。デフォルトで有効。 |
QWebEngineSettings::LocalContentCanAccessRemoteUrls | 6 | 通常ブロックされるリモートリソースへのローカルオリジン文書のアクセスを許可する。デフォルトでは無効。以下のDnsPrefetchEnabledは、この設定とは独立して動作し、有効にするとローカルコンテンツからのリモートアクセスを引き起こす可能性があることに注意してください。 |
QWebEngineSettings::XSSAuditingEnabled | 7 | この設定は廃止され、何の効果もありません。 |
QWebEngineSettings::SpatialNavigationEnabled | 8 | これは、左、右、上、下の矢印キーを使用して、Web ページ上のハイパーリンクやフォームコントロールなどのフォーカス可能な要素間を移動する機能を意味します。たとえば、ユーザーが Right キーを押した場合、ヒューリスティック機能により、ユーザーが右方向に到達しようとしている要素があるかどうか、また、おそらくどの要素を望んでいるかが判断されます。デフォルトでは無効になっています。 |
QWebEngineSettings::LocalContentCanAccessFileUrls | 9 | ローカルに読み込まれたドキュメントが他のローカルURLにアクセスすることを許可します。これを無効にすると、QtWebEngine の動作がより Chrome や Firefox に近くなります(デフォルト)。デフォルトで有効。 |
QWebEngineSettings::HyperlinkAuditingEnabled | 10 | ハイパーリンクのping 属性のサポートを有効にします。デフォルトでは無効です。 |
QWebEngineSettings::ScrollAnimatorEnabled | 11 | アニメーションスクロールを有効にします。デフォルトでは無効。 |
QWebEngineSettings::ErrorPageEnabled | 12 | Chromium 組み込みのエラーページの表示を有効にします。デフォルトで有効です。 |
QWebEngineSettings::PluginsEnabled | 13 | Flash Player などの 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 canvas を OpenGL フレームバッファにするかどうかを指定します。これにより、多くの描画操作が速くなりますが、ピクセルへのアクセスが遅くなります。利用可能ならデフォルトで有効。(Qt 5.7 で追加) |
QWebEngineSettings::AutoLoadIconsForPage | 18 | ウェブページ用のアイコンを自動的にダウンロードします。デフォルトで有効。(Qt 5.7 で追加) |
QWebEngineSettings::TouchIconsEnabled | 19 | タッチアイコンと合成済みタッチアイコンのサポートを有効にします。 デフォルトでは無効です。(Qt 5.7 で追加)。 |
QWebEngineSettings::FocusOnNavigationEnabled | 20 | ナビゲーション操作(load, stop, reload, reload and bypass cache, forward, backward, set content, and so on)が発生するたびに、ページに関連付けられたビューにフォーカスを与える。デフォルトでは無効です。(Qt 5.8 で追加) |
QWebEngineSettings::PrintElementBackgrounds | 21 | Web ページを印刷するときに CSS 背景の印刷をオンにします。デフォルトで有効。(Qt 5.8 で追加)。 |
QWebEngineSettings::AllowRunningInsecureContent | 22 | デフォルトでは、HTTPSページはHTTP URLからJavaScript、CSS、プラグイン、Webソケットを実行できません。これは、古い安全でない動作を取得するためのオーバーライドを提供します。デフォルトでは無効です。(Qt 5.8 で追加) |
QWebEngineSettings::AllowGeolocationOnInsecureOrigins | 23 | Qt 5.7 以降、HTTPS のような安全なオリジンのみが Geolocation 機能を要求することができます。これは、非セキュアなオリジンが再び Geolocation にアクセスできるようにするためのオーバーライドです。デフォルトでは無効になっています。(Qt 5.9 で追加) |
QWebEngineSettings::AllowWindowActivationFromJavaScript | 24 | JavaScriptのwindow.focus()メソッドでウィンドウをアクティブにできるようになりました。デフォルトでは無効。(Qt 5.10 で追加)。 |
QWebEngineSettings::ShowScrollBars | 25 | スクロールバーを表示します。デフォルトで有効。(Qt 5.10 で追加)。 |
QWebEngineSettings::PlaybackRequiresUserGesture | 26 | ユーザーがページとインタラクトするまで、メディアコンテンツの再生を禁止する。デフォルトでは、WebEngine 、Autoplay Policy Changes で説明されているように、Chromium の設定が使用されます。これは、Android の Chrome の動作に似ています。一方、無効にした場合のデフォルトの動作は、デスクトップの Chrome に似ています。デフォルトの動作を上書きするには、この設定を無効にしてください。(Qt 5.11 で追加) |
QWebEngineSettings::JavascriptCanPaste | 28 | JavaScript プログラムによるクリップボードからの読み込み(貼り付け)と、サニタイズされていないコンテンツの書き込みを許可します。サニタイズされた書き込みは、write およびwriteText JavaScript Clipboard 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 | すべての canvas 要素からの読み込みを有効にします。この設定は、オリジンに関係なくすべての HTML5 canvas 要素に影響し、canvas フィンガープリンティングを防ぐために無効にすることができます。デフォルトでは有効です。(Qt 6.6 で追加) |
QWebEngineSettings::ForceDarkMode | 33 | すべてのウェブコンテンツがダークテーマを使ってレンダリングされるように指定します。詳細は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 で導入されました。
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.