WebEngineSettings QML Type

ブラウザのプロパティと属性を設定できるようにします。詳細...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• accelerated2dCanvasEnabled : bool (since QtWebEngine 1.3)
• allowGeolocationOnInsecureOrigins : bool (since QtWebEngine 1.5)
• allowRunningInsecureContent : bool (since QtWebEngine 1.4)
• allowWindowActivationFromJavaScript : bool (since QtWebEngine 1.6)
• autoLoadIconsForPage : bool (since QtWebEngine 1.3)
• autoLoadImages : bool
• backForwardCacheEnabled : bool (since QtWebEngine 6.10)
• defaultTextEncoding : string (since QtWebEngine 1.2)
• dnsPrefetchEnabled : bool (since QtWebEngine 1.8)
• errorPageEnabled : bool
• focusOnNavigationEnabled : bool (since QtWebEngine 1.4)
• forceDarkMode : bool (since QtWebEngine 6.7)
• fullscreenSupportEnabled : bool (since QtWebEngine 1.2)
• hyperlinkAuditingEnabled : bool
• imageAnimationPolicy : enumeration (since QtWebEngine 6.8)
• javascriptCanAccessClipboard : bool
• javascriptCanOpenWindows : bool
• javascriptCanPaste : bool (since QtWebEngine 1.7)
• javascriptEnabled : bool
• linksIncludedInFocusChain : bool
• localContentCanAccessFileUrls : bool
• localContentCanAccessRemoteUrls : bool
• localStorageEnabled : bool
• navigateOnDropEnabled : bool (since QtWebEngine 6.4)
• pdfViewerEnabled : bool (since QtWebEngine 1.9)
• playbackRequiresUserGesture : bool (since QtWebEngine 1.7)
• pluginsEnabled : bool
• preferCSSMarginsForPrinting : bool (since QtWebEngine 6.9)
• printElementBackgrounds : bool (since QtWebEngine 1.4)
• printHeaderAndFooter : bool (since QtWebEngine 6.9)
• readingFromCanvasEnabled : bool (since QtWebEngine 6.6)
• screenCaptureEnabled : bool (since QtWebEngine 1.3)
• scrollAnimatorEnabled : bool (since QtWebEngine 6.8)
• showScrollBars : bool (since QtWebEngine 1.6)
• spatialNavigationEnabled : bool
• touchEventsApiEnabled : bool (since QtWebEngine 6.9)
• touchIconsEnabled : bool (since QtWebEngine 1.3)
• trimAccessibilityIdentifiers : bool (since QtWebEngine 6.11)
• unknownUrlSchemePolicy : enumeration (since QtWebEngine 1.7)
• webGLEnabled : bool (since QtWebEngine 1.3)
• webRTCPublicInterfacesOnly : bool (since QtWebEngine 1.7)

詳細説明

WebEngineSettings 型は、JavaScript のサポート、フォーカスの動作、リモート コンテンツへのアクセスなど、ブラウザのプロパティや一般的な属性を設定するために使用できます。この型は作成できませんが、すべての Web エンジン ビューのデフォルト設定には、WebEngine.settings プロパティを使用してアクセスできます。

各ウェブエンジン・ビューは、WebEngineView.settings プロパティを使用してアクセスできる個別の設定を持つことができます。

プロパティの説明

accelerated2dCanvasEnabled : bool [since QtWebEngine 1.3]

HTML 5の2DキャンバスをOpenGLフレームバッファにするかどうかを指定します。これにより、多くの描画操作が速くなりますが、ピクセルへのアクセスが遅くなります。

利用可能な場合、デフォルトで有効になります。

このプロパティは QtWebEngine 1.3 で導入されました。

allowGeolocationOnInsecureOrigins : bool [since QtWebEngine 1.5]

HTTPS のような安全なオリジンだけが Geolocation 機能を要求できる。これは、非セキュアなオリジンが再びGeolocationにアクセスすることを許可するオーバーライドを提供します。

デフォルトでは無効です。

このプロパティは QtWebEngine 1.5 で導入されました。

allowRunningInsecureContent : bool [since QtWebEngine 1.4]

