PageSetup Members (Word)

GitHub-Mark-64px

Contribute to this content

Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

Represents the page setup description. The PageSetup object contains all the page setup attributes of a document (such as left margin, bottom margin, and paper size) as properties.

Methods

Name

Description

SetAsTemplateDefault

Sets the specified page setup formatting as the default for the active document and all new documents based on the active template.

TogglePortrait

Switches between portrait and landscape page orientations for a document or section.

Properties

Name

Description

Application

Returns an Application object that represents the Microsoft Word application.

BookFoldPrinting

True for Microsoft Word to print a document in a series of booklets so the printed pages can be folded and read as a book. Read/write Boolean.

BookFoldPrintingSheets

Returns or sets a Long which represents the number of pages for each booklet. Read/write Boolean.

BookFoldRevPrinting

True for Microsoft Word to reverse the printing order for book fold printing of bidirectional or Asian language documents. Read/write Boolean.

BottomMargin

Returns or sets the distance (in points) between the bottom edge of the page and the bottom boundary of the body text. Read/write Single.

CharsLine

Returns or sets the number of characters per line in the document grid. Read/write Single.

Creator

Returns a 32-bit integer that indicates the application in which the specified object was created. Read-only Long.

DifferentFirstPageHeaderFooter

True if a different header or footer is used on the first page. Can be True, False, or wdUndefined. Read/write Long.

FirstPageTray

Returns or sets the paper tray to use for the first page of a document or section. Read/write WdPaperTray.

FooterDistance

Returns or sets the distance (in points) between the footer and the bottom of the page. Read/write Single.

Gutter

Returns or sets the amount (in points) of extra margin space added to each page in a document or section for binding. Read/write Single.

GutterPos

Returns or sets on which side the gutter appears in a document. Read/write WdGutterStyle.

GutterStyle

Returns or sets whether Microsoft Word uses gutters for the current document based on a right-to-left language or a left-to-right language. Read/write WdGutterStyleOld.

HeaderDistance

Returns or sets the distance (in points) between the header and the top of the page. Read/write Single.

LayoutMode

Returns or sets the layout mode for the current document. Read/write WdLayoutMode.

LeftMargin

Returns or sets the distance (in points) between the left edge of the page and the left boundary of the body text. Read/write Single.

LineNumbering

Returns or sets a LineNumbering object that represents the line numbers for the specified PageSetup object.

LinesPage

Returns or sets the number of lines per page in the document grid. Read/write Single.

MirrorMargins

True if the inside and outside margins of facing pages are the same width. Read/write Long.

OddAndEvenPagesHeaderFooter

True if the specified PageSetup object has different headers and footers for odd-numbered and even-numbered pages. Read/write Long.

Orientation

Returns or sets the orientation of the page. Read/write WdOrientation.

OtherPagesTray

Returns or sets the paper tray to be used for all but the first page of a document or section. Read/write WdPaperTray.

PageHeight

Returns or sets the height of the page in points. Read/write Single.

PageWidth

Returns or sets the width of the page in points. Read/write Single.

PaperSize

Returns or sets the paper size. Read/write WdPaperSize.

Parent

Returns an Object that represents the parent object of the specified PageSetup object.

RightMargin

Returns or sets the distance (in points) between the right edge of the page and the right boundary of the body text. Read/write Single.

SectionDirection

Returns or sets the reading order and alignment for the specified sections. Read/write WdSectionDirection.

SectionStart

Returns or sets the type of section break for the specified object. Read/write WdSectionStart.

ShowGrid

True to display the page grid. False to hide it. Read/write Boolean.

SuppressEndnotes

True if endnotes are printed at the end of the next section that doesn't suppress endnotes. Read/write Long.

TextColumns

Returns a TextColumns collection that represents the set of text columns for the specified PageSetup object.

TopMargin

Returns or sets the distance (in points) between the top edge of the page and the top boundary of the body text. Read/write Single.

TwoPagesOnOne

True if Microsoft Word prints the specified document two pages per sheet. Read/write Boolean.

VerticalAlignment

Returns or sets the vertical alignment of text on each page in a document or section. Read/write WdVerticalAlignment.