# SubTextPartEventArgs Object

> The event argument object for SubTextPart related events. (e. g. the subTextPartEntered event)

- **Product:** DS Server
- **Section:** Reference
- **Kind:** Object
- **Introduced:** 24.0
- **Path:** DS Server > Reference > JavaScript API > SubTextPartEventArgs Object
- **611 words**
- **Web URL:** https://docs.textcontrol.com/ds-server/reference/javascript/subtextparteventargs/
- **LLMs URL:** https://docs.textcontrol.com/ds-server/reference/javascript/subtextparteventargs/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/ds-server/reference/javascript/subtextparteventargs/llms-full.txt

---

### Description

The event argument object for SubTextPart related events. (e. g. the [subTextPartEntered event](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol/addeventlistener-method/llms-full.txt))

### Syntax

```javascript
{
   id: <number>,
   start: <number>,
   length: <number>,
   name: <string>,
   number: <number>,
   nestedLevel: <number>
}
```

### Examples

The following example demonstrates `SubTextPartEventArgs` in a practical document-editing workflow. The event argument object for SubTextPart related events. (e. g. the subTextPartEntered event).

```javascript
function handleSubTextPart(args) {
    console.log("id:", args.id);
    console.log("start:", args.start);
    console.log("length:", args.length);
    console.log("name:", args.name);
}
```

---

## In This Section

- [Javascript: SubTextPartEventArgs.id Property](https://docs.textcontrol.com/ds-server/reference/javascript/subtextparteventargs/id-property/llms-full.txt): The subtextpart's identifier. Must be a one-based value. A value of zero indicates that the subtextpart has no identifier.
- [Javascript: SubTextPartEventArgs.length Property](https://docs.textcontrol.com/ds-server/reference/javascript/subtextparteventargs/length-property/llms-full.txt): The length of the SubTextPart in characters.
- [Javascript: SubTextPartEventArgs.name Property](https://docs.textcontrol.com/ds-server/reference/javascript/subtextparteventargs/name-property/llms-full.txt): The name of the subtextpart. An empty string indicates that the subtextpart has no name.
- [Javascript: SubTextPartEventArgs.nestedLevel Property](https://docs.textcontrol.com/ds-server/reference/javascript/subtextparteventargs/nestedlevel-property/llms-full.txt): The subtextpart's nested level. The top level is 1.
- [Javascript: SubTextPartEventArgs.number Property](https://docs.textcontrol.com/ds-server/reference/javascript/subtextparteventargs/number-property/llms-full.txt): The subtextpart's number. The first subtextpart has the number 1. The number is defined through the textflow. A textpart with a smaller start position has a smaller number. When an outer subtextpart has the same start position than one of its nested textparts the outer textpart has a smaller number.
- [Javascript: SubTextPartEventArgs.start Property](https://docs.textcontrol.com/ds-server/reference/javascript/subtextparteventargs/start-property/llms-full.txt): The 1-based position of the first character which belongs to the subtextpart.

---

## Nearby

- **Previous:** [Javascript: SubTextPartCollection.remove Method](https://docs.textcontrol.com/ds-server/reference/javascript/subtextpartcollection/remove-method/llms-full.txt)
- **Next:** [Javascript: SubTextPartEventArgs.id Property](https://docs.textcontrol.com/ds-server/reference/javascript/subtextparteventargs/id-property/llms-full.txt)