Aspose::Words::DocumentBuilder::MoveToHeaderFooter method
Contents
[
Hide
]DocumentBuilder::MoveToHeaderFooter method
Moves the cursor to the beginning of a header or footer in the current section.
void Aspose::Words::DocumentBuilder::MoveToHeaderFooter(Aspose::Words::HeaderFooterType headerFooterType)
| Parameter | Type | Description |
|---|---|---|
| headerFooterType | Aspose::Words::HeaderFooterType | Specifies the header or footer to move to. |
Remarks
After you moved the cursor into a header or footer, you can use the rest of DocumentBuilder methods to modify the contents of the header or footer.
If you want to create headers and footers different for the first page, you need to set DifferentFirstPageHeaderFooter.
If you want to create headers and footers different for even and odd pages, you need to set OddAndEvenPagesHeaderFooter.
Use MoveToSection() to move out of the header into the main text.
Examples
Shows how to insert an image, and use it as a watermark.
auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);
// Insert the image into the header so that it will be visible on every page.
builder->MoveToHeaderFooter(Aspose::Words::HeaderFooterType::HeaderPrimary);
System::SharedPtr<Aspose::Words::Drawing::Shape> shape = builder->InsertImage(get_ImageDir() + u"Transparent background logo.png");
shape->set_WrapType(Aspose::Words::Drawing::WrapType::None);
shape->set_BehindText(true);
// Place the image at the center of the page.
shape->set_RelativeHorizontalPosition(Aspose::Words::Drawing::RelativeHorizontalPosition::Page);
shape->set_RelativeVerticalPosition(Aspose::Words::Drawing::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(get_ArtifactsDir() + u"DocumentBuilder.InsertWatermark.docx");
See Also
- Enum HeaderFooterType
- Class DocumentBuilder
- Namespace Aspose::Words
- Library Aspose.Words for C++