デフォルトでは、HTTPSページはHTTP URLからJavaScript、CSS、プラグイン、ウェブソケットを実行できません。これは以前は可能で、これは以前の動作を得るためのオーバーライドを提供します。

デフォルトでは無効です。

このプロパティは QtWebEngine 1.4 で導入されました。

allowWindowActivationFromJavaScript : bool [since QtWebEngine 1.6]

JavaScriptでwindow.focus()メソッドを許可する。デフォルトでは許可されていません。

このプロパティは QtWebEngine 1.6 で導入されました。

autoLoadIconsForPage : bool [since QtWebEngine 1.3]

ウェブページのアイコンを自動的にダウンロードします。

デフォルトで有効です。

このプロパティは QtWebEngine 1.3 で導入されました。

autoLoadImages : bool

ウェブページに画像を自動的にロードする。

デフォルトで有効。

backForwardCacheEnabled : bool [since QtWebEngine 6.10]

バック/フォワードキャッシュ（またはbfcache）のサポートを有効にし、バック/フォワードナビゲーションを高速化する。

デフォルトでは無効です。

このプロパティは QtWebEngine 6.10 で導入されました。

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]

画像フレームがアニメーションのためにレンダリングされるときに、画像アニメーションがどのように処理されるかを指定します。

デフォルト値はWebEngineSettings.ImageAnimationPolicy.Allow です。

このプロパティは QtWebEngine 6.8 で導入されました。

javascriptCanAccessClipboard : bool

JavaScriptプログラムは、サニタイズされたコンテンツをクリップボードに書き込む（コピーする）ことができます。サニタイズされた書き込みは、write とwriteText JavaScript Clipboard APIコールで行われ、ユーザーアクションを伴わなければならない。

サニタイズされていない書き込みとクリップボードからの読み出しは、javascriptCanPaste で有効になります。

Chromiumバージョン81以前では、この設定によってすべてのクリップボード書き込みが有効になっていました。

クリップボードへの無制限のアクセスはセキュリティ上の潜在的な懸念事項であるため、アプリケーションはこの設定を無効にしたままにしておき、代わりにClipboardReadWrite 機能の許可要求に応答することをお勧めします。

デフォルトでは無効になっています。

javascriptCanOpenWindows : bool

JavaScriptプログラムがユーザーの操作なしにポップアップウィンドウを開くことを許可する。

デフォルトで有効です。

javascriptCanPaste : bool [since QtWebEngine 1.7]

JavaScript プログラムがクリップボードから読み込み（貼り付け）、サニタイズされていないコンテンツを書き込めるようにします。サニタイズされた書き込みは、write およびwriteText JavaScript Clipboard API 呼び出しで行われ、ユーザーアクションを伴わなければなりません。サニタイズされていない書き込みは、これらの基準を満たさない書き込みです。

この設定を有効にするには、javascriptCanAccessClipboard も有効にする必要があります。

クリップボードへの無制限のアクセスはセキュリティ上の潜在的な懸念事項であるため、アプリケーションはこれを無効のままにしておき、代わりにClipboardReadWrite 機能の許可リクエストに応答することを推奨します。

デフォルトでは無効です。

このプロパティは QtWebEngine 1.7 で導入されました。

javascriptEnabled : bool

JavaScriptプログラムの実行を有効にします。

デフォルトで有効。

linksIncludedInFocusChain : bool

キーボード・フォーカス・チェインにハイパーリンクを含める。

デフォルトで有効。

localContentCanAccessFileUrls : bool

ローカルに読み込まれたドキュメントが他のローカルURLにアクセスできるようにする。

デフォルトで有効。

localContentCanAccessRemoteUrls : bool

ローカルに読み込まれたドキュメントがリモートのURLにアクセスできるようにする。

デフォルトでは無効。

localStorageEnabled : bool

HTML 5のローカルストレージ機能のサポートを有効にします。

デフォルトで有効。

navigateOnDropEnabled : bool [since QtWebEngine 6.4]

ビューにURLをドロップすることでナビゲーションをトリガーできるように指定します。

