QWebEngineProfile Class

メンバ関数のドキュメント

[explicit] QWebEngineProfile::QWebEngineProfile(QObject *parent = nullptr)

parent を親として、新しい off-the-record プロファイルを構築します。

off-the-recordプロファイルは、ローカルマシンにレコードを残さず、永続的なデータやキャッシュを持ちません。したがって，HTTPキャッシュはメモリ内にのみ存在し，クッキーは非永続的であることしかできない。これらの設定を変更しようとしても、何の効果もありません。

isOffTheRecord()も参照 。

[explicit] QWebEngineProfile::QWebEngineProfile(const QString &storageName, QObject *parent = nullptr)

ストレージ名storageName と親parent を持つ新しいプロファイルを構築します。

ストレージ名は一意でなければなりません。

ディスクベースの QWebEngineProfile は、アプリケーションの終了時に破棄する必要があります。

storageName()も参照してください 。

QString QWebEngineProfile::cachePath() const

キャッシュに使用されるパスを返します。

デフォルトでは、QtWebengine/StorageName 固有のサブディレクトリの StandardPaths::CacheLocation 以下になります。

setCachePath(),storageName(),QStandardPaths::writableLocation()も参照してください 。

void QWebEngineProfile::clearAllVisitedLinks()

訪問済みリンク・データベースからすべてのリンクを消去します。

clearVisitedLinks()も参照して ください。

void QWebEngineProfile::clearHttpCache()

プロファイルのキャッシュ・エントリを削除します。

QWebEngineProfile::clearHttpCacheCompleted()も参照してください 。

[signal, since 6.7] void QWebEngineProfile::clearHttpCacheCompleted()

このシグナルは、clearHttpCache() 操作が完了したときに発行されます。

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

QWebEngineProfile::clearHttpCache() も参照して ください。

void QWebEngineProfile::clearVisitedLinks(const QList<QUrl> &urls)

訪問済みリンクデータベースからurls のリンクを消去します。

clearAllVisitedLinks() も参照して ください。

QWebEngineClientCertificateStore *QWebEngineProfile::clientCertificateStore()

プロファイルのクライアント証明書ストアを返します。

[since 6.8] QWebEngineClientHints *QWebEngineProfile::clientHints() const

このブラウジングコンテキストに関連付けられたクライアントヒント設定を返します。

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

QWebEngineClientHintsも参照してください 。

QWebEngineCookieStore *QWebEngineProfile::cookieStore()

このプロファイルの Cookie ストアを返します。

[static] QWebEngineProfile *QWebEngineProfile::defaultProfile()

デフォルトのプロファイルを返します。

デフォルトのプロファイルは off-the-record です。

storageName()も参照して ください。

QString QWebEngineProfile::downloadPath() const

ダウンロードされたファイルが保存される場所へのパス。

setDownloadPath() およびQStandardPaths::writableLocation() も参照 。

[signal] void QWebEngineProfile::downloadRequested(QWebEngineDownloadRequest *download)

このシグナルは、ダウンロードがトリガされるたびに発行される。引数download は、ダウンロードの状態を保持する。ダウンロードは、QWebEngineDownloadRequest::accept() で明示的に受け入れられなければ、デフォルトでキャンセルされる。ダウンロード項目はプロファイルによって親にされます。ダウンロードを受け入れないと、シグナルが発せられた直後に削除されます。このシグナルは、キュー接続では使用できません。

QWebEngineDownloadRequest およびQWebEnginePage::download()も参照してください 。

QString QWebEngineProfile::httpAcceptLanguage() const

Accept-Language HTTP リクエストヘッダーフィールドの値を返します。

setHttpAcceptLanguage() も参照 。

int QWebEngineProfile::httpCacheMaximumSize() const

HTTP キャッシュの最大サイズをバイト単位で返します。

サイズがQtWebEngine で自動的に制御されている場合は0 を返します。

setHttpCacheMaximumSize() およびhttpCacheType() も参照 。

QWebEngineProfile::HttpCacheType QWebEngineProfile::httpCacheType() const

使用する HTTP キャッシュの種類を返します。

プロファイルが off-the-record の場合はMemoryHttpCache を返します。

setHttpCacheType() およびcachePath() も参照 。

QString QWebEngineProfile::httpUserAgent() const

ブラウザを識別するために HTTP で送信されるユーザーエージェント文字列を返します。

setHttpUserAgent() およびWindows アプリケーション・マニフェストも参照して ください。

