signcap – Datenaustausch

Die Funktionalität der Schnittstellen unterscheidet sich teilweise; am Anfang jeder Beschreibung ist gekennzeichnet, für welche Schnittstelle die Methode oder Eigenschaft gültig ist.

Eigenschaft SignData

Enthält die digitalisierte Unterschrift im SignData-Format.

Erst verfügbar nach dem erfolgreichen Aufruf von Capture.

object SignData

VARIANT SignData

Eigenschaft SignDataBase64

Enthält die digitalisierte Unterschrift als base64-kodierten String.

Erst verfügbar nach dem erfolgreichen Aufruf von Capture.

string SignDataBase64

BSTR SignDataBase64

Eigenschaft PadData

Für die Schnittstelle PadTabletPC enthält die Eigenschaft die Unterschriftendaten im Rohformat als eine Zeichenkette (Null-terminiert). In dem Rohformat sind unter anderem die Unterschriftenkoordinaten und die Zeitwerte für diese enthalten. Für die Schnittstelle IPadSignotecSignatureDevice enthält die Eigenschaft die SignData als Base64-kodierten String.

Erst verfügbar nach dem erfolgreichen Aufruf von Capture.

object PadData

VARIANT PadData

Eigenschaft Image

Rendert die aktuelle Unterschrift als Bild (ohne biometrische Zusatzdaten). Standardmäßig ist das Bild im TIFF-Format, mit SaveSignatureEx kann aber auch ein anderes Format gewählt werden. Dazu muss SaveSignatureEx vor Capture aufgerufen werden. Je nach eingestelltem Format wird ein Bytearray oder ein String zurückgegeben.

Erst verfügbar nach dem erfolgreichen Aufruf von Capture.

Wird die Schnittstelle für Tablet PCs verwendet, wird ein globales Handle auf das Bild zurückgegeben. Nach dem Abrufen muss es mittels der Methode FreeHandle, SaveSignature oder SaveSignatureEx aus dem internen Speicher gelöscht werden. Bei letzteren beiden Methoden muss dafür der Parameter “bDeleteImage” auf true gesetzt sein.

object Image

VARIANT Image

Eigenschaft PadID

Enthält die eindeutige Identifikationsnummer (ID) für das angeschlossenen Pad. Erst verfügbar nach dem erfolgreichen Aufruf von Capture.

string PadID

BSTR PadID

Methode Capture

Mit dieser wird das Einholen der Unterschriftendaten durchgeführt. Auf der entsprechenden Hardware wird ein Unterschriftenfenster angezeigt, in dem der Benutzer unterschreiben und danach die Unterschrift bestätigen kann.

Danach kann über die entsprechenden Methoden und Eigenschaften auf die Unterschriftendaten zugegriffen werden.

Bei einem Fehler (zum Beispiel keine Hardware angeschlossen oder nicht richtig konfiguriert) oder einem Abbruch (zum Beispiel auf Benutzerwunsch oder wegen zu kurzem geleisteten Unterschriftenzug) liefert die Methode einen Fehlercode zurück (HRESULT). Bei schweren Fehlern wird der Benutzer über die Art des Fehlers mittels eines Dialogs informiert. Die Datenstrukturen für die Signatur bleiben im Fehlerfall leer.

Verschiedene Bildeigenschaften und Padeinstellungen können vor dem Aufruf dieser Methode geändert werden. Die relevanten Methoden sind hier beschrieben.

void Capture();

HRESULT Capture();

Methode SaveSignature

Speichert den erfassten Unterschriftenzug (entspricht der Eigenschaft Image) als Bild in die angegebene Datei.

Aufruf dieser Methode ist erst nach dem erfolgreichen Aufruf von Capture möglich.

Das gespeicherte Bild ist schwarz-weiß (1-bitig).

void SaveSignature(string bstrFileName,int bDeleteImage);

HRESULT SaveSignature(BSTR bstrFileName, long bDeleteImage);

Methode SaveSignatureEx

Speichert den erfassten Unterschriftenzug (entspricht der Eigenschaft Image) als Bild in die angegebene Datei.
Der Parameter „nImgType“ definiert, in welchem Bildformat der Unterschriftenzug gespeichert werden soll.

Das Speichern mit dieser Methode ist erst nach dem erfolgreichen Aufruf von Capture möglich, kann aber für IPadSignotecSignatureDevice vor Capture zum Setzen des Bildformats aufgerufen werden.

Das gespeicherte Bild ist schwarz-weiß (1-bitig).

void SaveSignatureEx(
                     string bstrFilename,
                     int nImgType,
                     int bTimeStamp,
                     int bDeleteImage
                     );

HRESULT SaveSignatureEx(
                        BSTR bstrFilename,
                        int nImgType,
                        long bTimeStamp,
                        long bDeleteImage
                        );

Methode FreeHandle

Gibt das intern gespeicherte Bild der aktuellen Unterschrift frei. (Dies entspricht der Eigenschaft Image).

void FreeHandle();

HRESULT FreeHandle();