SetGlobalMeasurementUnits

Version history

This function was introduced in Quick PDF Library version 17.15.

Description

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

This is similar to the SetMeasurementUnits function however that function only changes the measurement units 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 be changed for the selected document, either loaded using LoadFromFile, LoadFromStream or LoadFromString or subsquently selected with SelectDocument.

This function will also change the measurement units of the standalone functions such as ExtractFilePageText or direct access functions such as DAExtractPageText, DAGetPageWidth, DAGetPageHeight, etc.

Syntax

Delphi

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

ActiveX

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

DLL

int DPLSetGlobalMeasurementUnits(int InstanceID, int MeasurementUnits)

Parameters

MeasurementUnits

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