ViewDocOnDeviceDefaultZoom

Declaration

Delphi

function ViewDocOnDeviceDefaultZoom(startPage: integer; showSignButton: boolean; defaultZoomLevel: integer) : LongBool; stdcall;

ActiveX

HRESULT _stdcall ViewDocOnDeviceDefaultZoom([in] long startPage, [in] VARIANT_BOOL showSignButton, [in] long defaultZoomLevel, [out, retval] VARIANT_BOOL* result);

 

Description

A function to load the document page to the connected device. This function is only supported by devices with a colour display (e.g. Colour, Flawless, Brilliance) and it's not working for Black&White devices (e.g. Classic, Mobile). Before you call ViewDocOnDeviceDefaultZoom, be sure to have loaded a document with LoadDoc.

Important:

Be sure to call LoadDoc before calling this function! You also need to link the DeviceAPI to the SignAPI (see InitDeviceDLL / SignatureDevice ) and forward the ButtonEvents from DeviceAPI to SignAPI (OnDeviceLCDButtonHandler).

 

 

Arguments

ArgumentDescription
startPage

Page, which should be shown first.

showSignButton

Option to enable the SignButton on the device in the DocumentViewingMode, which is used to start the SignMode directly form the device. This button currently exists only on pads with colour displays.

defaultZoomLevel

With the values 0, 1, 2 you can define the zoom level at the start.

 

  • 0 = Fit to Width
  • 1 = Fit to LCD (complete Page)
  • 2 = maximal possible Zoom on Device


C# sample

AddSignature
// Show Document on the Device (Colour, Comfort and Flawless)

SignAPIv4.LoadDoc(@"c:\test\demo.pdf");
                
int page = 1;
int zoomLevel = 2;              // maximum zoom level 
bool signButton = true; 	// works only for ColourPad
 
bool status = SignAPIv4.ViewDocOnDeviceDefaultZoom(page, signButton, zoomLevel);