QTextBlock Class

メンバ関数 ドキュメント

QTextBlock::QTextBlock(const QTextBlock &other)

other テキストブロックの属性をこのテキストブロックにコピーします。

QTextBlock::iterator QTextBlock::begin() const

テキストブロックの先頭を指すテキストブロックイテレータを返します。

end()も参照してください 。

QTextBlockFormat QTextBlock::blockFormat() const

ブロック固有のプロパティを記述したQTextBlockFormat を返します。

charFormat()も参照して ください。

int QTextBlock::blockFormatIndex() const

テキス ト ブ ロ ッ ク の形式に対す る ブ ロ ッ ク 書式の文書内部 リ ス ト 内への イ ンデ ッ ク ス を返 し ます。

QTextDocument::allFormats()も参照 。

int QTextBlock::blockNumber() const

このブロックの番号を返し、ブロックが無効な場合は -1 を返します。

QTextCursor::blockNumber() も参照 。

QTextCharFormat QTextBlock::charFormat() const

ブロックの文字書式を表すQTextCharFormat を返します。ブロックの文字書式は、空のブロックにテキストを挿入するときに使用されます。

blockFormat() も参照して ください。

int QTextBlock::charFormatIndex() const

テキス ト ブ ロ ッ ク の文字形式に対す る 、 文書内部の文字形式 リ ス ト への イ ンデ ッ ク ス を返 し ます。

QTextDocument::allFormats()も参照 。

void QTextBlock::clearLayout()

ブロックの内容のレイアウトや表示に使用するQTextLayout をクリアします。

layout()も参照 。

bool QTextBlock::contains(int position) const

与えられたposition がテキストブロック内にあればtrue を返し、なければfalse を返します。

const QTextDocument *QTextBlock::document() const

こ のテ キ ス ト ブ ロ ッ ク が属 し てい る テ キ ス ト 文書を返 し 、 テ キ ス ト ブ ロ ッ ク が ど の文書に も 属 し ていない と き はnullptr を返 し ます。

QTextBlock::iterator QTextBlock::end() const

テ キ ス ト ブ ロ ッ ク の末尾を指 し 示す テ キ ス ト ブ ロ ッ ク イ テ レー タ を返 し ます。

begin()、next()、previous()も参照 。

int QTextBlock::firstLineNumber() const

このブロックの最初の行番号、またはブロックが無効な場合は -1 を返します。レイアウトがサポートしていない限り、行番号はブロック番号と同じです。

QTextBlock::blockNumber()も参照 。

bool QTextBlock::isValid() const

このテキストブロックが有効な場合はtrue を返し、そうでない場合はfalse を返す。

bool QTextBlock::isVisible() const

ブロックが表示されている場合はtrue を返し、そうでない場合はfalse を返します。

setVisible()も参照 。

QTextLayout *QTextBlock::layout() const

ブロックの内容をレイアウトして表示するために使用されるQTextLayout を返します。

返されたQTextLayout オブジェクトは、QAbstractTextDocumentLayout サブクラスの documentChanged 実装からのみ変更できることに注意してください。外部からの変更は未定義の振る舞いを引き起こします。

clearLayout()も参照してください 。

int QTextBlock::length() const

ブロックの長さを文字数で返します。

text()、charFormat()、blockFormat() も参照 。

int QTextBlock::lineCount() const

行数を返します。すべての文書レイアウトがこの機能をサポートしているわけではありません。

setLineCount() も参照 。

QTextBlock QTextBlock::next() const

このブロックの後にある文書内のテキストブロック、あるいはこれが最後のブロックの場合は空のテキストブロックを返します。

次のブロックは、このブロックとは別のフレームやテーブルにある可能性があることに注意しましょう。

previous()、begin()、end()も参照 。

int QTextBlock::position() const

ドキュメント内のブロックの最初の文字のインデックスを返します。

QTextBlock QTextBlock::previous() const

このブロックの前にある文書内のテキストブロック、またはこれが最初のブロックの場合は空のテキストブロックを返します。

前のブロックは、このブロックとは別のフレームやテーブル内にある可能性があることに注意しましょう。

next()、begin()、end()も参照 。

