# ParagraphFormat.TabPositions Property

> Gets or sets an array containing the absolute tab stop positions, in twips, in a paragraph.

- **Product:** TX Text Control .NET for Windows Forms
- **Section:** Reference
- **Kind:** Property
- **Namespace:** `TXTextControl`
- **Package:** `TXTextControl.TextControl.WinForms.SDK` (assembly `TXTextControl.dll`, from the private NuGet feed or Text Control Offline Packages)
- **.NET Framework:** reference `TXTextControl.dll` from the setup
- **Path:** TX Text Control .NET for Windows Forms > Reference > TXTextControl > ParagraphFormat.TabPositions Property
- **769 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/paragraphformat/tabpositions-property/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/paragraphformat/tabpositions-property/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/paragraphformat/tabpositions-property/llms-full.txt

---

### Description

Gets or sets an array containing the absolute tab stop positions, in twips, in a paragraph.

### Syntax

```csharp
public int[] TabPositions { get; set; }
```

```vbnet
Public Property TabPositions As Integer()
```

### Examples

The following example applies paragraph layout to selected report text by using `ParagraphFormat.TabPositions`.

```csharp
textControl.Text = "First item\nSecond item\nThird item";
textControl.Select(0, textControl.Text.Length);
ParagraphFormat paragraphFormat = textControl.Selection.ParagraphFormat;

paragraphFormat.TabPositions = new int[] { 1 };
if (paragraphFormat.TabPositions != null)
{
    Console.WriteLine("Paragraph Format: Tab Positions is available.");
}

textControl.Selection.ParagraphFormat = paragraphFormat;
```

```vbnet
textControl.Text = "First item" & vbCrLf & "Second item" & vbCrLf & "Third item"
textControl.Select(0, textControl.Text.Length)
Dim paragraphFormat As ParagraphFormat = textControl.Selection.ParagraphFormat

paragraphFormat.TabPositions = New Integer() { 1 }
If paragraphFormat.TabPositions IsNot Nothing Then
    Console.WriteLine("Paragraph Format: Tab Positions is available.")
End If

textControl.Selection.ParagraphFormat = paragraphFormat
```

### Limitations

The maximum number of tabs in a line is 14.

### Remarks

The default positions are multiple of 1134 twips (2 cm).

The property returns an array with common values when the text selection contains multiple paragraphs with mixed positions. The remaining not common values are set to zero. If all values are different, the [Selection.IsCommonValueSelected](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/selection/iscommonvalueselected-method/llms-full.txt) method returns false.

---

## Nearby

- **Previous:** [ParagraphFormat.TabLeaders Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/paragraphformat/tableaders-property/llms-full.txt)
- **Next:** [ParagraphFormat.TabTypes Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/paragraphformat/tabtypes-property/llms-full.txt)
