この記事を開いてくださったこと、心から感謝しています。MQL5のEAでチャートの見た目を変えたいと思い、どの関数を使えばよいか迷った人も多いはずです。
結論から言うと、オンオフ、色、日時などの整数系の設定ならChartSetInteger、価格や余白の割合など小数の設定ならChartSetDoubleが向いています。
ただし、範囲外の値を入れたときの動きなど、一部の細かい点は、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の対象・書き方・動き方・仮の使い方・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ChartSetIntegerとChartSetDoubleは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。
ChartSetIntegerは、整数系のプロパティを設定する
MQL5公式リファレンスによると、ChartSetIntegerは、チャートの整数系のプロパティを設定する関数です。公式ページには、対象のプロパティは、日時、整数、色、bool、charのいずれかでなければならない、と書かれています。
引数は、チャートのID、プロパティの種類、値の3つです。サブウィンドウの番号を加えた書き方も、もう1つ用意されています。
- 日時、整数、色、bool、charが対象
- チャートID、種類、値を渡す
- サブウィンドウを指定する書き方もある
ChartSetDoubleは、小数のプロパティを設定する
ChartSetDoubleは、double型のプロパティを設定する関数です。公式ページには、チャートのプロパティはdouble型でなければならない、と書かれています。
引数は、チャートのID、プロパティの種類、値の3つです。確認したページには、サブウィンドウの番号を加えた書き方は載っていませんでした。
- double型のプロパティが対象
- チャートID、種類、値を渡す
- サブウィンドウ付きの書き方は載っていない
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ChartSetInteger | ChartSetDouble |
|---|---|---|
| 対象の型 | 日時、整数、色、bool、char | double |
| 書き方の数 | 2つ(サブウィンドウ付きあり) | 1つ |
| 戻り値 | bool(命令を追加できたか) | bool(命令を追加できたか) |
| 動き方 | 非同期 | 非同期 |
※公式の説明をもとにした、筆者の整理です。
2つに共通する動き方には、どんな決まりがあるのか?
次に、2つの関数に共通する動き方を見ていきます。ここを知っておくと、思い通りに反映されないときに慌てずに済みます。
どちらも非同期で、戻り値は命令の追加結果になる
公式ページには、どちらの関数も非同期だと書かれています。戻り値のtrueは、命令をチャートの待ち行列に追加できたという意味です。プロパティが変わるのは、その命令が処理されてからです。
失敗したときはfalseが返り、その理由はGetLastErrorで調べます。結果を確かめたいときは、ChartGetIntegerやChartGetDoubleを使う、という説明があります。
- 非同期で動く
- trueは命令を追加できた意味
- 失敗の理由はGetLastError
- 確認はChartGetIntegerなど
ChartRedrawで、まとめて反映させる
公式ページには、すぐに反映したいときはChartRedrawを呼ぶ、と書かれています。複数のプロパティを変えるときは、呼び出しをまとめてから、ChartRedrawを1回呼ぶ方法が勧められています。
チャートのプロパティの一覧のページにも、設定の関数は変更の命令を送るだけなので、すぐに見た目が変わることは期待しないように、という説明があります。
| ページ | ChartRedrawの扱い |
|---|---|
| ChartSetInteger | サンプルで呼んでいる |
| ChartSetDouble | サンプルでは呼んでいない |
| プロパティ一覧 | すぐの更新は期待しないよう説明 |
※公式の説明から読み取れる内容を、筆者が整理しました。
細かい動きは、確認できなかった
ChartSetDoubleで、範囲外の値を入れたときの動きは、確認したページに記載なしでした。後で出てくるCHART_SHIFT_SIZEのように、範囲が書かれているプロパティでも、範囲外の扱いは記載なしです。
無効なチャートIDを渡したときの動きや、サブウィンドウの番号を誤ったときの動きも、記載なしでした。
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
どんなプロパティが、それぞれの対象になるのか?
ここでは、チャートのプロパティの一覧のページをもとに、それぞれの関数で設定できるものを整理します。
ChartSetIntegerでは、オンオフや色を設定できる
一覧のページには、整数系のプロパティとして、グリッドや価格目盛りの表示のオンオフ、背景やローソク足の色、チャートの拡大率などが並んでいます。拡大率のCHART_SCALEは、0から5の整数です。
読み取り専用のプロパティもあります。表示されている足の数や、ウィンドウの総数などは、読み取り専用で、設定には使えません。
- グリッドや価格目盛りの表示のオンオフ
- 背景やローソク足などの色
- CHART_SCALEは0から5の整数
- 読み取り専用のものは設定できない
ChartSetDoubleでは、割合や価格の固定値を設定できる
double型のプロパティには、CHART_SHIFT_SIZEやCHART_FIXED_MAX、CHART_FIXED_MINなどがあります。
CHART_SHIFT_SIZEは、右端の余白の大きさを表す値です。
一覧のページでは、CHART_SHIFT_SIZEは10から50パーセントの範囲、と書かれています。一方、CHART_PRICE_MINとCHART_PRICE_MAXは、読み取り専用です。
| プロパティ | 種類 | 設定できるか |
|---|---|---|
| CHART_SHIFT_SIZE | double | できる |
| CHART_FIXED_MAX | double | できる |
| CHART_PRICE_MAX | double | 読み取り専用 |
| CHART_COMMENT | string | ChartSetStringを使う |
※公式の説明から読み取れる内容を、筆者が整理しました。
公式のサンプルを、見比べる
ChartSetIntegerのサンプルでは、マウスの移動イベントを有効にするため、CHART_EVENT_MOUSE_MOVEに1を設定し、そのあとChartRedrawを呼んでいます。マウスの位置とボタンの状態をコメントに出す例です。
ChartSetDoubleのサンプルでは、CHART_SHIFT_SIZEを少しずつ変えながら、チャートを右端へ動かしています。変更の前に元の値を保存し、最後に戻す作りです。
- Integerのサンプルはイベントの有効化
- Doubleのサンプルは右端の余白を少しずつ変える
- 元の値を保存して最後に戻している
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、2つの使い方を比べます。
例の前提を、そろえる
EAを起動したときに、チャートの見た目を整える場合を考えます。グリッドを消して、右端に余白を作り、マウスの動きを受け取れるようにする、という流れです。
- グリッドを消す
- 右端に余白を作る
- マウスの動きを受け取る
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
グリッドとイベントは、ChartSetIntegerで設定する
グリッドの表示のオンオフと、マウスの移動イベントの有効化は、どちらも整数系のプロパティです。ChartSetIntegerで、続けて呼べます。
マウスの動きを受け取る仕組みは、OnChartEventの記事で整理しています。
- グリッドの表示はオンオフの値
- マウスの移動イベントも設定で有効にする
- 続けて呼んでから、まとめて反映する
右端の余白は、ChartSetDoubleで設定する
右端の余白の大きさは、CHART_SHIFT_SIZEで決まるため、ChartSetDoubleを使います。ただし、余白を使うには、別のプロパティでチャートのシフトを有効にしておく必要があるのかは、確認したページに記載なしでした。
最後に、ChartRedrawを1回だけ呼べば、まとめて反映する形になります。コメント欄への表示との違いは、CommentとChartSetStringの記事で整理しています。
| 場面(仮) | 向いている関数 |
|---|---|
| グリッドを消す | ChartSetInteger |
| マウスの動きを受け取る | ChartSetInteger |
| 右端の余白を決める | ChartSetDouble |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。と言っても、実際には、設定したいプロパティの型で自然に決まります。
型が整数系なら、ChartSetIntegerを選ぶ
オンオフ、色、日時、拡大率のような設定は、ChartSetIntegerの担当です。プロパティの型が分からないときは、一覧のページで、どの関数用の表に載っているかを確かめましょう。
FX口座・ツールの比較一覧もあわせて確認してみてください。
型がdoubleなら、ChartSetDoubleを選ぶ
右端の余白の割合や、価格の固定値のように、小数で決めるプロパティは、ChartSetDoubleの担当です。範囲が決まっているものは、範囲の中で指定しましょう。
- 余白の割合を決めたい
- 価格の固定値を決めたい
- 範囲が書かれているものは範囲内で指定する
小さく試して、動きを確かめる
いきなり本番のEAで使わず、小さなスクリプトで、1つずつ設定してみましょう。設定の前に元の値を保存し、終わったら戻す作りにしておくと、チャートの見た目を壊しにくいです。









