MQL4では、チャートの見た目や動作を制御するためのチャートプロパティ定数が用意されています。この記事では、ENUM_CHART_PROPERTY_INTEGER、ENUM_CHART_PROPERTY_STRING、ENUM_CHART_PROPERTY_DOUBLEの3種類の列挙型を中心に、チャート設定の操作方法をわかりやすく解説します。

チャートプロパティを操作する関数の全体像

MQL4では、チャートプロパティの値を「設定する関数」と「取得する関数」がデータ型ごとにペアで用意されています。

これらの関数の第1引数にはチャートIDを指定します。0を指定すると現在のチャートを意味します。第2引数に、これから説明する列挙型の定数を渡すことで、どのプロパティを操作するかを指定します。

ENUM_CHART_PROPERTY_INTEGER — 整数型プロパティ

最も種類が多く、よく使うのがこの整数型プロパティです。チャートの表示/非表示の切り替え、色の設定、モードの変更など幅広い操作ができます。

表示モード系のプロパティ

表示要素の ON/OFF 系プロパティ

色の設定用プロパティ

チャートの配色もすべてプログラムから制御できます。color型の値を指定します。

読み取り専用のプロパティ

以下のプロパティは値の取得のみ可能で、プログラムから変更はできません（読み取り専用 = r/o）。

実践サンプル：チャートの配色をカスタマイズする

以下はEAのOnInit()内でチャートの見た目を一括変更する例です。

int OnInit()
{
   // チャート表示をローソク足に変更
   ChartSetInteger(0, CHART_MODE, CHART_CANDLES);
   
   // 背景色をダークブルーに設定
   ChartSetInteger(0, CHART_COLOR_BACKGROUND, clrMidnightBlue);
   
   // グリッドを非表示にする（背景色と同色でも可）
   ChartSetInteger(0, CHART_SHOW_GRID, false);
   
   // 陽線（Bull）の色設定
   ChartSetInteger(0, CHART_COLOR_CANDLE_BULL, clrDodgerBlue);
   ChartSetInteger(0, CHART_COLOR_CHART_UP, clrDodgerBlue);
   
   // 陰線（Bear）の色設定
   ChartSetInteger(0, CHART_COLOR_CANDLE_BEAR, clrMediumOrchid);
   ChartSetInteger(0, CHART_COLOR_CHART_DOWN, clrMediumOrchid);
   
   // Askラインを表示する
   ChartSetInteger(0, CHART_SHOW_ASK_LINE, true);
   
   // 設定を反映
   ChartRedraw();
   
   return(INIT_SUCCEEDED);
}

ポイント：ChartSetInteger()を呼んだだけでは画面にすぐ反映されないことがあります。確実に描画を更新したい場合は、最後にChartRedraw()を呼びましょう。

ENUM_CHART_PROPERTY_DOUBLE — 浮動小数点型プロパティ

Double型のプロパティは数が少なく、主にチャートの価格範囲を取得するために使います。

実践サンプル：現在のチャート価格範囲を取得する

void OnTick()
{
   // 現在チャートに表示されている価格範囲を取得
   double priceMin = ChartGetDouble(0, CHART_PRICE_MIN);
   double priceMax = ChartGetDouble(0, CHART_PRICE_MAX);
   
   Print("表示中の価格範囲: ", priceMin, " ～ ", priceMax);
}

CHART_PRICE_MINとCHART_PRICE_MAXは、画面上に「今見えている」範囲の最小・最大価格です。スクロールやズームに応じて動的に変化するため、現在の表示状態を知りたいときに便利です。

ENUM_CHART_PROPERTY_STRING — 文字列型プロパティ

文字列型のプロパティは現在1つだけです。

実践サンプル：チャートにコメントを表示する

