既刊のバッファ記事では、

バッファが「データを一時的に保存しておく変数」であることを説明しました。

ですが、その配列を実際にインジケーターの線として画面に表示するには、

`SetIndexBuffer`、

`SetIndexStyle`、

`SetIndexLabel`という、

3つの関数を正しい順番で呼ぶ必要があります。

この記事では、サンプルコードをコピペするだけでは気づきにくい、

3関数それぞれの役割分担と、

「何も描画されない」事故の代表的な原因を解説します。

なぜこの3関数を知らないと「何も描画されない」事故が起きるのか

まず、この記事が解決する範囲を整理します。

既刊「バッファ」記事で解説した範囲

既刊バッファの記事では、

`double`型の配列をバッファとして宣言する書き方を解説しました。

ただし、配列を宣言しただけでは、

MT4はその配列を「画面に描く対象」だとは認識しません。

この記事が解決する範囲:登録・描画・表示名の3工程

配列を実際の線として表示するには、

(1)配列をバッファとして登録する、

(2)描画のタイプ・色・太さを指定する、

(3)DataWindowに表示する名前を付ける、

という3つの工程が必要です。

この記事では、この3工程をそれぞれ担当する関数を順番に解説します。

補足: 3関数の呼び出し順序は、

通常`OnInit()`の中で、

SetIndexBuffer→SetIndexStyle→SetIndexLabelの、

順に書きます。

登録前にスタイルだけ先に設定しても効果がありません。

SetIndexBuffer:配列をインジケーターバッファとして登録する

最初に必要なのが、配列の登録です。

シグネチャと引数

公式リファレンス(SetIndexBuffer)によると、シグネチャは次の2通りです。

bool SetIndexBuffer(
   int    index,      //バッファ番号(0から開始)
   double buffer[]     //登録する配列
  );

bool SetIndexBuffer(
   int                    index,      //バッファ番号
   double                 buffer[],   //登録する配列
   ENUM_INDEXBUFFER_TYPE  data_type   //保存するデータの種類
  );

戻り値は、登録に成功すれば`true`、

失敗すれば`false`です。

indexと#property indicator_buffersの関係(落とし穴)

注意: `index`に渡せる値は、

`#property indicator_buffers`で、

宣言した数より小さい値だけです。

例えば`#property indicator_buffers 2`なら、

使えるindexは0と1だけで、2を渡すと登録に失敗します。

「配列は宣言したのに描画されない」という事故の多くは、

この宣言数とindexの食い違いが原因です。

バッファ数を1つ増やしたら、

必ず`#property indicator_buffers`の数値も合わせて増やす、

という習慣をつけておくと事故を防げます。

SetIndexStyle:描画タイプ・色・太さを指定する

登録した配列を、どう描くかを決めるのがこの関数です。

シグネチャと引数

公式リファレンス(SetIndexStyle)によると、シグネチャは次の通りです。

void SetIndexStyle(
   int   index,            //バッファ番号
   int   type,             //描画タイプ
   int   style=EMPTY,      //線のスタイル(EMPTYなら変更しない)
   int   width=EMPTY,      //線の太さ1〜5(EMPTYなら変更しない)
   color clr=clrNONE       //色(clrNONEなら変更しない)
  );

この関数には戻り値がありません(`void`)。

DRAW_タイプの使い分け表

既刊記事群で実際に使われている代表的なタイプを整理します。

typeの値 表示される見た目 使う場面の例
DRAW_LINE 連続した折れ線 移動平均線・RSI等の値を連続表示
DRAW_HISTOGRAM 0ラインからの棒グラフ OsMA・Force Index等の増減を表示
DRAW_ARROW 1本ずつ独立した記号 シグナル検知時だけ矢印を出す

要点: `DRAW_ARROW`を使う場合、

記号の形は次に解説する`SetIndexArrow`で別途指定します。

`SetIndexStyle`だけでは矢印の形は決まりません。

SetIndexLabel・SetIndexArrow・SetIndexEmptyValue:表示を仕上げる補助関数

最後に、見た目を仕上げる3つの補助関数を紹介します。

SetIndexLabel:DataWindowに表示する名前を付ける

公式リファレンス(SetIndexLabel)によると、シグネチャは次の通りです。

void SetIndexLabel(
   int    index,  //バッファ番号
   string text    //DataWindow・ツールチップに表示する名前
  );

`text`に`NULL`を渡すと、

DataWindow上にそのバッファの値が表示されなくなります。

SetIndexArrow:矢印の形を指定する

公式リファレンス(SetIndexArrow)によると、シグネチャは`void SetIndexArrow(int index, int code)`です。

`code`には、Wingdingsフォントの記号コード(33〜255の範囲)を渡します。

既刊CCI矢印表示の記事では、

上向き矢印に233、下向き矢印に234を使っています。

SetIndexEmptyValue:「値なし」を描画しない値を決める

公式リファレンス(SetIndexEmptyValue)によると、シグネチャは`void SetIndexEmptyValue(int index, double value)`です。

デフォルトは`EMPTY_VALUE`で、

この値が入っているバー位置は、線もDataWindowの値も表示されません。

`DRAW_ARROW`でシグナルが出ないバーを非表示にするのに使う、

基本テクニックです。

