Scribd
Upload
67 views8 pages

How To Create A PDF With Multilevel List in C#

The article describes how to create a PDF document with hierarchical Multilevel List in C# using PDFFlow library.

Uploaded by

DotNet Developer
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
67 views8 pages

How To Create A PDF With Multilevel List in C#

The article describes how to create a PDF document with hierarchical Multilevel List in C# using PDFFlow library.

Uploaded by

DotNet Developer
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 8

Creating PDF document with Multilevel List in C#

Brief
The article describes how to create a PDF document with Multilevel List
in C# using PDFFlow library.
Library website: https://www.pdfflow.io
Nuget package: https://www.nuget.org/packages/Gehtsoft.PDFFlowLib
Details
PDF document consists of sections. A section may have as many multilevel
lists as you need.
Creating a list with PDFFlow is only a few lines of code:
1. First you need to create DocumentBuilder.
2. Then add Section to it.
3. Now add as many Paragraphs to Section, as many list items you need.
4. Make each Paragraph a list item, set level and style if needed.
You can make a paragraph an item of a numbered multilevel list using the
ParagraphBuilder.SetListNumbered method. For each item, you can specify
the numbering style, the level of the list, the left indent, and enable
the hierarchic numeration is necessary. Items of a numbered list are
numbered automatically on each level. The available numbering styles are:
Arabic numbers, lower and upper Roman numbers, lower and upper Latin
letters, lower and upper Cyrillic letters (see the NumerationStyle
enumeration).
You can make a paragraph an item of a bulleted multilevel list using the
ParagraphBuilder.SetListBulleted method. For each item, you can specify
the bullet symbol, the level of the list, and the left indent. The
available bullet symbols are a bullet and a dash (see the ListBullet
enumeration).
The default level left indent for a multilevel list is 20f, the default
numbering style of a numbered list is Arabic, the default bullet symbol
is Bullet.
You can configure the formatting settings of list items directly or apply
a style to them using methods of ParagraphBuilder. You can also set a
style for all lists in the section using the SectionBuilder.SetListStyle
method. In this case, you can use the ParagraphBuilder.SetList method to
quickly make the necessary paragraphs list items and the set style will
be applied to all list items in the section.
Once a paragraph which is not an item of a multilevel list is met, the
multilevel list is considered completed.
When later another paragraph is made an item of a multilevel list, it
becomes the first item of a new multilevel list, and its automatic
numeration will start from the beginning.
Examples

Example 1. Create a numbered list


using GehtSoft.PDFFlow.Builder;
var latin = NumerationStyle.LowerLatin;
DocumentBuilder.New()
.AddSection()
.AddParagraph("Level 0, Item 1").SetListNumbered()
.ToSection()
.AddParagraph("Level 1, Item a").SetListNumbered(latin, 1)
.ToSection()
.AddParagraph("Level 1, Item b").SetListNumbered(latin, 1)
.ToSection()
.AddParagraph("Level 0, Item 2").SetListNumbered()
.ToSection()
.AddParagraph("Level 0, Item 3").SetListNumbered()
.ToDocument()
.Build("Result.pdf");

The above code will generate the following:

Example 2. Create a bulleted list


DocumentBuilder.New()
.AddSection()
.AddParagraph("Level 0, Item 1")
.SetFontColor(Color.Red)
.SetListBulleted().ToSection()
.AddParagraph("Level 1, Item 1")
.SetListBulleted(ListBullet.Bullet, 1).ToSection()
.AddParagraph("Level 1, Item 2")
.SetListBulleted(ListBullet.Bullet, 1).ToSection()
.AddParagraph("Level 2, Item 1")
.SetListBulleted(ListBullet.Dash, 2).ToSection()
.AddParagraph("Level 2, Item 2")
.SetListBulleted(ListBullet.Dash, 2).ToSection()
.AddParagraph("Level 0, Item 2")
.SetFontColor(Color.Red)
.SetListBulleted().ToSection()
.AddParagraph("Level 0, Item 3")
.SetFontColor(Color.Red)
.SetListBulleted()
.ToDocument()
.Build("Result.pdf");
The above code will generate the following:

Example 3. Set level indent values


DocumentBuilder.New()
.AddSection()
.AddParagraph("Level 0, Item 1. Shifted by 5 points")
.SetListBulleted(ListBullet.Bullet, 0, 5)
.ToSection()
.AddParagraph("Level 1, Item 1. Shifted by 15 points")
.SetListBulleted(ListBullet.Bullet, 1, 15)
.ToSection()
.AddParagraph("Level 1, Item 2. Shifted by 15 points")
.SetListBulleted(ListBullet.Bullet, 1, 15)
.ToSection()
.AddParagraph("Level 2, Item 1. Shifted by 20 points")
.SetListBulleted(ListBullet.Dash, 2, 20)
.ToSection()
.AddParagraph("Level 2, Item 2. Shifted by 20 points")
.SetListBulleted(ListBullet.Dash, 2, 20)
.ToDocument()
.Build("Result.pdf");

The above code will generate the following:


