Printing and Layouts

The table below lists all of the GISDK functions that are used to set up and configure printers and to print maps, editors, and layout windows:

GISDK Function	Summary
EditorPrintSetup()	Displays an extended version of the "Print" common dialog, with controls for setting up the printing format for an editor.
FigurePrintSetup()	Displays the "Print" common dialog
GetDefaultPrinter()	Gets the default printer
GetLayoutPrinter()	Gets the printer for a layout window
GetLayoutPrintSettings()	Gets the layout printer settings
GetLayoutPrintSize()	Gets the size of a layout printer's imageable area
GetLayoutResizeItems()	Gets whether items in a layout are resized automatically when the page size or number of pages changes
GetLayoutSaveFlag()	Determines whether a layout has changed since it was last saved to a file
GetPrinters()	Gets the model and driver names for all installed printers
GetPrintMargins()	Gets the current print margin settings
GetLayoutPrinter()	Gets the printer for a layout window
LayoutPrintSetup()	Collects printer settings for a layout window
MapPrintSetup()	Displays an extended version of the "Print" common dialog, with check boxes for whether to print at a fixed scale and whether to print fonts at fixed point size or adjusted to match the map window
PrintEditor()	Prints all or part of an editor window
PrintFigure()	Prints a figure as shown in the figure window
PrintLayout()	Prints all or part of a layout window
PrintMap()	Prints a map as shown in the map window
SetLayoutPrinter()	Sets the printer for the current layout window
SetLayoutPrintSettings()	Sets the layout printer settings
SetLayoutResizeItems()	Sets items in a layout to resize automatically when the page size or number of pages changes
SetPrintMargins()	Sets the left, top, right, and bottom printing margin settings

The table below lists GISDK functions that support the manipulation of layout windows:

GISDK Function	Summary
AddAnnotation()	Adds an annotation to a map or layout window
CenterLayout()	Centers a layout at a specific point
ClickAndDragLayout()	Allows the user to pan around in a layout by dragging it to a new position
ClickLayout()	Allows user to edit annotations in the current map or layout
DrawLayout()	Redraw a layout window
GetLayoutPages()	Gets the number of printed pages in a layout
GetLayoutScale()	Gets the scale of a layout window
GetPaperUnitNames()	Gets a list of the available paper measurement units
GetPaperUnits()	Gets the current paper measurement unit
GetUnitSize()	Computes the ratio between two measurement units
LayoutProperties()	Displays an extended version of the "Print Setup" common dialog, with controls for setting page dimensions and margins
SetLayoutPages()	Sets the number of printed pages in a layout
SetLayoutPrevious()	Changes the layout window to display at the scale that was in effect before the most recent change
SetLayoutScale()	Sets the scale of a layout window
SetPaperUnits()	Sets the current paper measurement unit
SetVisibleRectangle()	Controls the portion of a layout that is displayed in a layout window
ZoomLayout()	Changes the layout scale by a factor

When working in a layout, locations on the layout page are specified using coordinates, where the measurements are in hundredths of a printer's point (1/7200ths of an inch) from the upper-left hand corner of the layout. For example:

// On an 8-1/2" X 11" layout...
x = Coord(3600, 3600)	// x is 0.5 inches from the top and 0.5 inches from the left
y = Coord(57600, 57600)	// y is 0.5 inches from the bottom and 0.5 inches from the right

pgsize = GetlayoutPrintSize()	// Total printable width and height...
mrgn = GetlayoutPrintMargins()	// Margins on each printed sheet...
lpgs = GetlayoutPages()	// Number of pages across and down...

// Compute the center of the layout, left to right

center_horiz = (lpgs[1] * pgsize.lon + mrgn[1] + mrgn[3]) / 2.0

// Compute the center of the layout, top to bottom

center_vert = (lpgs[2] * pgsize.lat + mrgn[2] + mrgn[4]) / 2.0