officefileapi-devexpress-dot-xtrarichedit-dot-api-dot-native-dot-abstractnumberinglistcollection.md
Creates a new AbstractNumberingList object and adds it to the collection.
Namespace : DevExpress.XtraRichEdit.API.Native
Assembly : DevExpress.RichEdit.v25.2.Core.dll
NuGet Package : DevExpress.RichEdit.Core
AbstractNumberingList Add()
Function Add As AbstractNumberingList
| Type | Description |
|---|---|
| AbstractNumberingList |
An AbstractNumberingList interface specifying base list format options.
|
Use the Add method to create a pattern for bulleted, numbered or multilevel list. The NumberingListBase.NumberingType property define the list type.
The NumberingListBase.Levels obtains list levels. A list has 9 levels regardless of its type. Use ListLevel.ParagraphProperties and ListLevel.CharacterProperties properties to access list marker’s format options.
Document document = server.Document;
document.BeginUpdate();
// Create a new list pattern object
AbstractNumberingList list = document.AbstractNumberingLists.Add();
//Specify the list's type
list.NumberingType = NumberingType.Bullet;
ListLevel level = list.Levels[0];
//Set the left indent of the list
level.ParagraphProperties.LeftIndent = 100;
//Specify the bullets' format
//Without this step, the list is considered as numbered
level.DisplayFormatString = "\u00B7";
level.CharacterProperties.FontName = "Symbol";
//Create a new list based on the specific pattern
NumberingList bulletedList = document.NumberingLists.Add(0);
// Add paragraphs to the list
ParagraphCollection paragraphs = document.Paragraphs;
paragraphs.AddParagraphsToList(document.Range, bulletedList, 0);
document.EndUpdate();
Dim document As Document = server.Document
document.BeginUpdate()
' Create a new list pattern objects
Dim list As AbstractNumberingList = document.AbstractNumberingLists.Add()
' Specify the list's type
list.NumberingType = NumberingType.Bullet
Dim level As ListLevel = list.Levels(0)
' Set the left indent of the list
level.ParagraphProperties.LeftIndent = 100
' Specify the bullet's format
' Without this step, the list is considered as numbered
level.DisplayFormatString = "·"
level.CharacterProperties.FontName = "Symbol"
' Create a new list based on the specific pattern
Dim bulletedList as NumberingList = document.NumberingLists.Add(0)
' Add paragraphs to the list
Dim paragraphs As ParagraphCollection = document.Paragraphs
paragraphs.AddParagraphsToList(document.Range, bulletedList, 0)
document.EndUpdate()
The following code snippets (auto-collected from DevExpress Examples) contain references to the Add() method.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.
winforms-richedit-document-api/CS/RichEditAPISample/CodeExamples/List.cs#L19
// Create a new list pattern object
AbstractNumberingList list = document.AbstractNumberingLists.Add();
wpf-richedit-document-api/CS/DXRichEditControlAPISample/CodeExamples/ListActions.cs#L19
// Create a new list pattern object
AbstractNumberingList list = document.AbstractNumberingLists.Add();
word-document-api-examples/CS/CodeExamples/ListsActions.cs#L29
// Create a new list pattern object.
AbstractNumberingList list = document.AbstractNumberingLists.Add();
winforms-richedit-document-api/VB/RichEditAPISample/CodeExamples/List.vb#L17
' Create a new list pattern object
Dim list As DevExpress.XtraRichEdit.API.Native.AbstractNumberingList = document.AbstractNumberingLists.Add()
'Specify the list's type
wpf-richedit-document-api/VB/DXRichEditControlAPISample/CodeExamples/ListActions.vb#L16
' Create a new list pattern object
Dim list As AbstractNumberingList = document.AbstractNumberingLists.Add()
word-document-api-examples/VB/CodeExamples/ListsActions.vb#L28
' Create a new list pattern object.
Dim list As DevExpress.XtraRichEdit.API.Native.AbstractNumberingList = document.AbstractNumberingLists.Add()
' Specify the list type.
See Also
AbstractNumberingListCollection Interface