MQL4(MT4) EventChartCustomの使い方

EventChartCustom関数は、MetaTrader 4 (MT4) プラットフォームのMQL4言語で使用され、カスタムチャートイベントを発生させるために使用されます。この関数は特定のチャートに対してユーザー定義のイベントを送信し、それに応じた処理をOnChartEvent関数内で行うことができます。

EventChartCustom関数の使用法

bool EventChartCustom(
   long chart_id,          // イベントを受信するチャートの識別子
   ushort custom_event_id, // イベント識別子
   long lparam,            // long型のパラメータ
   double dparam,          // double型のパラメータ
   string sparam           // イベントのstringパラメータ
);

• chart_id: イベントを受信するチャートの識別子。ChartID()関数で取得できます。
• custom_event_id: カスタムイベント識別子。ユーザーが定義する値です。
• lparam: イベントに関連するlong型のパラメータ。
• dparam: イベントに関連するdouble型のパラメータ。
• sparam: イベントに関連する文字列型のパラメータ。

パラメータに関する情報を以下の表にまとめます。

この表は、EventChartCustom関数で使用されるイベントと、それらのイベントに対応するパラメータの値に関する概要を示しています。より詳細な情報については、公式のMQL4ドキュメントを参照してください。

使用例: カスタムイベントを送信し、OnChartEventで処理する

以下の例では、カスタムイベントをチャートに送信し、OnChartEvent関数でそのイベントを処理します。

// カスタムイベント識別子を定義
#define CUSTOM_EVENT_ID 10001

//+------------------------------------------------------------------+
//| Expert initialization function                                   |
//+------------------------------------------------------------------+
int OnInit()
  {
    // カスタムイベントを設定するための何らかの条件や初期化処理
    // ...

    return(INIT_SUCCEEDED);
  }

//+------------------------------------------------------------------+
//| ChartEvent function                                              |
//+------------------------------------------------------------------+
void OnChartEvent(const int id, const long &lparam, const double &dparam, const string &sparam)
  {
    // カスタムイベントを検出
    if(id == CUSTOM_EVENT_ID)
      {
        Print("カスタムイベントを受信しました: ", sparam);
        // イベントに応じた処理をここで行う
      }
  }

//+------------------------------------------------------------------+
//| Expert tick function                                             |
//+------------------------------------------------------------------+
void OnTick()
  {
    // 何らかの条件が満たされたときにカスタムイベントを発生させる
    if( /* 条件 */ )
      {
        if(!EventChartCustom(ChartID(), CUSTOM_EVENT_ID, 0, 0.0, "Hello, World!"))
          {
            Print("カスタムイベントの送信に失敗しました。");
          }
      }
  }
//+------------------------------------------------------------------+

注意点

• カスタムイベント識別子custom_event_idは、既存のMT4イベントと衝突しないようにユーザーが選ぶ必要があります。
• EventChartCustom関数を使用してイベントを送信するときは、対象となるチャートが開いていることを確認してください。
• EventChartCustom関数でイベントを送信すると、OnChartEvent関数が呼び出されます。この関数内でカスタムイベントを適切に処理するためのロジックを実装してください。
• カスタムイベントを使用する際は、パフォーマンスに影響を与えないように適切なタイミングでイベントを送信することが重要です。また、イベントの処理中に重い処理を行うと、MT4の応答性が低下する可能性があるため注意が必要です。