# ObjectChangeZOrder Method

> Changes the z-order of the current image, text frame, signature field or OLE object: topmost, top, up, bottommost, bottom or down, in front of or behind text.

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

---

Changes the z-order of an image, text frame, signature field or OLE object. The [ObjectCurrent](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectcurrent-property/llms-full.txt) property determines the object.

Introduced: 18.0.

### Syntax

```vbscript
TXTextControl.ObjectChangeZOrder ZOrder
```

### Parameters

| Parameter | Description |
|---|---|
| ZOrder | This parameter specifies how to change the object's z-order. Possible values are the following: |

#### ZOrder

| Constant | Description |
|---|---|
| txZOrderTopMost (1) | The image, text frame, signature field or OLE object is moved in front of the text at the top of all other objects. |
| txZOrderTop (2) | If the image, text frame, signature field or OLE object is behind the text, it becomes the topmost of all objects behind the text. If it is in front of the text, it becomes the topmost of all objects. |
| txZOrderUp (3) | The image, text frame, signature field or OLE object is moved up one plane. If it is the topmost object behind the text, it is not moved in front of the text. |
| txZOrderBottomMost (4) | The image, text frame, signature field or OLE object is moved behind the text below all other objects. This value is only possible, if the [ObjectTextflow](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objecttextflow-property/llms-full.txt) property is 4 (behind the text). |
| txZOrderBottom (5) | If the image, text frame, signature field or OLE object is in front of the text, it becomes the bottommost of all objects in front of the text. If it is behind the text, it becomes the bottommost of all objects. |
| txZOrderDown (6) | The image, text frame, signature field or OLE object is moved down one plane. If it is the bottommost object in front of the text, it is not moved behind the text. |

### Return Value

The method returns True, if the z-order could be changed. The method returns False, if the object already has the specified z-order or if an error has occurred.

### Data Types

| Name | Data type |
|---|---|
| ZOrder | Integer |
| Return value | Boolean |

### See Also

- [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:** [ObjectAttrDialog Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectattrdialog-method/llms-full.txt)
- **Next:** [ObjectClicked Event](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/objectclicked-event/llms-full.txt)