Window

La classe API Window permet d'afficher des fenêtres avec un contenu personnalisé de manière similaire à WinForms et WPF.

L'utilisation de WinForms et WPF présente plusieurs problèmes lors de la création de cBots, de plug-ins et d'indicateurs. Par exemple, les algorithmes doivent répartir les appels du thread WPF et WinForms vers le thread cBot ou indicateur, ce qui n'est pas idéal. S'appuyer sur la classe Window intégrée est une solution plus rapide et plus facile.

Lorsque vous travaillez avec des fenêtres, vous pouvez utiliser des contrôles personnalisés comme contenu. Par exemple, vous pouvez créer un contrôle Grid et le placer dans une fenêtre.

De manière similaire aux boîtes de message, les fenêtres sont intrinsèquement stylisées de manière analogue aux autres fenêtres de dialogue de cTrader. Vous n'avez pas besoin de les styliser manuellement.

Remarque

La classe Window ne fonctionne que sur les indicateurs et cBots .NET 6 ou version ultérieure.

Avantages et inconvénients des fenêtres par rapport à WinForms et WPF

Nous examinerons brièvement les avantages et les inconvénients de l'utilisation de la classe Window par rapport à WinForms et WPF.

Avantages

Les fenêtres ne nécessitent pas de droits d'accès complets.
Les fenêtres ont déjà l'apparence native de cTrader.
Les fenêtres sont faciles à utiliser.
Il n'est pas nécessaire de répartir les appels entre les threads.

Inconvénients

Les fenêtres ne peuvent contenir que des contrôles personnalisés comme contenu.
Les fenêtres ne sont pas entièrement personnalisables dans la mesure où le sont les contrôles WinForms et WPF.

Créer des fenêtres simples

Tout d'abord, instanciez la classe Window. Ensuite, attribuez un contrôle enfant et appelez la méthode Window.Show().

using cAlgo.API;

namespace cAlgo
{
    [Indicator(AccessRights = AccessRights.None)]
    public class WindowSample : Indicator
    {
        protected override void Initialize()
        {
            var window = new Window
            {
                Child = new TextBlock 
                {
                    Text = "Hi, This is my Window!",
                    VerticalAlignment = VerticalAlignment.Center,
                    HorizontalAlignment = HorizontalAlignment.Center,
                    FontSize = 20,
                    FontWeight = FontWeight.UltraBold
                },
                Title = "My Window",
                WindowStartupLocation = WindowStartupLocation.CenterScreen,
                Topmost = true
            };

            window.Show();
        }

        public override void Calculate(int index)
        {
        }
    }
}

Lors du lancement d'une instance de cet indicateur, vous devriez voir une nouvelle fenêtre automatiquement ouverte par cTrader.

Créer des fenêtres complexes

Cet exemple d'indicateur affiche les informations de l'instance dans une fenêtre séparée.

using cAlgo.API;
using cAlgo.API.Internals;
using System;

namespace cAlgo
{
    [Indicator(AccessRights = AccessRights.None)]
    public class WindowSample : Indicator
    {
        private TextBlock _spreadTextBlock;
        private TextBlock _bidTextBlock;
        private TextBlock _askTextBlock;
        private TextBlock _unrealizedGrossProfitTextBlock;
        private TextBlock _unrealizedNetProfitTextBlock;
        private TextBlock _timeTillOpenTextBlock;
        private TextBlock _timeTillCloseTextBlock;
        private TextBlock _isOpenedTextBlock;
        private TextBox _symbolNameTextBox;
        private Button _updateButton;
        private Style _style;
        private Grid _mainGrid;
        private Grid _infoGrid;
        private Window _window;
        private Symbol _symbol;

        protected override void Initialize()
        {
            _mainGrid = new Grid(2, 2)
            {
                BackgroundColor = Color.Gold,
                Opacity = 0.6,
                HorizontalAlignment = HorizontalAlignment.Stretch,
                VerticalAlignment = VerticalAlignment.Stretch,
            };

            _mainGrid.Rows[0].SetHeightToAuto();
            _mainGrid.Rows[1].SetHeightInStars(1);

            _style = new Style();

            _style.Set(ControlProperty.Padding, 1);
            _style.Set(ControlProperty.Margin, 2);
            _style.Set(ControlProperty.BackgroundColor, Color.Black);
            _style.Set(ControlProperty.FontSize, 12);

            _symbol = Symbol;

            _symbolNameTextBox = new TextBox
            {
                Text = _symbol.Name,
                Style = _style,
            };

            _mainGrid.AddChild(_symbolNameTextBox, 0, 0);

            _updateButton = new Button
            {
                Text = "Update",
            };

            _updateButton.Click += OnUpdateButtonClick;

            _mainGrid.AddChild(_updateButton, 0, 1);

            _infoGrid = GetSymbolDataGrid(_symbol);

            _mainGrid.AddChild(_infoGrid, 1, 0, 1, 2);

            _window = new Window
            {
                Child = _mainGrid,
                Title = "Symbol Info",
                WindowStartupLocation = WindowStartupLocation.CenterScreen,
                Topmost = true
            };

            _window.Show();

            _symbol.Tick += Symbol_Tick;

            Timer.Start(TimeSpan.FromSeconds(1));
        }