実際に動くコード全体:5関数を組み合わせた矢印インジケーター

ここまでの5関数を、1本のインジケーターとして組み合わせます。

//+------------------------------------------------------------------+
//|                                       BufferStyleLabelDemo.mq4    |
//|                     Copyright 2026, FX-EA System Project Creator |
//|                        https://creator.fx-ea-system-project.com/ |
//+------------------------------------------------------------------+
#property copyright "Copyright 2026, FX-EA System Project Creator"
#property link      "https://creator.fx-ea-system-project.com/"
#property version   "1.00"
#property strict
#property indicator_chart_window
#property indicator_buffers 1

double ArrowBuffer[];

input int InpMAPeriod = 20;//判定に使う移動平均の期間

//+------------------------------------------------------------------+
//| Custom indicator initialization function                          |
//+------------------------------------------------------------------+
int OnInit()
  {
   SetIndexBuffer(0, ArrowBuffer);               //(1)登録
   SetIndexStyle(0, DRAW_ARROW, STYLE_SOLID, 2, clrLime); //(2)矢印指定
   SetIndexArrow(0, 233);                        //上向き三角
   SetIndexLabel(0, "終値が20MAを上抜け");            //(3)表示名
   SetIndexEmptyValue(0, EMPTY_VALUE);            //非シグナルは非表示

   return(INIT_SUCCEEDED);
  }

//+------------------------------------------------------------------+
//| 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[])
  {
   int start = (prev_calculated > 1) ? prev_calculated - 1 : InpMAPeriod;

   for(int i = start; i < rates_total; i++)
     {
      double ma      = iMA(NULL, 0, InpMAPeriod, 0, MODE_SMA, PRICE_CLOSE, rates_total - 1 - i);
      double maPrev  = iMA(NULL, 0, InpMAPeriod, 0, MODE_SMA, PRICE_CLOSE, rates_total - i);

      //初期値はEMPTY_VALUEのままにして描画を消す
      ArrowBuffer[i] = EMPTY_VALUE;

      //前のバーまでMA未満で、今のバーでMAを上抜けた瞬間だけ矢印を立てる
      if(close[i] > ma && close[i - 1] <= maPrev)
         ArrowBuffer[i] = low[i] - 10 * _Point;
     }

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

MetaEditorで実際に動かす手順

  1. MT4の「ツール」→「MetaQuotes Language Editor」でMetaEditorを開く
  2. 「ファイル」→「新規作成」→「カスタムインディケータ」を選び、名前を「BufferStyleLabelDemo」にして作成する
  3. テンプレートの中身を全て削除し、上のコードを丸ごと貼り付ける
  4. F7キー(またはコンパイルボタン)でコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
  5. チャートへドラッグ&ドロップし、終値が20MAを上抜けた瞬間にだけ矢印が出ることを確認する

コンパイルできない・何も描画されないときに確認すること

  • コンパイルエラーになる: `#property indicator_buffers`の数値と、`SetIndexBuffer`のindexの最大値が一致しているか確認する
  • 何も描画されない: `SetIndexBuffer`を呼ぶ前に`SetIndexStyle`を呼んでいないか、順番を確認する
  • 矢印の形が出ない: `SetIndexArrow`のcodeが33〜255の範囲外になっていないか確認する
  • 意図しないバーにも矢印が出る: `EMPTY_VALUE`を入れ忘れたバーが残っていないか確認する

よくある質問

SetIndexBuffer・SetIndexStyle・SetIndexLabelの、

3関数についてよく検索されている疑問を、

3つにまとめて回答します。

SetIndexBufferとSetIndexStyleはどちらを先に呼ぶべきですか?

必ず`SetIndexBuffer`を先に呼んでください。

配列をバッファとして登録していない状態で、

`SetIndexStyle`だけ呼んでも、

対応するバッファが無いため設定が反映されません。

indicator_buffersの数はどこまで増やせますか?

公式リファレンスに明確な上限の記載はありませんが、

既刊記事群では2〜3本程度が中心です。

増やしすぎるとDataWindowが見づらくなるため、

必要な本数だけ登録することをおすすめします。

MQL5でも同じ関数が使えますか?

MQL5にも同名の`SetIndexBuffer`がありますが、

引数の構成がMQL4とは異なり、

`SetIndexStyle`に相当する機能は、

`PlotIndexSetInteger`に分かれています。

既刊PlotIndexSetIntegerの記事で、MQL5版の描画設定を解説しています。

【MQL4】SetIndexBuffer・SetIndexStyle・SetIndexLabelの意味について解説してみた(自作インジケーターが描画されないときに確認する3関数):まとめ

この記事では、自作インジケーターを画面に表示するまでに必要な、

`SetIndexBuffer`(登録)、

`SetIndexStyle`(描画指定)、

`SetIndexLabel`(表示名)の役割分担と、

`SetIndexArrow`・`SetIndexEmptyValue`を加えた、

5関数の組み合わせを解説しました。

ポイントは、`index`の値が、

`#property indicator_buffers`の宣言数より小さいこと、

関数を呼ぶ順番(登録→描画指定→表示名)を守ることの2点です。

「コピペしたのに何も表示されない」ときは、

まずこの2点を確認してみてください。

くわしい自動化の開示方針は編集方針ページもご覧ください。

関連記事