# SignatureFieldInsert Method

> Inserts a signature field anchored to a paragraph, with alignment, position, size and distances in twips and text flow, and returns its identifier or zero.

- **Product:** TX Text Control ActiveX
- **Section:** Documentation
- **Kind:** Method
- **Path:** TX Text Control ActiveX > API Reference > TXTextControl > SignatureFieldInsert Method
- **853 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsert-method/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsert-method/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsert-method/llms-full.txt

---

This method inserts a new signature field anchored to a paragraph. The text flows around the signature field.

Introduced: 31.0.

### Syntax

```vbscript
TXTextControl.SignatureFieldInsert TextPos, Alignment, PosX, PosY, Width, Height, TextFlow, DistanceL, DistanceT, DistanceR, DistanceB
```

### Parameters

| Parameter | Description |
|---|---|
| TextPos | Specifies a text position in the paragraph where to insert the signature field. If TextPos is -1, the signature field is anchored to the paragraph at the current input position. |
| Alignment | Specifies the signature field's horizontal alignment. It can be one of the following values: |
| PosX | Specifies the signature field's horizontal position in [twips](https://docs.textcontrol.com/tx-text-control-activex/document-editor/viewing/#measure-in-twips) relative to the left border of the paragraph. This value is used if the Alignment parameter has been set to 0. |
| PosY | Specifies the signature field's vertical position in [twips](https://docs.textcontrol.com/tx-text-control-activex/document-editor/viewing/#measure-in-twips) relative to the top border of the paragraph. |
| Width | Specifies the width of the signature field in [twips](https://docs.textcontrol.com/tx-text-control-activex/document-editor/viewing/#measure-in-twips). If this parameter is set to zero, a built-in mouse interface is started which enables the end-user to define the size of the signature field through a rectangle, drawn with the mouse. |
| Height | Specifies the height of the signature field in [twips](https://docs.textcontrol.com/tx-text-control-activex/document-editor/viewing/#measure-in-twips). If this parameter is set to zero, a built-in mouse interface is started which enables the end-user to define the size of the signature field through a rectangle, drawn with the mouse. |
| TextFlow | Specifies how text flows around the signature field. It can be one of the following values: |
| DistanceL, DistanceT, DistanceR, DistanceB | Specifies distances, in [twips](https://docs.textcontrol.com/tx-text-control-activex/document-editor/viewing/#measure-in-twips), between the signature field and the document's text. |

#### Alignment

| Value | Description |
|---|---|
| 0 | The horizontal position is given through the PosX parameter. |
| 1 | The signature field is left aligned relative to the paragraph to which it is anchored. |
| 2 | The signature field is right aligned relative to the paragraph to which it is anchored. |
| 3 | The signature field is centered relative to the paragraph to which it is anchored. |

#### TextFlow

| Value | Description |
|---|---|
| 2 | The text stops at the top and continues at the bottom of the signature field. |
| 3 | The text flows around the signature field. Empty areas at the left and right side are filled. |

### Return Value

The method returns the signature field's identifier, if a new signature field could be inserted. Otherwise, it returns zero. The signature field's identifier can also be obtained with the [ObjectCurrent](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectcurrent-property/llms-full.txt) property.

### Data Types

| Name | Data type |
|---|---|
| TextPos | Long |
| Alignment | Integer |
| PosX | Long |
| PosY | Long |
| Width | Integer |
| Height | Integer |
| TextFlow | Integer |
| DistanceL | Integer |
| DistanceT | Integer |
| DistanceR | Integer |
| DistanceB | Integer |
| Return value | Integer |

### See Also

- [SignatureFieldInsertAsChar Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsertaschar-method/llms-full.txt)
- [SignatureFieldInsertFixed Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsertfixed-method/llms-full.txt)
- [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)

---

## Nearby

- **Previous:** [ShrinkFont Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/shrinkfont-method/llms-full.txt)
- **Next:** [SignatureFieldInsertAsChar Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/signaturefieldinsertaschar-method/llms-full.txt)