Control iSign

This control provides the functionality of CIC's ink capture and display technology for web developers.

To embed the control into your html page either use a tool like Microsoft Visual Interdev, Frontpage or similar, or add the following code to your source file. Using a tool will also make it a lot easier to set initial properties like borderstyle, bordercolor, inkcolor, etc. since you can use the built-in property sheets.

<OBJECT id=iSign1 style="WIDTH: 504px; COLOR: limegreen; HEIGHT: 192px"
name=iSign1 codeBase=../Cab/iSign.cab#version=3,2,0,5323
classid=clsid:93E5204A-4344-4381-8912-8A7091E0FAE5
data=data:application/x-oleobject;base64,SiDlk0RDgUOJEopwkeD65QADAAAXNAAA2BMAABMA////ABMAAAAAAAMAAgAAABMAAAD/AAMAAgAAAAMAAgAAAAMA7gIAAAMAAAAAAAMAAgAAAAgAAgAAAAAA width=504 height=192 VIEWASTEXT>


<PARAM NAME="_cx" VALUE="10927">
<PARAM NAME="_cy" VALUE="4842">
<PARAM NAME="BackgroundColor" VALUE="16777215">
<PARAM NAME="InkColor" VALUE="0">
<PARAM NAME="BorderStyle" VALUE="3">
<PARAM NAME="BorderColor" VALUE="0">
<PARAM NAME="InkWidth" VALUE="2">
<PARAM NAME="WritingGuide" VALUE="2">
<PARAM NAME="Timeout" VALUE="750">
<PARAM NAME="EncryptionEnabled" VALUE="0">
<PARAM NAME="Enabled" VALUE="1">
<PARAM NAME="EncryptionAlgorithm" VALUE="1">
<PARAM NAME="EncryptionKey" VALUE="">


</OBJECT>

 
Property Summary
int

BackgroundColor

Background color of the control window.

int

BorderStyle

Border style of the control window.

int

BorderColor

Border color of the control window.

int

Enabled

Enables/disables inking in control.

EncrAlg

EncryptionAlgorithm

Sets the encryption algorithm

int

EncryptionEnabled

Enables/disables the encryption of the ink.

string

EncryptionKey

Sets the encryption key

long

HashVal

Return the result(s) of the hashing done using InitHash, AddHash and FinishHash.  Each hash value is a long integer. 

bool

Initialized

READ-ONLY. TRUE if control is fully initialized.

int

InkColor

Current color of ink input.

int

InkWidth

Current width of ink input.

int

SamplingRate

READ-ONLY. The current sampling rate for the signature. This is needed for verifying the signature.

string

Signature

The signature data. Access this property to save or restore the control's contents from disk or a database.

int

Status

The status of the signature stream-in process.

int

TimeOut

The timeout for the InkReady event in milliseconds.

int

WritingGuide

Option of letter guide, signature guide or no guide.

 

Method Summary
long

AddHash(string sHash)

Adds string to be hashed to the current hashing session.

void

ClearSignature( )

Clears the signature in the control.

long

FinishHash( )

Finalizes the hashing session and returns the result in HashVal1 through HashVal5 or HashVal.

void

InitHash( )

Initiates a hashing session. Is used in conjunction with AddHash and FinishHash.

long

HasInk( )

Returns whether or not control contains any ink .

void

SetHashAlgorithm (int alg)

Set the hash mode.

 

Event Summary
 

OnInkReady

Occurs 750 milliseconds after the last pen-down point. The timeout can be changed using the Timeout property.

 

OnStrokeReady

Occurs immediately when the pen is lifted at the end of a stroke.

 

 

Property Details

BackgroundColor

public static int BackgroundColor

Background color of the control window.

VBScript Usage: object.BackgroundColor = 255


BorderStyle

public static int BorderStyle

Border style of the control window.

Options:

0
None
1
Single
2
Double
3
3D

VBScript Usage: Object.BorderStyle = 3;


BorderColor

public static int BorderColor

Border color of the control window.

VBScript Usage: object.BorderColor = 255


