QTextList Class

QTextList クラスは、QTextDocument の項目の装飾されたリストを提供します。

Header:	`#include <QTextList>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Gui)` `target_link_libraries(mytarget PRIVATE Qt6::Gui)`
qmake:	`QT += gui`
Inherits:	QTextBlockGroup

継承メンバを含む全メンバ一覧
QTextListはリッチテキスト処理APIの一部です。

注意:このクラスの関数はすべてリエントラントです。

パブリック関数

void	add(const QTextBlock &block)
int	count() const
QTextListFormat	format() const
QTextBlock	item(int i) const
int	itemNumber(const QTextBlock &block) const
QString	itemText(const QTextBlock &block) const
void	remove(const QTextBlock &block)
void	removeItem(int i)
void	setFormat(const QTextListFormat &format)

詳細説明

リストには一連のテキストブロックが含まれ、各ブロックには箇条書きなどの記号が付けられています。複数のレベルのリストを使用することができ、自動番号付け機能により、数値順リストやアルファベット順リストをサポートします。

リストは、テキストカーソルを使って現在の位置に空のリストを挿入するか、既存のテキストを新しいリストに移動することによって作成されます。QTextCursor::insertList （）関数は、カーソル位置の文書に空のブロックを挿入し、それをリストの最初の項目にします。

    QTextListFormat listFormat;
    if (list) {
        listFormat = list->format();
        listFormat.setIndent(listFormat.indent() + 1);
    }

    listFormat.setStyle(QTextListFormat::ListDisc);
    cursor.insertList(listFormat);

QTextCursor::createList （）関数は、カーソルの現在のブロックの内容を取り、それを新しいリストの最初の項目にします。

カーソルの現在のリストは、QTextCursor::currentList （）で見つけることができる。

リスト内の項目数は、count （）で与えられる。各項目は、item() 関数を使用して、リスト内のインデックスで取得できる。同様に、指定した項目のインデックスはitemNumber() で求めることができる。各項目のテキストは、itemText() 関数で取得できます。

リスト内の項目は、文書内で隣接する要素とは限らないことに注意。たとえば、複数階層のリストの最上位階層の項目は、その下位階層の項目で区切られます。

リストの項目は、removeItem() 関数でインデックスごとに削除することができます。remove() は、リスト内の指定された項目を削除します。

リストの書式はsetFormat() で設定し、format() で読み込む。書式は、個々の項目ではなく、リスト自体の装飾を表します。

QTextBlock 、QTextListFormat 、QTextCursorも参照のこと。

メンバ関数ドキュメント

void QTextList::add(const QTextBlock &block)

与えられたblock をリストの一部にする。

remove() およびremoveItem()も参照 。

int QTextList::count() const

リスト内の項目数を返します。

QTextListFormat QTextList::format() const

リストの書式を返します。

setFormat()も参照 。

QTextBlock QTextList::item(int i) const

i-番目のテキスト・ブロックを返します。

count() およびitemText() も参照して ください。

int QTextList::itemNumber(const QTextBlock &block) const

指定されたblock に対応するリスト項目のインデックスを返します。そのブロックがリストに存在しない場合は -1 を返します。

QString QTextList::itemText(const QTextBlock &block) const

与えられたblock に対応するリスト項目のテキストを返します。

void QTextList::remove(const QTextBlock &block)

指定されたblock をリストから削除します。

add() およびremoveItem()も参照してください 。

void QTextList::removeItem(int i)

項目位置i にある項目をリストから削除します。リストの最後の項目が削除されると、リストを所有するQTextDocument によってリストが自動的に削除されます。

add() およびremove()も参照して ください。

void QTextList::setFormat(const QTextListFormat &format)

リストの形式をformat に設定します。

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

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。