Shape.HorizontalAlignment Property
Specifies how a shape is aligned horizontally.
Namespace: DevExpress.XtraRichEdit.API.Native
Assembly: DevExpress.RichEdit.v24.2.Core.dll
NuGet Package: DevExpress.RichEdit.Core
Declaration
Property Value
| Type | Description |
|---|---|
| ShapeHorizontalAlignment | An enumeration member that specifies the shape’s horizontal alignment. |
Available values:
| Name | Description |
|---|---|
| None | The Shape.OffsetX property specifies the shape’s position relative to the element defined by the Shape.RelativeHorizontalPosition property. |
| Left | The shape is left-aligned relative to the element defined by the Shape.RelativeHorizontalPosition property. |
| Center | The shape is centered relative to the element defined by the Shape.RelativeHorizontalPosition property. |
| Right | The shape is right-aligned relative to the element defined by the Shape.RelativeHorizontalPosition property. |
| Inside | The shape is left-aligned relative to the element defined by the Shape.RelativeHorizontalPosition property on odd pages, and right-aligned on even pages. The Rich Text Editor left-aligns the shape relative to the given element for both odd and even pages. |
| Outside | The shape is right-aligned relative to the element defined by the Shape.RelativeHorizontalPosition property on odd pages, and left-aligned on even pages. The Rich Text Editor right-aligns the shape relative to the given element for both odd and even pages. |
Remarks
Use the following properties to align a shape on the page:
Shape.HorizontalAlignment - aligns the shape horizontally relative to the element defined by the Shape.RelativeHorizontalPosition property.
Shape.VerticalAlignment - aligns the shape vertically relative to the element defined by the Shape.RelativeVerticalPosition property.
The following example displays a rectangle in the center of the page below the top margin:
Document document = wordProcessor.Document;
// Create a rectangle.
Shape rectangle = document.Shapes.InsertShape(document.Range.Start, ShapeGeometryPreset.Rectangle, new SizeF(500, 300));
// Align the rectangle horizontally and vertically.
rectangle.RelativeHorizontalPosition = ShapeRelativeHorizontalPosition.Page;
rectangle.HorizontalAlignment = ShapeHorizontalAlignment.Center;
rectangle.RelativeVerticalPosition = ShapeRelativeVerticalPosition.Margin;
rectangle.VerticalAlignment = ShapeVerticalAlignment.Top;
Set the alignment values to None and use the Shape.OffsetX and Shape.OffsetY properties to specify the absolute position of the shape on the page.
Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the HorizontalAlignment property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.