QTextBrowser Class

멤버 함수 설명서

[explicit] QTextBrowser::QTextBrowser(QWidget *parent = nullptr)

parent 를 부모로 하는 빈 QTextBrowser를 생성합니다.

[signal] void QTextBrowser::anchorClicked(const QUrl &link)

사용자가 앵커를 클릭하면 이 신호가 발생합니다. 앵커가 가리키는 URL은 ` link`에 전달됩니다.

openLinks 속성이 false로 설정되어 있거나, 연결된 슬롯에서 setSource()을 호출하지 않는 한, 브라우저는 link 로 지정된 위치로의 이동을 자동으로 처리합니다. 이 메커니즘은 브라우저의 기본 탐색 기능을 재정의하는 데 사용됩니다.

[virtual slot] void QTextBrowser::backward()

링크를 따라 이동하여 생성된 문서 목록에서 현재 표시된 문서를 이전 문서로 변경합니다. 이전 문서가 없는 경우에는 아무 작업도 수행하지 않습니다.

forward() 및 backwardAvailable()도 참조하십시오 .

[signal] void QTextBrowser::backwardAvailable(bool available)

이 신호는 backward()의 사용 가능 여부가 변경될 때 발생합니다. 사용자가 home()에 있을 때는 available 가 false이며, 그렇지 않은 경우에는 true입니다.

int QTextBrowser::backwardHistoryCount() const

기록에서 뒤로 거슬러 올라가는 위치의 수를 반환합니다.

void QTextBrowser::clearHistory()

방문한 문서의 기록을 삭제하고 앞/뒤로 이동 기능을 비활성화합니다.

backward() 및 forward()도 참조하십시오 .

[virtual protected] void QTextBrowser::doSetSource(const QUrl &url, QTextDocument::ResourceType type = QTextDocument::UnknownResource)

지정된 url 에서 지정된 type 를 사용하여 문서를 불러오려고 시도합니다.

setSource()는 doSetSource를 호출합니다. Qt 5에서는 setSource(const QUrl &url)이 가상 메서드였습니다. Qt 6에서는 대신 doSetSource()가 가상 메서드가 되어 하위 클래스에서 재정의할 수 있게 되었습니다.

[override virtual protected] bool QTextBrowser::event(QEvent *e)

QAbstractScrollArea::event(QEvent *event)를 재구현합니다.

[override virtual protected] bool QTextBrowser::focusNextPrevChild(bool next)

QTextEdit::focusNextPrevChild(bool next)를 재구현합니다.

[override virtual protected] void QTextBrowser::focusOutEvent(QFocusEvent *ev)

QTextEdit::focusOutEvent(QFocusEvent *e)를 재구현합니다.

[virtual slot] void QTextBrowser::forward()

링크를 따라 이동하여 생성된 문서 목록에서 현재 표시된 문서를 다음 문서로 변경합니다. 다음 문서가 없는 경우에는 아무 작업도 수행하지 않습니다.

backward() 및 forwardAvailable()도 참조하십시오 .

[signal] void QTextBrowser::forwardAvailable(bool available)

이 신호는 ‘ forward ’()의 가용성 상태가 변경될 때 발송됩니다. 사용자가 ‘ backward ’()로 이동한 후에는 ‘ available ’가 true가 되고, 사용자가 ‘ forward ’()로 이동하거나 해당 페이지를 닫으면 false가 됩니다.

int QTextBrowser::forwardHistoryCount() const

기록에서 앞으로 이동할 위치 수를 반환합니다.

[signal] void QTextBrowser::highlighted(const QUrl &link)

이 신호는 사용자가 문서 내의 앵커를 선택했으나 활성화하지는 않은 경우에 발생합니다. 해당 앵커가 가리키는 URL은 ` link`에 전달됩니다.

[signal] void QTextBrowser::historyChanged()

이 신호는 기록이 변경될 때 발생합니다.

historyTitle() 및 historyUrl()도 참조하십시오 .

QString QTextBrowser::historyTitle(int i) const

HistoryItem의 documentTitle()을 반환합니다.