Enabled

public static int Enabled

Enables/disables inking in control.

Options:

0
Disabled
1
Enabled

VBScript Usage: object.CtlEnabled = "1"


EncryptionAlgorithm

public static EncrAlg EncryptionAlgorithm

Sets the encryption algorithm

Options:

-1
NONE
No encryption algorithm specified.
0
FAST CIC's FAST encryption algorithm
1
DES DES 56 bit encryption algorithm
2
DES_40 DES 40 bit encryption algorithm
3
TRIPLE_DES DES 128 bit encryption algorithm

VBScript Usage: object.EncryptionAlgorithm = 3


EncryptionEnabled

public static int EncryptionEnabled

Enables/disables the encryption of the ink.

Options:

0
Disabled
1
Enabled

VBScript Usage: object.EncryptionEnabled = "1"


EncryptionKey

public static string Encryptionkey

Sets the encryption key

VBScript Usage: object.Encryptionkey = "12345678"


HashVal

public static string HashVal

Return the result(s) of the hashing done using InitHash, AddHash and FinishHash.  Each hash value is a long integer. 

VBScript Usage: object.HashVal


Initialized

public static bool Initialized

READ-ONLY. TRUE if control is fully initialized.

VBScript Usage: object.Initialized


InkColor

public static int InkColor

Sets/gets the current color of ink input.

VBScript Usage: object.InkColor = 255


InkWidth

public static int InkWidth

Sets/gets the current width of ink input.

VBScript Usage: object.InkWidth


SamplingRate

public static int SamplingRate

READ-ONLY. The current sampling rate for the signature. This is needed for verifying the signature.

VBScript Usage: object.SamplingRate;


Signature

public static string Signature

The signature data. Access this property to save or restore the control's contents from disk or a database.

VBScript Usage: object.signature


Status

public static int Status

The status of the signature stream-in process.

Returns:

0
SigOK
The signature stream in process is OK
-1
SigError The signature stream process has an error

VBScript Usage: if (object.Status = 0) then   ' SigOK


TimeOut

public static int TimeOut

The timeout for the InkReady event in milliseconds.

VBScript Usage: object.TimeOut


WritingGuide

public static int WritingGuide

Option of letter guide, signature guide or no guide.

Options:

0
wgNONE No writing guide
1 wgUnderline Specify the underline guide
2 wgSignatureLine Specify the signature line guide

VBScript Usage:

object.WritingGuide = 2

 

Method Details

AddHash(string sHash)

public long AddHash(string sHash)

Adds string to be hashed to the current hashing session. The maximum length of a string is 32K bytes.

Returns:

0
Success
100 MaxLengthExceeded
101 Bad Mode

VBScript Usage: object.AddHash(signature )


ClearSignature()

public void ClearSignature()

Clears the signature in the control.

VBScript Usage: object.ClearSignature


FinishHash()

public long FinishHash()

Finalizes the hashing session and returns the result in HashVal1 through HashVal5.

Returns: Always returns Success = 0

VBScript Usage: object.FinishHash


HasInk( )

public long HasInk( )

Returns whether or not control contains any ink.

Returns:

0
no ink
1 ink exists

VBScript Usage: object.HasInk


InitHash()

public void InitHash()

Initiates a hashing session. Is used in conjunction with AddHash and FinishHash.

VBScript Usage: object.InitHash


SetHashAlgorithm (int alg)

public void SetHashAlgorithm (int alg)

Set the hash mode.

Mode :

0
HASH_SHA0
SHAO Algorithm
1
HASH_SHA1
SHA1 Algorithm

Default is SHA0. Once set, all hash operation are done in this mode until control is unloaded.

VBScript Usage: object.SetHashAlgorithm (1)

 

Event Details

OnInkReady

Occurs 750 milliseconds after the last pen-down point. The timeout can be changed using the Timeout property.

VBScript Usage: object_OnInkReady


OnStrokeReady

Occurs immediately when the pen is lifted at the end of a stroke.

VBScript Usage: object_OnStrokeReady