---
id: "T:cAlgo.API.ChartFrame"
kind: "interface"
namespace: "cAlgo.API"
url: "https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/ChartFrame/"
---

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

# ChartFrame (interface)

Represents a chart frame.

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

- CLI: Available to plugins only, and plugins cannot run in the CLI.
- Cloud: Available to plugins only, and plugins cannot run in the cloud.

## Definition

```csharp
public interface ChartFrame
```

## Examples

C#:

```csharp
var chartFrame = ChartManager.AddChartFrame("EURUSD", TimeFrame.Hour);
chartFrame.LinkedChartGroup = LinkedChartGroup.A;
Print("Chart {0} {1} has {2} bars", chartFrame.Symbol.Name, chartFrame.TimeFrame, chartFrame.Chart.Bars.Count);
```

Python:

```python
chartFrame = api.ChartManager.AddChartFrame("EURUSD", TimeFrame.Hour)
chartFrame.LinkedChartGroup = LinkedChartGroup.A
api.Print(f"Chart {chartFrame.Symbol.Name} {chartFrame.TimeFrame} has {chartFrame.Chart.Bars.Count} bars")
```

## Methods

- `bool TryChangeTimeFrame(TimeFrame timeFrame)` — Changes the time frame on the chart. [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/ChartFrame/TryChangeTimeFrame/index.md)
- `bool TryChangeTimeFrameAndSymbol(TimeFrame timeFrame, string symbolName)` — Changes the time frame and the symbol on the chart. [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/ChartFrame/TryChangeTimeFrameAndSymbol/index.md)

## Properties

- `Chart Chart {get;}` — Returns frame chart. [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/ChartFrame/Chart/index.md)
- `LinkedChartGroup LinkedChartGroup {get; set;}` — Get / set linked group of frame. [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/ChartFrame/LinkedChartGroup/index.md)
- `Symbol Symbol {get; set;}` — Get / set frame chart symbol. [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/ChartFrame/Symbol/index.md)
- `TimeFrame TimeFrame {get; set;}` — Get / set frame chart timeframe. [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/ChartFrame/TimeFrame/index.md)

## Events

- `event Action<ChartFrameLinkedChartGroupChangedEventArgs> LinkedChartGroupChanged;` — Occurs when frame LinkedChartGroup is changed. [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/ChartFrame/LinkedChartGroupChanged/index.md)

## Inherited members

- `bool Attach()` (from Frame) [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/Frame/Attach/index.md)
- `bool Attach(ChartContainer targetContainer)` (from Frame) [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/Frame/Attach/index.md)
- `bool Detach()` (from Frame) [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/Frame/Detach/index.md)
- `void Activate()` (from Frame) [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/Frame/Activate/index.md)
- `string Id {get;}` (from Frame) [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/Frame/Id/index.md)
- `ChartContainer ChartContainer {get;}` (from Frame) [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/Frame/ChartContainer/index.md)
- `double Width {get;}` (from Frame) [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/Frame/Width/index.md)
- `double Height {get;}` (from Frame) [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/Frame/Height/index.md)
- `bool IsAttached {get;}` (from Frame) [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/Frame/IsAttached/index.md)
- `int Index {get; set;}` (from Frame) [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/Frame/Index/index.md)
- `event Action<FrameSizeChangedEventArgs> SizeChanged;` (from Frame) [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/Frame/SizeChanged/index.md)
- `event Action<FrameAttachedEventArgs> Attached;` (from Frame) [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/Frame/Attached/index.md)
- `event Action<FrameDetachedEventArgs> Detached;` (from Frame) [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/Frame/Detached/index.md)
- `event Action<FrameContainerChangedEventArgs> ContainerChanged;` (from Frame) [details](https://help.ctrader.com/ctrader-algo/references/Plugin/Chart/Frame/ContainerChanged/index.md)