SignatureFieldInsertFixed Method
This method inserts a new signature field at a fixed geometrical position. The text flows around the signature field.
Introduced: 31.0.
Syntax
TXTextControl.SignatureFieldInsertFixed PageNo, PosX, PosY, Width, Height, TextFlow, DistanceL, DistanceT, DistanceR, DistanceB
Parameters
| Parameter | Description |
|---|---|
| PageNo | Specifies the number of the page where the signature field is inserted, beginning with number 1. If the ViewMode property has not been set to Page View, this parameter must be set to zero. In this case, the PosY parameter specifies the position relative to the top of the control. |
| PosX | Specifies the signature field's horizontal position in twips relative to the left border of the page. |
| PosY | Specifies the signature field's vertical position in twips relative to the top border of the page or control. |
| Width | Specifies the width of the signature field 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. 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, between the signature field and the document's text. |
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 property.
Data Types
| Name | Data type |
|---|---|
| PageNo | Long |
| PosX | Long |
| PosY | Long |
| Width | Integer |
| Height | Integer |
| TextFlow | Integer |
| DistanceL | Integer |
| DistanceT | Integer |
| DistanceR | Integer |
| DistanceB | Integer |
| Return value | Integer |