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()
現在の項目を履歴の前の項目に設定し、対応するページに移動します。
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)
Web エンジン履歴history をstream に保存します。
QDataStream &operator>>(QDataStream &stream, QWebEngineHistory &history)
ウェブエンジン履歴をstream からhistory に読み込みます。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。