ArcMap

SetPageSize

获得 Production Mapping 许可后可用。

描述

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.

讨论

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.

语法

SetPageSize (map_document, size, {orientation}, {custom_width}, {custom_height}, {page_units})
参数说明数据类型
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.

(默认值为 Inches)

String

代码示例

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")