この記事を開いてくださったこと、心から感謝しています。チャートの幅や、表示されている価格の範囲を、プログラムから読み取りたいと考えている人も多いはずです。
結論から言うと、本数・幅・高さ・色などの整数で扱える値はChartGetInteger、価格の上下限のような小数の値はChartGetDoubleです。どちらも、読み取りたい項目を列挙型で指定して使います。
ただし、失敗したときの戻り値や、エラーコードの扱いなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・戻り値・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ChartGetIntegerとChartGetDoubleは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。読み取れる値の種類が違い、使う列挙型も違います。
ChartGetIntegerは、整数で扱える値を読み取る
ChartGetIntegerは、チャートのプロパティのうち、整数で扱えるものを読み取る関数です。指定には、ENUM_CHART_PROPERTY_INTEGERの値を使います。
公式の列挙型の一覧には、CHART_WIDTH_IN_BARS、CHART_FIRST_VISIBLE_BAR、CHART_VISIBLE_BARS、CHART_WIDTH_IN_PIXELSなどがあります。本数や画面の大きさが中心です。
- 本数や画面の大きさなど、整数で扱える値
- 項目の指定には、ENUM_CHART_PROPERTY_INTEGERを使う
- 色や列挙型の項目も、この一覧に入っている
ChartGetDoubleは、小数で扱える値を読み取る
ChartGetDoubleは、チャートのプロパティのうち、小数で扱えるものを読み取る関数です。指定には、ENUM_CHART_PROPERTY_DOUBLEの値を使います。
公式の一覧には、CHART_PRICE_MIN、CHART_PRICE_MAX、CHART_SHIFT_SIZE、CHART_FIXED_MIN、CHART_FIXED_MAXなどがあります。価格の範囲や余白の割合が中心です。
- 価格の範囲や余白の割合など、小数で扱える値
- 項目の指定には、ENUM_CHART_PROPERTY_DOUBLEを使う
- 価格の上下限は、サブウィンドウ番号を修飾子に取る
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ChartGetInteger | ChartGetDouble |
|---|---|---|
| 読み取る値 | 整数で扱える値 | 小数で扱える値 |
| 項目の指定 | ENUM_CHART_PROPERTY_INTEGER | ENUM_CHART_PROPERTY_DOUBLE |
| 値を直接返す形の戻り値 | long型 | double型 |
| 値を変数に入れる形 | long型の変数に格納 | double型の変数に格納 |
| 失敗したときの戻り値(直接返す形) | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
呼び出し方は、2通りあるのか?
2つの関数には、どちらも、値を直接返す形と、変数に格納して成否を返す形の2通りがあります。ここを押さえると、失敗の扱いが理解しやすくなります。
値を直接返す形は、手軽に使える
1つ目の形は、チャートID、プロパティの指定、サブウィンドウ番号を渡し、値をそのまま返してもらう形です。サブウィンドウ番号の初期値は0で、メインのチャートウィンドウを指します。
チャートIDの0は、現在のチャートを意味すると書かれています。公式の説明では、ほとんどのプロパティはサブウィンドウ番号を必要としないとも書かれています。
- チャートID、項目、サブウィンドウ番号を渡す
- サブウィンドウ番号の初期値は0
- 値がそのまま返ってくる
変数に格納する形は、成否も分かる
2つ目の形は、値を入れる変数を最後の引数に渡し、戻り値は成否を示すbool型になる形です。指定したプロパティが利用できて、値が格納されたときにtrueを返し、そうでなければfalseです。
追加の情報が必要なときは、GetLastError関数を呼ぶと書かれています。ただし、具体的なエラーコードの一覧は、確認したページには記載なしでした。
- 戻り値は、成否を示すbool型
- 利用できて格納できたときにtrue
- 詳細はGetLastErrorで調べると書かれている
2つの形を、表で比べる
| 形 | 戻り値 | 失敗の知らせ方 |
|---|---|---|
| 値を直接返す形 | 値そのもの | 失敗時の戻り値は記載なし |
| 変数に格納する形 | bool型(成否) | falseを返し、GetLastErrorで調べる |
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
なお、公式ページのChartGetDoubleでは、変数に格納する形のサブウィンドウ番号に初期値の記載がありません。省略できるかどうかは、書き方を見て確かめる必要があります。
どんな項目を読み取れるのか?
読み取れる項目は、公式の列挙型の一覧にまとまっています。ここでは、一覧から、いくつかの例だけを拾って整理します。
整数側の項目は、画面の大きさや本数が中心
整数側には、チャートの幅を本数で表すCHART_WIDTH_IN_BARSや、画面の最初に見える足の番号を示すCHART_FIRST_VISIBLE_BARがあります。表示されている本数はCHART_VISIBLE_BARSです。
画面の大きさでは、CHART_WIDTH_IN_PIXELSが幅、CHART_HEIGHT_IN_PIXELSが高さです。高さは、修飾子としてサブウィンドウ番号を取ると一覧に書かれています。
- CHART_WIDTH_IN_BARS:幅を本数で表す
- CHART_FIRST_VISIBLE_BAR:最初に見える足
- CHART_VISIBLE_BARS:表示されている本数
- CHART_WIDTH_IN_PIXELS:幅をピクセルで表す
- CHART_HEIGHT_IN_PIXELS:高さをピクセルで表す
小数側の項目は、価格の範囲が中心
小数側には、画面に表示されている価格の最小値と最大値を示す、CHART_PRICE_MINとCHART_PRICE_MAXがあります。どちらも読み取り専用で、修飾子としてサブウィンドウ番号を取ります。
ほかに、固定スケールの最小値と最大値を示すCHART_FIXED_MINとCHART_FIXED_MAX、右の余白の割合を示すCHART_SHIFT_SIZEなどが並んでいます。
- CHART_PRICE_MIN:表示中の価格の最小値
- CHART_PRICE_MAX:表示中の価格の最大値
- CHART_FIXED_MINとCHART_FIXED_MAX:固定スケールの範囲
- CHART_SHIFT_SIZE:右の余白の割合
2つの一覧は、セットの関数と共通している
この2つの列挙型は、値を設定する側のChartSetIntegerとChartSetDoubleでも使われます。設定側の違いは、ChartSetIntegerとChartSetDoubleの記事で整理しています。
一方、読み取り専用の項目は、設定側では変更できません。公式の一覧では、読み取り専用を示す印がついていますが、書き込み専用の項目は、確認した表では見当たりませんでした。
| 種類 | 読み取り専用の例 | 設定もできる例 |
|---|---|---|
| 整数側 | CHART_WIDTH_IN_BARS、CHART_VISIBLE_BARS | CHART_SHOW、CHART_MODE |
| 小数側 | CHART_PRICE_MIN、CHART_PRICE_MAX | CHART_FIXED_MIN、CHART_FIXED_MAX |
※一覧の一部を、筆者が整理した例です。全項目は公式の一覧でご確認ください。
公式のサンプルは、どう書かれているのか?
2つの公式サンプルは、どちらも短い作りで、現在のチャートの値を読み取って表示します。値を読み取る流れが分かりやすい例です。
ChartGetIntegerのサンプルは、幅と高さを読む
ChartGetIntegerのサンプルは、現在のチャートのメインウィンドウについて、高さと幅をピクセルで読み取ります。読み取った値は、Print関数で表示されます。
引数は、チャートIDに0、項目にCHART_HEIGHT_IN_PIXELSかCHART_WIDTH_IN_PIXELS、サブウィンドウ番号に0です。実行したときの出力は、ページには記載なしでした。
- 現在のチャートの高さと幅を読み取る
- サブウィンドウ番号は0(メイン)
- Printで値を表示する
ChartGetDoubleのサンプルは、価格の上下限を読む
ChartGetDoubleのサンプルは、現在のチャートのメインウィンドウについて、表示されている価格の最小値と最大値を読み取ります。こちらも、Print関数で値を表示します。
項目はCHART_PRICE_MINとCHART_PRICE_MAXで、チャートIDとサブウィンドウ番号は0です。こちらも、出力例は記載なしでした。
- 現在のチャートの価格の最小値と最大値を読み取る
- サブウィンドウ番号は0(メイン)
- Printで値を表示する
2つのサンプルを、表で比べる
| 項目 | ChartGetInteger | ChartGetDouble |
|---|---|---|
| 読み取る内容 | 高さと幅(ピクセル) | 価格の最小値と最大値 |
| 対象 | 現在のチャートのメイン | 現在のチャートのメイン |
| 表示のしかた | Print関数 | Print関数 |
| 出力例 | 記載なし | 記載なし |
※公式サンプルの内容を、筆者が整理しました。
呼び出しのタイミングで、気をつけることはあるのか?
公式ページには、2つの関数について、同じ注意書きがあります。読み取りの前に、チャートへ出した命令がどう扱われるかに関わる内容です。
2つの関数は、同期的に動く
公式の説明では、どちらも同期的な関数と書かれています。呼び出す前に、チャートのキューへ追加された命令がすべて実行されるまで、待つという意味です。
つまり、設定を変えたあとに値を読み取ると、その変更が反映されたあとの値を読み取れる、という使い方がしやすい関数です。ただし、それ以上の細かい動きは、記載なしでした。
- 呼び出し前に出した命令の実行を待つ
- 設定のあとに読むと、反映後の値が分かりやすい
- 細かい動きは記載なし
修飾子の指定は、項目によって変わる
列挙型の説明には、特定のプロパティでは、修飾子を追加で指定する必要があると書かれています。0はメインのウィンドウを示します。
サブウィンドウに指標を表示しているチャートでは、番号の指定が、読み取りたい範囲に関わる場合があります。範囲外の番号を渡したときの動きは、記載なしでした。
| 注意点 | 公式の記載 |
|---|---|
| 同期的に動く | あり |
| 修飾子が必要な項目がある | あり |
| 範囲外の番号を渡したときの動き | 記載なし |
| 無効なチャートIDを渡したときの動き | 記載なし |
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
どう使い分ければよいのか?
2つは競合する関数ではなく、値の種類で使い分ける、姉妹関数です。読み取りたい項目が、整数側と小数側のどちらの一覧にあるかで決まります。
本数や画面の大きさなら、ChartGetIntegerを選ぶ
表示本数、幅、高さ、色など、整数で扱える値を読み取りたいときは、ChartGetIntegerが向いています。項目の一覧が広いため、読める種類が多いのが特長です。
FX口座・ツールの比較一覧もあわせて確認してみてください。
価格の範囲なら、ChartGetDoubleを選ぶ
画面に表示されている価格の最小値と最大値のように、小数で扱いたい値は、ChartGetDoubleが向いています。固定スケールの範囲や余白の割合も、こちらの担当です。
- 表示中の価格の上下限を読みたい
- 固定スケールの範囲を読みたい
- 小数側の一覧から項目を選ぶ
読み取りの結果を確かめたいなら、変数に格納する形を選ぶ
成否を確かめながら使いたいときは、変数に格納する形が向いています。falseのときにGetLastErrorで調べる流れが、公式に書かれているためです。









