この記事を開いてくださったこと、心から感謝しています。スクリプトやEAをチャートにドロップした位置の情報を、プログラムで使いたいと考えた人も多いはずです。
結論から言うと、ドロップした位置の時間が欲しいならChartTimeOnDropped、価格が欲しいならChartPriceOnDroppedが向いています。どちらも引数は不要で、1行で受け取れます。
ただし、値がいつまで有効なのか、ドロップしていないときの値はどうなるのか、といった点は、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・戻り値・関連する関数・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ChartTimeOnDroppedとChartPriceOnDroppedは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらも、ドロップした位置の座標を返す関数で、返す値の種類が違います。
ChartTimeOnDroppedは、時間を返す
MQL5公式リファレンスによると、ChartTimeOnDroppedは、EAやスクリプトをドロップしたチャート上の点に対応する、時間の座標を返す関数です。戻り値はdatetime型です。
引数はありません。公式のサンプルは、受け取った時間を、そのままログに表示する短い内容になっています。
- ドロップした点の時間を返す
- 戻り値はdatetime型
- 引数はない
ChartPriceOnDroppedは、価格を返す
ChartPriceOnDroppedは、EAやスクリプトをドロップしたチャート上の点に対応する、価格の座標を返す関数です。戻り値はdouble型です。
こちらも引数はありません。公式のサンプルは、受け取った価格を、そのままログに表示する短い内容です。
- ドロップした点の価格を返す
- 戻り値はdouble型
- 引数はない
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ChartTimeOnDropped | ChartPriceOnDropped |
|---|---|---|
| 返すもの | 時間の座標 | 価格の座標 |
| 戻り値の型 | datetime | double |
| 引数 | なし | なし |
| サンプルの内容 | 時間をログに表示 | 価格をログに表示 |
| 失敗時の扱い | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
ほかのドロップ系の関数には、どんなものがあるのか?
公式ページの関連項目には、ドロップした位置を調べる関数が、ほかにも並んでいます。2つの関数と合わせて、全体像をつかんでおきましょう。
画面の座標を返すChartXOnDroppedとChartYOnDropped
ChartXOnDroppedは、ドロップした点のX座標を返し、ChartYOnDroppedは、Y座標を返します。どちらも戻り値はint型で、引数はありません。
公式ページには、X軸は左から右へ、Y軸は上から下へ向かう、と書かれています。時間や価格ではなく、画面上の位置で受け取りたいときに使います。
- Xは左から右へ向かう
- Yは上から下へ向かう
- どちらも戻り値はint型
ウィンドウ番号を返すChartWindowOnDropped
ChartWindowOnDroppedは、ドロップしたサブウィンドウの番号を返します。公式ページには、0はメインのチャートウィンドウを意味する、と書かれています。
公式のサンプルでは、この番号と、CHART_WINDOWS_TOTALで調べたウィンドウの総数を、ログに表示しています。
| 関数 | 返すもの |
|---|---|
| ChartTimeOnDropped | 時間(datetime) |
| ChartPriceOnDropped | 価格(double) |
| ChartXOnDropped | X座標(int) |
| ChartYOnDropped | Y座標(int) |
| ChartWindowOnDropped | ウィンドウ番号(int) |
※公式の説明から読み取れる内容を、筆者が整理しました。
公式ページに、書かれていないことは何か?
2つの関数のページは、とても短く、使うときに気になる点の多くが書かれていません。確認できた範囲と、できなかった範囲を分けて整理します。
確認できなかったこと
値がいつまで有効なのかは、記載なしでした。ドロップしていないプログラムで呼んだときの値や、失敗したときの扱い、エラーコードも、記載なしです。
サブウィンドウにドロップしたときの、時間と価格の座標の扱いも、書かれていません。使うときは、自分の環境で結果を確かめる必要があります。
- 値が有効な期間は記載なし
- ドロップしていないときの値は記載なし
- 失敗時の扱いは記載なし
- サブウィンドウでの座標の扱いは記載なし
確認できたこと
一方で、戻り値の型は、はっきり書かれています。時間はdatetime型、価格はdouble型です。また、どちらも引数なしで呼び出せる点は、確実です。
| 確認できること | 確認できないこと |
|---|---|
| 戻り値の型が分かる | 値が有効な期間 |
| 引数なしで呼べる | ドロップしていないときの値 |
| 関連する関数が5つある | 失敗時のエラーコード |
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
公式のサンプルは、どう書かれているのか?
ここでは、公式ページにあるサンプルの流れを見ていきます。どれも、ログに表示するだけの、短い内容です。
時間と価格のサンプルは、ログに表示する
ChartTimeOnDroppedのサンプルは、受け取った時間を文字にして、スクリプトがドロップされた位置として表示します。ChartPriceOnDroppedのサンプルは、受け取った価格を、そのまま表示します。
どちらのページにも、実際の出力例は載っていませんでした。出力の見え方は、記載なしです。
- 時間をログに表示する
- 価格をログに表示する
- 出力例は載っていない
座標のサンプルには、出力例がある
ChartYOnDroppedのページのサンプルは、X座標とY座標を受け取り、ログに表示します。コメントには、Xが429、Yが114という結果の例が書かれています。
この例が、どんなチャートでの結果かは、記載なしです。値の大きさの目安として、見る程度にとどめましょう。
| サンプル | やっていること |
|---|---|
| ChartTimeOnDropped | 時間をログに表示 |
| ChartPriceOnDropped | 価格をログに表示 |
| ChartYOnDropped | XとYをログに表示(出力例あり) |
| ChartWindowOnDropped | ウィンドウ番号と総数を表示 |
※公式のサンプルの内容を、筆者が整理しました。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、使い方を比べます。実際の結果を示すものではありません。
例の前提を、そろえる
スクリプトをチャートにドロップした位置に、印となる線を引きたい場合を考えます。
- ドロップした位置に、線を引きたい
- 時間と価格の両方が必要
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
垂直線なら時間、水平線なら価格
垂直線は時間で位置が決まるため、ChartTimeOnDroppedで受け取った時間を使います。水平線は価格で位置が決まるため、ChartPriceOnDroppedで受け取った価格を使います。
- 垂直線には、時間を使う
- 水平線には、価格を使う
- 両方使えば、十字線にもできる
画面上の位置が欲しいなら、座標の関数を使う
画面上の位置を数字で知りたいときは、ChartXOnDroppedとChartYOnDroppedを使います。時間と価格に直したいときの考え方は、座標の変換を扱った記事で整理しています。
| 場面(仮) | 向いている関数 |
|---|---|
| 垂直線を引く | ChartTimeOnDropped |
| 水平線を引く | ChartPriceOnDropped |
| 画面上の位置を知る | ChartXOnDropped・ChartYOnDropped |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。結局のところ、欲しいのが時間か価格かで決まります。
時間が欲しいなら、ChartTimeOnDroppedを選ぶ
ドロップした位置の時間が欲しいときは、ChartTimeOnDroppedが向いています。垂直線を引く場面や、時間を基準にした処理の起点に合います。
FX口座・ツールの比較一覧もあわせて確認してみてください。
価格が欲しいなら、ChartPriceOnDroppedを選ぶ
ドロップした位置の価格が欲しいときは、ChartPriceOnDroppedが向いています。水平線を引く場面や、価格を基準にした処理の起点に合います。
画面の座標と、時間・価格を相互に変換する方法については、ChartXYToTimePriceとChartTimePriceToXYの記事で整理しています。ドロップ系の関数と、あわせて読むと理解しやすくなります。
- ドロップした位置の価格を使いたい
- 水平線を引きたい
- 価格を処理の起点にしたい
小さく試して、動きを確かめる
いきなり複雑な処理を作らず、スクリプトをドロップして、時間と価格をログに表示するところから始めましょう。表示位置の動かし方は、ChartNavigateとChartSetIntegerの記事が参考になります。









もう1つのコツは、受け取った値を、まずログに出して確かめることです。公式のサンプルも、まず表示する書き方になっています。
- 受け取った値を、まずログに出す
- ドロップしていない場合は自分で確かめる
- 使う前に、値の範囲を確認する
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
どんなプログラムで使えるのか?
公式ページには、EAやスクリプトをドロップした点、と書かれています。ほかの種類のプログラムでの扱いは、記載なしです。
- EAとスクリプトが対象
- ほかの種類は記載なし
引数は、本当に不要なのか?
はい、2つの関数のシグネチャには、引数がありません。チャートIDを指定する書き方も、確認できませんでした。そのため、対象はドロップしたチャートと読み取れます。
- 引数はない
- チャートIDの指定は確認できない
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のChartTimeOnDroppedとChartPriceOnDropped、ドロップした位置の時間をそのまま受け取れる手軽さと価格をそのまま受け取れる分かりやすさどっちを選ぶ?」
ドロップした位置の時間が欲しいならChartTimeOnDropped、価格が欲しいならChartPriceOnDroppedが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