デフォルトで有効です。

このプロパティは QtWebEngine 6.4 で導入されました。

pdfViewerEnabled : bool [since QtWebEngine 1.9]

PDF文書がダウンロードされるのではなく、内部のPDFビューアで開かれることを指定します。

デフォルトで有効。

このプロパティは QtWebEngine 1.9 で導入されました。

playbackRequiresUserGesture : bool [since QtWebEngine 1.7]

ユーザーがページを操作するまで、メディアコンテンツの再生を禁止します。

デフォルトでは、QtWebEngine は、「Autoplay Policy Changes」で説明されているように、Chromium の設定を使用します。デフォルトの動作を上書きするには、このプロパティをfalse に設定する必要があります。

このプロパティは QtWebEngine 1.7 で導入されました。

pluginsEnabled : bool

Flash Player などの Pepper プラグインのサポートを有効にします。

デフォルトでは無効です。

preferCSSMarginsForPrinting : bool [since QtWebEngine 6.9]

ウェブページを印刷する際に、デフォルトのサイズ（0, 0, 0, 0）よりもCSSマージンを優先するように設定します。

デフォルトでは無効です。

このプロパティは QtWebEngine 6.9 で導入されました。

printElementBackgrounds : bool [since QtWebEngine 1.4]

ウェブページ印刷時にCSS背景の印刷をオンにする。

デフォルトで有効です。

このプロパティは QtWebEngine 1.4 で導入されました。

printHeaderAndFooter : bool [since QtWebEngine 6.9]

印刷結果のヘッダーとフッターに、基本的なページ情報（URL、タイトル、日付、ページ番号）を表示します。適切な上下マージンを設定することにより、これらのテキストに十分なスペースを提供することは、エンベッダーの責任です。

デフォルトでは無効です。

このプロパティは QtWebEngine 6.9 で導入されました。

readingFromCanvasEnabled : bool [since QtWebEngine 6.6]

すべての canvas 要素からの読み取りを有効にします。

この設定は、オリジンに関係なくすべての HTML5 canvas 要素に影響し、canvas フィンガープリントを防ぐために無効にすることができます。

デフォルトで有効です。

このプロパティは 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

これは、左、右、上、下矢印キーを使用して、ウェブページ上のハイパーリンクやフォームコントロールなどのフォーカス可能な要素間をナビゲートする機能を意味します。

たとえば、ユーザーが Right キーを押した場合、ヒューリスティック機能により、ユーザーが右方向に到達しようとしている要素があるかどうか、また、おそらくどの要素に到達したいかが判断されます。

デフォルトでは無効になっています。

touchEventsApiEnabled : bool [since QtWebEngine 6.9]

JavaScriptのタッチイベントAPIのサポートを有効にする。つまり、ontouchstart 、ontouchend 、ontouchmove ハンドラーがdocument.window オブジェクトに存在する。

一部のウェブサイトでは、このAPIを使用してモバイル・デバイスかデスクトップ・デバイスかを判断し、それに基づいてデザインを決めていることに注意してください。このため、タッチスクリーンのノートパソコンや、偽のタッチデバイスをエミュレートするその他のセットアップでは、望ましくない結果が生じる可能性があります。

システムによってタッチデバイスが検出された場合、デフォルトで有効になり、そうでない場合は無効になります。

このプロパティは QtWebEngine 6.9 で導入されました。

touchIconsEnabled : bool [since QtWebEngine 1.3]

タッチアイコンと合成済みタッチアイコンのサポートを有効にする。

デフォルトでは無効です。

このプロパティは QtWebEngine 1.3 で導入されました。

trimAccessibilityIdentifiers : bool [since QtWebEngine 6.11]

HTML の 'id' 属性をオートメーション ID (QAccessible::Identifier) としてそのまま使用します。無効にすると、Qt はオブジェクト階層全体を識別子の前に追加します。

デフォルトでは無効です。

このプロパティは QtWebEngine 6.11 で導入されました。

unknownUrlSchemePolicy : enumeration [since QtWebEngine 1.7]

不明なスキームを持つ 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 で導入されました。