Shape.OffsetYRelative Property
Specifies the vertical position of a shape relative to an element defined by the RelativeVerticalPosition property.
Namespace: DevExpress.XtraRichEdit.API.Native
Assembly: DevExpress.RichEdit.v24.2.Core.dll
NuGet Package: DevExpress.RichEdit.Core
Declaration
Property Value
| Type | Description |
|---|---|
| Single | The offset (in percentage) relative to the specified element. Valid values range from -10 (-1000%) to 10 (1000%). |
Remarks
Use the following properties to specify the relative position of a floating shape on the page:
Shape.OffsetXRelative - specifies the horizontal offset (in percentage) relative to the element defined by the Shape.RelativeHorizontalPosition property.
OffsetYRelative - specifies the vertical offset (in percentage) relative to the element defined by the Shape.RelativeVerticalPosition property.
The Shape.OffsetRelative property specifies both the horizontal and vertical relative positions.
Note
The OffsetRelative properties are in effect when the Shape.HorizontalAlignment and Shape.VerticalAlignment properties are set to None.
The example below creates a rectangle and places it on the page as follows:
the horizontal offset is equal to 20% of the page width,
the vertical offset is equal to 10% of the page height.
Document document = wordProcessor.Document;
// Set the measurement unit to inches.
document.Unit = DevExpress.Office.DocumentUnit.Inch;
// Create a rectangle.
Shape rectangle = document.Shapes.InsertShape(document.Range.Start, ShapeGeometryPreset.Rectangle, new SizeF(2.5f, 1.5f));
// Specify the rectangle position on the page.
rectangle.RelativeHorizontalPosition = ShapeRelativeHorizontalPosition.Page;
rectangle.OffsetXRelative = 0.2f;
rectangle.RelativeVerticalPosition = ShapeRelativeVerticalPosition.Page;
rectangle.OffsetYRelative = 0.1f;