# Javascript: TextFrame.setBorderWidth Method

> Sets the width, in twips, of a text frame's border line. To alter the distance between the border line and the text, use the InternalMargins property. If this property is set to zero, the text frame has no border line.

- **Product:** TX Text Control .NET Server
- **Section:** Reference
- **Kind:** Method
- **Introduced:** 28.0
- **Path:** TX Text Control .NET Server > Reference > JavaScript API > Javascript: TextFrame.setBorderWidth Method
- **419 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/textframe/setborderwidth-method/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/textframe/setborderwidth-method/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/textframe/setborderwidth-method/llms-full.txt

---

### Description

Sets the width, in twips, of a text frame's border line. To alter the distance between the border line and the text, use the InternalMargins property. If this property is set to zero, the text frame has no border line.

### Syntax

```javascript
<void> TextFrame.setBorderWidth(<number> value, [<EmptyRequestCallback> callback], [<ErrorCallback> errorCallback])
```

### Parameters

| Parameter | Description |
|---|---|
| value | The new property value. |
| callback | Optional. Is called when the operation completed. |
| errorCallback | Optional. Is called when the operation failed with an error. |

### Examples

The following example demonstrates `TextFrame.setBorderWidth` in a practical document-editing workflow. It sets the width, in twips, of a text frame's border line. To alter the distance between the border line and the text, use the InternalMargins property. If this property is set to zero, the text frame has no border line.

```javascript
function onTxError(error) {
    console.error("TX Text Control error:", error.msg);
    error.handled = true;
}

function configureBorderWidth(textFrame) {
    textFrame.setBorderWidth(
        1,
        function() {
            console.log("set border width completed.");
        },
        onTxError
    );
}
```

---

## Nearby

- **Previous:** [Javascript: TextFrame.setBorderStyle Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/textframe/setborderstyle-method/llms-full.txt)
- **Next:** [Javascript: TextFrame.setDescriptiveText Method](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/javascript/textframe/setdescriptivetext-method/llms-full.txt)