backaction.setToolTip(browser.historyTitle(-1));
forwardaction.setToolTip(browser.historyTitle(+1));

QUrl QTextBrowser::historyUrl(int i) const

HistoryItem의 URL을 반환합니다.

[virtual slot] void QTextBrowser::home()

표시된 문서를 기록의 첫 번째 문서로 변경합니다.

bool QTextBrowser::isBackwardAvailable() const

텍스트 브라우저가 backward()를 사용하여 문서 기록을 뒤로 되돌릴 수 있는 경우 true 를 반환합니다.

backwardAvailable() 및 backward()도 참조하십시오 .

bool QTextBrowser::isForwardAvailable() const

텍스트 브라우저가 forward()을 사용하여 문서 기록을 앞으로 이동할 수 있는 경우 true 를 반환합니다.

forwardAvailable() 및 forward()도 참조하십시오 .

[override virtual protected] void QTextBrowser::keyPressEvent(QKeyEvent *ev)

QTextEdit::keyPressEvent(QKeyEvent *e)를 재구현합니다.

ev 이벤트는 다음 키보드 단축키를 제공하는 데 사용됩니다:

[override virtual] QVariant QTextBrowser::loadResource(int type, const QUrl &name)

QTextEdit::loadResource(int type, const QUrl &name)를 재구현합니다.

이 함수는 문서가 로드될 때 및 문서 내의 각 이미지에 대해 호출됩니다. ` type `는 로드될 리소스의 유형을 나타냅니다. 리소스를 로드할 수 없는 경우 유효하지 않은 ` QVariant `가 반환됩니다.

기본 구현은 type 를 무시하고, name 를 파일 이름으로 해석하여 리소스의 위치를 찾으려고 시도합니다. 절대 경로가 아닌 경우, searchPaths 속성의 경로와 현재 소스 파일과 동일한 디렉터리에서 파일을 찾으려고 시도합니다. 성공하면, 파일의 내용을 담은 QByteArray 를 저장하는 QVariant 가 반환됩니다.

이 함수를 재구현하는 경우, 다른 QVariant 유형을 반환할 수 있습니다. 아래 표는 리소스 유형에 따라 지원되는 변형 유형을 보여줍니다:

[override virtual protected] void QTextBrowser::mouseMoveEvent(QMouseEvent *e)

QTextEdit::mouseMoveEvent(QMouseEvent *e)를 재구현합니다.

[override virtual protected] void QTextBrowser::mousePressEvent(QMouseEvent *e)

QTextEdit::mousePressEvent(QMouseEvent *e)를 재구현합니다.

[override virtual protected] void QTextBrowser::mouseReleaseEvent(QMouseEvent *e)

QTextEdit::mouseReleaseEvent(QMouseEvent *e)를 재구현합니다.

[override virtual protected] void QTextBrowser::paintEvent(QPaintEvent *e)

QTextEdit::paintEvent(QPaintEvent *event)을 재구현합니다.

[virtual slot] void QTextBrowser::reload()

현재 설정된 소스를 다시 불러옵니다.

[slot] void QTextBrowser::setSource(const QUrl &url, QTextDocument::ResourceType type = QTextDocument::UnknownResource)

지정된 type 를 사용하여 url 에 있는 문서를 불러오려고 시도합니다.

type 가 UnknownResource (기본값)인 경우, 문서 유형이 자동으로 감지됩니다. 즉, URL이 .md, .mkd 또는 .markdown 확장자로 끝나는 경우 문서는 QTextDocument::setMarkdown()를 통해 로드되며, 그렇지 않은 경우 QTextDocument::setHtml()를 통해 로드됩니다. 이 감지 기능을 우회하려면 type 을 명시적으로 지정하면 됩니다.

source()도 참조하십시오 .

[signal] void QTextBrowser::sourceChanged(const QUrl &src)

이 신호는 소스가 변경되었을 때 발생하며, src 이 새로운 소스입니다.

소스 변경은 setSource(), forward(), backward() 또는 home()을 호출하는 프로그래밍 방식의 경우뿐만 아니라, 사용자가 링크를 클릭하거나 이에 상응하는 키 조합을 누를 때에도 발생합니다.