easyPDF SDK Usermanual
PDF Creator Programming API  |  Download Free Trial  |  Contact Us to Purchase

FitInvalidMargins Property

Determines whether invalid margins are fixed by scaling (true) or by cropping (false).

bool FitInvalidMargins { get; set; }

Property FitInvalidMargins As Boolean

def getFitInvalidMargins(self)
def setFitInvalidMargins(self, value)
boolean getFitInvalidMargins() throws PrinterException
void setFitInvalidMargins(boolean value) throws PrinterException
function getFitInvalidMargins() 
function setFitInvalidMargins($value) 
BclPrnResult GetFitInvalidMargins(BclPrinter* pPrinter, BclBool* poutVal);
BclPrnResult SetFitInvalidMargins(BclPrinter* pPrinter, BclBool newVal);
Property FitInvalidMargins As Boolean

bepprint +Word -fitInvalidMargins [on|off]


Boolean (default value: True)


There might be a situation when incorrectly set up margins prevent successful printing. In this case, Microsoft Word pops up a dialog box, and if there is no user to manually close it, the conversion will time out and fail.

There are two possible solutions to this problem:

When FitInvalidMargins is True (this is the default value), easyPDF scales the document so that the margins fit on the page. This means that no information will be lost, but the entire document may be proportionally scaled down to a smaller size. Use this option if information loss is not permitted, but scaling the page is acceptable. Note that scaling only happens when margins are violated. Also note that even if one page violates the margins, the entire document may be scaled down.

When FitInvalidMargins is False, easyPDF crops the unprintable areas outside of the invalid margins. It is guaranteed that the document will not be resized, but some information loss may occur (for example, if an object is outside of the margins). Use this option if scaling the page is not permitted, but cropping on the edges is acceptable. Note that cropping only happens when margins are violated.

This property does not affect normal printing operation. It is only used when a margin violation occurs, which would cause a warning dialog to pop up. There is no cropping or scaling when all the content is inside the margins, and the margins fit on the paper. Yet easyPDF has to know how you prefer to handle the situation when this occurs.

Example Usage

Set oPrinter = CreateObject("easyPDF.Printer.8")

Set oPrintJob = oPrinter.WordPrintJob
oPrintJob.FitInvalidMargins = True

oPrintJob.PrintOut "C:\test\input.doc", "C:\test\output.pdf"