Aspose::Words::Drawing::RelativeVerticalPosition enum

RelativeVerticalPosition enum

Specifies to what the vertical position of a shape or text frame is relative.

enum class RelativeVerticalPosition

Values

Name	Value	Description
Margin	0	Specifies that the vertical positioning shall be relative to the page margins.
Page	1	The object is positioned relative to the top edge of the page.
Paragraph	2	The object is positioned relative to the top of the paragraph that contains the anchor.
Line	3	Undocumented.
TopMargin	4	Specifies that the vertical positioning shall be relative to the top margin of the current page.
BottomMargin	5	Specifies that the vertical positioning shall be relative to the bottom margin of the current page.
InsideMargin	6	Specifies that the vertical positioning shall be relative to the inside margin of the current page.
OutsideMargin	7	Specifies that the vertical positioning shall be relative to the outside margin of the current page.
TableDefault	n/a	Default value is Margin.
TextFrameDefault	n/a	Default value is Paragraph.

Examples

Shows how to insert an image, and use it as a watermark.

auto doc = MakeObject<Document>();
auto builder = MakeObject<DocumentBuilder>(doc);

// Insert the image into the header so that it will be visible on every page.
SharedPtr<System::Drawing::Image> image = System::Drawing::Image::FromFile(ImageDir + u"Transparent background logo.png");
builder->MoveToHeaderFooter(HeaderFooterType::HeaderPrimary);
SharedPtr<Shape> shape = builder->InsertImage(image);
shape->set_WrapType(WrapType::None);
shape->set_BehindText(true);

// Place the image at the center of the page.
shape->set_RelativeHorizontalPosition(RelativeHorizontalPosition::Page);
shape->set_RelativeVerticalPosition(RelativeVerticalPosition::Page);
shape->set_Left((builder->get_PageSetup()->get_PageWidth() - shape->get_Width()) / 2);
shape->set_Top((builder->get_PageSetup()->get_PageHeight() - shape->get_Height()) / 2);

doc->Save(ArtifactsDir + u"DocumentBuilder.InsertWatermark.docx");

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

auto doc = MakeObject<Document>();
auto builder = MakeObject<DocumentBuilder>(doc);

// Insert a floating image that will appear behind the overlapping text and align it to the page's center.
SharedPtr<Shape> shape = builder->InsertImage(ImageDir + u"Logo.jpg");
shape->set_WrapType(WrapType::None);
shape->set_BehindText(true);
shape->set_RelativeHorizontalPosition(RelativeHorizontalPosition::Page);
shape->set_RelativeVerticalPosition(RelativeVerticalPosition::Page);
shape->set_HorizontalAlignment(HorizontalAlignment::Center);
shape->set_VerticalAlignment(VerticalAlignment::Center);

doc->Save(ArtifactsDir + u"Image.CreateFloatingPageCenter.docx");

See Also

• Namespace Aspose::Words::Drawing
• Library Aspose.Words for C++