QWebEngineHistory Class

QWebEngineHistory クラスは、ウェブエンジンページの履歴を表します。詳細...

Header: #include <QWebEngineHistory>
CMake: find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake: QT += webenginecore
In QML: WebEngineHistory
Inherits: QObject

パブリック関数

void back()
QWebEngineHistoryItem backItem() const
QList<QWebEngineHistoryItem> backItems(int maxItems) const
QWebEngineHistoryModel *backItemsModel() const
bool canGoBack() const
bool canGoForward() const
void clear()
int count() const
QWebEngineHistoryItem currentItem() const
int currentItemIndex() const
void forward()
QWebEngineHistoryItem forwardItem() const
QList<QWebEngineHistoryItem> forwardItems(int maxItems) const
QWebEngineHistoryModel *forwardItemsModel() const
void goToItem(const QWebEngineHistoryItem &item)
QWebEngineHistoryItem itemAt(int i) const
QList<QWebEngineHistoryItem> items() const
QWebEngineHistoryModel *itemsModel() const
QDataStream &operator<<(QDataStream &stream, const QWebEngineHistory &history)
QDataStream &operator>>(QDataStream &stream, QWebEngineHistory &history)

詳細説明

各ウェブエンジンページには、QWebEnginePage::history() によってアクセスできる、訪問したページの履歴が含まれています。

この履歴は、back() とforward() 関数を使用して前後にナビゲートすることで、訪問したページを訪問可能なページに分割し、現在のアイテムの概念を使用しています。カレント・アイテムはcurrentItem() を呼び出すことで取得でき、ヒストリ内の任意のアイテムをgoToItem() に渡すことでカレント・アイテムにすることができる。

また、backItems ()関数を呼び出すことで、遡ることで訪問可能なページを記述したアイテムのリストを取得することができる。同様に、forwardItems ()関数を呼び出すことで、現在のページより先のページを記述したアイテムを取得することができる。全項目リストは、items ()関数で得られる。

また、以下のQWebEngineHistoryModel データモデル・オブジェクトが用意されている:

  • backItemsModel()訪問したページのURLが格納されている。
  • forwardItemsModel()現在のページを訪問した後に訪問したページのURLを含む。
  • itemsModel()これは、現在のページのURLだけでなく、戻る項目と進む項目のURLを含んでいます。

コンテナと同じように、履歴をリスト形式で調べる関数も用意されている。履歴の任意の項目はitemAt() で取得でき、項目の総数はcount() で与えられ、履歴はclear() 関数でクリアできます。

QWebEngineHistory の状態は、>> 演算子を使用してQDataStream に保存でき、<< 演算子を使用してロードできます。

QWebEngineHistoryItem およびQWebEnginePageも参照して ください。

メンバ関数ドキュメント

void QWebEngineHistory::back()

現在の項目を履歴の前の項目に設定し、対応するページに移動します。

forward() およびgoToItem()も参照

QWebEngineHistoryItem QWebEngineHistory::backItem() const

現在の項目の前の項目を返します。

QList<QWebEngineHistoryItem> QWebEngineHistory::backItems(int maxItems) const

後方履歴リスト内の項目のリストを返します。返される項目は最大でもmaxItems 件です。

forwardItems()も参照

QWebEngineHistoryModel *QWebEngineHistory::backItemsModel() const

訪問したページの URL を表すデータ・モデルを返す。

注釈: プロパティbackItems に対するゲッター関数。

bool QWebEngineHistory::canGoBack() const

現在の項目の前に履歴の項目がある場合はtrue を返し、そうでない場合はfalse を返す。

canGoForward()も参照してください

bool QWebEngineHistory::canGoForward() const

前に進む項目があればtrue を返し、なければfalse を返す。

canGoBack() も参照

[invokable] void QWebEngineHistory::clear()

履歴を消去する。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

count() およびitems() も参照

int QWebEngineHistory::count() const

履歴項目の総数を返します。

QWebEngineHistoryItem QWebEngineHistory::currentItem() const

履歴の現在の項目を返します。

int QWebEngineHistory::currentItemIndex() const

履歴内の現在の項目のインデックスを返します。

void QWebEngineHistory::forward()

現在の項目をヒストリ内の次の項目に設定し、対応するページに移動します。

back() およびgoToItem()も参照

QWebEngineHistoryItem QWebEngineHistory::forwardItem() const

現在の項目の次の項目を返します。

QList<QWebEngineHistoryItem> QWebEngineHistory::forwardItems(int maxItems) const

前方履歴リストの項目のリストを返します。返される項目は最大でmaxItems 個です。

backItems()も参照

QWebEngineHistoryModel *QWebEngineHistory::forwardItemsModel() const

現在のページを訪問した後に訪問したページの URL を表すデータ・モデルを返します。

注釈: プロパティforwardItems のゲッター関数。

void QWebEngineHistory::goToItem(const QWebEngineHistoryItem &item)

現在の項目を履歴の指定されたitem に設定し、そのページに移動する。

back() およびforward()も参照

QWebEngineHistoryItem QWebEngineHistory::itemAt(int i) const

履歴のインデックスi にある項目を返します。

QList<QWebEngineHistoryItem> QWebEngineHistory::items() const

現在ヒストリにあるすべての項目のリストを返します。

count() およびclear() も参照 ください。

QWebEngineHistoryModel *QWebEngineHistory::itemsModel() const

データ・モデルを返します。このデータ・モデルは、ヒストリ内の戻るアイテム、進むアイテム、および現在のアイテムの URL を表します。

注釈: プロパティitems のゲッター関数。

関連する非メンバー

QDataStream &operator<<(QDataStream &stream, const QWebEngineHistory &history)

Web エンジン履歴historystream に保存します。

QDataStream &operator>>(QDataStream &stream, QWebEngineHistory &history)

ウェブエンジン履歴をstream からhistory に読み込みます。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。