# Signature Fields > Insert signature fields with SignatureFieldInsert in VB6, store the suggested signer, add a signature image and sign the fields when saving as PDF. - **Product:** TX Text Control ActiveX - **Section:** Documentation - **Kind:** Topic - **Path:** TX Text Control ActiveX > Document Editor > Signature Fields - **4360 words** - **Web URL:** https://docs.textcontrol.com/tx-text-control-activex/document-editor/signature-fields/ - **LLMs URL:** https://docs.textcontrol.com/tx-text-control-activex/document-editor/signature-fields/llms.txt - **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-activex/document-editor/signature-fields/llms-full.txt --- A signature field reserves the place in a `TXTextControl` document where somebody signs a contract, an approval or a delivery note. It is a rectangle that shows a signature line until it receives a signature image, it knows who is expected to sign and, when the document is saved as PDF, it can be associated with a digital certificate. Signature fields arrived in TX Text Control ActiveX 31.0. The Visual Basic 6 code below inserts a signature field the way the *TXWords* sample does, names it, stores the suggested signer, finds the fields of a document and signs them when the document is saved as PDF. ### What a Signature Field Is A signature field is an object in the text, like an image or a text frame, and it is placed the same ways: - **Anchored to a paragraph**, at a position relative to the paragraph, with text flowing around it. - **As a single character** in the text. - **At a fixed position** on a page. It has an identifier like any other object. The [ObjectCurrent](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectcurrent-property/llms-full.txt) property selects the object that the `Object...` and `Image...` properties change, and all of them work with signature fields: position, size, name, text flow and deletion. The programming category [Images, Text Frames, Signature Fields and OLE Objects](https://docs.textcontrol.com/tx-text-control-activex/reference/categories/images-objects/llms-full.txt) lists them. [Using Images](https://docs.textcontrol.com/tx-text-control-activex/document-editor/images/llms-full.txt) and [Using Text Frames](https://docs.textcontrol.com/tx-text-control-activex/document-editor/text-frames/llms-full.txt) explain the placement of objects in detail. Besides its layout, a signature field holds three things: - **A signature image.** The field is the site of a signature image, set with the [ImageFilename](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/imagefilename-property/llms-full.txt) property when the document is designed or later, when it is signed. Without an image, the field shows a gray background with a signature line. - **A name.** To be associated with a certificate, a signature field needs a name, set with the [ObjectName](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectname-property/llms-full.txt) property. - **Signer data.** The name, title, address, contact information and signing reason of a suggested signer, set with the [SignatureFieldSignerData](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldsignerdata-property/llms-full.txt) property. > Warning > > **Formats That Keep Signature Fields.** Signature fields are saved in the TX Text Control format and in PDF. All other formats save only the signature image. ### Insert a Signature Field Three methods insert a signature field, one for each kind of placement: | Method | Places the signature field | |---|---| | [SignatureFieldInsert](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsert-method/llms-full.txt) | anchored to a paragraph, with text flowing around it | | [SignatureFieldInsertAsChar](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsertaschar-method/llms-full.txt) | as a single character in the text | | [SignatureFieldInsertFixed](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsertfixed-method/llms-full.txt) | at a fixed position on a page | TXWords inserts a signature field from **Insert** > **Signature Field**. It anchors the field to the current paragraph, except while the input position is in the footnote section, where it inserts the field as a character: ```vbscript Private Sub mnuInsert_SigField_Click() On Error GoTo err If IsInFootnoteSection Then TXTextControl1.SignatureFieldInsertAsChar -1, 2880, 1440 Else TXTextControl1.SignatureFieldInsert -1, 0, 0, 0, 0, 0, 3, 100, 100, 100, 100 End If Exit Sub err: MsgBox err.Description, vbInformation, "TX Text Control Words" End Sub ``` The code works as follows: - `IsInFootnoteSection` is a variable of the sample, set in the handlers of the [FootnoteSectionActivated](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/footnotesectionactivated-event/llms-full.txt) and [FootnoteSectionDeactivated](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/footnotesectiondeactivated-event/llms-full.txt) events. - [SignatureFieldInsertAsChar](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsertaschar-method/llms-full.txt) takes a text position, here -1 for the current input position, and the width and height in *twips*, 1/1440 inch. The field is 2 inches wide and 1 inch high. [Text Formatting and Views](https://docs.textcontrol.com/tx-text-control-activex/document-editor/viewing/#measure-in-twips) explains twips. - [SignatureFieldInsert](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsert-method/llms-full.txt) takes, in this order: the text position (-1, the paragraph at the input position), the horizontal alignment (0, given by the next parameter), the horizontal and vertical position relative to the paragraph, the width and the height, the text flow (3, text flows around the field and fills the empty areas at its sides) and the distances to the text at the left, top, right and bottom, 100 twips each. - Width and height are 0 in the `SignatureFieldInsert` call. This starts a built-in mouse interface: the user draws a rectangle with the mouse, which sets the size of the field. ![A signature field drawn with the mouse below the text Signed by, selected with size handles and with the anchor symbol of its paragraph in the margin.](https://docs.textcontrol.com/assets/img/tx-text-control-activex/signature-field-selected.58ff2463.webp) #### Choose Size and Alignment in Code When your code sets the size, the field is inserted directly. The following call anchors a signature field of 3 by 1 inch to the paragraph at the input position, aligned at the paragraph's left edge: ```vbscript Dim sigFieldId As Integer sigFieldId = TXTextControl1.SignatureFieldInsert(-1, 1, 0, 0, 4320, 1440, 3, 100, 100, 100, 100) If sigFieldId = 0 Then MsgBox "The signature field could not be inserted." End If ``` The **Alignment** parameter is 0 to use the horizontal position, 1 to align the field left, 2 to align it right and 3 to center it in the paragraph. The **TextFlow** parameter is 2 when the text stops above the field and continues below it, or 3 when the text flows around it. Each insert method returns the identifier of the new signature field, or zero when it could not be inserted. It also sets [ObjectCurrent](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectcurrent-property/llms-full.txt) to the new field, so the properties in the next sections apply to it right away. For [SignatureFieldInsertFixed](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsertfixed-method/llms-full.txt), the first parameter is the page number, beginning with 1, and the position is relative to the page. The page number must be 0 when the [ViewMode](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/viewmode-property/llms-full.txt) property isn't set to Page View; the vertical position is then relative to the top of the control. ### Name the Signature Field A name identifies the field when the PDF document is signed. Set [ObjectName](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectname-property/llms-full.txt) while the field is the current object, directly after it was inserted or after setting `ObjectCurrent` to its identifier: ```vbscript TXTextControl1.ObjectCurrent = sigFieldId TXTextControl1.ObjectName = "ManagerSignature" ``` Setting a name replaces a name the field already has. ### Set the Suggested Signer [SignatureFieldSignerData](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldsignerdata-property/llms-full.txt) stores who is expected to sign. It is one string of six parts separated by TAB characters: 1. The signer's name. 2. The signer's title. 3. The signer's address. 4. The signer's contact information. 5. The reason why the document is signed. 6. A reserved part, which must be an empty string. Each of the first five parts can be empty. Setting the property replaces existing signer data of the current object: ```vbscript TXTextControl1.ObjectCurrent = sigFieldId TXTextControl1.SignatureFieldSignerData = "Jane Smith" & vbTab & "Sales Manager" & vbTab & _ "12 Main Street, Springfield" & vbTab & "jane.smith@example.com" & vbTab & _ "Approval of the offer" & vbTab ``` The last `vbTab` separates the empty reserved part. #### Edit the Signer Data in a Dialog Box TXWords has a **Signer Info** form, *frmSignerData.frm*, with the boxes **Name**, **Title**, **Address**, **Contact Info** and **Reason**. It opens from **Edit** > **Signature Field...**, which TXWords enables only while a signature field is selected. An object is selected when a frame with size handles is drawn around it; [ObjectGetSelected](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectgetselected-method/llms-full.txt) with `&H400` returns the selected signature field, or zero: ```vbscript mnuEdit_SigField.Enabled = (.ObjectGetSelected(OBJECTKIND_SIGFIELD) <> 0) ``` ![The Signer Info form of TXWords with the boxes Name, Title, Address, Contact Info and Reason filled in for a suggested signer.](https://docs.textcontrol.com/assets/img/tx-text-control-activex/signer-info-form.edb3c1d4.webp) `OBJECTKIND_SIGFIELD` is a constant of the sample's *tx.bas* module with the value `&H400`. Clicking an object makes it the current object, and the form relies on this: it reads and writes the signer data without setting `ObjectCurrent`. It splits the string into the boxes when it loads, and joins the boxes again when the user clicks **OK**: ```vbscript Public tx As TXTextControl Private Sub Form_Load() Dim signerData As String Dim subStrings As Variant signerData = tx.SignatureFieldSignerData If Len(signerData) = 0 Then signerData = vbTab & vbTab & vbTab & vbTab & vbTab tx.SignatureFieldSignerData = signerData End If subStrings = Split(signerData, vbTab) txtSignerName = subStrings(0) txtSignerTitle = subStrings(1) txtSignerAddress = subStrings(2) txtContactInfo = subStrings(3) txtReason = subStrings(4) End Sub Private Sub btnOK_Click() tx.SignatureFieldSignerData = txtSignerName & vbTab & txtSignerTitle & vbTab & txtSignerAddress & vbTab & txtContactInfo & vbTab & txtReason & vbTab Unload Me End Sub ``` The code works as follows: - The main form passes its control to the form's `tx` variable before it shows the form: `Set frmSignerData.tx = TXTextControl1`. - When the field has no signer data yet, `Form_Load` writes a string of six empty parts, so that `Split` always returns six elements. - `btnOK_Click` writes the five boxes back, followed by the TAB that separates the empty reserved part. ### Add a Signature Image [ImageFilename](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/imagefilename-property/llms-full.txt) sets the image file that the current signature field shows: ```vbscript TXTextControl1.ObjectCurrent = sigFieldId TXTextControl1.ImageFilename = "c:\signatures\jane-smith.png" ``` An empty string removes the image, and the field shows the gray background with the signature line again. [ImageExportFilename](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/imageexportfilename-property/llms-full.txt) and [ImageExportFormat](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/imageexportformat-property/llms-full.txt) set the file name and format of the signature image when the document is saved. ### Find the Signature Fields of a Document [ObjectNext](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectnext-method/llms-full.txt) with the object group `&H400` returns only signature fields. Starting with 0, it returns the first one; it returns 0 when there is no further field. The following procedure prints the name of every signature field: ```vbscript Private Sub ListSignatureFields() Dim objectId As Integer objectId = TXTextControl1.ObjectNext(0, &H400) Do While objectId <> 0 TXTextControl1.ObjectCurrent = objectId Debug.Print objectId, TXTextControl1.ObjectName objectId = TXTextControl1.ObjectNext(objectId, &H400) Loop End Sub ``` ### Sign the Document When Saving as PDF When the document is saved as PDF or PDF/A, the `txSignatureFields` attribute of the [LoadSaveAttribute](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/loadsaveattribute-property/llms-full.txt) property signs it digitally. The attribute is a string of four parts, separated by TAB characters, for each signature field: 1. The name of a certificate file that contains an X.509 certificate. 2. The password for this file. 3. The name of the signature field, as set with `ObjectName`. 4. The URL of a time server. Each certificate is associated with the signature field of that name in the PDF document. For a second signature field, its four parts follow the four parts of the first, and so on. For other formats than PDF and PDF/A, the attribute has no meaning. ```vbscript Private Sub SaveSignedPdf(certFile As String, certPassword As String, timeServerUrl As String) TXTextControl1.LoadSaveAttribute(txSignatureFields) = certFile & vbTab & _ certPassword & vbTab & "ManagerSignature" & vbTab & timeServerUrl TXTextControl1.Save "c:\contract.pdf", 0, 12, False End Sub ``` The code works as follows: - `LoadSaveAttribute(txSignatureFields)` associates the certificate file with the signature field named *ManagerSignature*. - [Save](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/save-method/llms-full.txt) with the format value 12 saves an Adobe PDF file; 14 saves PDF/A. For both formats, the last parameter must be False. [PDF Export](https://docs.textcontrol.com/tx-text-control-activex/pdf/llms-full.txt) covers the settings that PDF export needs, such as the Page View. ### Change the Layout or Delete a Signature Field The [ObjectAttrDialog](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectattrdialog-method/llms-full.txt) method opens the built-in dialog box for the selected object. For a signature field, it offers layout settings such as position, size and text distances, and image saving options when the field has a signature image. [ObjectDelete](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectdelete-method/llms-full.txt) deletes a signature field by its identifier and returns True when it could be deleted: ```vbscript If TXTextControl1.ObjectDelete(sigFieldId) Then sigFieldId = 0 End If ``` When code deletes the field this way, no [ObjectDeleted](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectdeleted-event/llms-full.txt) event occurs. ### Key Members | Member | Description | |---|---| | [SignatureFieldInsert](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsert-method/llms-full.txt) | Inserts a signature field anchored to a paragraph. | | [SignatureFieldInsertAsChar](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsertaschar-method/llms-full.txt) | Inserts a signature field as a single character. | | [SignatureFieldInsertFixed](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsertfixed-method/llms-full.txt) | Inserts a signature field at a fixed position on a page. | | [SignatureFieldSignerData](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldsignerdata-property/llms-full.txt) | Sets the data of the suggested signer of the current signature field. | | [ObjectCurrent](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectcurrent-property/llms-full.txt) | Sets or returns the object that the `Object...`, `Image...` and `SignatureField...` properties change. | | [ObjectName](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectname-property/llms-full.txt) | Names the signature field, which associates it with a certificate. | | [ImageFilename](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/imagefilename-property/llms-full.txt) | Sets the signature image of the current signature field. | | [ObjectNext](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectnext-method/llms-full.txt) | Enumerates objects; `&H400` returns only signature fields. | | [ObjectGetSelected](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectgetselected-method/llms-full.txt) | Returns the selected object; `&H400` looks only for signature fields. | | [LoadSaveAttribute](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/loadsaveattribute-property/llms-full.txt) | With `txSignatureFields`, associates certificates with signature fields in a PDF document. | The programming category [Images, Text Frames, Signature Fields and OLE Objects](https://docs.textcontrol.com/tx-text-control-activex/reference/categories/images-objects/llms-full.txt) lists all members for signature fields. ### Related Pages - [Form Fields](https://docs.textcontrol.com/tx-text-control-activex/document-editor/form-fields/llms-full.txt): text boxes, check boxes, lists and date fields for the user to fill in. - [Using Images](https://docs.textcontrol.com/tx-text-control-activex/document-editor/images/llms-full.txt): the placement, size and text flow that signature fields share with images. - [PDF Export](https://docs.textcontrol.com/tx-text-control-activex/pdf/llms-full.txt): saving documents as PDF and PDF/A. - [Document Protection](https://docs.textcontrol.com/tx-text-control-activex/document-editor/protection/llms-full.txt): restricting what the user may change in a document. - [A Word Processor](https://docs.textcontrol.com/tx-text-control-activex/document-editor/word-processor/llms-full.txt): the TXWords sample and its menus. --- ## Nearby - **Previous:** [Form Fields](https://docs.textcontrol.com/tx-text-control-activex/document-editor/form-fields/llms-full.txt) - **Next:** [Track Changes](https://docs.textcontrol.com/tx-text-control-activex/document-editor/track-changes/llms-full.txt)