Skip to main content

Paragraph.ChangePropertiesAsync(Action<ParagraphProperties>, CancellationToken) Method

Sets the paragraph’s properties.

Namespace: DevExpress.Blazor.RichEdit

Assembly: DevExpress.Blazor.RichEdit.v24.1.dll

NuGet Package: DevExpress.Blazor.RichEdit

Declaration

public ValueTask<bool> ChangePropertiesAsync(
    Action<ParagraphProperties> modifier,
    CancellationToken cancellationToken = default(CancellationToken)
)

Parameters

Name Type Description
modifier Action<ParagraphProperties>

A delegate method that configures paragraph properties.

Optional Parameters

Name Type Default Description
cancellationToken CancellationToken null

An object that propagates a cancellation notification.

Returns

Type Description
ValueTask<Boolean>

A structure that stores an awaitable result of an asynchronous operation. The awaitable result is true if the operation ends successfully; otherwise, it is false.

Remarks

Pass a ParagraphProperties object to the ChangePropertiesAsync method to set a paragraph’s properties. You can specify paragraph properties manually or use the CopyFrom(Paragraph) method to copy properties from another paragraph.

<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;
            Paragraph firstParagraph = await documentAPI.Paragraphs.GetAsync(0);
            IReadOnlyList<Paragraph> paragraphs = await documentAPI.Paragraphs.GetAllAsync();
            foreach (Paragraph p in paragraphs)
                if (p.Index != 0)
                    await p.ChangePropertiesAsync(properties => {
                        properties.CopyFrom(firstParagraph);
                    });
        }
        catch (OperationCanceledException e) {
            Console.WriteLine($"{nameof(OperationCanceledException)} thrown with message: {e.Message}");
        }
}
See Also