        private void OnUpdateButtonClick(ButtonClickEventArgs obj)
        {
            var symbol = Symbols.GetSymbol(_symbolNameTextBox.Text);

            if (symbol != null)
            {
                _symbol.Tick -= Symbol_Tick;

                _symbol = symbol;

                _mainGrid.RemoveChild(_infoGrid);

                _infoGrid = GetSymbolDataGrid(_symbol);

                _mainGrid.AddChild(_infoGrid, 1, 0, 1, 2);

                _symbol.Tick += Symbol_Tick;
            }
            else
            {
                _symbolNameTextBox.Text = "Invalid Symbol Name";
            }
        }

        private Grid GetSymbolDataGrid(Symbol symbol)
        {
            var grid = new Grid(24, 2)
            {
                BackgroundColor = Color.Gold,
                Opacity = 0.6,
                HorizontalAlignment = HorizontalAlignment.Stretch,
                VerticalAlignment = VerticalAlignment.Stretch
            };

            grid.AddChild(new TextBlock
            {
                Text = "Name",
                Style = _style
            }, 1, 0);
            grid.AddChild(new TextBlock
            {
                Text = symbol.Name,
                Style = _style
            }, 1, 1);

            grid.AddChild(new TextBlock
            {
                Text = "ID",
                Style = _style
            }, 2, 0);
            grid.AddChild(new TextBlock
            {
                Text = symbol.Id.ToString(),
                Style = _style
            }, 2, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Digits",
                Style = _style
            }, 3, 0);
            grid.AddChild(new TextBlock
            {
                Text = symbol.Digits.ToString(),
                Style = _style
            }, 3, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Description",
                Style = _style
            }, 4, 0);
            grid.AddChild(new TextBlock
            {
                Text = symbol.Description,
                Style = _style
            }, 4, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Lot Size",
                Style = _style
            }, 5, 0);
            grid.AddChild(new TextBlock
            {
                Text = symbol.LotSize.ToString(),
                Style = _style
            }, 5, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Pip Size",
                Style = _style
            }, 6, 0);
            grid.AddChild(new TextBlock
            {
                Text = symbol.PipSize.ToString(),
                Style = _style
            }, 6, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Pip Value",
                Style = _style
            }, 7, 0);
            grid.AddChild(new TextBlock
            {
                Text = symbol.PipValue.ToString(),
                Style = _style
            }, 7, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Tick Size",
                Style = _style
            }, 8, 0);
            grid.AddChild(new TextBlock
            {
                Text = symbol.TickSize.ToString(),
                Style = _style
            }, 8, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Tick Value",
                Style = _style
            }, 9, 0);
            grid.AddChild(new TextBlock
            {
                Text = symbol.TickValue.ToString(),
                Style = _style
            }, 9, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Volume In Units Max",
                Style = _style
            }, 10, 0);
            grid.AddChild(new TextBlock
            {
                Text = symbol.VolumeInUnitsMax.ToString(),
                Style = _style
            }, 10, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Volume In Units Min",
                Style = _style
            }, 11, 0);
            grid.AddChild(new TextBlock
            {
                Text = symbol.VolumeInUnitsMin.ToString(),
                Style = _style
            }, 11, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Volume In Units Step",
                Style = _style
            }, 12, 0);
            grid.AddChild(new TextBlock
            {
                Text = symbol.VolumeInUnitsStep.ToString(),
                Style = _style
            }, 12, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Ask",
                Style = _style
            }, 13, 0);

            _askTextBlock = new TextBlock
            {
                Text = symbol.Ask.ToString(),
                Style = _style
            };

            grid.AddChild(_askTextBlock, 13, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Bid",
                Style = _style
            }, 14, 0);

            _bidTextBlock = new TextBlock
            {
                Text = symbol.Bid.ToString(),
                Style = _style
            };

            grid.AddChild(_bidTextBlock, 14, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Spread",
                Style = _style
            }, 15, 0);

            _spreadTextBlock = new TextBlock
            {
                Text = symbol.Spread.ToString(),
                Style = _style
            };

            grid.AddChild(_spreadTextBlock, 15, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Unrealized Gross Profit",
                Style = _style
            }, 16, 0);

            _unrealizedGrossProfitTextBlock = new TextBlock
            {
                Text = symbol.UnrealizedGrossProfit.ToString(),
                Style = _style
            };

            grid.AddChild(_unrealizedGrossProfitTextBlock, 16, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Unrealized Net Profit",
                Style = _style
            }, 17, 0);

            _unrealizedNetProfitTextBlock = new TextBlock
            {
                Text = symbol.UnrealizedNetProfit.ToString(),
                Style = _style
            };

            grid.AddChild(_unrealizedNetProfitTextBlock, 17, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Time Till Open",
                Style = _style
            }, 18, 0);

            _timeTillOpenTextBlock = new TextBlock
            {
                Text = symbol.MarketHours.TimeTillOpen().ToString(),
                Style = _style
            };

            grid.AddChild(_timeTillOpenTextBlock, 18, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Time Till Close",
                Style = _style
            }, 19, 0);

            _timeTillCloseTextBlock = new TextBlock
            {
                Text = symbol.MarketHours.TimeTillClose().ToString(),
                Style = _style
            };

            grid.AddChild(_timeTillCloseTextBlock, 19, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Is Opened",
                Style = _style
            }, 20, 0);

            _isOpenedTextBlock = new TextBlock
            {
                Text = symbol.MarketHours.IsOpened().ToString(),
                Style = _style
            };

            grid.AddChild(_isOpenedTextBlock, 20, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Trading Sessions #",
                Style = _style
            }, 21, 0);

            grid.AddChild(new TextBlock
            {
                Text = symbol.MarketHours.Sessions.Count.ToString(),
                Style = _style
            }, 21, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Trading Session Week Days",
                Style = _style
            }, 22, 0);

            var weekDays = string.Empty;

            for (var iSession = 0; iSession < symbol.MarketHours.Sessions.Count; iSession++)
            {
                var currentSessionWeekDays = string.Format("{0}({1})-{2}({3})", symbol.MarketHours.Sessions[iSession].StartDay, symbol.MarketHours.Sessions[iSession].StartTime, symbol.MarketHours.Sessions[iSession].EndDay, symbol.MarketHours.Sessions[iSession].EndTime);

                weekDays = iSession == 0 ? currentSessionWeekDays : string.Format("{0}, {1}", weekDays, currentSessionWeekDays);
            }

            grid.AddChild(new TextBlock
            {
                Text = weekDays,
                Style = _style
            }, 22, 1);

            grid.AddChild(new TextBlock
            {
                Text = "Leverage Tier",
                Style = _style
            }, 23, 0);

            var leverageTiers = string.Empty;

            for (var iLeveragTier = 0; iLeveragTier < symbol.DynamicLeverage.Count; iLeveragTier++)
            {
                var currentLeverageTiers = string.Format("Volume up to {0} is {1}", symbol.DynamicLeverage[iLeveragTier].Volume, symbol.DynamicLeverage[iLeveragTier].Leverage);

                leverageTiers = iLeveragTier == 0 ? currentLeverageTiers : string.Format("{0}, {1}", leverageTiers, currentLeverageTiers);
            }

            grid.AddChild(new TextBlock
            {
                Text = leverageTiers,
                Style = _style
            }, 23, 1);

            return grid;
        }

        private void Symbol_Tick(SymbolTickEventArgs obj)
        {
            _askTextBlock.Text = obj.Symbol.Ask.ToString();
            _bidTextBlock.Text = obj.Symbol.Bid.ToString();
            _spreadTextBlock.Text = obj.Symbol.Spread.ToString();
            _unrealizedGrossProfitTextBlock.Text = obj.Symbol.UnrealizedGrossProfit.ToString();
            _unrealizedNetProfitTextBlock.Text = obj.Symbol.UnrealizedNetProfit.ToString();
        }

        protected override void OnTimer()
        {
            _timeTillOpenTextBlock.Text = _symbol.MarketHours.TimeTillOpen().ToString();
            _timeTillCloseTextBlock.Text = _symbol.MarketHours.TimeTillClose().ToString();
            _isOpenedTextBlock.Text = _symbol.MarketHours.IsOpened().ToString();
        }

        public override void Calculate(int index)
        {
        }
    }
}