void OnTick()
{
   // ChartSetString でチャートコメントを設定
   string info = "スプレッド: " + IntegerToString(SymbolInfoInteger(_Symbol, SYMBOL_SPREAD))
               + " / Bid: " + DoubleToString(Bid, _Digits);
   
   ChartSetString(0, CHART_COMMENT, info);
   ChartRedraw();
}

// コメントの取得
void ShowCurrentComment()
{
   string currentComment = ChartGetString(0, CHART_COMMENT);
   Print("現在のコメント: ", currentComment);
}

ChartSetString()によるCHART_COMMENTの設定は、Comment()関数と同様にチャート左上にテキストを表示します。Comment()関数との違いは、チャートIDを指定できるため他のチャートウィンドウに対してもコメントを設定できる点です。

応用テクニック：チャートの設定を保存・復元する

EAやインジケーターでチャートの見た目を変更する場合、終了時に元の設定に戻すのがマナーです。以下のパターンを覚えておきましょう。

// グローバル変数に元の設定を保存
color g_origBgColor;
bool  g_origShowGrid;

int OnInit()
{
   // 元の設定を保存
   g_origBgColor  = (color)ChartGetInteger(0, CHART_COLOR_BACKGROUND);
   g_origShowGrid = (bool)ChartGetInteger(0, CHART_SHOW_GRID);
   
   // 新しい設定を適用
   ChartSetInteger(0, CHART_COLOR_BACKGROUND, clrBlack);
   ChartSetInteger(0, CHART_SHOW_GRID, false);
   ChartRedraw();
   
   return(INIT_SUCCEEDED);
}

void OnDeinit(const int reason)
{
   // 元の設定を復元
   ChartSetInteger(0, CHART_COLOR_BACKGROUND, g_origBgColor);
   ChartSetInteger(0, CHART_SHOW_GRID, g_origShowGrid);
   ChartRedraw();
}

こうすることで、EAを取り外したときにチャートが元の見た目に戻ります。ユーザーにとって親切な設計になりますので、ぜひ習慣にしてください。

よくある注意点とつまずきポイント

① ChartRedraw()を忘れない

チャートプロパティを変更する関数は、実際にはイベントキューにコマンドを追加するだけです。画面への即時反映が必要な場合は、ChartRedraw()を明示的に呼びましょう。

② 第1引数のチャートID

第1引数に0を指定すると「現在のチャート」を意味します。別のチャートを操作したい場合は、ChartID()やChartFirst()/ChartNext()で取得したIDを使います。

③ 読み取り専用プロパティに注意

CHART_WIDTH_IN_PIXELSやCHART_PRICE_MINなどの読み取り専用（r/o）プロパティに対してSet関数を呼んでも、値は変更されません。公式リファレンスで「r/o」の表記を確認しましょう。

④ 新しく開いたチャートの操作タイミング

ChartOpen()で新しくチャートを開いた直後は、まだデータが読み込まれていない場合があります。CHART_PRICE_MINやCHART_PRICE_MAXを取得しても0が返ることがあるため、少し待つか、次のティックで取得するようにしましょう。

まとめ

MQL4のチャートプロパティ定数は、大きく3つの列挙型に分類されます。

• ENUM_CHART_PROPERTY_INTEGER：色・表示切替・モード設定など（最も種類が多い）
• ENUM_CHART_PROPERTY_DOUBLE：価格範囲・スケール関連
• ENUM_CHART_PROPERTY_STRING：チャートコメント

操作にはChartSetInteger()/ChartGetInteger()、ChartSetDouble()/ChartGetDouble()、ChartSetString()/ChartGetString()の6つの関数を使い分けます。

特に、EAやインジケーターでチャートの配色カスタマイズや情報表示を行う際に必須の知識となりますので、まずは本記事のサンプルコードを動かして、チャートプロパティの変更を体験してみてください！

投稿 【MQL4】チャート設定定数を完全理解！ENUM_CHART_PROPERTY_INTEGER・STRING・DOUBLEの使い方 は 自動売買を作ろう！ に最初に表示されました。