# SignatureFieldInsertAsChar Method

> Inserts a signature field as a single character at a text position, with width and height in twips or drawn with the mouse, and returns its identifier.

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

---

This method inserts a new signature field, which is then handled as a single character in the text.

Introduced: 31.0.

### Syntax

```vbscript
TXTextControl.SignatureFieldInsertAsChar TextPos, Width, Height
```

### Parameters

| Parameter | Description |
|---|---|
| TextPos | Specifies a text position where the signature field should be inserted. If TextPos is -1, the signature field is inserted at the current input position. |
| 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. |

### 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 |
| Width | Integer |
| Height | Integer |
| Return value | Integer |

### See Also

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