Styling Table of Contents with Multilevel List Numbering in Telerik WordsProcessing
Environment
| Version | Product | Author |
|---|---|---|
| 2025.3.806 | RadWordsProcessing | Yoan Karamanov |
Description
This article describes how to apply multilevel list numbering and other specific styles to each level of Table Of Contents (TOC) in a DOCX document, such as font size, indentations, and font weight.
This knowledge base article also answers the following questions:
- How to add multilevel list numbering to a TOC in Telerik WordsProcessing?
- How to customize TOC level styles programmatically?
- How to use ParagraphProperties and CharacterProperties to style a TOC?
Solution
To achieve a multilevel list numbering in your Table Of Contents (TOC) and apply custom styles to each level, follow these steps:
- Set the
NumberingFieldsProviderfor the hierarchical numbering functionality. - Load your document using the
DocxFormatProvider. - Add a table of contents field using the
RadFlowDocumentEditor. - Configure hierarchical numbering by adding a list of type
NumberedHierarchical. - Style each TOC level by specifying its properties using
ParagraphPropertiesandCharacterProperties.
Implementation
using System;
using System.IO;
using System.Diagnostics;
using Telerik.Windows.Documents.Flow.Model;
using Telerik.Windows.Documents.Flow.FormatProviders.Docx;
using Telerik.Windows.Documents.Flow.Extensibility;
FlowExtensibilityManager.NumberingFieldsProvider = new Telerik.Windows.Documents.Flow.FormatProviders.Pdf.NumberingFieldsProvider();
RadFlowDocument flowDocument;
DocxFormatProvider docxFormatProvider = new DocxFormatProvider();
// Load the document.
using (Stream input = File.OpenRead("input.docx"))
{
flowDocument = docxFormatProvider.Import(input, null);
}
var editor = new RadFlowDocumentEditor(flowDocument);
// Insert table of contents field.
FieldInfo tocFieldInfo = editor.InsertField("TOC \f a");
tocFieldInfo.UpdateField();
// Create hierarchical numbering list for the TOC.
var tocList = flowDocument.Lists.Add(ListTemplateType.NumberedHierarchical);
tocList.MultilevelType = MultilevelType.Multilevel;
// Style TOC Level 1
var tocLevel1StyleId = BuiltInStyleNames.GetTocStyleIdByIndex(1);
flowDocument.StyleRepository.AddBuiltInStyle(tocLevel1StyleId);
var tocLevel1Style = flowDocument.StyleRepository.GetStyle(tocLevel1StyleId);
tocLevel1Style.CharacterProperties.FontSize.LocalValue = 13;
tocLevel1Style.ParagraphProperties.LeftIndent.LocalValue = 0;
tocLevel1Style.CharacterProperties.FontWeight.LocalValue = FontWeights.Bold;
tocLevel1Style.ParagraphProperties.HangingIndent.LocalValue = 35;
tocLevel1Style.ParagraphProperties.ListLevel.LocalValue = 0;
tocLevel1Style.ParagraphProperties.ListId.LocalValue = tocList.Id;
// Style TOC Level 2
var tocLevel2StyleId = BuiltInStyleNames.GetTocStyleIdByIndex(2);
flowDocument.StyleRepository.AddBuiltInStyle(tocLevel2StyleId);
var tocLevel2Style = flowDocument.StyleRepository.GetStyle(tocLevel2StyleId);
tocLevel2Style.ParagraphProperties.ListLevel.LocalValue = 1;
tocLevel2Style.ParagraphProperties.LeftIndent.LocalValue = 35;
tocLevel2Style.ParagraphProperties.HangingIndent.LocalValue = 35;
tocLevel2Style.CharacterProperties.FontSize.LocalValue = 13;
tocLevel2Style.ParagraphProperties.ListId.LocalValue = tocList.Id;
// Style TOC Level 3
var tocLevel3StyleId = BuiltInStyleNames.GetTocStyleIdByIndex(3);
flowDocument.StyleRepository.AddBuiltInStyle(tocLevel3StyleId);
var tocLevel3Style = flowDocument.StyleRepository.GetStyle(tocLevel3StyleId);
tocLevel3Style.ParagraphProperties.ListLevel.LocalValue = 2;
tocLevel3Style.ParagraphProperties.LeftIndent.LocalValue = 65;
tocLevel3Style.ParagraphProperties.HangingIndent.LocalValue = 35;
tocLevel3Style.CharacterProperties.FontSize.LocalValue = 13;
tocLevel3Style.ParagraphProperties.ListId.LocalValue = tocList.Id;
// Export the styled document
string docxOutputPath = "..\\..\\..\\output.docx";
File.Delete(docxOutputPath);
using (Stream output = File.OpenWrite(docxOutputPath))
{
docxFormatProvider.Export(flowDocument, output, null);
}