Represents the page setup properties of a section. To learn more, visit the Working with Sections documentation article.
PageSetup object contains all the page setup attributes of a section (left margin, bottom margin, paper size, and so on) as properties.
|Specifies that this section contains bidirectional (complex scripts) text.
|Specifies where the page border is positioned relative to intersecting texts and objects.
|Specifies which pages the page border is printed on.
|Gets or sets a value that indicates whether the specified page border is measured from the edge of the page or from the text it surrounds.
|Specifies whether the page border includes or excludes the footer.
|Specifies whether the page border includes or excludes the header.
|Gets a collection of the page borders.
|Returns or sets the distance (in points) between the bottom edge of the page and the bottom boundary of the body text.
|Gets or sets the separator character that appears between the chapter number and the page number.
|Gets or sets the number of characters per line in the document grid.
|True if a different header or footer is used on the first page.
|Provides options that control numbering and positioning of endnotes in this section.
|Gets or sets the paper tray (bin) to use for the first page of a section. The value is implementation (printer) specific.
|Returns or sets the distance (in points) between the footer and the bottom of the page.
|Provides options that control numbering and positioning of footnotes in this section.
|Gets or sets the amount of extra space added to the margin for document binding.
|Returns or sets the distance (in points) between the header and the top of the page.
|Gets or sets the heading level style that is applied to the chapter titles in the document.
|Gets or sets the layout mode of this section.
|Returns or sets the distance (in points) between the left edge of the page and the left boundary of the body text.
|Returns or sets the numeric increment for line numbers.
|Gets or sets distance between the right edge of line numbers and the left edge of the document.
|Gets or sets the way line numbering runs that is, whether it starts over at the beginning of a new page or section or runs continuously.
|Gets or sets the starting line number.
|Gets or sets the number of lines per page in the document grid.
|Returns or sets preset Margins of the page.
|For multiple page documents, gets or sets how a document is printed or rendered so that it can be bound as a booklet.
|True if the document has different headers and footers for odd-numbered and even-numbered pages.
|Returns or sets the orientation of the page.
|Gets or sets the paper tray (bin) to be used for all but the first page of a section. The value is implementation (printer) specific.
|Returns or sets the height of the page in points.
|Gets or sets the page number format.
|Gets or sets the starting page number of the section.
|Returns or sets the width of the page in points.
|Returns or sets the paper size.
|True if page numbering restarts at the beginning of the section.
|Returns or sets the distance (in points) between the right edge of the page and the right boundary of the body text.
|Gets or sets whether Microsoft Word uses gutters for the section based on a right-to-left language or a left-to-right language.
|Returns or sets the type of section break for the specified object.
|Returns or sets the number of pages to be included in each booklet.
|True if endnotes are printed at the end of the next section that doesn’t suppress endnotes. Suppressed endnotes are printed before the endnotes in that section.
|Returns a collection that represents the set of text columns.
|Allows to specify PageSetup.text_orientation for the whole page. Default value is TextOrientation.HORIZONTAL
|Returns or sets the distance (in points) between the top edge of the page and the top boundary of the body text.
|Returns or sets the vertical alignment of text on each page in a document or section.
|Resets page setup to default paper size, margins and orientation.
Shows how to apply and revert page setup settings to sections in a document.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
# Modify the page setup properties for the builder's current section and add text.
builder.page_setup.orientation = aw.Orientation.LANDSCAPE
builder.page_setup.vertical_alignment = aw.PageVerticalAlignment.CENTER
builder.writeln("This is the first section, which landscape oriented with vertically centered text.")
# If we start a new section using a document builder,
# it will inherit the builder's current page setup properties.
# We can revert its page setup properties to their default values using the "ClearFormatting" method.
builder.writeln("This is the second section, which is in default Letter paper size, portrait orientation and top alignment.")
doc.save(ARTIFACTS_DIR + "PageSetup.clear_formatting.docx")
- module aspose.words