Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

Image.HorizontalAnchorElement Property

Gets the element used to specify the image’s horizontal position.

Namespace: DevExpress.Blazor.RichEdit

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

NuGet Package: DevExpress.Blazor.RichEdit

#Declaration

C#
public FloatingObjectHorizontalAnchorElement HorizontalAnchorElement { get; }

#Property Value

Type Description
FloatingObjectHorizontalAnchorElement

The horizontal anchor element.

Available values:

Name Description
Page

A floating object is aligned to a page.

Character

A floating object is aligned to a character.

Column

A floating object is aligned to a column.

Margin

A floating object is aligned to the left or right page margin, or centered horizontally.

LeftMargin

A floating object is aligned to the left margin.

RightMargin

A floating object is aligned to the right margin.

InsideMargin

Currently not supported and is treated as the LeftMargin anchor element.
Floating objects are aligned to the left margin for odd pages, and the right margin for even pages.

OutsideMargin

Currently not supported and is treated as the RightMargin anchor element.
Floating objects are aligned to the right margin for odd pages, and the left margin for even pages.

#Remarks

Use any of the following properties to define a horizontal position of an image relative to its horizontal anchor element:

HorizontalAlignment
Horizontally aligns an image. If you set this property to a value different from None, the Rich Text Editor sets the HorizontalOffset and HorizontalRelativeOffset properties to 0.
HorizontalOffset
Defines an image’s horizontal offset in twips. If you set this property to a value different from 0, the Rich Text Editor sets the HorizontalRelativeOffset property to 0.
HorizontalRelativeOffset
Defines an image’s horizontal offset in percentage.

Use the ChangePropertiesAsync method to change the horizontal anchor element of the image.

Razor
<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;
            @* ... *@
            Image firstImage = await documentAPI.Images.GetAsync(0);
            @* ... *@
            await firstImage.ChangePropertiesAsync(properties => {
                if (firstImage.HorizontalAnchorElement != FloatingObjectHorizontalAnchorElement.Page)
                    properties.HorizontalAnchorElement = FloatingObjectHorizontalAnchorElement.Page;
            });
            @* ... *@
        }
        catch (OperationCanceledException e) {
            Console.WriteLine($"{nameof(OperationCanceledException)} thrown with message: {e.Message}");
        }
}
See Also