---
id: "T:cAlgo.API.TabControl"
kind: "class"
namespace: "cAlgo.API"
url: "https://help.ctrader.com/ctrader-algo/references/Controls/TabControl/"
---

> Documentation index for agents: https://help.ctrader.com/ctrader-algo/llms.txt · machine index: https://help.ctrader.com/ctrader-algo/api.json

# TabControl (class)

Represents the Tab control.

Environments: Desktop supported · CLI not supported · Cloud not supported.

- CLI: Accepted without error but never displayed, so control events such as Click are never raised.
- Cloud: Accepted without error but never displayed, so control events such as Click are never raised.

## Definition

```csharp
public class TabControl : Control
```

Available since cAlgo.API 5.2.

## Examples

C#:

```csharp
using cAlgo.API;

namespace cAlgo.Robots;

public partial class TestExample : Robot
{
    protected override void OnStart()
    {
        var tabControl = new TabControl
        {
            HorizontalAlignment = HorizontalAlignment.Center,
            VerticalAlignment = VerticalAlignment.Center,
        };

        var firstTab = new TabItem
        {
            Header = new TextBlock {Text = "First Tab"},
            Content = new TextBlock {Text = "First Tab Content"}
        };

        var secondTab = new TabItem
        {
            Header = new TextBlock {Text = "Second Tab"},
            Content = new TextBlock {Text = "Second Tab Content"}
        };

        tabControl.AddTab(firstTab);
        tabControl.AddTab(secondTab);

        Chart.AddControl(tabControl);
    }
}
```

Python:

```python
import clr
clr.AddReference("cAlgo.API")

from cAlgo.API import *

class Test():
    def get_text_block(self, text):
        textBlock = TextBlock()
        textBlock.Text = text
        return textBlock

    def initialize(self):
        tabControl = TabControl()
        tabControl.HorizontalAlignment = HorizontalAlignment.Center
        tabControl.VerticalAlignment = VerticalAlignment.Center

        firstTab = TabItem()
        firstTab.Header = self.get_text_block("First Tab")
        firstTab.Content = self.get_text_block("First Tab Content")

        secondTab = TabItem()
        secondTab.Header = self.get_text_block("Second Tab")
        secondTab.Content = self.get_text_block("Second Tab Content")

        tabControl.AddTab(firstTab)
        tabControl.AddTab(secondTab)

        api.Chart.AddControl(tabControl)
```

config.json:

```json
{
  "AccessRights": "None"
}
```

## Constructors

- `public TabControl()` — Initializes a new instance of the TabControl class. [details](https://help.ctrader.com/ctrader-algo/references/Controls/TabControl/Constructor/index.md)

## Methods

- `public void AddTab(TabItem tab)` — Adds a new tab. [details](https://help.ctrader.com/ctrader-algo/references/Controls/TabControl/AddTab/index.md)
- `public bool RemoveTab(TabItem tab)` — Removes an existing tab. [details](https://help.ctrader.com/ctrader-algo/references/Controls/TabControl/RemoveTab/index.md)

## Properties

- `public TabItem SelectedTab {get; set;}` — Gets or sets the SelectedTab. [details](https://help.ctrader.com/ctrader-algo/references/Controls/TabControl/SelectedTab/index.md)
- `public Dock TabStripPlacement {get; set;}` — Gets or sets the TabStripPlacement (Default: Top). [details](https://help.ctrader.com/ctrader-algo/references/Controls/TabControl/TabStripPlacement/index.md)
- `public IReadonlyList<TabItem> Tabs {get;}` — Get tabs. [details](https://help.ctrader.com/ctrader-algo/references/Controls/TabControl/Tabs/index.md)

## Events

- `public event Action<TabControlSelectedTabChangedEventArgs> SelectedTabChanged;` — Occurs when the selected tab is changed. [details](https://help.ctrader.com/ctrader-algo/references/Controls/TabControl/SelectedTabChanged/index.md)

## Inherited members

- `public Color ForegroundColor {get; set;}` (from Control) [details](https://help.ctrader.com/ctrader-algo/references/Controls/Control/ForegroundColor/index.md)
- `public Color BackgroundColor {get; set;}` (from Control) [details](https://help.ctrader.com/ctrader-algo/references/Controls/Control/BackgroundColor/index.md)
- `public Thickness Padding {get; set;}` (from Control) [details](https://help.ctrader.com/ctrader-algo/references/Controls/Control/Padding/index.md)
- `public VerticalAlignment VerticalContentAlignment {get; set;}` (from Control) [details](https://help.ctrader.com/ctrader-algo/references/Controls/Control/VerticalContentAlignment/index.md)
- `public HorizontalAlignment HorizontalContentAlignment {get; set;}` (from Control) [details](https://help.ctrader.com/ctrader-algo/references/Controls/Control/HorizontalContentAlignment/index.md)
- `public FontWeight FontWeight {get; set;}` (from Control) [details](https://help.ctrader.com/ctrader-algo/references/Controls/Control/FontWeight/index.md)
- `public FontStyle FontStyle {get; set;}` (from Control) [details](https://help.ctrader.com/ctrader-algo/references/Controls/Control/FontStyle/index.md)
- `public string FontFamily {get; set;}` (from Control) [details](https://help.ctrader.com/ctrader-algo/references/Controls/Control/FontFamily/index.md)
- `public double FontSize {get; set;}` (from Control) [details](https://help.ctrader.com/ctrader-algo/references/Controls/Control/FontSize/index.md)
- `public void ResetProperty(ControlProperty property)` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/ResetProperty/index.md)
- `public Guid UniqueId {get;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/UniqueId/index.md)
- `public Style Style {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/Style/index.md)
- `public double Left {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/Left/index.md)
- `public double Top {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/Top/index.md)
- `public double Right {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/Right/index.md)
- `public double Bottom {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/Bottom/index.md)
- `public double Width {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/Width/index.md)
- `public double Height {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/Height/index.md)
- `public double MinWidth {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/MinWidth/index.md)
- `public double MinHeight {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/MinHeight/index.md)
- `public double MaxWidth {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/MaxWidth/index.md)
- `public double MaxHeight {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/MaxHeight/index.md)
- `public bool IsEnabled {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/IsEnabled/index.md)
- `public bool IsVisible {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/IsVisible/index.md)
- `public double Opacity {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/Opacity/index.md)
- `public Thickness Margin {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/Margin/index.md)
- `public VerticalAlignment VerticalAlignment {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/VerticalAlignment/index.md)
- `public HorizontalAlignment HorizontalAlignment {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/HorizontalAlignment/index.md)
- `public Dock Dock {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/Dock/index.md)
- `public bool IsHitTestVisible {get; set;}` (from ControlBase) [details](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/IsHitTestVisible/index.md)