QWebEngineSettings Class
QWebEngineSettings クラスは、QWebEnginePage で使用される設定を保存するオブジェクトを提供します。詳細...
| Header: | #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
この enum は、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 プログラムによるクリップボードからの読み取りとクリップボードへの書き込みを許可します。クリップボードへの書き込みは、ユーザーによって特別に要求された場合、常に許可されます。JavaScriptからクリップボードの内容を貼り付けることも許可するには、JavascriptCanPasteを参照してください。クリップボードへの無制限のアクセスはセキュリティ上の潜在的な懸念があるため、アプリケーションはこれを無効のままにしておき、代わりに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 キャンバスを 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 | JavaScriptexecCommand("paste") を有効にします。これも 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も参照してください 。
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
