You create a bullet list by creating an instance of the NBulletList class and assigning it to one or more paragraphs in the document. For example, the following code creates a simple numbered bullet list:

NBulletList bulletList = new NBulletList(ENBulletListTemplateType.Decimal);
m_RichText.Content.BulletLists.Add(bulletList);
for (int i = 0; i < 3; i++)
{
    NParagraph paragraph = new NParagraph("Bullet List Item " + i.ToString());
    paragraph.SetBulletList(bulletList, 0);
    section.Blocks.Add(paragraph);
}

The generated bullet list will look like this:

Notice that in the previous section we used the SetBulletList shortcut method to assign bullet list and bullet list level to the paragraph. This information is stored in the Bullet property of the paragraph. The Bullet property holds a reference to an inline text object of type NBulletInline. This inline can contain text and optionally a separator space or tab. The following code shows how to assign those properties from code:

Like with any inline you can modify the text font, fill, style etc. For example:

Creates a red bullet list item.

As shown in the above sections the steps to create a bullet list are:

1. Create an instance of the NBulletList class.

2. Add the bullet list to the document BulletLists collection.

3. Assign this bullet list to one or more paragraphs.

Each bullet list consists of one or more levels that you add to the ListLevels collection of that list. Each bullet list level is responsible for formatting the bullets generated by bullet list items for that level. For example, if you have two paragraphs where the first one has bullet inline that has ListLevel set to 0 and the second one has a bullet inline that has ListLevel set to 1,  then the bullet generated by the first one will be formatted using the properties of the first bullet list level, whereas the bullet generated by the second one will be formatted using the properties of the second bullet list level. The following code shows how to create a bullet list with a single level:

The following sections discuss the properties of the NBulletListLevel class:

Bullet Format

Each bullet list level has a property called Format which allows you to specify the text displayed by the bullets for that level. The string value you pass there can contain either plain characters or backward slash followed by level number. For example in the code above the format is set to "\0.", meaning that the formatted counter value for level 1 is followed by a dot. If you create a second bullet list level it will typically use "\0.\1." and so on. In general by placing a backslash followed by a level number you create a place holder for formatted counter values, which you can mix with arbitrary characters.

Bullet Type

The bullet list template level has a property called BulletType which controls how counter values are formatted for this particular level. The following table lists the available options:

The following example shows how to create a bullet list level that specifies filled circle as the bullet text:

// create a bullet list template
NBulletList bulletList = new NBulletList();
// create a bullet list template level
NBulletListLevel bulletListLevel1 = new NBulletListLevel();
// set the bullet type to text and bullet text to unicode char for filled bullet circle
bulletListLevel1.BulletType = ENBulletType.Text;
bulletListLevel1.BulletText = new string((char)0x25CF, 1);
bulletList.Levels.Add(bulletListLevel1);

 Note that the code above species a special char for the bullet text. The control provides the ENBulletChar enum which provides commonly used Unicode bullet chars:

The following code snippet shows how to use the values in this enum:

bulletListLevel1.BulletText = new string((char)ENBulletChar.TriangularBullet, 1);

Bullet Tab Stop

The generated bullet text can optionally be followed by a space or tab character. This is controlled from the BulletFollowChar property accepting values from the ENBulletFollowChar enum:

Adding tabs that follow the bullets helps to increase readability when the bullet list uses bullets embedded in paragraphs. The following code snippet shows how to create a bullet followed by a tab stop at 40 dips:

bulletListLevel1.BulletFollowChar = ENBulletFollowChar.Tab;
bulletListLevel1.TabStop = new NTabStop(40, ENTabStopAlignment.Left, ENTabStopLeaderStyle.None);