Como Criar Painéis Gráficos no MQL5 – Guia Completo

Se você já se perdeu entre janelas de preço, indicadores sobrepostos e menus indecifráveis do MetaTrader 5, a ideia de montar um painel gráfico próprio parece mais um capricho de designer do que uma ferramenta de análise. Mas, na prática, um painel bem configurado corta ruído, acelera decisões e ainda permite exportar métricas para back‑test automatizados.

Este artigo desmonta a promessa de “painéis prontos” e entrega o caminho granular para que programadores quantitativos — e traders que não tem medo de mexer em código — criem, ajustem e integrem seus próprios dashboards usando MQL5. Cada segmento traz exemplos reais, armadilhas frequentes e sugestões de extensão que vão direto ao ponto que você realmente quer resolver.

Estrutura básica de um painel no MQL5

Antes de colocar objetos na tela, é preciso entender o ciclo de vida de um painel: criação, posicionamento, atualização e destruição. O código abaixo demonstra a sequência mínima dentro de um Expert Advisor.

void OnInit()
{
   // Cria um retângulo como contêiner
   CChartObjectRectangle panel;
   panel.Create(0,"MyPanel",0,10,10,200,150);
   panel.Color(clrDarkSlateGray);
   panel.Fill(true,clrBlack);
   // Adiciona texto estático
   CChartObjectLabel label;
   label.Create(0,"Title",0,20,20);
   label.Text("Painel Estratégico");
   label.FontSize(12);
   label.Color(clrWhite);
}

O que se destaca aqui não é a estética, mas a separação clara entre objeto gráfico (retângulo) e conteúdo (texto). Essa prática evita sobreposições inesperadas quando o usuário abre múltiplas janelas.

Objetos gráficos avançados

Além de retângulos e labels, MQL5 oferece objetos de desenho vetorial, controles de botão e até gráficos de barra internos. Abaixo, uma lista resumida dos que mais sobrevivem ao uso intensivo:

• CChartObjectButton: ideal para disparar funções de reload ou toggle;
• CChartObjectTrend: usado para traçar linhas de suporte/resistência dinâmicas;
• CChartObjectHistogram: exibe histogramas de volume ou frequência de sinais;
• CChartObjectText: permite linhas de anotação com formatação RTF.

Combine-os em um layout modular e você terá algo próximo a um painel de controle de trading algorítmico.

Integração com dados de mercado em tempo real

Um painel perde utilidade se não refletir o que acontece no mercado. A atualização deve ser feita no evento OnTick() ou, para menos carga, no OnTimer() disparado a cada segundo.

void OnTimer()
{
   double ask = SymbolInfoDouble(_Symbol,SYMBOL_ASK);
   double bid = SymbolInfoDouble(_Symbol,SYMBOL_BID);
   CChartObjectLabel askLabel;
   askLabel.Create(0,"AskLabel",0,30,50);
   askLabel.Text("ASK: "+DoubleToString(ask,_Digits));
   askLabel.Color(clrLime);
}

Observe que a criação repetida de objetos pode levar a “memory leaks”. A prática recomendada é criar o objeto uma única vez e, em seguida, usar ObjectSetString() ou ObjectSetDouble() para atualizar seu conteúdo.

Exemplo prático: painel de volatilidade

Suponha que você queira monitorar a volatilidade implícita de um ativo usando o indicador ATR (Average True Range). O trecho abaixo gera um histograma de 10 períodos dentro do painel.

int atrPeriod = 14;
double atrValue = iATR(_Symbol,PERIOD_CURRENT,atrPeriod,0);
CChartObjectHistogram volHist;
volHist.Create(0,"VolHist",0,50,100,200,150);
volHist.SetValue(0,atrValue);
volHist.Color(clrOrange);
volHist.Width(3);

O código deve ser inserido em OnCalculate() se o painel estiver atrelado a um indicador customizado, ou em OnTimer() para EA.

Recursos avançados e boas práticas

Construir painéis não é só colar objetos. Quando você pretende distribuir o código — ou manter múltiplas estratégias em um único arquivo — a modularização faz diferença.

• Encapsule cada bloco de UI dentro de uma classe (ex.: class Dashboard);
• Use #property strict para evitar erros silenciosos de tipagem;
• Adote nomes de objeto com prefixos (“Pnl_”, “Lbl_”) para evitar colisões;
• Teste a carga de CPU com GetTickCount() antes e depois das atualizações.

Tabela comparativa de desempenho

Os números acima foram obtidos rodando 10.000 ticks em EURUSD, janela 1‑min; a diferença é mais notória em estratégias com 100+ objetos simultâneos.

FAQ – Perguntas frequentes

Vale a pena criar painéis personalizados?

Se sua estratégia depende de métricas que não são exibidas nativamente — como múltiplos indicadores combinados ou sinais de IA — o custo de implementação compensa ao reduzir tempo de resposta.

É confiável usar objetos gráficos para tomada de decisão?

Objetos são apenas representações visuais; a lógica de decisão deve residir em variáveis e funções. Use o painel como “visor”, não como critério decisório.

Para quem é indicado?

Quant traders que já manuseiam MQL5, desenvolvedores que integram APIs externas e gestores que precisam monitorar múltiplos ativos em um único monitor.

Quais são os principais diferenciais deste método?

Modularização, atualização incremental e métricas de performance mensuráveis, permitindo escalar de 5 para 200 objetos sem degradar a experiência.