SignatureField Class

Description

An instance of the SignatureField class represents a signature field in a Text Control document. A signature field is a frame which can be inserted in a document and that acts as a site for a signature image. An image can be added, when the document is designed or later when it is digitally signed. When the document is saved as a .pdf document, each signature field can be associated with a digital certificate using the SaveSettings.SignatureFields property.

Syntax

public class SignatureField : FrameBase

Public Class SignatureField
    Inherits FrameBase

Examples

The following example adds a named signature field to the document.

SignatureField signatureField = new(new System.Drawing.Size(3000, 1000), "ApproverSignature", 10);
textControl.SignatureFields.Add(signatureField, FrameInsertionMode.AsCharacter);

Dim signatureField As New SignatureField(New System.Drawing.Size(3000, 1000), "ApproverSignature", 10)
textControl.SignatureFields.Add(signatureField, FrameInsertionMode.AsCharacter)

Members

Constructors

Constructor	Description
SignatureField	Initializes a new instance of the SignatureField class. A name is necessary when the signature field is associated with a digital certificate.

Properties

Property	Description
Alignment	Gets or sets the frame's horizontal alignment when it is anchored to a paragraph. (Inherited from FrameBase.)
Bounds	Gets the frame's bounding rectangle relative to the upper left corner of the document. (Inherited from FrameBase.)
DescriptiveText	Gets or sets a descriptive text for the frame. An empty string indicates that the frame has no such text. An empty string can also be used to delete a previously set text. (Inherited from FrameBase.)
ID	Gets or sets an identifier for the frame. It must be a one-based value. A value of zero indicates that the image, text frame, chart, barcode or drawing has no identifier. Zero can also be used to delete a previously set identifier. (Inherited from FrameBase.)
Image	Gets or sets a SignatureImage. The property's value is null, when the signature field has no signature image. When the property is set to null, a previously inserted image is removed.
InsertionMode	Gets or sets a value determining whether the frame is treated as a single character or the document's text either flows around or overwrites the frame. If the document's text flows around or overwrites the frame, this property also determines whether the image, text frame, chart, barcode or drawing is moved with the text or fixed positioned on a page. (Inherited from FrameBase.)
Location	Gets or sets, in twips, the frame's current location. If the image, text frame, chart, barcode or drawing is anchored to a paragraph, the location is relative to the paragraph. Otherwise, it is relative to the document. If the frame has a horizontal alignment or if it is inserted inline, this property returns zero. This property cannot be set for images, text frames, charts, barcodes or drawings which are inserted inline. (Inherited from FrameBase.)
Moveable	Determines whether a frame can be moved in the document at run time with the built-in mouse interface. (Inherited from FrameBase.)
Name	Gets or sets a name for the frame. An empty string indicates that the frame has no name. An empty string can also be used to delete a previously set name. (Inherited from FrameBase.)
SignerData	Gets or sets a suggested signer's name, title and address and a reason why to sign the document. The property's value is an object of the type SignerData.
Size	Gets or sets the frame's size in twips. For images this property is read only. (Inherited from FrameBase.)
Sizeable	Determines whether the frame can be resized at run time with the built-in mouse interface. (Inherited from FrameBase.)
TextDistances	Gets or sets the distances, in twips, between the frame and the document's text. The property's value is an array of four variables specifying the distances in the following order: left, top, right and bottom. If a value is set to -1, it is not changed. (Inherited from FrameBase.)
TextPosition	Read only. Gets the frame's character position in the document's text (one-based). (Inherited from FrameBase.)

Methods

Method	Description
ChangeZOrder	Changes the frame's z-order. (Inherited from FrameBase.)