Práce Se Seznamy

Seznam v dokumentu Microsoft Word je sada vlastností formátování seznamu. Seznamy lze v dokumentech použít k formátování, uspořádání a zdůraznění textu. Seznamy jsou skvělým způsobem, jak uspořádat data v dokumentech, a čtenářům usnadňují pochopení klíčových bodů.

Každý seznam může mít až 9 úrovní a vlastnosti formátování, jako je styl čísla, počáteční hodnota, odsazení, pozice karty atd., jsou definovány samostatně pro každou úroveň.

V Aspose.Words je práce se seznamy reprezentována jmenným prostorem Lists. Objekt List však vždy patří do kolekce ListCollection.

Toto téma popisuje, jak programově pracovat se seznamy pomocí Aspose.Words.

Určení formátování pro úroveň seznamu

Objekty na úrovni seznamu se vytvářejí automaticky při vytváření seznamu. Pomocí vlastností a metod třídy ListLevel můžete řídit formátování jednotlivých úrovní seznamu.

Seznam restartu pro každou sekci

Seznam pro každou sekci můžete restartovat pomocí vlastnosti IsRestartAtEachSection. Tato možnost je podporována pouze ve formátech dokumentů RTF, DOC a DOCX. Tato volba bude zapsána do DOCX pouze v případě, že OoxmlCompliance je vyšší než Ecma376.

Následující příklad kódu ukazuje, jak vytvořit seznam a restartovat jej pro každou sekci:

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);