# ParagraphFormat.TabLeaders Property

> Gets or sets an array containing the tab leaders in a paragraph. A tab leader defines how a tab gap is filled.

- **Product:** TX Text Control .NET for WPF
- **Section:** Reference
- **Kind:** Property
- **Introduced:** 29.0
- **Namespace:** `TXTextControl`
- **Package:** `TXTextControl.TextControl.WPF.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 WPF > Reference > TXTextControl > ParagraphFormat.TabLeaders Property
- **850 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/paragraphformat/tableaders-property/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/paragraphformat/tableaders-property/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/paragraphformat/tableaders-property/llms-full.txt

---

### Description

Gets or sets an array containing the tab leaders in a paragraph. A tab leader defines how a tab gap is filled.

### Syntax

```csharp
public TabLeader[] TabLeaders { get; set; }
```

```vbnet
Public Property TabLeaders As TabLeader()
```

### Members

| Value | Description |
|---|---|
| None | The tab gap is not filled. |
| Period | The tab gap is filled with periods. |
| Dot | The tab gap is filled with dots. |
| Dash | The tab gap is filled with dashes. |
| Underline | The tab gap is underlined. |

### Examples

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

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

paragraphFormat.TabLeaders = new TabLeader[] { TabLeader.Period };
if (paragraphFormat.TabLeaders != null)
{
    Console.WriteLine("Paragraph Format: Tab Leaders 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.TabLeaders = New TabLeader() { TabLeader.Period }
If paragraphFormat.TabLeaders IsNot Nothing Then
    Console.WriteLine("Paragraph Format: Tab Leaders is available.")
End If

textControl.Selection.ParagraphFormat = paragraphFormat
```

### Limitations

The maximum number of tabs in a parapgraph is 14.

### Remarks

The default type is TabLeader.None.

The property returns an array with common values when the text selection contains multiple paragraphs with mixed types. If the selection contains different tab leaders, the [Selection.IsCommonValueSelected](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/selection/iscommonvalueselected-method/llms-full.txt) method returns false.

---

## Nearby

- **Previous:** [ParagraphFormat.StructureLevel Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/paragraphformat/structurelevel-property/llms-full.txt)
- **Next:** [ParagraphFormat.TabPositions Property](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/paragraphformat/tabpositions-property/llms-full.txt)