ListLevel.ListLevelFormat Property
Gets the number or bullet format of the list level’s paragraphs.
Namespace: DevExpress.Blazor.RichEdit
Assembly: DevExpress.Blazor.RichEdit.v24.2.dll
NuGet Package: DevExpress.Blazor.RichEdit
#Declaration
public ListLevelFormat ListLevelFormat { get; }
#Property Value
Type | Description |
---|---|
List |
The list level format. |
Available values:
Name | Description | Example |
---|---|---|
Decimal | The sequence consists of decimal numbers. |
1, 2, 3 |
Bullet | The sequence consists of bullet characters. |
●, ●, ● |
Cardinal |
The sequence consists of numbers written alphabetically. |
One, Two, Three |
Decimal |
The sequence consists of decimal numbers enclosed in parentheses. |
(1), (2), (3) |
Decimal |
The sequence consists of decimal numbers with a zero added to numbers less than ten. |
01, 02, … , 09, 10 |
Hex | The sequence consists of hexadecimal numbers. |
1, 2, … , e, f |
Lower |
The sequence consists of lowercase letters of the alphabet. |
a, b, c |
Lower |
The sequence consists of lowercase Roman numerals. |
i, ii, iii |
None | The default format. The sequence consists of decimal numbers. |
1, 2, 3 |
Number |
The sequence consists of decimal numbers enclosed in dashes. |
- 1 -, - 2 -, - 3 - |
Ordinal | The sequence consists of ordinal numbers written as numerals with letter suffixes. |
1st, 2nd, 3rd |
Ordinal |
The sequence consists of ordinal numbers written alphabetically. |
First, Second, Third |
Upper |
The sequence consists of uppercase letters of the alphabet. |
A, B, C |
Upper |
The sequence consists of uppercase Roman numerals. |
I, II, III |
#Remarks
The Rich Edit supports only the formats that are listed in the ListLevelFormat enum. If you open a document that uses an unsupported list level format, the Rich Edit keeps that format, but displays it as Decimal
.
Use the list’s ChangeLevelPropertiesAsync(Int32, Action<ListLevelProperties>, CancellationToken) method to change a list level’s number or bullet format.
<DxRichEdit @ref="richEdit" />
@code {
DxRichEdit richEdit;
Document documentAPI;
/* Surround the code that contains an asynchronous operation with a try-catch block to handle
the OperationCanceledException. This exception is thrown when an asynchronous operation is canceled. */
try {
documentAPI = richEdit.DocumentAPI;
List multiLevelList = await documentAPI.Lists.CreateAsync(ListType.MultiLevel);
IReadOnlyList<ListLevel> listLevels = multiLevelList.ListLevels;
ListLevel firstLevel = listLevels[0];
await multiLevelList.ChangeLevelPropertiesAsync(0, properties => {
if (firstLevel.ListLevelFormat != ListLevelFormat.Decimal)
properties.ListLevelFormat = ListLevelFormat.Decimal;
});
}
catch (OperationCanceledException e) {
Console.WriteLine($"{nameof(OperationCanceledException)} thrown with message: {e.Message}");
}
}