void QWebEngineProfile::installUrlSchemeHandler(const QByteArray &scheme, QWebEngineUrlSchemeHandler *handler)

カスタム URL スキームscheme のハンドラhandler をプロファイルに登録します。

アプリケーションの起動時に、最初にQWebEngineUrlScheme::registerScheme にスキームを登録する必要があります。

bool QWebEngineProfile::isOffTheRecord() const

コンピュータに記録を残さないオフ・ザ・レコード・プロファイルの場合は、true を返します。

これにより、クッキーとHTTPキャッシュはメモリに保存されますが、その他の通常永続的なデータもすべてメモリに保存されます。

[since 6.5] bool QWebEngineProfile::isPushServiceEnabled() const

プッシュ・メッセージング・サービスが有効な場合は、true を返します。

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

setPushServiceEnabled()も参照してください 。

bool QWebEngineProfile::isSpellCheckEnabled() const

スペルチェッカーが有効な場合はtrue を返し、そうでない場合はfalse を返します。

setSpellCheckEnabled()も参照して ください。

[since 6.8] QList<QWebEnginePermission> QWebEngineProfile::listAllPermissions() const

QWebEnginePermission オブジェクトのQList を返します。各オブジェクトは、パーミッションストアに現在存在する単一のパーミッションを表します。返されるリストには、このプロファイルに対して過去に付与/拒否されたすべてのパーミッションが含まれます。

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

queryPermission()、QWebEnginePermission::PermissionType 、およびQWebEnginePermission::isPersistent()も参照してください 。

[since 6.8] QList<QWebEnginePermission> QWebEngineProfile::listPermissionsForOrigin(const QUrl &securityOrigin) const

QWebEnginePermission オブジェクトのQList を返します。各オブジェクトは、パーミッションストアに現在存在する1つのパーミッションを表します。返されるリストには、このプロファイルの特定のsecurityOrigin に関連付けられた、以前に付与/拒否されたすべてのパーミッションが含まれます。

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

queryPermission()、QWebEnginePermission::PermissionType 、およびQWebEnginePermission::isPersistent()も参照してください 。

[since 6.8] QList<QWebEnginePermission> QWebEngineProfile::listPermissionsForPermissionType(QWebEnginePermission::PermissionType permissionType) const

QWebEnginePermission オブジェクトのQList を返します。各オブジェクトは、パーミッションストアに現在存在する1つのパーミッションを表します。返されるリストには、提供されたpermissionType の、過去に付与/拒否されたすべてのパーミッションが含まれる。permissionTypeがnon-persistentの場合、リストは空になります。

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

queryPermission()、QWebEnginePermission::PermissionType 、およびQWebEnginePermission::isPersistent()も参照してください 。

QWebEngineProfile::PersistentCookiesPolicy QWebEngineProfile::persistentCookiesPolicy() const

永続的クッキーの現在のポリシーを返します。

プロファイルが off-the-record の場合、NoPersistentCookies が返されます。

setPersistentCookiesPolicy()も参照して ください。

[since 6.8] QWebEngineProfile::PersistentPermissionsPolicy QWebEngineProfile::persistentPermissionsPolicy() const

永続的なパーミッションに関する現在のポリシーを返します。

Off-the-Recordプロファイルは、データをディスクに保存することを許可されていないので、StoreInMemory またはAskEveryTime を返すことしかできません。

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

QWebEngineProfile::PersistentPermissionsPolicy およびsetPersistentPermissionsPolicy()も参照してください 。

QString QWebEngineProfile::persistentStoragePath() const

ブラウザとウェブコンテンツの永続データの保存に使用されるパスを返します。

永続的なデータには、永続的なクッキー、HTML5 ローカルストレージ、訪問したリンクが含まれます。

デフォルトでは、QtWebengine/StorageName 固有のサブディレクトリの QStandardPaths::DataLocation 以下になります。

setPersistentStoragePath(),storageName(),QStandardPaths::writableLocation()も参照してください 。

[since 6.8] QWebEnginePermission QWebEngineProfile::queryPermission(const QUrl &securityOrigin, QWebEnginePermission::PermissionType permissionType) const

指定されたsecurityOrigin およびpermissionType に対する単一のパーミッションに対応するQWebEnginePermission オブジェクトを返します。このオブジェクトを使用して、パーミッションの現在の状態を問い合わせたり、変更したりすることができます。パーミッションがすでに存在する必要はありません。返されたオブジェクトは、ウェブサイトがパーミッションを使用することが分かっている場合、パーミッションを事前に付与するために使用することもできます。

