page_layout property

ImageSaveOptions.page_layout property

Gets or sets the layout used when rendering multiple pages into a single output.

@property
def page_layout(self) -> aspose.words.saving.MultiPageLayout:
    ...

@page_layout.setter
def page_layout(self, value: aspose.words.saving.MultiPageLayout):
    ...

Remarks

Use one of the factory methods of MultiPageLayout to configure this property.

For SaveFormat.TIFF the default value is MultiPageLayout.tiff_frames(). For other formats the default value is MultiPageLayout.single_page().

This property has effect only when saving to the following formats: SaveFormat.JPEG, SaveFormat.GIF, SaveFormat.PNG, SaveFormat.BMP, SaveFormat.TIFF, SaveFormat.WEB_P

Examples

Shows how to save the document into JPG image with multi-page layout settings.

doc = aw.Document(file_name=MY_DIR + 'Rendering.docx')
options = aw.saving.ImageSaveOptions(aw.SaveFormat.JPEG)
# Set up a grid layout with:
# - 3 columns per row.
# - 10pts spacing between pages (horizontal and vertical).
options.page_layout = aw.saving.MultiPageLayout.grid(3, 10, 10)
# Alternative layouts:
# options.PageLayout = MultiPageLayout.Horizontal(10);
# options.PageLayout = MultiPageLayout.Vertical(10);
# Customize the background and border.
options.page_layout.back_color = aspose.pydrawing.Color.light_gray
options.page_layout.border_color = aspose.pydrawing.Color.blue
options.page_layout.border_width = 2
doc.save(file_name=ARTIFACTS_DIR + 'ImageSaveOptions.GridLayout.jpg', save_options=options)

See Also

ImageSaveOptions.metafile_rendering_options property ImageSaveOptions.page_set property