Declaration

Delphi

procedure SetSignText(lineNum: Integer; Text: ShortString);

C/C++

SOPAD_API void SOPAD_setSignText(int nLineNumber, const char* szText);

ActiveX

HRESULT SetSignText([in] long lineNum, [in] BSTR Text);

Description

It's possible to display custom text on the pad's LCD during signing. This function allows to define custom text for one line of the LCD. For built-in 8x8 font there are 30 lines available, each of them is 40 characters width. Text will be drawn on the call of startRead function.

By Devices with Colour Displays an additional LCDImageExR(5, 0, 0, 0) call is required. The LCDImageExR call also contain another background image, in that case the deviceapi will merge the text and the image before the upload.

Arguments

lineNum

Line number, starting from 1.

Text

Text string.

Sample

//  before you call SetSignText be sure the Signature Pad is connected
axStepOverSignatureDevice1.checkConnectedPad("", true, true, true, ref padsettings);

axStepOverSignatureDevice1.SetSignText(1, "Line 1...............");
axStepOverSignatureDevice1.SetSignText(2, "Line 2...............");
axStepOverSignatureDevice1.SetSignText(3, "Line 3...............");

//  LCDImageExR call is required for Signature Pads with Colour Displays
axStepOverSignatureDevice1.LCDImageExR(5, 0, 0, 0);