General usage of the SRP Signature Control

The SRP Signature Control is an easy way to let user's add their signature to a work order or invoice. You simply provide the control, they sign it, and you export their signature for later printing.

Every single property of the SRP Signature Control can be set in the Form Designer's property list dialog box for the control, so setup is a snap.

The properties all define the look and feel of your control. The Background and Border properties are standard SRP properties. The SignatureColor and SignatureWidth property define the color and pen width of the user's signature respectively.

When the user hovers over the control, the mouse cursor will change to a pencil. If you desire a different cursor, or none at all, use the Cursor property.

The signature baseline is the line that appears on the control guiding the user as to where to sign. It has no effect on the signature itself. That is to say, if you move the baseline after the user has signed, the signature will not move with it. It's merely a visual cue to the user. The LineColor and LineWidth define the look of the signature baseline, and the Margin property determines the position. You can hide the signature baseline altogether by setting the ShowLine property to 0.


For convenience, the margin can be set either all at once using the Margin property or in parts using the MarginLeftMarginTopMarginRight, and MarginBottom properties.


The "sign here" X is simply for esthetics. It displays an X to the left of the signature line. It has no effects on the signature itself. You can customize the look of the X using the XColor and XWidth properties, or hide it altogether by setting the ShowX property to 0. If the ShowLine property is 0, then the "sign here" X is not displayed.

Once you are satisfied with the signature, you can export it in one of two ways: as a bitmap or a metafile. Bitmaps are raster images and therefore have a fixed resolution. Call the ExportToBitmap method to export your signature as a bitmap (.bmp). Metafiles are vector images and adapt to the resolution, though they don't have a set width or height making them harder to keep in proper aspect ration. Call the ExportToMetafile method to export you signature as a metafile (.wmf).

To clear the control of the current signature, use the Clear method. Note, however, that once a signature is gone, it cannot be retrieved.

  • No labels