Skip to end of metadata
Go to start of metadata

Declaration

Delphi

function SetLcdButtonOptions(Button,Mode, Enabled,Visible,  Color: Integer ) :integer; register;

C/C++

int __stdcall SOPAD_function SetLcdButtonOptions(Button,Mode, Enabled,Visible,  Color: Integer ) ;

ActiveX

function SetLcdButtonOptions(Button,Mode, Enabled,Visible,  Color: Integer ) :integer; safecall;

Description

The SetLcdButtonOptions function allows to enable predefined buttons for different pad modes. The buttons are only part of the Firmware of the colour devices, the B/W devices does not support this option. 

Reference to button event handling: OnDeviceButton, OnDeviceButtonEx

Arguments

Button

    the button ID  ( more info)  

Button codedescriptionDeviceSupportmode=0mode=5mode=6
HID_CMD_BUTTON_ZOOM_P         =200Zoom into PageColourPad, Flawless, Comfort, Brilliance, 10" Pad-yes-
HID_CMD_BUTTON_ZOOM_M         =201Zoom out of PageColourPad, Flawless, Comfort, Brilliance, 10" Pad-yes-
HID_CMD_BUTTON_NEXT           =202Next Page or SignatureColourPad, Flawless, Comfort, Brilliance, 10" Padyesyesyes
HID_CMD_BUTTON_PREV           =203Previous Page or SignatureColourPad, Flawless, Comfort, Brilliance, 10" Padyesyesyes
HID_CMD_BUTTON_START_SIGN     =204Start Sign from PadColourPad, Flawless, Comfort, Brilliance, 10" Pad-yes-
HID_CMD_BUTTON_ROTATE         =205Rotate Display (left / right hand mode)ColourPad, Flawless, Comfort, Brilliance, 10" Padyesyesyes
HID_CMD_BUTTON_OK             =206Confirm the SignatureBrilliance, 10" Padyes-yes
HID_CMD_BUTTON_REPEAT         =207Repeat the SignatureBrilliance, 10" Padyes-yes
HID_CMD_BUTTON_CANCEL         =208Cancel the SignatureBrilliance, 10" Padyes-yes
HID_CMD_BUTTON_ROTATE90      =209landscape or portrait mode ( GEN 13 PAD)10" Padyesyesyes

 

 

Mode

0:  default signature mode

5: Document view mode

6: sign in document mode

Enabled

0:  disable

1: enable

Visible

0 :  not visible

1: visible

Color

BGR color of the button, 32 Bit (TColor type in Delphi):

Bit 31 - 24 : 00h (all zero)

Bit 23 - 16 : Intensity of Blue

Bit 15 - 08 : Intensity of Green

Bit 07 - 00 : Intensity of Red

The value 00FF0000h represents full-intensity, pure blue.

The value 0000FF00h is full intensity pure green.

The value 000000FFh is pure red.

The value 00000000h is black.

The value 00FFFFFFh is white.

 

The default used color values are:

    Blue      = 00FF0000h

    Green   = 00369000h

    Yellow   = 0038CCF0h

    Red      = 001A00E2h

    White   = 00FFFFFFh

    Grey    = 00B5B5B5h

Return value

const  SOPAD_ERROR_SUCCESS     = (0);

 const  SOPAD_ERROR_FNC_FAILURE     = (12);    // may be because ther is no signature device initialized

 const  SOPAD_ERROR_FNC_NOTSUPORTED = (13);  //not suported for this signature device

 

Sample

C#
            
if (devicetyp == "StepOver duraSign Pad Brilliance")
{
        SigDev.OnDeviceButtonEx += new AxStepOverSignatureDevice1.IStepOverSignatureDeviceEvents_OnDeviceButtonExEventHandler(SigDev_OnDeviceButtonEx);
                
	// Colour in Red(0x000000FF), you can change the colour Blue(0x00FF0000), Green(0x0000FF00), Yellow(0x0000FFFF)... 
	SigDev.SetLCDButtonOptions(206, 0, 1, 1, 0x0000FF00); 
	SigDev.SetLCDButtonOptions(207, 0, 1, 1, 0x0000FFFF); 
	SigDev.SetLCDButtonOptions(208, 0, 1, 1, 0x000000FF);
}
 
 
private void SigDev_OnDeviceButtonEx(object sender, AxStepOverSignatureDevice1.IStepOverSignatureDeviceEvents_OnDeviceButtonExEvent e)
{
      int ID = Convert.ToInt32(e.buttonEvent >> 16);
      int Mode = Convert.ToInt32(e.buttonEvent << 16);
      
	//  Check buttonID
             
       switch (ID)       
       {                
		case 206:	//  OK Button
                		break;
                
		case 207:	//  Repeat Button
				break;
                
		case 208:	//  Abort Button
                     		break;       
	}
}

 

 

  • No labels