signoAPI iOS – Klasse STSignatureCaptureViewController

Die Klasse STSignatureCaptureViewController ist der wichtigste Bestandteil der Bibliothek libSignoSignatureCapture. Diese Klasse kann zur Anzeige eines Dialogs zum Erfassen einer Unterschrift verwendet werden. Die Klasse STSignatureCaptureViewController unterstützt derzeit für das Property modalPresentationStyle nur den Wert UIModalPresentationFullScreen. Die Klasse ist Bestandteil sowohl der libSignoPDFSigner als auch der libSignoSignatureCapture.

@interface STSignatureCaptureViewController : UIViewController 

Anwendung:

STSignatureCaptureViewController
       *signoCaptureVC = [[STSignatureCaptureViewController alloc] init];
signoCaptureVC.modalPresentationStyle = UIModalPresentationFullScreen;
[self presentViewController:signoCaptureVC animated:YES completion:nil];

oder

STSignatureCaptureViewController
       *signoCaptureVC = [[STSignatureCaptureViewController alloc] init];
signoCaptureVC.modalPresentationStyle = UIModalPresentationFullScreen;
[self.view addSubview:signoCaptureVC.view];

Eigenschaft signCaptureDelegate

Mit dieser Eigenschaft kann die Instanz gesetzt werden, die die Klasse STSignatureCaptureDelegate implementiert und somit über Ereignisse im STSignatureCaptureViewController informiert werden soll.

@property (weak, nonatomic) id signCaptureDelegate

Eigenschaft

Bedeutung

id signCaptureDelegate

-

Rückgabewert

Bedeutung

-

-

Anwendung:

signoCaptureVC.signCaptureDelegate = self;

Methode configureDialog:withCaptureConfig:

Mit dieser Methode kann der Signaturdialog positioniert und konfiguriert werden. Die Konfiguration wird ignoriert, wenn die Eigenschaft enableFullScreenCapture der Klasse STSignatureCaptureConfig auf YES gesetzt wird.

-(void)configureDialog:(CGRect)frame withCaptureConfig: (STSignatureCaptureConfig*)captureConfig

Parameter

Bedeutung

(CGRect)frame

Positionsangabe des Signaturdialogs.

(STSignatureCaptureConfig*)captureConfig

Das STSignatureCaptureConfig–Objekt oder nil.

Rückgabewert

Bedeutung

-

-

Anwendung:

STSignatureCaptureConfig *sigCapConfig = 
[[STSignatureCaptureConfig alloc] init];
sigCapConfig.displayText = @"Display Name";
sigCapConfig.font = [UIFont fontWithName:@"Helvetica" size:24];
sigCapConfig.textColor = [UIColor blackColor];
sigCapConfig.position = CGRectMake(30.0f, 30.0f, 200.0f, 30.0f);
sigCapConfig.signatureColor = [UIColor blueColor];

[signoCaptureVC configureDialog:CGRectMake(0, 0, 650, 500)
withCaptureConfig:sigCapConfig];

Methode getSignatureImage:height:penColor:penWidth:

Diese Methode gibt die zuletzt erfasste Unterschrift als Bild im PNG-Format zurück.

-(NSData*)getSignatureImage:(CGFloat)width height:(CGFloat)height penColor:(UIColor*)penColor penWidth:(int)penWidth

Parameter

Bedeutung

(CGFloat)width

Maximale Breite des Bildes in Pixeln.

(CGFloat)height

Maximale Höhe des Bildes in Pixeln.

(UIColor*)penColor

Farbe der Unterschriftlinie.

(int)penWidth

Breite der Unterschriftlinie in Pixeln.

Rückgabewert

Bedeutung

NSData*

Das Signaturbild als Byte-Array oder nil.

Anwendung:

NSData* signatureImageData = [signoCaptureVC getSignatureImage:650 height:500 penColor:[UIColor blueColor] penWidth:5];

Methode getSignData

Diese Methode gibt die zuletzt erfasste Unterschrift im SignData-Format zurück.

-(NSData*)getSignData

Parameter

Bedeutung

-

-

Rückgabewert

Bedeutung

NSData*

Die SignData als Byte-Array oder nil.

Anwendung:

NSData* signData = [signoCaptureVC getSignData];

Methode setLicenseKey:

Mit dieser Methode kann die Komponente libSignoSignatureCapture freigeschaltet und somit der Demo-Hinweis entfernt werden. Bitte verwenden Sie den Lizenzstring, der Ihnen von Ihrem Kontakt bei signotec mitgeteilt worden ist.

ℹ️ Hinweis: Diese Methode kann nur für Lizenzschlüssel im alten Format verwendet werden. Wenn Sie einen Lizenzschlüssel im neuen UUID-Format (XXXXXXXX–XXXX–XXXX–XXXX–XXXXXXXXXXXX) haben, verwenden Sie bitte die Klasse STLicenceManager.

+(void)setLicenseKey:(NSString*)key

Parameter

Bedeutung

(NSString*)key

Lizenzstring

Rückgabewert

Bedeutung

-

-

Anwendung:

[STSignatureCaptureViewController setLicenseKey:@"1234"];