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の使い方 は 自動売買を作ろう！ に最初に表示されました。

チャート出来高の種類の定数は、チャート出来高の表示の種類を選択するときに使用されます。

主に、ChartSetInteger関数です。

チャート出来高の種類の定数（ENUM_CHART_VOLUME_MODE）

チャート出来高の種類の定数の使い方

主に、ChartSetInteger関数で使用されます。

ChartSetInteger関数の、CHART_SHOW_VOLUMESの設定値で使用されます。

上記の定数を入力しましょう。

すると、その定数に対応したチャート出来高の種類が選択されます。

例えば、以下のように使用します。

  //ChartSetInteger関数
  //CHART_SHOW_VOLUMESの設定値にCHART_VOLUME_HIDEを入れる
  //出来高を表示しない
  bool chartSetInteger = ChartSetInteger(ChartID(), CHART_SHOW_VOLUMES ,CHART_VOLUME_HIDE);

返り値はbool型です。

成功すればture、失敗すればfalseが返ってきます。

【補足】チャート出来高の種類の定数の列挙型（ENUM_CHART_VOLUME_MODE）

チャート出来高の種類の定数は、ENUM_CHART_VOLUME_MODE​という列挙型に含まれています。

列挙型は、定数群をひとまとめにしたものです。

以下のように使います。

ENUM_CHART_VOLUME_MODE chartVolumeMode = CHART_VOLUME_HIDE;

上記のようにプログラムすると、chartVolumeMode変数に CHART_VOLUME_HIDEの数値が代入されます。

【MQLプログラミング基礎】列挙型とは？配列との違いを理解して使いこなそう！

目次 列挙型とは？列挙型と配列の違い列挙型と配列のデータの取り出し方法の違い列挙型と配列のデータの取り出し方法のまとめ列挙型の構造と使い方列挙型の構造列挙型の使い方列挙型はどこで使われているのか列挙型のプログラム例まとめ

mql-programing.com

【MQL4プログラミング】自動売買の作り方！FXで使えるテンプレートあり

目次 はじめにFX自動売買とはFX自動売買を作るための準備FX自動売買の作り方口座凍結の対策をするプログラムテンプレートを作る決済ロジックをプログラミングするプログラムテンプレートを作るエントリーロジックをプログラミング

mql-programing.com

MQL4リファレンス【全データ一覧】

/*! elementor - v3.6.5 - 27-04-2022 */.e-container.e-container--row .elementor-spacer-inner{width:var(--spacer-size)}.e-

mql-programing.com

投稿 【MQL4定数】チャート出来高の種類の定数（ENUM_CHART_VOLUME_MODE） は 自動売買を作ろう！ に最初に表示されました。

チャートバーの種類の定数は、チャートバーの表示の種類を選択するときに使用されます。

主に、ChartSetInteger関数です。

チャートバーの種類の定数（ENUM_CHART_MODE）

チャートバーの種類の定数の使い方

主に、ChartSetInteger関数で使用されます。

ChartSetInteger関数の、CHART_MODEの設定値で使用されます。

上記の定数を入力しましょう。

すると、その定数に対応したチャートバーの種類が選択されます。

例えば、以下のように使用します。

  //ChartSetInteger関数
  //CHART_MODEの設定値にCHART_CANDLESを入れる
  //ロウソク足を選択
  bool chartSetInteger = ChartSetInteger(ChartID(), CHART_MODE ,CHART_CANDLES);

返り値はbool型です。

成功すればture、失敗すればfalseが返ってきます。

【補足】チャートバーの種類の定数の列挙型（ENUM_CHART_MODE）

チャートバーの種類の定数は、ENUM_CHART_MODE​という列挙型に含まれています。

列挙型は、定数群をひとまとめにしたものです。

以下のように使います。

ENUM_CHART_MODE chartMode = CHART_CANDLES;

上記のようにプログラムすると、chartMode変数に CHART_CANDLESの数値が代入されます。

【MQLプログラミング基礎】列挙型とは？配列との違いを理解して使いこなそう！

目次 列挙型とは？列挙型と配列の違い列挙型と配列のデータの取り出し方法の違い列挙型と配列のデータの取り出し方法のまとめ列挙型の構造と使い方列挙型の構造列挙型の使い方列挙型はどこで使われているのか列挙型のプログラム例まとめ

