Exemplos de como trabalhar com propriedades do gráfico. Uma ou duas funções completas são exibidas para cada propriedade. Estas funções permitem configurar/receber o valor da propriedade. Essas funções podem ser utilizadas "como estão" em aplicativos personalizados MQL5.
a imagem abaixo mostra o painel gráfico ilustrando como modificara propriedade do gráficomudando sua aparência. Clicando próximo botão permite definir o novo valor da propriedade apropriada e visualizar as alterações na janela do gráfico.
Propriedades do Gráfico e Exemplos de Funções para Trabalhar com Eles
CHART_IS_OBJECT define se um objeto é um gráfico real ou um objeto gráfico.
//+-------------------------------------------------------------------------+
//| Definir se um objeto é um gráfico. Se ele for |
//| um objeto gráfico, o resultado é verdadeiro. Se ele for um gráfico real |
//| o resultado da variável foi o valor falso. |
//+-------------------------------------------------------------------------+
bool ChartIsObject(bool &result,const long chart_ID=0)
{
//--- preparar a variável para obter o valor da propriedade
long value;
//--- redefine o valor de erro
ResetLastError();
//--- obter a propriedade do gráfico
if(!ChartGetInteger(chart_ID,CHART_IS_OBJECT,0,val ue))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
//--- retorna false
return(false);
}
//--- armazenar o valor da propriedade do gráfico na memória
result=value;
//--- sucesso na execução
return(true);
}
CHART_BRING_TO_TOP exibe o gráfico no topo de outros gráficos.
//+-------------------------------------------------------------------------+
//| Enviar comando para o terminal para exibir o gráfico acima dos outros. |
//+-------------------------------------------------------------------------+
bool ChartBringToTop(const long chart_ID=0)
{
//--- redefine o valor de erro
ResetLastError();
//--- exibe o gráfico no topo de outros gráficos
if(!ChartSetInteger(chart_ID,CHART_BRING_TO_TOP,0, true))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- sucesso na execução
return(true);
}
CHART_MOUSE_SCROLL é uma propriedade para rolagem do gráfico usando botão esquerdo do mouse.
//+--------------------------------------------------------------------------+
//| A função define se a rolagem do gráfico usando o botão esquerdo do mouse |
//| está habilitado. |
//+--------------------------------------------------------------------------+
bool ChartMouseScrollGet(bool &result,const long chart_ID=0)
{
//--- preparar a variável para obter o valor da propriedade
long value;
//--- redefine o valor de erro
ResetLastError();
//--- receber o valor da propriedade
if(!ChartGetInteger(chart_ID,CHART_MOUSE_SCROLL,0, value))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- armazenar o valor da propriedade do gráfico na memória
result=value;
//--- sucesso na execução
return(true);
}
//+--------------------------------------------------------------------+
//| A função habilita/desabilita a rolagem do gráfico usando botão |
//| esquerdo do mouse. |
//+--------------------------------------------------------------------+
bool ChartMouseScrollSet(const bool value,const long chart_ID=0)
{
//--- redefine o valor de erro
ResetLastError();
//--- define valor de propriedade
if(!ChartSetInteger(chart_ID,CHART_MOUSE_SCROLL,0, value))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- sucesso na execução
return(true);
}
CHART_EVENT_MOUSE_MOVE é uma propriedade de enviar mensagens sobre mudança de eventos e cliques de mouse para aplicações MQL5 CHARTEVENT_MOUSE_MOVE).
//+------------------------------------------------------------------+
//| Verificar se mudança de eventos e cliques de mouse |
//| são enviadas para todas as aplicações mql5 no gráfico. |
//+------------------------------------------------------------------+
bool ChartEventMouseMoveGet(bool &result,const long chart_ID=0)
{
//--- preparar a variável para obter o valor da propriedade
long value;
//--- redefine o valor de erro
ResetLastError();
//--- receber o valor da propriedade
if(!ChartGetInteger(chart_ID,CHART_EVENT_MOUSE_MOV E,0,value))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- armazenar o valor da propriedade do gráfico na memória
result=value;
//--- sucesso na execução
return(true);
}
//+------------------------------------------------------------------------------+
//| A função habilita/desabilita o modo de envio de mensagens sobre mudança |
//| de eventos e cliques de mouse para aplicações no |
//| gráfico. |
//+------------------------------------------------------------------------------+
bool ChartEventMouseMoveSet(const bool value,const long chart_ID=0)
{
//--- redefine o valor de erro
ResetLastError();
//--- define valor de propriedade
if(!ChartSetInteger(chart_ID,CHART_EVENT_MOUSE_MOV E,0,value))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- sucesso na execução
return(true);
}
CHART_EVENT_OBJECT_CREATE é uma propriedade de enviar mensagens sobre o evento da criação do objeto gráfico para aplicações MQL5 (CHARTEVENT_OBJECT_CREATE).
//+---------------------------------------------------------------------+
//| Verificar se é mensagens do evento da criação de um objeto gráfico |
//| são enviadas para todas as aplicações mql5 no gráfico. |
//+---------------------------------------------------------------------+
bool ChartEventObjectCreateGet(bool &result,const long chart_ID=0)
{
//--- preparar a variável para obter o valor da propriedade
long value;
//--- redefine o valor de erro
ResetLastError();
//--- receber o valor da propriedade
if(!ChartGetInteger(chart_ID,CHART_EVENT_OBJECT_CR EATE,0,value))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- armazenar o valor da propriedade do gráfico na memória
result=value;
//--- sucesso na execução
return(true);
}
//+--------------------------------------------------------------------------+
//| A função habilita/desabilita o modo de envio de mensagens sobre |
//| o evento da criação do objeto gráfico para aplicações mql5 no |
//| gráfico. |
//+--------------------------------------------------------------------------+
bool ChartEventObjectCreateSet(const bool value,const long chart_ID=0)
{
//--- redefine o valor de erro
ResetLastError();
//--- define valor de propriedade
if(!ChartSetInteger(chart_ID,CHART_EVENT_OBJECT_CR EATE,0,value))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- sucesso na execução
return(true);
}
CHART_EVENT_OBJECT_DELETE é uma propriedade de enviar mensagens sobre o evento da exclusão do objeto gráfico para aplicações MQL5 (CHARTEVENT_OBJECT_DELETE).
//+---------------------------------------------------------------------+
//| Verificar se mensagens é do evento da exclusão de um objeto gráfico |
//| são enviadas para todas as aplicações mql5 no gráfico. |
//+---------------------------------------------------------------------+
bool ChartEventObjectDeleteGet(bool &result,const long chart_ID=0)
{
//--- preparar a variável para obter o valor da propriedade
long value;
//--- redefine o valor de erro
ResetLastError();
//--- receber o valor da propriedade
if(!ChartGetInteger(chart_ID,CHART_EVENT_OBJECT_DE LETE,0,value))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- armazenar o valor da propriedade do gráfico na memória
result=value;
//--- sucesso na execução
return(true);
}
//+--------------------------------------------------------------------------+
//| A função habilita/desabilita o modo de envio de mensagens sobre |
//| o evento da exclusão do objeto gráfico para aplicações mql5 no |
//| gráfico. |
//+--------------------------------------------------------------------------+
bool ChartEventObjectDeleteSet(const bool value,const long chart_ID=0)
{
//--- redefine o valor de erro
ResetLastError();
//--- define valor de propriedade
if(!ChartSetInteger(chart_ID,CHART_EVENT_OBJECT_DE LETE,0,value))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- sucesso na execução
return(true);
}
CHART_MODE — tipo de gráfico (candles, barras ou linha).
//+------------------------------------------------------------------+
//| Obter tipo de gráfico (candles, barras ou |
//| linha). |
//+------------------------------------------------------------------+
ENUM_CHART_MODE ChartModeGet(const long chart_ID=0)
{
//--- preparar a variável para obter o valor da propriedade
long result=WRONG_VALUE;
//--- redefine o valor de erro
ResetLastError();
//--- receber o valor da propriedade
if(!ChartGetInteger(chart_ID,CHART_MODE,0,result))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
}
//--- retorna o valor da propriedade do gráfico
return((ENUM_CHART_MODE)result);
}
//+------------------------------------------------------------------+
//| Define tipo de gráfico (candles, barras ou |
//| linha). |
//+------------------------------------------------------------------+
bool ChartModeSet(const long value,const long chart_ID=0)
{
//--- redefine o valor de erro
ResetLastError();
//--- define valor de propriedade
if(!ChartSetInteger(chart_ID,CHART_MODE,value))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- sucesso na execução
return(true);
}
CHART_FOREGROUND é uma propriedade de exibição do gráfico de preço no primeiro plano.
//+------------------------------------------------------------------+
//| A função define se um gráfico de preço é exibido no |
//| primeiro plano. |
//+------------------------------------------------------------------+
bool ChartForegroundGet(bool &result,const long chart_ID=0)
{
//--- preparar a variável para obter o valor da propriedade
long value;
//--- redefine o valor de erro
ResetLastError();
//--- receber o valor da propriedade
if(!ChartGetInteger(chart_ID,CHART_FOREGROUND,0,va lue))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- armazenar o valor da propriedade do gráfico na memória
result=value;
//--- sucesso na execução
return(true);
}
//+---------------------------------------------------------------------------+
//| A função habilita/desabilita o modo de exibição do gráfico de preço no |
//| primeiro plano. |
//+---------------------------------------------------------------------------+
bool ChartForegroundSet(const bool value,const long chart_ID=0)
{
//--- redefine o valor de erro
ResetLastError();
//--- define valor de propriedade
if(!ChartSetInteger(chart_ID,CHART_FOREGROUND,0,va lue))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- sucesso na execução
return(true);
}
CHART_SHIFT — modo de encaixe do gráfico de preço a partir da borda direita.
//+------------------------------------------------------------------------------------+
//| A função define se o modo de deslocamento do gráfico de preço do limite direito |
//| está habilitado. |
//+------------------------------------------------------------------------------------+
bool ChartShiftGet(bool &result,const long chart_ID=0)
{
//--- preparar a variável para obter o valor da propriedade
long value;
//--- redefine o valor de erro
ResetLastError();
//--- receber o valor da propriedade
if(!ChartGetInteger(chart_ID,CHART_SHIFT,0,value))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- armazenar o valor da propriedade do gráfico na memória
result=value;
//--- sucesso na execução
return(true);
}
//+--------------------------------------------------------------------------+
//| A função habilita/desabilita o modo de exibição do gráfico de preço com |
//| deslocamento do limite direito. |
//+--------------------------------------------------------------------------+
bool ChartShiftSet(const bool value,const long chart_ID=0)
{
//--- redefine o valor de erro
ResetLastError();
//--- define valor de propriedade
if(!ChartSetInteger(chart_ID,CHART_SHIFT,0,value))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- sucesso na execução
return(true);
}
CHART_AUTOSCROLL — modo de movimentação automática para a borda direita do gráfico.
//+---------------------------------------------------------------------+
//| A função define o modo de auto-rolamento do gráfico |
//| para a direita no caso de chegada de novos ticks estar habilitado. |
//+---------------------------------------------------------------------+
bool ChartAutoscrollGet(bool &result,const long chart_ID=0)
{
//--- preparar a variável para obter o valor da propriedade
long value;
//--- redefine o valor de erro
ResetLastError();
//--- receber o valor da propriedade
if(!ChartGetInteger(chart_ID,CHART_AUTOSCROLL,0,va lue))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- armazenar o valor da propriedade do gráfico na memória
result=value;
//--- sucesso na execução
return(true);
}
//+------------------------------------------------------------------+
//| A função habilita/desabilita o modo de auto-rolamento do gráfico |
//| para a direita no caso da chegada de novos ticks. |
//+------------------------------------------------------------------+
bool ChartAutoscrollSet(const bool value,const long chart_ID=0)
{
//--- redefine o valor de erro
ResetLastError();
//--- define valor de propriedade
if(!ChartSetInteger(chart_ID,CHART_AUTOSCROLL,0,va lue))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- sucesso na execução
return(true);
}
CHART_SCALE — chart scale property.
//+------------------------------------------------------------------+
//| Obter escala do gráfico (de 0 a 5). |
//+------------------------------------------------------------------+
int ChartScaleGet(const long chart_ID=0)
{
//--- preparar a variável para obter o valor da propriedade
long result=-1;
//--- redefine o valor de erro
ResetLastError();
//--- receber o valor da propriedade
if(!ChartGetInteger(chart_ID,CHART_SCALE,0,result) )
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
}
//--- retorna o valor da propriedade do gráfico
return((int)result);
}
//+------------------------------------------------------------------+
//| Definir escala do gráfico (de 0 a 5). |
//+------------------------------------------------------------------+
bool ChartScaleSet(const long value,const long chart_ID=0)
{
//--- redefine o valor de erro
ResetLastError();
//--- define valor de propriedade
if(!ChartSetInteger(chart_ID,CHART_SCALE,0,value))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- sucesso na execução
return(true);
}
CHART_SCALEFIX — o modo de especificar a escala do gráfico em pontos por barra.
//+------------------------------------------------------------------+
//| A função define se o modo de fixar a escala está habilitado. |
//+------------------------------------------------------------------+
bool ChartScaleFixGet(bool &result,const long chart_ID=0)
{
//--- preparar a variável para obter o valor da propriedade
long value;
//--- redefine o valor de erro
ResetLastError();
//--- receber o valor da propriedade
if(!ChartGetInteger(chart_ID,CHART_SCALEFIX,0,valu e))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- armazenar o valor da propriedade do gráfico na memória
result=value;
//--- sucesso na execução
return(true);
}
//+------------------------------------------------------------------+
//| A função habilita/desabilita o modo de fixar a escala. |
//+------------------------------------------------------------------+
bool ChartScaleFixSet(const bool value,const long chart_ID=0)
{
//--- redefine o valor de erro
ResetLastError();
//--- define valor de propriedade
if(!ChartSetInteger(chart_ID,CHART_SCALEFIX,0,valu e))
{
//--- exibe uma mensagem para o diário Experts
Print(__FUNCTION__+", Código de erro = ",GetLastError());
return(false);
}
//--- sucesso na execução
return(true);
}