SetMeasurementUnits

Description

Set the units to use for all measurements given to and returned from the library, for the selected document.

Default user space is exactly 1/72 inches per unit, which is approximately the same as a "point", a unit used in the printing industry. 25.4 millimetres is one inch.

The measurement units will only be changed for the selected document, either loaded using LoadFromFile, LoadFromStream or LoadFromString or subsquently selected with SelectDocument.

This function does not have an effect on the standalone functions such as ExtractFilePageText or direct access functions such as DAExtractPageText, DAGetPageWidth, DAGetPageHeight, etc. For those it's necessary to rather use the SetGlobalMeasurementUnits function.

Syntax

Delphi

function TDebenuPDFLibrary1811.SetMeasurementUnits(
MeasurementUnits: Integer): Integer;

ActiveX

Function DebenuPDFLibrary1811.PDFLibrary::SetMeasurementUnits(
MeasurementUnits As Long) As Long

DLL

int DPLSetMeasurementUnits(int InstanceID, int MeasurementUnits)

Parameters

MeasurementUnits

The units to use:
0 = Default user space
1 = Millimetres
2 = Inches
Anything else = Default user space