Example 4. Set hierarchic numeration
var latin = NumerationStyle.LowerLatin;
var arabic = NumerationStyle.Arabic;
DocumentBuilder.New().AddSection()
.AddParagraph("Level 0, Item 1")
.SetListNumbered().ToSection()
.AddParagraph("Level 1, Item a")
.SetListNumbered(latin, 1, hierarchicNumeration:
true).ToSection()
.AddParagraph("Level 1, Item b")
.SetListNumbered(latin, 1, hierarchicNumeration:
true).ToSection()
.AddParagraph("Level 0, Item 2")
.SetListNumbered().ToSection()
.AddParagraph("Level 1, Item 1")
.SetListNumbered(arabic, 1, hierarchicNumeration:
true).ToSection()
.AddParagraph("Level 1, Item 2")
.SetListNumbered(arabic, 1, hierarchicNumeration:
true).ToSection()
.AddParagraph("Level 0, Item 3")
.SetListNumbered().ToSection()
.AddParagraph("Level 1, Item 1")
.SetListNumbered(arabic, 1, hierarchicNumeration:
true).ToSection()
.AddParagraph("Level 1, Item 2")
.SetListNumbered(arabic, 1, hierarchicNumeration:
true).ToSection()
.AddParagraph("Level 2, Item 1")
.SetListNumbered(arabic, 2, hierarchicNumeration:
true).ToSection()
.AddParagraph("Level 2, Item 2")
.SetListNumbered(arabic, 2, hierarchicNumeration:
true).ToSection()
.AddParagraph("Level 1, Item 3")
.SetListNumbered(arabic, 1, hierarchicNumeration:
true).ToDocument()
.Build("Result.pdf");

The above code will generate the following:


Example 5. Add a list to a table
DocumentBuilder.New()
.AddSection()
.AddTable()
.AddColumnToTable().AddColumnToTable()
.AddRow()
.AddCellToRow("Cell1")
.AddCell()
.AddParagraphToCell("List 1:")
.AddParagraph("Item 1").SetListBulleted()
.ToCell()
.AddParagraph("Item 2").SetListBulleted()
.ToCell()
.AddParagraph("Item 3").SetListBulleted()
.ToCell()
.AddParagraphToCell("List 2:")
.AddParagraph("Item 1").SetListNumbered()
.ToCell()
.AddParagraph("Item 2").SetListNumbered()
.ToCell()
.AddParagraph("Item 3").SetListNumbered()
.ToDocument()
.Build("Result.pdf");

The above code will generate the following:

Example 6. Set the style and formatting for a list and list items
// Set a style for all lists in the section: numbered, font color red:
StyleBuilder listStyleInCurrentSection =
StyleSheet.DefaultListNumberedBuilder().SetFontColor(Color.Red);
StyleBuilder styleBlue = StyleBuilder.New().SetFontColor(Color.Blue);
StyleBuilder styleListBold =
StyleBuilder.New(StyleSheet.DefaultListNumberedBuilder())
.SetFontBold();
// Create document:
DocumentBuilder.New()
.AddSection()
// Set a style for the lists found in current section:
.SetListStyle(listStyleInCurrentSection)
// Create a list, it will be numbered and have red font color as defined
by the list style for the section:
.AddParagraph("Item 1").SetList().ToSection()
.AddParagraph("Item 2").SetList().ToSection()
.AddParagraph("Item 3").SetList().ToSection()
// Set formatting of one item:
.AddParagraph("Item 4").SetList()
.SetBold()
.SetFontColor(Color.Green)
.ToSection()
// Apply Blue style to paragraph, then apply list formatting. It will be
bulleted, because direct ApplyStyle() has higher priority than
s.SetListStyle():
.AddParagraph("Item 5").ApplyStyle(styleBlue)
.SetList().ToSection()
// Make a paragraph a list item:
.AddParagraph("Item 6")
.ApplyStyle(StyleSheet.DefaultListNumberedBuilder())
.ToSection()
// Make a paragraph a list item and apply the Bold style:
.AddParagraph("Item 7").ApplyStyle(styleListBold)
.ToSection()
// Apply the Bulleted style to a list item. It will be bulleted because
the direct ApplyStyle() has a higher priority than s.SetListStyle():
.AddParagraph("Item 8")
.ApplyStyle(StyleSheet.DefaultListBulletedBuilder())
.ToSection()
// First apply the numbered style, then set the bulleted formatting. The
list will be bulleted because the formatting has a higher priority than
the style:
.AddParagraph("Item 9")
.ApplyStyle(StyleSheet.DefaultListNumberedBuilder())
.SetListBulleted(ListBullet.Dash)
.ToDocument().Build("Result.pdf");
The above code will generate the following:

To compile the above examples you need to add Gehtsoft.PDFFlowLib package


from nuget.org to your project:
https://www.nuget.org/packages/Gehtsoft.PDFFlowLib.
For the installation instructions please read “Installing PDFFlow
Library” article: https://go.pdfflow.io/PdfFlowLibraryInstall.

The PDFFlow library is supplied with source code samples of real business
documents accompanied by descriptive articles:
https://go.pdfflow.io/PDFFlowLibrarySamples.

There are also Tutorials with many working code examples that can be used
as is or modified: https://go.pdfflow.io/PDFFlowLibraryTutorials.

Here is a source code and descriptive article of Warehouse Shipment


Report, using Multilevel List with hierarchic numeration, barcodes,
different fonts, repeating areas and other useful features:
https://go.pdfflow.io/ReportExample.

Hope, this article will help you to create complex PDF documents fast and
efficiently.

(c) GehtSoft USA, LLC


https://gehtsoftusa.com

You might also like