【MQL】図形やラインを表示させるための『オブジェクト関数一覧』についてまとめてみた

オブジェクト関数の一覧を調べても、

実際にどう組み合わせればチャートにライン1本引けるのか分からない

——という人向けの記事です。

この記事では、よく使うオブジェクト関数を1つずつ紹介したあと、

実際にMetaEditorでコンパイルして

チャートに水平線を1本表示できるサンプルコードを紹介します。

ObjectCreate・ObjectNameでオブジェクトを生成・取得する

オブジェクト関数とは、

グラフィカルオブジェクトを操作する為の関数です。

オブジェクト関数はかなり量があるので、

よく使うオブジェクト関数をご紹介したいと思います。

あわせて、現在のMQL4で推奨されている書き方

(チャートIDを明示する形)で紹介します。

ObjectCreate関数でオブジェクトを生成する

指定したチャートに指定したタイプの

オブジェクトを生成します。

bool  ObjectCreate(
   long          chart_id,      // チャートID(0で現在のチャート)
   string        name,          // オブジェクト名
   ENUM_OBJECT   type,          // オブジェクトタイプ
   int           sub_window,    // ウインドウインデックス
   datetime      time1,         // 1番目の時間のアンカーポイント
   double        price1,        // 1番目の価格のアンカーポイント
   datetime      time2=0,       // 2番目の時間のアンカーポイント
   double        price2=0,      // 2番目の価格のアンカーポイント
   datetime      time3=0,       // 3番目の時間のアンカーポイント
   double        price3=0       // 3番目の価格のアンカーポイント
   );

ObjectName関数でオブジェクト名を取得する

オブジェクトリストの指定したインデックスに

対応するオブジェクト名を返します。

string  ObjectName(
   long   chart_id,             // チャートID(0で現在のチャート)
   int    pos,                  // オブジェクトリストの位置
   int    sub_window=-1,        // ウインドウインデックス(-1で全ウインドウ)
   int    type=-1                // オブジェクトタイプ(-1で全タイプ)
   );

ObjectDelete・ObjectsDeleteAllでオブジェクトを削除する

次に、作成したオブジェクトを削除する

2つの関数を確認します。

ObjectDelete関数で指定した名前を削除する

指定した名前のオブジェクトを削除します。

bool  ObjectDelete(
   long     chart_id,    // チャートID(0で現在のチャート)
   string   name         // オブジェクト名
   );

ObjectsDeleteAll関数で指定タイプを一括削除する

指定したサブウインドウから

指定したタイプのオブジェクトを全て削除します。

bool  ObjectsDeleteAll(
   long   chart_id,               // チャートID(0で現在のチャート)
   int    sub_window = -1,        // ウインドウインデックス(-1で全ウインドウ)
   int    type = -1               // オブジェクトタイプ(-1で全タイプ)
   );

ObjectSet・ObjectType・ObjectSetTextでプロパティを扱う

続いて、オブジェクトの見た目や種類を

扱う関数を確認します。

ObjectSet関数(非推奨)と現行APIへの置き換え

指定したオブジェクトのプロパティ値を変更します。

bool  ObjectSet(
   string   object_name,   // オブジェクト名
   int      index,         // プロパティインデックス
   double   value          // 設定値
   );

ObjectType関数とオブジェクトタイプの定数一覧

オブジェクトタイプを返します。

int  ObjectType(
   string   object_name   // object name
   );

ObjectSetText関数で説明文を変更する

オブジェクトの説明を変更します。

bool  ObjectSetText(
   string   object_name,            // オブジェクト名
   string   text,                   // 説明
   int      font_size  = 0,         // フォントサイズ
   string   font_name  = NULL,     // フォント
   color    text_color = clrNONE   // 色
   );

オブジェクト関数を組み合わせて水平線を1本引く

ここまでの関数を組み合わせて、

現在のBid価格に水平線を1本引くだけの

最小限のインジケーターを作ってみましょう。

//+------------------------------------------------------------------+
//|                                              PriceLine.mq4       |
//+------------------------------------------------------------------+
#property strict
#property indicator_chart_window

//+------------------------------------------------------------------+
//| Custom indicator initialization function                         |
//+------------------------------------------------------------------+
int OnInit()
  {
   return(INIT_SUCCEEDED);
  }

//+------------------------------------------------------------------+
//| Custom indicator deinitialization function                       |
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
  {
   ObjectDelete(0, "PriceLine");//チャートから削除
  }

//+------------------------------------------------------------------+
//| Custom indicator iteration function                              |
//+------------------------------------------------------------------+
int OnCalculate(const int rates_total,
                 const int prev_calculated,
                 const datetime &time[],
                 const double &open[],
                 const double &high[],
                 const double &low[],
                 const double &close[],
                 const long &tick_volume[],
                 const long &volume[],
                 const int &spread[])
  {
   ObjectDelete(0, "PriceLine");//毎回いったん削除して重複を防ぐ
   ObjectCreate(0, "PriceLine", OBJ_HLINE, 0, 0, Bid);
   ObjectSetInteger(0, "PriceLine", OBJPROP_STYLE, STYLE_SOLID);
   ObjectSetInteger(0, "PriceLine", OBJPROP_COLOR, clrYellow);

   return(rates_total);
  }
//+------------------------------------------------------------------+

ポイントは、毎回ObjectDelete()で

同じ名前のオブジェクトを一度削除してから

ObjectCreate()で作り直している点です。

これを省くと、同じ名前のオブジェクトが

既に存在している場合は上書きされるだけなので実害はありませんが、

「削除してから作り直す」習慣をつけておくと、

名前の付け方を変えたときの二重表示事故を防げます。

【MQL】図形やラインを表示させるための『オブジェクト関数一覧』についてまとめてみた：まとめ

ObjectCreate・ObjectDelete・ObjectSetInteger等の

基本的なオブジェクト関数を組み合わせれば、

水平線1本のようなシンプルな表示から始められます。

まずは今回のPriceLine.mq4のような

最小構成のコードで動きを確認し、

必要なオブジェクトタイプや装飾を少しずつ増やしていくとよいでしょう。

関連記事

• 【MQL】移動平均線のゴールデンクロス・デッドクロス時にシグナルを表示するインジケーター【中級編】
• 【MQL】チャート上にトレード情報を表示するインジケーター【初級編】
• 【MQL】2つの種類の違う移動平均線を表示させるインジケーター【初級編】
• 【MQL】チャート上にスプレッドを表示するインジケーター【初級編】