もう1つのコツは、項目の名前を、変数や定数に入れて整理することです。どの項目を読み取っているのかが、あとから読み返しても分かりやすくなります。設定側の関数との関係は、ChartNavigateとChartSetIntegerの記事もあわせて参考にしてください。
- 項目の名前は、読みやすく整理する
- 結果は、まずログに出して確かめる
- 成否の確認は、必ず行う
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
チャートIDに0を渡すと、どのチャートが対象なのか?
公式の説明では、0は現在のチャートを意味します。そのため、0を渡すと、プログラムが動いている現在のチャートが対象です。
- 0は、現在のチャート
- サンプルも、0を渡している
失敗したときの戻り値は、どうなるのか?
変数に格納する形では、falseを返すと書かれています。一方、値を直接返す形の失敗時の戻り値は、確認したページには記載なしでした。
- 格納する形は、falseを返す
- 直接返す形の失敗時は記載なし
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のChartGetIntegerとChartGetDouble、幅や表示本数などを整数で読み取れる幅広さと価格の上下限を小数で読み取れる細かさどっちを選ぶ?」
本数や画面の大きさなど、整数で扱える値はChartGetInteger、価格の上下限のような小数の値はChartGetDoubleです。成否を確かめたいときは、変数に格納する形を使い、記載のない点は自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