これを使用して、永続的でないタイプのパーミッションを事前に付与することができます。そうすることで、関連するオリジンを持つWebサイトが次にそれを要求するまで、パーミッションは許可（または拒否）された状態に保たれます。その時点で、パーミッションのライフタイムはその特定のWebページのライフタイムに関連付けられ、ナビゲートすることでパーミッションは無効になります。

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

listAllPermissions(),listPermissionsForOrigin(),listPermissionsForPermissionType(),QWebEnginePermission::PermissionTypeも参照してください 。

void QWebEngineProfile::removeAllUrlSchemeHandlers()

プロファイルにインストールされているすべてのカスタム URL スキーム ハンドラを削除します。

void QWebEngineProfile::removeUrlScheme(const QByteArray &scheme)

プロファイルからカスタム URL スキームscheme を削除します。

removeUrlSchemeHandler()も参照してください 。

void QWebEngineProfile::removeUrlSchemeHandler(QWebEngineUrlSchemeHandler *handler)

カスタム URL スキームハンドラhandler をプロファイルから削除します。

removeUrlScheme()も参照して ください。

[since 6.2] void QWebEngineProfile::requestIconForIconURL(const QUrl &url, int desiredSizeInPixel, std::function<void (const QIcon &, const QUrl &)> iconAvailableCallback) const

指定されたurl を持つアイコンをデータベースから要求します。各プロファイルには独自のアイコンデータベースがあり、永続ストレージに保存されます。アイコンをデータベースに保存するには、事前に読み込んでおく必要があります。

url はアイコンのURLを指定します。利用可能なアイコンが複数ある場合は、 に最も近いサイズのものが返されます。結果のアイコンは にリサイズされます。 desiredSizeInPixel が 0 の場合、利用可能な最大のアイコンが返されます。desiredSizeInPixel desiredSizeInPixel

この関数は非同期であり、結果はiconAvailableCallback によって返される。コールバックは、アイコンの要求が実行された場合に呼び出される。要求されたアイコンが利用可能な場合、最初のパラメータ(型はQIcon)は結果である。そうでない場合、nullである。

2番目のパラメータには、要求されたアイコンのURLが格納される。アイコンを取得できない場合は空である。

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

requestIconForPageURL()も参照してください 。

[since 6.2] void QWebEngineProfile::requestIconForPageURL(const QUrl &url, int desiredSizeInPixel, std::function<void (const QIcon &, const QUrl &, const QUrl &)> iconAvailableCallback) const

このプロファイルで以前にロードされたページのアイコンをデータベースから要求します。各プロファイルには独自のアイコンデータベースがあり、永続ストレージに保存されます。アイコンがデータベースに保存されるには、以前にロードされている必要があります。

url は、アイコンを要求するページのURLを指定します。利用可能なアイコンが複数ある場合は、 に最も近いサイズのものが返されます。結果のアイコンは にリサイズされます。 desiredSizeInPixel が 0 の場合、利用可能な最大のアイコンが返されます。desiredSizeInPixel desiredSizeInPixel

この関数は非同期であり、結果はiconAvailableCallback によって返される。コールバックは、アイコンの要求が実行された場合に呼び出される。要求されたアイコンが利用可能な場合、最初のパラメータ(型はQIcon)は結果である。そうでない場合、nullである。

2番目のパラメータには、要求されたアイコンのURLが格納される。アイコンを取得できない場合は空である。

3番目のパラメータには、アイコンが割り当てられているページのURLが格納される。

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

requestIconForIconURL()も参照してください 。

QWebEngineScriptCollection *QWebEngineProfile::scripts() const

このプロファイルを共有するすべてのページに注入されるスクリプトのコレクションを返します。

QWebEngineScriptCollection 、QWebEngineScript 、QWebEnginePage::scripts()、スクリプト・インジェクション も参照して ください。

void QWebEngineProfile::setCachePath(const QString &path)

ディスク・キャッシュに使用されるデフォルトのパスを上書きし、path に設定します。

NULL 文字列を設定すると、デフォルト・パスに戻ります。

cachePath()も参照してください 。

void QWebEngineProfile::setDownloadPath(const QString &path)

ダウンロード場所に使用されるデフォルト・パスを上書きし、path に設定します。

NULL 文字列を設定すると、デフォルトのパスが復元されます。

downloadPath() も参照して ください。

