Sign in Join
FPDoc Onlineexperiment

TPrinter.DoGetPaperRect function

Member of TPrinterprotectedIn unit Printers

Performs actions needed to get the dimensions (rectangle) for the specified paper.

Declaration

pascal
function DoGetPaperRect(aName: string; var aPaperRc: TPaperRect)
: Integer; virtual

Arguments

aName

Paper name to locate for the selected printer.

aPaperRc

Rectangle with the dimensions for the paper.

Function result

0 for margins, 1 for physical paper, -1 when not found.

Description

DoGetPaperRect is an Integer function used to get the dimensions (or rectangle) for the specified paper name. The return value indicates whether the rectangle represents the margins or the actual work area for the specified paper name.

0
aPaperRc is the margins for the specified paper name.
1
aPaperRc is the physical dimensions for the work area in the paper.
-1
A paper with the specified name was not found, or its dimension are not known.
In TPrinter, DoGetPaperRect always returns -1. It must be overridden in a descendant class to use the facilities for the printer type to get page areas.

See also

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.