# ImageInsert Method

> Inserts an image anchored to a paragraph with text flowing around it: file name, text position, alignment, position and distances in twips, scaling in percent.

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

---

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

Introduced: 12.0.

### Syntax

```vbscript
TXTextControl.ImageInsert FileName, TextPos, Alignment, PosX, PosY, ScaleX, ScaleY, TextFlow, DistanceL, DistanceT, DistanceR, DistanceB
```

### Parameters

| Parameter | Description |
|---|---|
| FileName | Specifies the image file with a full path name. |
| TextPos | Specifies a text position in the paragraph where the image should be inserted. If TextPos is -1, the image is anchored to the paragraph at the current input position. |
| Alignment | Specifies the image's horizontal alignment. It can be one of the following values: |
| PosX | Specifies the image'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 image'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. |
| ScaleX | Specifies a horizontal scaling factor as a percentage. |
| ScaleY | Specifies a vertical scaling factor as a percentage. |
| TextFlow | Specifies how text flows around the image. 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 image and the document's text. |

#### Alignment

| Value | Description |
|---|---|
| 0 | The horizontal position is given through the PosX parameter. |
| 1 | The image is left aligned relative to the paragraph to which it is anchored. |
| 2 | The image is right aligned relative to the paragraph to which it is anchored. |
| 3 | The image 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 image. |
| 3 | The text flows around the image. Empty areas at the left and right side are filled. |

### Return Value

The method returns the image's identifier, if a new image could be inserted. Otherwise, it returns zero. The image'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 |
|---|---|
| FileName | String |
| TextPos | Long |
| Alignment | Integer |
| PosX | Long |
| PosY | Long |
| ScaleX | Integer |
| ScaleY | Integer |
| TextFlow | Integer |
| DistanceL | Integer |
| DistanceT | Integer |
| DistanceR | Integer |
| DistanceB | Integer |
| Return value | Integer |

### See Also

- [ImageInsertAsChar Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/imageinsertaschar-method/llms-full.txt)
- [ImageInsertFixed Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/imageinsertfixed-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:** [ImageFilters Property](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/imagefilters-property/llms-full.txt)
- **Next:** [ImageInsertAsChar Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/imageinsertaschar-method/llms-full.txt)