Back to Qt.io
Contact Us Blog Download Qt

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

현재 항목을 기록의 이전 항목으로 설정하고 해당 페이지로 이동합니다. 즉, 기록 항목 하나를 거슬러 올라갑니다.

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)

웹 엔진 기록 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.