もう1つのコツは、設定の呼び出しを、1つの関数にまとめておくことです。起動時の見た目の設定を1か所に集めておけば、あとから直したいときも探しやすくなります。
また、設定の結果を確かめたいときは、ChartGetIntegerやChartGetDoubleを使います。公式ページには、これらは同期で結果を待つ、という趣旨の説明があります。
- 設定の呼び出しを1つの関数にまとめる
- 元の値を保存して戻せるようにする
- 確認にはChartGetIntegerなどを使う
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
設定したらすぐに見た目が変わるのか?
すぐとは限りません。公式ページには、命令は待ち行列に追加され、処理されてから反映される、と書かれています。すぐに反映したいときは、ChartRedrawを呼びます。
- 命令は待ち行列に入る
- すぐ反映したいならChartRedraw
読み取り専用のプロパティは、設定できるのか?
いいえ。公式ページには、プロパティの種類には、読み取り専用のものを除く、と書かれています。一覧のページで、r/oと書かれているものが、読み取り専用です。
- 読み取り専用は設定できない
- 一覧のr/oの印で確かめる
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のChartSetIntegerとChartSetDouble、表示のオンオフや色をまとめて切り替えられる幅広さと価格や余白の割合を小数で細かく決められる繊細さどっちを選ぶ?」
整数系の設定ならChartSetInteger、小数の設定ならChartSetDoubleが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










