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

ImageProperties.VerticalAlignment Property

Specifies an image’s vertical alignment relative to a vertical anchor element.

Namespace: DevExpress.Blazor.RichEdit

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

NuGet Package: DevExpress.Blazor.RichEdit

#Declaration

C#
public FloatingObjectVerticalAlignment VerticalAlignment { get; set; }

#Property Value

Type Description
FloatingObjectVerticalAlignment

The vertical alignment.

Available values:

Name Description
None

A floating object is not aligned.

Top

A floating object is aligned to the top of a vertical anchor element.

Center

A floating object is aligned to the center of a vertical anchor element.

Bottom

A floating object is aligned to the bottom of a vertical anchor element.

Inside

Currently not supported and is displayed as the Top alignment type. Floating objects are aligned to the top of a vertical anchor element for odd pages, and the bottom of a vertical anchor element for even pages.

Outside

Currently not supported and is displayed as the Bottom alignment type. Floating objects are aligned to the bottom of a vertical anchor element for odd pages, and the top of a vertical anchor element for even pages.

#Remarks

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

VerticalAlignment
Vertically aligns an image. If you set this property to a value different from None, the Rich Text Editor sets the VerticalOffset and VerticalRelativeOffset properties to 0.
VerticalOffset
Defines an image’s vertical offset in twips. If you set this property to a value different from 0, the Rich Text Editor sets the VerticalRelativeOffset property to 0.
VerticalRelativeOffset
Defines an image’s vertical offset in percentage.
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.VerticalAlignment != FloatingObjectVerticalAlignment.Center)
                    properties.VerticalAlignment = FloatingObjectVerticalAlignment.Center;
            });
            @* ... *@
        }
        catch (OperationCanceledException e) {
            Console.WriteLine($"{nameof(OperationCanceledException)} thrown with message: {e.Message}");
        }
}

Use the VerticalAlignment property to get the vertical alignment of the image.

See Also