ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • Help
  • Sign Out
ArcGIS Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS Desktop

A complete professional GIS

ArcGIS Enterprise

GIS in your enterprise

ArcGIS Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

ArcMap

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • Extensions

SetPageSize

Available with Production Mapping license.

  • Summary
  • Discussion
  • Syntax
  • Code sample

Summary

Changes the page size of an input map document. Choices for the sizes are the standard ArcMap layouts, as well as a custom option. The orientation can be set to portrait or landscape, and the page units can be set to ArcGIS supported units.

Discussion

Sometimes changes are needed for the layers or layouts of several maps (MXDs). With the SetPageSize function, you don’t have to manage and keep several MXDs synchronized on the server or desktop application. This function can also be used in conjunction with the ApplyLayoutRules function to ensure that the MXD's layout is properly preserved after changing the page size.

Syntax

SetPageSize (map_document, size, {orientation}, {custom_width}, {custom_height}, {page_units})
ParameterExplanationData Type
map_document

A variable that references a MapDocument object.

Map
size

The size the page layout can be changed to.

  • LETTER —8.5 x 11 inches
  • LEGAL —8.5 x 14 inches
  • TABLOID —11 x 17 inches
  • A5 —5.83 x 8.27 inches
  • A4 —8.27 x 11.69 inches
  • A3 —11.69 x 16.54 inches
  • A2 —16.54 x 23.39 inches
  • A1 —23.39 x 33.11 inches
  • A0 —33.11 x 46.8 inches
  • C —17 x 22 inches
  • D —22 x 34 inches
  • E —34 x 44 inches
  • CUSTOM —Enter custom values for custom_width and custom_height.
String
orientation

The orientation the page layout can be changed to. If the size argument is set to CUSTOM, the orientation parameter is ignored.

  • PORTRAIT —Orientation where the height of the display area is greater than the width. This is the default.
  • LANDSCAPE —Orientation where the width of the display area is greater than the height.
String
custom_width

The custom page width in page units. If a custom size is selected, the orientation is ignored and this value is used to set the page size.

Double
custom_height

The custom page height in page units. If a custom size is selected, the orientation is ignored and this value is used to set the page size.

Double
page_units

Specifies which ArcGIS supported page units the output extent/AOI can be when a custom page size is selected. The default is inches.

(The default value is Inches)

String

Code sample

SetPageSize example 1

This script shows how to set the page layout size by choosing an option from the ArcGIS supported sizes.

import arcpy
import arcpyproduction

# Check out Production Mapping extension
arcpy.CheckOutExtension("foundation")

# Define variables
mxd = arcpy.mapping.MapDocument(r'C:\Project\Project.mxd')

# Set the page size
arcpyproduction.mapping.SetPageSize(mxd, "LEGAL", "LANDSCAPE")

# Check in Production Mapping extension
arcpy.CheckInExtension("foundation")
SetPageSize example 2

This script shows how to set the page layout size with a custom option.

import arcpy
import arcpyproduction

# Check out Production Mapping extension
arcpy.CheckOutExtension("foundation")

# Define variables
mxd = arcpy.mapping.MapDocument(r'C:\Project\Project.mxd')

# Set the page size
arcpyproduction.mapping.SetPageSize(mxd, "CUSTOM", custom_width=60, custom_height=40, page_units="CENTIMETERS")

# Check in Production Mapping extension
arcpy.CheckInExtension("foundation")

ArcGIS Desktop

  • Home
  • Documentation
  • Support

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Esri Blog
  • User Conference
  • Developer Summit
Esri
Tell us what you think.
Copyright © 2021 Esri. | Privacy | Legal