TX Text Control ActiveX

ImageInsertFixed Method

Method

This method inserts a new image at a fixed geometrical position. The text flows around the image.

Introduced: 12.0.

Syntax

TXTextControl.ImageInsertFixed FileName, PageNo, PosX, PosY, ScaleX, ScaleY, TextFlow, DistanceL, DistanceT, DistanceR, DistanceB

Parameters

ParameterDescription
FileNameSpecifies the image file with a full path name.
PageNoSpecifies the number of the page where the image 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.
PosXSpecifies the image's horizontal position in twips relative to the left border of the page.
PosYSpecifies the image's vertical position in twips relative to the top border of the page or control.
ScaleXSpecifies a horizontal scaling factor as a percentage.
ScaleYSpecifies a vertical scaling factor as a percentage.
TextFlowSpecifies how text flows around the image. It can be one of the following values:
DistanceL, DistanceT, DistanceR, DistanceBSpecifies distances, in twips, between the image and the document's text.

TextFlow

ValueDescription
2The text stops at the top and continues at the bottom of the image.
3The 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 property.

Data Types

NameData type
FileNameString
PageNoLong
PosXLong
PosYLong
ScaleXInteger
ScaleYInteger
TextFlowInteger
DistanceLInteger
DistanceTInteger
DistanceRInteger
DistanceBInteger
Return valueInteger

See Also