---
id: "P:cAlgo.API.ControlBase.Top"
kind: "property"
type: "T:cAlgo.API.ControlBase"
url: "https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/Top/"
---

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

# ControlBase.Top

Member of [ControlBase](https://help.ctrader.com/ctrader-algo/references/Controls/ControlBase/index.md).

## Top

Gets or sets the position of the chart control to the top of the chart area. Works only when the control is inside the Canvas panel.

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.

C#:

```csharp
public double Top {get; set;}
```

Python:

```python
controlBase.Top: float
```

### Returns

`double` — The top.

### Examples

C#:

```csharp
var canvas = new Canvas();
var button = new Button { Text = "Buy", Left = 10, Top = 50 };
canvas.AddChild(button);
Chart.AddControl(canvas);
Print("Top: {0}", button.Top);
```

Python:

```python
canvas = Canvas()
button = Button()
button.Text = "Buy"
button.Left = 10
button.Top = 50
canvas.AddChild(button)
api.Chart.AddControl(canvas)
api.Print(f"Top: {button.Top}")
```