void QWebEngineProfile::setHttpAcceptLanguage(const QString &httpAcceptLanguage)

Accept-Language HTTP 要求ヘッダ・フィールドの値をhttpAcceptLanguage に設定します。

httpAcceptLanguage() も参照して ください。

void QWebEngineProfile::setHttpCacheMaximumSize(int maxSize)

HTTP キャッシュの最大サイズをmaxSize バイトに設定します。

0 に設定すると、サイズはQtWebEngine によって自動的に制御されます。

httpCacheMaximumSize() およびsetHttpCacheType() も参照して ください。

void QWebEngineProfile::setHttpCacheType(QWebEngineProfile::HttpCacheType httpCacheType)

HTTP キャッシュ・タイプをhttpCacheType に設定します。

httpCacheType()、setCachePath() およびclearHttpCache()も参照 。

void QWebEngineProfile::setHttpUserAgent(const QString &userAgent)

デフォルトのユーザエージェント文字列を上書きし、userAgent に設定します。

httpUserAgent() も参照 。

void QWebEngineProfile::setNotificationPresenter(std::function<void (std::unique_ptr<QWebEngineNotification>)> notificationPresenter)

送信された通知を表示する関数としてnotificationPresenter を設定します。

QWebEngineNotificationも参照してください 。

void QWebEngineProfile::setPersistentCookiesPolicy(QWebEngineProfile::PersistentCookiesPolicy newPersistentCookiesPolicy)

永続的クッキーのポリシーをnewPersistentCookiesPolicy に設定します。

persistentCookiesPolicy() も参照して ください。

[since 6.8] void QWebEngineProfile::setPersistentPermissionsPolicy(QWebEngineProfile::PersistentPermissionsPolicy newPersistentPermissionsPolicy)

永続的なパーミッションのポリシーをnewPersistentPermissionsPolicy に設定します。

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

QWebEngineProfile::PersistentPermissionsPolicy およびpersistentPermissionsPolicy() も参照して ください。

void QWebEngineProfile::setPersistentStoragePath(const QString &path)

永続的な Web エンジン・データの格納に使用される既定のパスを上書きします。

path に NULL 文字列が設定されると、デフォルトのパスが復元されます。

persistentStoragePath() も参照して ください。

[since 6.5] void QWebEngineProfile::setPushServiceEnabled(bool enable)

enable がtrue の場合、プッシュ・メッセージング・サービスを有効にします。

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

isPushServiceEnabled()も参照してください 。

void QWebEngineProfile::setSpellCheckEnabled(bool enable)

enable がtrue であればスペルチェッカーを有効にし、そうでなければ無効にします。

isSpellCheckEnabled()も参照 。

void QWebEngineProfile::setSpellCheckLanguages(const QStringList &languages)

スペルチェッカーの現在のリストlanguages を設定します。各言語は、.bdic 辞書の名前と一致しなければならない。たとえば、言語en-US は、en-US.bdic 辞書ファイルをロードする。

辞書ファイルの検索方法については、スペルチェッカー機能のドキュメントを参照してください。

.bdic 辞書のコンパイル方法の詳細については、「スペルチェッカーの例」を参照してください。

spellCheckLanguages()も参照して ください。

void QWebEngineProfile::setUrlRequestInterceptor(QWebEngineUrlRequestInterceptor *interceptor)

URL リクエストをインターセプトするために、リクエストインターセプターシングル トンinterceptor を登録します。

プロファイルはポインタの所有権を持ちません。

QWebEngineUrlRequestInfo およびQWebEngineUrlRequestInterceptor も参照して ください。

QWebEngineSettings *QWebEngineProfile::settings() const

このプロファイルのすべてのページのデフォルト設定を返します。

QStringList QWebEngineProfile::spellCheckLanguages() const

スペルチェッカーが使用する言語のリストを返します。

setSpellCheckLanguages()も参照して ください。

QString QWebEngineProfile::storageName() const

プロファイルのストレージ名を返します。

ストレージ名は、ディスクを使用する各プロファイルに、永続データとキャッシュ用に別々のサブディレクトリを与えるために使用されます。

const QWebEngineUrlSchemeHandler *QWebEngineProfile::urlSchemeHandler(const QByteArray &scheme) const

URL スキームscheme のカスタム URL スキームハンドラ登録を返します。

bool QWebEngineProfile::visitedLinksContainsUrl(const QUrl &url) const

url がこのプロファイルによって訪問済みリンクと見なされる場合、true を返します。