relative_horizontal_position property

ShapeBase.relative_horizontal_position property

Specifies relative to what the shape is positioned horizontally.

@property
def relative_horizontal_position(self) -> aspose.words.drawing.RelativeHorizontalPosition:
    ...

@relative_horizontal_position.setter
def relative_horizontal_position(self, value: aspose.words.drawing.RelativeHorizontalPosition):
    ...

Remarks

The default value is RelativeHorizontalPosition.COLUMN.

Has effect only for top level floating shapes.

Examples

Shows how to insert a floating image to the center of a page.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

# Insert a floating image that will appear behind the overlapping text and align it to the page's center.
shape = builder.insert_image(IMAGE_DIR + "Logo.jpg")
shape.wrap_type = aw.drawing.WrapType.NONE
shape.behind_text = True
shape.relative_horizontal_position = aw.drawing.RelativeHorizontalPosition.PAGE
shape.relative_vertical_position = aw.drawing.RelativeVerticalPosition.PAGE
shape.horizontal_alignment = aw.drawing.HorizontalAlignment.CENTER
shape.vertical_alignment = aw.drawing.VerticalAlignment.CENTER

doc.save(ARTIFACTS_DIR + "Image.create_floating_page_center.docx")

See Also