int QTextBlock::revision() const

ブロックのリビジョンを返します。

setRevision() およびQTextDocument::revision() も参照 。

void QTextBlock::setLineCount(int count)

行数をcount に設定します。

lineCount() も参照 。

void QTextBlock::setRevision(int rev)

ブロック・リビジョンをrev に設定します。

revision() およびQTextDocument::revision() も参照 。

void QTextBlock::setUserData(QTextBlockUserData *data)

与えられたdata オブジェクトをテキスト・ブロックにアタッチします。

QTextBlockUserData は、カスタム設定を保存するために使用できます。すなわち、 与えた オブジ ェ ク ト は、 対応す る テ キ ス ト ブ ロ ッ ク が削除 さ れた場合には削除 さ れます。ユーザーデー タ オブジ ェ ク ト は元に戻 し 履歴に格納 さ れませんので、 テ キ ス ト ブ ロ ッ ク の削除を元に戻 し て も 利用可能にはな り ません。QTextBlockUserData

例えば、IDEでプログラミング・エディタを書いている場合、統合デバッガのためにユーザーがコードに視覚的にブレークポイントを設定できるようにしたいと思うかもしれません。プログラミング・エディタでは、1行のテキストは通常1つのQTextBlock に相当します。QTextBlockUserData インタフェースにより、開発者はQTextBlock ごとにデータを保存することができます。たとえば、ユーザーがソース・コードのどの行にブレークポイントを設定しているかなどを保存できます。もちろん、これは外部に保存することもできますが、QTextDocument の内部に保存することで、たとえばユーザーが関連する行を削除したときに自動的に削除されます。これは、QTextFormat のカスタムプロパティを使用することなく、QTextDocument にカスタム情報を保存する方法です。

userData()も参照のこと 。

void QTextBlock::setUserState(int state)

指定されたstate 整数値をテキストブロックに格納します。これは、たとえばシンタックス・ハイライタでテキストの解析状態を保存するのに便利です。

userState()も参照 。

void QTextBlock::setVisible(bool visible)

ブロックの可視性をvisible に設定します。

isVisible() も参照 。

QString QTextBlock::text() const

ブロックの内容をプレーン・テキストとして返します。

length()、charFormat() およびblockFormat() も参照 。

Qt::LayoutDirection QTextBlock::textDirection() const

解決されたテキストの方向を返します。

ブロックに明示的な方向が設定されていない場合は、ブロックの内容から方向を解決します。Qt::LeftToRight あるいはQt::RightToLeft のいずれかを返します。

QTextFormat::layoutDirection()、QString::isRightToLeft()、Qt::LayoutDirectionも参照 。

QList<QTextLayout::FormatRange> QTextBlock::textFormats() const

ブロックのテキスト書式オプションを、QTextCharFormat の連続した範囲のリストとして返します。範囲の文字書式は、範囲の境界内にテキストを挿入するときに使用されます。

charFormat() およびblockFormat()も参照 。

QTextList *QTextBlock::textList() const

ブロックがリスト項目を表している場合は、その項目が属するリストを返します。そうでない場合はnullptr を返します。

QTextBlockUserData *QTextBlock::userData() const

setUserData() でQTextBlockUserData オブジェクトが設定されている場合はそのオブジェクトへのポインタを、nullptr で設定されている場合はそのオブジェクトへのポインタを返す。

setUserData()も参照 。

int QTextBlock::userState() const

setUserState() で設定した整数値または -1 を返します。

setUserState()も参照 。

bool QTextBlock::operator!=(const QTextBlock &other) const

このテキスト・ブロックがother テキスト・ブロックと異なる場合はtrue を返します。

bool QTextBlock::operator<(const QTextBlock &other) const

こ のテ キ ス ト ブ ロ ッ ク が文書内でother テ キ ス ト ブ ロ ッ ク よ り 前にあ る と き はtrue を返す。

QTextBlock &QTextBlock::operator=(const QTextBlock &other)

other テキストブロックをこのテキストブロックに割り当てます。

bool QTextBlock::operator==(const QTextBlock &other) const

このテキストブロックがother テキストブロックと同じ場合はtrue を返します。