既刊のバッファ記事では、
バッファが「データを一時的に保存しておく変数」であることを説明しました。
ですが、その配列を実際にインジケーターの線として画面に表示するには、
`SetIndexBuffer`、
`SetIndexStyle`、
`SetIndexLabel`という、
3つの関数を正しい順番で呼ぶ必要があります。
この記事では、サンプルコードをコピペするだけでは気づきにくい、
3関数それぞれの役割分担と、
「何も描画されない」事故の代表的な原因を解説します。
- なぜこの3関数を知らないと「何も描画されない」事故が起きるのか
- SetIndexBuffer:配列をインジケーターバッファとして登録する
- SetIndexStyle:描画タイプ・色・太さを指定する
- SetIndexLabel・SetIndexArrow・SetIndexEmptyValue:表示を仕上げる補助関数
- 実際に動くコード全体:5関数を組み合わせた矢印インジケーター
- コンパイルできない・何も描画されないときに確認すること
- よくある質問
- 【MQL4】SetIndexBuffer・SetIndexStyle・SetIndexLabelの意味について解説してみた(自作インジケーターが描画されないときに確認する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で実際に動かす手順
- MT4の「ツール」→「MetaQuotes Language Editor」でMetaEditorを開く
- 「ファイル」→「新規作成」→「カスタムインディケータ」を選び、名前を「BufferStyleLabelDemo」にして作成する
- テンプレートの中身を全て削除し、上のコードを丸ごと貼り付ける
- F7キー(またはコンパイルボタン)でコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
- チャートへドラッグ&ドロップし、終値が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点を確認してみてください。
くわしい自動化の開示方針は編集方針ページもご覧ください。
コメント