QWebEngineProfile Class

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

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

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

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()

このプロファイルのクッキーストアを返します。

[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

コンピュータに記録を残さないoff-the-recordプロファイルの場合、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 を返します。各オブジェクトは、パーミッションストアに現在存在する単一のパーミッションを表します。返されるリストには、このプロファイルの特定のsecurityOrigin に関連付けられた、以前に付与/拒否されたすべてのパーミッションが含まれます。

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

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

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

QWebEnginePermission オブジェクトのQList を返す。各オブジェクトは、パーミッションストアに現 在存する単一のパーミッションを表す。返されるリストには、提供された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 を返す。