When preparing the document viewer to acquire signatures from users, the SignatureSettings property must be set with an instance of a SignatureSettings object.

SignatureSettings Object

The following table lists the used SignatureSettings in the above MVC Html helper code.

Consider the following HTML Helper code that is adding a document viewer instance to an MVC Razor page:

@Html.TXTextControl().DocumentViewer(settings => {
   settings.DocumentPath = Server.MapPath("~/App_Data/signature.tx");
   settings.Dock = DocumentViewerSettings.DockStyle.Fill;
   settings.IsSelectionActivated = false;
   settings.ShowThumbnailPane = true;
   settings.SignatureSettings = new SignatureSettings() {
     ShowSignatureBar = true,
     OwnerName = "Paul Paulsen",
     SignerName = "Tim Typer",
     SignerInitials = "TT",
     SignatureBoxes = new SignatureBox[] { 
         new SignatureBox("txsign") { 
            SigningRequired = true, Style = SignatureBox.SignatureBoxStyle.Signature },
         new SignatureBox("txsign_init") { 
            SigningRequired = true, Style = SignatureBox.SignatureBoxStyle.Initials }}
   };
}).Render()

Signer Information

The following screenshot shows the specified values in the document viewer:

Additionally, in the above code, the SignatureBoxes property is defined with an array of SignatureBox objects.

Activate Signature Fields

When taking a look again at the code, two signature boxes are activated: txsign and txsign_init. txsign is defined as a signature box to acquire a signature and txsign_init is initialized as an initials box. Both fields are defined as a required field during the signature process.

SignatureBoxes = new SignatureBox[] { 
  new SignatureBox("txsign") { 
    SigningRequired = true, Style = SignatureBox.SignatureBoxStyle.Signature },
  new SignatureBox("txsign_init") { 
    SigningRequired = true, Style = SignatureBox.SignatureBoxStyle.Initials }}

Now consider the following template with 4 signature fields. The first two fields have the names that match the signature boxes in the above code. The other two fields have different names.

When initializing the document viewer, the first two defined signature fields are activated to request signatures.

Why is that useful? Consider a document that should be signed by 2 or more different parties. If the document is deployed to signer A, only those signature boxes are activated to acquire the visual signature representation.