The TX Text Control SignatureField objects are compatible to the Signature Line element in MS Word. This article shows how to insert those elements in MS Word in order to import and process these objects in TX Text Control.

Creating Signature Lines in MS Word

To create a document in MS Word that contains a signature line, use the Signature Line button in the Text ribbon group of the Insert ribbon tab.

In the opened dialog, additional information can be added to the signature line. These values are available in the SignatureField class when importing the document into TX Text Control.

After clicking OK, the signature line is inserted into the document.

Processing SignatureFields

After loading the document into TX Text Control, the signature lines are accessible through the SignatureFieldCollection.

using (TXTextControl.ServerTextControl tx = new ServerTextControl()) {
  tx.Create();
  tx.Load("test.docx", TXTextControl.StreamType.WordprocessingML);

  foreach (SignatureField field in tx.SignatureFields) {
     Debug.WriteLine(JsonConvert.SerializeObject(field));
  }
}

All signature properties have been imported:

{
   "Image":null,
   "SignerData":{
      "Name":"Klaus Signer",
      "Title":"Chief Signer",
      "Address":"",
      "ContactInfo":"signer@klaus.com",
      "Reason":""
   }
}

TX Text Control provides additional SignerData properties to be compatible to the Adobe PDF format when signing PDF documents.

Signing SignatureFields

An X509Certificate2 certificate object is created from a PFX file that is then assigned to all signature fields. The list of signatures is provided through the SignatureFields property to the Save method to export the signed document as an Adobe PDF document.

using (TXTextControl.ServerTextControl tx = new ServerTextControl()) {
  tx.Create();
  tx.Load("test.docx", TXTextControl.StreamType.WordprocessingML);

  List<TXTextControl.DigitalSignature> digitalSignatures = new List<DigitalSignature>();

  foreach (SignatureField field in tx.SignatureFields) {
     digitalSignatures.Add(new DigitalSignature(
     new System.Security.Cryptography.X509Certificates.X509Certificate2(
        "textcontrolself.pfx", "123"), null, field.Name));
  }

  SaveSettings saveSettings = new SaveSettings() {
     SignatureFields = digitalSignatures.ToArray()
  };

  tx.Save("results.pdf", TXTextControl.StreamType.AdobePDF, saveSettings);
}