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() の利用可能状態が変化したときに発火します。available は、ユーザーがhome() にアクセスしている場合は 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(constQUrl &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() の利用可能状態が変化したときに発火します。available は、ユーザーがbackward()に移動した後は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 プロパティで指定されたパスおよび現在のソースと同じディレクトリ内でファイルを探します。成功した場合、結果はQVariant となり、そこにはファイルの内容を含むQByteArray が格納されます。

この関数を再実装する場合、他の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() を呼び出すといったプログラムによる操作の際、あるいはユーザーがリンクをクリックしたり、対応するキーシーケンスを入力したりした際に発生します。