## ListLevelCollection class A collection of list formatting for each level in a list. To learn more, visit the [Working with Lists](https://docs.aspose.com/words/cpp/working-with-lists/) documentation article. ```cpp class ListLevelCollection : public System::Collections::Generic::IEnumerable> ``` ## Methods | Method | Description | | --- | --- | | [begin](./begin/)() | | | [begin](./begin/)() const | | | [cbegin](./cbegin/)() const | | | [cend](./cend/)() const | | | [end](./end/)() | | | [end](./end/)() const | | | [get_Count](./get_count/)() | Gets the number of levels in this list. | | [GetEnumerator](./getenumerator/)() override | Gets the enumerator object that will enumerate levels in this list. | | [GetType](./gettype/)() const override | | | [idx_get](./idx_get/)(int32_t) | Gets a list level by index. | | [idx_set](./idx_set/)(int32_t, const System::SharedPtr\\&) | Gets a list level by index. | | [Is](./is/)(const System::TypeInfo\&) const override | | | static [Type](./type/)() | | | [virtualizeBeginConstIterator](./virtualizebeginconstiterator/)() const override | | | [virtualizeBeginIterator](./virtualizebeginiterator/)() override | | | [virtualizeEndConstIterator](./virtualizeendconstiterator/)() const override | | | [virtualizeEndIterator](./virtualizeenditerator/)() override | | ## Typedefs | Typedef | Description | | --- | --- | | [const_iterator](./const_iterator/) | | | [iterator](./iterator/) | | | [iterator_holder_type](./iterator_holder_type/) | | | [virtualized_iterator](./virtualized_iterator/) | | | [virtualized_iterator_element](./virtualized_iterator_element/) | | ## Examples Shows how to apply custom list formatting to paragraphs when using [DocumentBuilder](../../aspose.words/documentbuilder/). ```cpp auto doc = System::MakeObject(); // A list allows us to organize and decorate sets of paragraphs with prefix symbols and indents. // We can create nested lists by increasing the indent level. // We can begin and end a list by using a document builder's "ListFormat" property. // Each paragraph that we add between a list's start and the end will become an item in the list. // Create a list from a Microsoft Word template, and customize the first two of its list levels. System::SharedPtr list = doc->get_Lists()->Add(ListTemplate::NumberDefault); System::SharedPtr listLevel = list->get_ListLevels()->idx_get(0); listLevel->get_Font()->set_Color(System::Drawing::Color::get_Red()); listLevel->get_Font()->set_Size(24); listLevel->set_NumberStyle(NumberStyle::OrdinalText); listLevel->set_StartAt(21); listLevel->set_NumberFormat(u"\x0000"); listLevel->set_NumberPosition(-36); listLevel->set_TextPosition(144); listLevel->set_TabPosition(144); listLevel = list->get_ListLevels()->idx_get(1); listLevel->set_Alignment(ListLevelAlignment::Right); listLevel->set_NumberStyle(NumberStyle::Bullet); listLevel->get_Font()->set_Name(u"Wingdings"); listLevel->get_Font()->set_Color(System::Drawing::Color::get_Blue()); listLevel->get_Font()->set_Size(24); // This NumberFormat value will create star-shaped bullet list symbols. listLevel->set_NumberFormat(u"\xf0af"); listLevel->set_TrailingCharacter(ListTrailingCharacter::Space); listLevel->set_NumberPosition(144); // Create paragraphs and apply both list levels of our custom list formatting to them. auto builder = System::MakeObject(doc); builder->get_ListFormat()->set_List(list); builder->Writeln(u"The quick brown fox..."); builder->Writeln(u"The quick brown fox..."); builder->get_ListFormat()->ListIndent(); builder->Writeln(u"jumped over the lazy dog."); builder->Writeln(u"jumped over the lazy dog."); builder->get_ListFormat()->ListOutdent(); builder->Writeln(u"The quick brown fox..."); builder->get_ListFormat()->RemoveNumbers(); builder->get_Document()->Save(get_ArtifactsDir() + u"Lists.CreateCustomList.docx"); ``` Shows how to create a list style and use it in a document. ```cpp auto doc = System::MakeObject(); // A list allows us to organize and decorate sets of paragraphs with prefix symbols and indents. // We can create nested lists by increasing the indent level. // We can begin and end a list by using a document builder's "ListFormat" property. // Each paragraph that we add between a list's start and the end will become an item in the list. // We can contain an entire List object within a style. System::SharedPtr listStyle = doc->get_Styles()->Add(StyleType::List, u"MyListStyle"); System::SharedPtr list1 = listStyle->get_List(); ASSERT_TRUE(list1->get_IsListStyleDefinition()); ASSERT_FALSE(list1->get_IsListStyleReference()); ASSERT_TRUE(list1->get_IsMultiLevel()); ASPOSE_ASSERT_EQ(listStyle, list1->get_Style()); // Change the appearance of all list levels in our list. for (auto&& level : list1->get_ListLevels()) { level->get_Font()->set_Name(u"Verdana"); level->get_Font()->set_Color(System::Drawing::Color::get_Blue()); level->get_Font()->set_Bold(true); } auto builder = System::MakeObject(doc); builder->Writeln(u"Using list style first time:"); // Create another list from a list within a style. System::SharedPtr list2 = doc->get_Lists()->Add(listStyle); ASSERT_FALSE(list2->get_IsListStyleDefinition()); ASSERT_TRUE(list2->get_IsListStyleReference()); ASPOSE_ASSERT_EQ(listStyle, list2->get_Style()); // Add some list items that our list will format. builder->get_ListFormat()->set_List(list2); builder->Writeln(u"Item 1"); builder->Writeln(u"Item 2"); builder->get_ListFormat()->RemoveNumbers(); builder->Writeln(u"Using list style second time:"); // Create and apply another list based on the list style. System::SharedPtr list3 = doc->get_Lists()->Add(listStyle); builder->get_ListFormat()->set_List(list3); builder->Writeln(u"Item 1"); builder->Writeln(u"Item 2"); builder->get_ListFormat()->RemoveNumbers(); builder->get_Document()->Save(get_ArtifactsDir() + u"Lists.CreateAndUseListStyle.docx"); ``` ## See Also * Namespace [Aspose::Words::Lists](../) * Library [Aspose.Words for C++](../../)