MailMergeOptions.NumberedListRestart Property
Sets the behavior of numbered lists when the mail merge operation is performed.
Namespace: DevExpress.XtraRichEdit.API.Native
Assembly: DevExpress.RichEdit.v23.2.Core.dll
NuGet Packages: DevExpress.RichEdit.Core, DevExpress.Win.Navigation
Declaration
Property Value
| Type | Description |
|---|---|
| MailMergeNumberingRestart | An enumeration value that indicates the numbering list restart mode. |
Available values:
| Name | Description |
|---|---|
| None | Continue the list numbering unless otherwise specified in the list settings (e.g, when a specific numbered list is manually restarted). |
| Always | Restart a numbered list for each record. |
| AlwaysExceptParagraphStyles | Restart the numbered list for each record, but ignore lists that are created by applying paragraph styles with numbering (e.g., “Chapter 1”, “Chapter 2”, etc.). |
Remarks
To restart a numbered list for each record in a mail merge document, set this property to the Always or AlwaysExceptParagraphStyles.
Note
When you work with large data sources, the NumberedListRestart property usage may result in a performance degradation. If your usage scenario requires the NumberedListRestart property, divide your data source into batches and use these parts in the mail merge process to obtain separate documents with small parts of your data source. You can use the FirstRecordIndex and LastRecordIndex properties to complete the task.