ObjectInsert Method
This method inserts a new OLE object or other control anchored to a paragraph. The inserted object is then moved with the text.
Introduced: 12.0.
Syntax
TXTextControl.ObjectInsert ObjectType, FileName, TextPos, Alignment, PosX, PosY, ScaleX, ScaleY, TextFlow, DistanceL, DistanceT, DistanceR, DistanceB[, KindOfObject]
Parameters
| Parameter | Description |
|---|---|
| ObjectType | Specifies the type of object. It can be one of the following identifiers: |
| FileName | The meaning of this parameter depends on the object that is to be inserted. See the description of the ObjectType parameter. This parameter can be zero, if the ObjectType parameter specifies a handle to a control. |
| TextPos | Specifies a text position in the paragraph where the object should be inserted. If TextPos is -1, the object is anchored to the paragraph at the current input position. |
| Alignment | Specifies the object's horizontal alignment. It can be one of the following values: |
| PosX | Specifies the object's horizontal position 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 object's vertical position 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 or object. It can be one of the following values: |
| DistanceL, DistanceT, DistanceR, DistanceB | Specifies distances, in twips, between the image or object and the text. |
| KindOfObject | Optional. Specifies an identifier for controls that are not OLE objects. If a document is loaded which contains such controls, an ObjectGethWnd event occurs for each control to give an application the opportunity of recreating these controls. This parameter can be used to handle groups of different control types, like buttons or checkboxes. |
ObjectType
| Value | Description |
|---|---|
| 1 - OLE object | Inserts an OLE object. The type of object can be selected with the system embedded OLE Insert dialog box. |
| 2 - OLE object (programmatic identifier) | Creates a newly created OLE object. In this case, the FileName parameter must specify a string which is the programmatic identifier of the OLE object to insert. The programmatic identifier is stored under the ProgID key in the registration database. |
| 3 - OLE object (embedded) | Inserts a newly created embedded OLE object from a file. In this case, the FileName parameter must specify a valid filename. |
| 4 - OLE object (linked) | Inserts a newly created linked OLE object from a file. In this case, the FileName parameter must specify a valid filename. |
| Otherwise | Specifies a handle to a control that can be obtained with a control's hWnd property. In this case the FileName parameter must be set to zero. |
Alignment
| Value | Description |
|---|---|
| 0 | The horizontal position is given through the PosX parameter. |
| 1 | The object is left aligned relative to the paragraph to which it is anchored. |
| 2 | The object is right aligned relative to the paragraph to which it is anchored. |
| 3 | The object 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 object. |
| 3 | The text flows around the object and empty areas at the left and right side are filled. |
Return Value
The method returns the object's identifier when an object could be inserted. Otherwise, it returns zero. The object's identifier can also be obtained with the ObjectCurrent property.
Data Types
| Name | Data type |
|---|---|
| ObjectType | Handle |
| FileName | String |
| TextPos | Long |
| Alignment | Integer |
| PosX | Long |
| PosY | Long |
| ScaleX | Integer |
| ScaleY | Integer |
| TextFlow | Integer |
| DistanceL | Integer |
| DistanceT | Integer |
| DistanceR | Integer |
| DistanceB | Integer |
| KindOfObject | Integer |
| Return value | Integer |