QWebEngineHistory Class
QWebEngineHistory クラスは、ウェブエンジンページの履歴を表します。詳細...
| ヘッダー | #include <QWebEngineHistory> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake | QT += webenginecore |
| QML で | WebEngineHistory |
| 継承： | 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()
現在の項目を履歴の前の項目に設定し、対応するページに移動する。
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 を参照してください。
int QWebEngineHistory::count() const
履歴にあるアイテムの総数を返します。
QWebEngineHistoryItem QWebEngineHistory::currentItem() const
履歴の現在の項目を返します。
int QWebEngineHistory::currentItemIndex() const
履歴の現在の項目のインデックスを返します。
void QWebEngineHistory::forward()
現在の項目を履歴の次の項目に設定し、対応するページに移動する。
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 に設定し、そのページに移動する。
QWebEngineHistoryItem QWebEngineHistory::itemAt(int i) const
履歴のインデックスi にある項目を返します。
QList<QWebEngineHistoryItem> QWebEngineHistory::items() const
現在履歴にあるすべての項目の一覧を返します。
QWebEngineHistoryModel *QWebEngineHistory::itemsModel() const
戻るアイテム、進むアイテム、履歴の現在のアイテムの URL を表すデータモデルを返す。
注: プロパティのゲッター関数items 。
関連する非会員
QDataStream &operator<<(QDataStream &stream, const QWebEngineHistory &history)
ウェブエンジン履歴history をstream に保存する。
QDataStream &operator>>(QDataStream &stream, QWebEngineHistory &history)
ウェブエンジンの履歴をstream からhistory にロードする。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
