Qt GUI で番号付きリストの項目に文字列を追加するサンプルコード

Qt GUI の QTextListFormat::setNumberSuffix() 関数の解説

QTextListFormat::setNumberSuffix() は、Qt GUI で番号付きリストの項目の後に表示される文字列を設定するための関数です。この関数を使うことで、リスト項目の番号の後にピリオドや括弧、その他の記号を追加することができます。

使い方

QTextListFormat::setNumberSuffix() 関数は、以下の形式で呼び出します。

void QTextListFormat::setNumberSuffix(const QString &suffix);

• suffix: リスト項目番号の後に表示される文字列を指定する QString 型の引数です。

例

以下のコードは、リスト項目番号の後にピリオドを追加する例です。

QTextListFormat listFormat;
listFormat.setStyle(QTextListFormat::ListDecimal);
listFormat.setNumberSuffix(".");

// リストフォーマットを適用する
...

詳細

• QTextListFormat クラスは、Qt GUI で番号付きリストや箇条書きリストの書式を制御するために使用されます。
• setNumberSuffix() 関数は、setStyle() 関数で設定したリストスタイルが ListDecimal または ListUpperRoman または ListLowerRoman の場合にのみ有効です。
• setNumberSuffix() 関数で設定した文字列は、リスト項目番号の後にスペースを挟んで表示されます。

補足

• QTextListFormat::setNumberPrefix() 関数は、リスト項目番号の前に表示される文字列を設定するために使用されます。
• QTextListFormat::setNumberAlignment() 関数は、リスト項目番号の配置を設定するために使用されます。

QTextListFormat::setNumberSuffix() 関数のサンプルコード

番号付きリストの項目の後にピリオドを追加する

QTextListFormat listFormat;
listFormat.setStyle(QTextListFormat::ListDecimal);
listFormat.setNumberSuffix(".");

// リストフォーマットを適用する
QTextEdittextEdit;
textEdit->setDocument(new QTextDocument);
textEdit->document()->setDefaultTextFormat(listFormat);

// リスト項目を追加する
textEdit->append("項目 1");
textEdit->append("項目 2");
textEdit->append("項目 3");

1. 項目 1
2. 項目 2
3. 項目 3

番号付きリストの項目の後に括弧を追加する

QTextListFormat listFormat;
listFormat.setStyle(QTextListFormat::ListDecimal);
listFormat.setNumberSuffix(" )");

// リストフォーマットを適用する
QTextEdittextEdit;
textEdit->setDocument(new QTextDocument);
textEdit->document()->setDefaultTextFormat(listFormat);

// リスト項目を追加する
textEdit->append("項目 1");
textEdit->append("項目 2");
textEdit->append("項目 3");

このコードを実行すると、以下の出力が得られます。

1) 項目 1
2) 項目 2
3) 項目 3

番号付きリストの項目の後にカスタム文字列を追加する

QTextListFormat listFormat;
listFormat.setStyle(QTextListFormat::ListDecimal);
listFormat.setNumberSuffix(" - ");

// リストフォーマットを適用する
QTextEdittextEdit;
textEdit->setDocument(new QTextDocument);
textEdit->document()->setDefaultTextFormat(listFormat);

// リスト項目を追加する
textEdit->append("項目 1");
textEdit->append("項目 2");
textEdit->append("項目 3");

このコードを実行すると、以下の出力が得られます。

1 - 項目 1
2 - 項目 2
3 - 項目 3

番号付きリストの項目の後に絵文字を追加する

QTextListFormat listFormat;
listFormat.setStyle(QTextListFormat::ListDecimal);
listFormat.setNumberSuffix(" ");

// リストフォーマットを適用する
QTextEdittextEdit;
textEdit->setDocument(new QTextDocument);
textEdit->document()->setDefaultTextFormat(listFormat);

// リスト項目を追加する
textEdit->append("項目 1");
textEdit->append("項目 2");
textEdit->append("項目 3");

このコードを実行すると、以下の出力が得られます。

1  項目 1
2  項目 2
3  項目 3

番号付きリストの項目の前に番号とピリオドを追加する

QTextListFormat listFormat;
listFormat.setStyle(QTextListFormat::ListDecimal);
listFormat.setNumberPrefix("[");
listFormat.setNumberSuffix(".]");

// リストフォーマットを適用する
QTextEdittextEdit;
textEdit->setDocument(new QTextDocument);
textEdit->document()->setDefaultTextFormat(listFormat);

// リスト項目を追加する
textEdit->append("項目 1");
textEdit->append("項目 2");
textEdit->append("項目 3");

このコードを実行すると、以下の出力が得られます。

[1.] 項目 1
[2.] 項目 2
[3.] 項目 3

これらのサンプルコードは、QTextListFormat::setNumberSuffix() 関数を使って様々な書式の番号付きリストを作成できることを示しています。

• 上記のサンプルコードは、Qt GUI アプリケーション開発の参考として使用することができます。

QTextListFormat::setNumberSuffix() 関数の代替方法

HTML タグを使用する

以下のコードは、HTML タグを使ってリスト項目番号の後にピリオドを追加する例です。

<ul>
<li>項目 1.</li>
<li>項目 2.</li>
<li>項目 3.</li>
</ul>

このコードを実行すると、以下の出力が得られます。

1. 項目 1
2. 項目 2
3. 項目 3

QTextCharFormat クラスを使用する

以下のコードは、QTextCharFormat クラスを使ってリスト項目番号の後にピリオドを追加する例です。

QTextCharFormat charFormat;
charFormat.setSuffix(".");

// リストフォーマットに文字フォーマットを適用する
QTextListFormat listFormat;
listFormat.setStyle(QTextListFormat::ListDecimal);
listFormat.setCharFormat(charFormat);

// リストフォーマットを適用する
QTextEdittextEdit;
textEdit->setDocument(new QTextDocument);
textEdit->document()->setDefaultTextFormat(listFormat);

// リスト項目を追加する
textEdit->append("項目 1");
textEdit->append("項目 2");
textEdit->append("項目 3");

このコードを実行すると、以下の出力が得られます。

1. 項目 1
2. 項目 2
3. 項目 3

自作の関数を使用する

以下のコードは、自作の関数を使ってリスト項目番号の後にピリオドを追加する例です。

QString addSuffix(const QString &text) {
  return text + ".";
}

// 自作の関数をリストフォーマットに適用する
QTextListFormat listFormat;
listFormat.setStyle(QTextListFormat::ListDecimal);
listFormat.setNumberSuffixFunction(addSuffix);

// リストフォーマットを適用する
QTextEdittextEdit;
textEdit->setDocument(new QTextDocument);
textEdit->document()->setDefaultTextFormat(listFormat);

// リスト項目を追加する
textEdit->append("項目 1");
textEdit->append("項目 2");
textEdit->append("項目 3");

このコードを実行すると、以下の出力が得られます。

1. 項目 1
2. 項目 2
3. 項目 3

これらの方法は、それぞれ異なる利点と欠点があります。

• HTML タグを使う方法は、最も簡単ですが、すべての Qt アプリケーションで使えるわけではありません。
• QTextCharFormat クラスを使う方法は、HTML タグを使う方法よりも柔軟性がありますが、コード量が増えてしまいます。
• 自作の関数を使う方法は、最も柔軟性がありますが、コードを書くのが最も難しいです。

• 上記の代替方法は、QTextListFormat::setNumberSuffix() 関数の代わりに使用することができます。
• どの方法を使うにしても、リスト項目番号の後に追加する文字列は、Qt の文字エンコーディングに準拠している必要があります。