RelativeVerticalPosition enumeration
RelativeVerticalPosition enumeration
Specifies to what the vertical position of a shape or text frame is relative.
Members
| Name | Description |
|---|---|
| MARGIN | Specifies that the vertical positioning shall be relative to the page margins. |
| PAGE | The object is positioned relative to the top edge of the page. |
| PARAGRAPH | The object is positioned relative to the top of the paragraph that contains the anchor. |
| LINE | Undocumented. |
| TOP_MARGIN | Specifies that the vertical positioning shall be relative to the top margin of the current page. |
| BOTTOM_MARGIN | Specifies that the vertical positioning shall be relative to the bottom margin of the current page. |
| INSIDE_MARGIN | Specifies that the vertical positioning shall be relative to the inside margin of the current page. |
| OUTSIDE_MARGIN | Specifies that the vertical positioning shall be relative to the outside margin of the current page. |
| TABLE_DEFAULT | Default value is RelativeVerticalPosition.MARGIN. |
| TEXT_FRAME_DEFAULT | Default value is RelativeVerticalPosition.PARAGRAPH. |
Examples
Shows how to insert an image, and use it as a watermark.
doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
# Insert the image into the header so that it will be visible on every page.
builder.move_to_header_footer(aw.HeaderFooterType.HEADER_PRIMARY)
shape = builder.insert_image(file_name=IMAGE_DIR + 'Transparent background logo.png')
shape.wrap_type = aw.drawing.WrapType.NONE
shape.behind_text = True
# Place the image at the center of the page.
shape.relative_horizontal_position = aw.drawing.RelativeHorizontalPosition.PAGE
shape.relative_vertical_position = aw.drawing.RelativeVerticalPosition.PAGE
shape.left = (builder.page_setup.page_width - shape.width) / 2
shape.top = (builder.page_setup.page_height - shape.height) / 2
doc.save(file_name=ARTIFACTS_DIR + 'DocumentBuilder.InsertWatermark.docx')
Shows how to insert a floating image to the center of a page.
doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
# Insert a floating image that will appear behind the overlapping text and align it to the page's center.
shape = builder.insert_image(file_name=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(file_name=ARTIFACTS_DIR + 'Image.CreateFloatingPageCenter.docx')
See Also
- module aspose.words.drawing
- property ShapeBase.relative_vertical_position