mql-programing.com

【MQL4プログラミング】自動売買の作り方！FXで使えるテンプレートあり

目次 はじめにFX自動売買とはFX自動売買を作るための準備FX自動売買の作り方口座凍結の対策をするプログラムテンプレートを作る決済ロジックをプログラミングするプログラムテンプレートを作るエントリーロジックをプログラミング

mql-programing.com

MQL4リファレンス【全データ一覧】

/*! elementor - v3.6.5 - 27-04-2022 */.e-container.e-container--row .elementor-spacer-inner{width:var(--spacer-size)}.e-

mql-programing.com

投稿 【MQL4定数】チャートバーの種類の定数（ENUM_CHART_MODE） は 自動売買を作ろう！ に最初に表示されました。

チャート設定の定数（Integer型）は、チャート設定関数の引数として使用します。

主に、ChartSetInteger関数と ChartGetInteger関数です。

以下、関数の簡単な説明です。

• ChartSetInteger関数：チャートの状態を設定する
• ChartGetInteger関数：チャートの状態を取得する

ここで注意して欲しいのは、定数の数値が直接設定されるのではなく、定数の項目に値を設定するということです。

そのため定数の他に、別の値を設定する必要があります。

定数によって、入出力可能な型が決まっているので、それも確認しましょう。

チャート操作用の定数には、Integer型の他にも Double型、String型の3種類があります。

ここでは、Integer型の情報を記載しております。

ちなみに Integer型とは、「int型・bool型・color型・datetime型・列挙型」を指します。

チャート設定の定数：Integer型（ENUM_CHART_PROPERTY_INTEGER）

チャート設定の定数（Integer型）の使い方

主に、ChartSetInteger関数と ChartGetInteger関数で使用されます。

ChartSetInteger関数を実行する場合は、定数の他にInteger型の値を入力します。

ChartGetInteger関数を実行する場合は、定数だけで問題ありません。

例えば、以下のように使用します。

  //ChartSetInteger関数
  //チャートの自動スクロールを許可
  bool chartSetInteger = ChartSetInteger(0,CHART_AUTOSCROLL,0,true);


  //ChartGetInteger関数
  //チャートの自動スクロールの状態を取得
  bool chartGetInteger = ChartGetInteger(0,CHART_AUTOSCROLL,0);

今回は返り値が bool型です。

実際にプログラミングするときは、上記の表にしたがって変数の型を設定してください。

【補足】チャート設定の定数：Integer型の列挙型（ENUM_CHART_PROPERTY_INTEGER）

チャート設定の定数（Integer型）は、ENUM_CHART_PROPERTY_INTEGER​という列挙型に含まれています。

列挙型は、定数群をひとまとめにしたものです。

以下のように使います。

ENUM_CHART_PROPERTY_INTEGER chartPropertyInteger = CHART_AUTOSCROLL;

上記のようにプログラムすると、chartPropertyInteger変数に CHART_AUTOSCROLLの数値が代入されます。

【MQLプログラミング基礎】列挙型とは？配列との違いを理解して使いこなそう！

目次 列挙型とは？列挙型と配列の違い列挙型と配列のデータの取り出し方法の違い列挙型と配列のデータの取り出し方法のまとめ列挙型の構造と使い方列挙型の構造列挙型の使い方列挙型はどこで使われているのか列挙型のプログラム例まとめ

mql-programing.com

【MQL4プログラミング】自動売買の作り方！FXで使えるテンプレートあり

目次 はじめにFX自動売買とはFX自動売買を作るための準備FX自動売買の作り方口座凍結の対策をするプログラムテンプレートを作る決済ロジックをプログラミングするプログラムテンプレートを作るエントリーロジックをプログラミング

mql-programing.com

MQL4リファレンス【全データ一覧】

/*! elementor - v3.6.5 - 27-04-2022 */.e-container.e-container--row .elementor-spacer-inner{width:var(--spacer-size)}.e-

mql-programing.com

投稿 【MQL4定数】チャート設定の定数：Integer型（ENUM_CHART_PROPERTY_INTEGER） は 自動売買を作ろう！ に最初に表示されました。