リストの操作

Microsoft Wordドキュメント内のリストは、リストの書式設定プロパティのセットです。 リストは、書式設定、配置、およびテキストを強調するためにあなたの文書で使用することができます。 リストは、ドキュメント内のデータを整理するための優れた方法であり、読者が重要なポイントを理解しやすくします。

各リストは9レベルまで持つことができ、数値スタイル、開始値、インデント、タブ位置などの書式設定プロパティはレベルごとに個別に定義されます。

Aspose.Wordsでは、リストの操作はLists名前空間で表されます。 ただし、Listオブジェクトは常にListCollectionコレクションに属します。

このトピックでは、Aspose.Wordsを使用してリストをプログラムで操作する方法について説明します。

リストレベルの書式設定の指定

リストレベルのオブジェクトは、リストの作成時に自動的に作成されます。 リストの個々のレベルの書式設定を制御するには、ListLevelクラスのプロパティとメソッドを使用します。

各セクションのリストを再起動します

IsRestartAtEachSectionプロパティを使用して、各セクションのリストを再起動できます。 このオプションは、RTF、DOC、DOCXのドキュメント形式でのみサポートされています。 このオプションは、OoxmlComplianceがEcma376よりも高い場合にのみDOCXに書き込まれます。

次のコード例は、リストを作成して各セクションで再起動する方法を示しています:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
System::SharedPtr<Document> doc = System::MakeObject<Document>();

doc->get_Lists()->Add(ListTemplate::NumberDefault);

System::SharedPtr<List> list = doc->get_Lists()->idx_get(0);

// Set true to specify that the list has to be restarted at each section.
list->set_IsRestartAtEachSection(true);

System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);

builder->get_ListFormat()->set_List(list);

for (int32_t i = 1; i < 45; i++)
{
    builder->Writeln(System::String::Format(u"List Item {0}", i));

    // Insert section break.
    if (i == 15)
    {
        builder->InsertBreak(BreakType::SectionBreakNewPage);
    }
}

// IsRestartAtEachSection will be written only if compliance is higher then OoxmlComplianceCore.Ecma376
System::SharedPtr<OoxmlSaveOptions> options = System::MakeObject<OoxmlSaveOptions>();
options->set_Compliance(OoxmlCompliance::Iso29500_2008_Transitional);

System::String outputPath = outputDataDir + u"WorkingWithList.SetRestartAtEachSection.docx";

// Save the document to disk.
doc->Save(outputPath, options);