この記事を開いてくださったこと、心から感謝しています。チャート上に置いた線や図形の設定を、EAやスクリプトから読み取りたいと考えた人も多いはずです。
結論から言うと、時間・色・種類など整数系の値を読むならObjectGetInteger、価格やレベルの値を小数のまま読むならObjectGetDoubleが向いています。
ただし、存在しない名前を渡したときの動きなど、一部は確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の仕組み・2種類の書き方・公式サンプル・仮の使い方・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ObjectGetIntegerとObjectGetDoubleは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらも、グラフィカルオブジェクトの設定値を読み取る関数です。
ObjectGetIntegerは、整数系の値を読み取る
MQL5公式リファレンスによると、ObjectGetIntegerは、オブジェクトのプロパティの値を返す関数です。対象は、datetime・int・color・bool・charのいずれかの型のプロパティです。
プロパティの指定には、ENUM_OBJECT_PROPERTY_INTEGERという列挙型を使います。値は、long型で受け取ります。
- 時間・整数・色・真偽・文字の型が対象
- 列挙型はENUM_OBJECT_PROPERTY_INTEGER
- 値はlong型で受け取る
ObjectGetDoubleは、小数の値を読み取る
ObjectGetDoubleも、オブジェクトのプロパティの値を返す関数です。こちらの対象は、double型のプロパティだけです。
プロパティの指定には、ENUM_OBJECT_PROPERTY_DOUBLEを使います。価格や、フィボナッチのレベル値のような、小数の値を扱います。
- double型のプロパティだけが対象
- 列挙型はENUM_OBJECT_PROPERTY_DOUBLE
- 値はdouble型で受け取る
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ObjectGetInteger | ObjectGetDouble |
|---|---|---|
| 対象の型 | datetime・int・color・bool・char | double |
| プロパティの列挙型 | ENUM_OBJECT_PROPERTY_INTEGER | ENUM_OBJECT_PROPERTY_DOUBLE |
| 直接返す値の型 | long | double |
| 参照で受け取る型 | long& | double& |
| 書き方の種類 | 2種類 | 2種類 |
※公式の説明をもとにした、筆者の整理です。
2種類の書き方は、どう違うのか?
2つの関数には、どちらにも2種類の書き方があります。ここを理解すると、失敗したときの扱いが見えてきます。
値を直接返す書き方
1つ目は、値をそのまま返す書き方です。引数は、チャートID・オブジェクト名・プロパティID・修飾子の4つで、修飾子は省略すると0になります。
式の中にそのまま書けるので、短く書けるのが利点です。サンプルでも、オブジェクトの種類や価格をこの形で読んでいます。
- 値をそのまま返す
- 修飾子は省略すると0
- 式の中に短く書ける
参照で受け取り、成否を返す書き方
2つ目は、bool型を返す書き方です。最後の引数に変数を渡すと、そこに値が入り、成功ならtrueが返ります。
公式ページには、プロパティが対応していて値を入れられたときにtrue、そうでなければfalseを返し、詳しい理由はGetLastErrorで調べる、と書かれています。この形では、修飾子の省略はできません。
- 値は渡した変数に入る
- 成功ならtrue、失敗ならfalse
- 理由はGetLastErrorで調べる
- 修飾子は省略できない
失敗したときの扱いを、表で整理する
2つの書き方で、失敗したときの扱いを比べます。値を直接返す書き方の失敗時の動きは、ページに書かれていませんでした。
| 書き方 | 失敗したときの扱い |
|---|---|
| 値を直接返す | 返す値は記載なし |
| 参照で受け取る | falseを返し、GetLastErrorで調べる |
※公式の説明から読み取れる内容を、筆者が整理しました。
修飾子とは、何のために使うのか?
引数のprop_modifierは、少し分かりにくい部分です。公式の説明と、サンプルでの使われ方を見ていきます。
ほとんどのプロパティでは、修飾子はいらない
公式ページには、ほとんどのプロパティには修飾子が必要ない、と書かれています。修飾子が必要なのは、フィボナッチの各ツールやアンドリューズ・ピッチフォークの、レベル番号を指定するときです。
レベルの番号は、0から数え始めます。たとえば、最初のレベルは0、次は1です。
- 多くのプロパティでは修飾子はいらない
- フィボナッチ系とピッチフォークで使う
- レベル番号は0から数える
サンプルでは、アンカー点にも番号を使っている
ObjectGetDoubleのサンプルでは、価格を読むときに、0と1の番号を渡しています。これは、フィボナッチの2つのアンカー点の価格を、順に読んでいます。
ただし、アンカー点の番号の意味が修飾子の説明に含まれるのかは、ページの説明文には記載なしでした。サンプルの書き方から、そう使われていることが分かる、という事実だけです。
| 場面 | 修飾子の使われ方(サンプル) |
|---|---|
| オブジェクトの種類を読む | 省略(0) |
| 作成時刻を読む | 0を明示 |
| アンカー点の価格を読む | 0と1 |
| レベルの値を読む | ループ変数のi |
※公式のサンプルの内容を、筆者が整理しました。
範囲外の番号を渡したときは、どうなるのか
存在しないレベル番号を渡したときの動きは、ページに記載なしでした。修飾子が不要なプロパティに番号を渡したときの動きも、記載なしです。
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
呼び出しの重さには、どんな注意があるのか?
2つの関数には、どちらにも同じ注意書きがあります。多くのオブジェクトを扱うときは、見落とせない点です。
同期呼び出しで、待ち時間が出ることがある
公式ページによると、この関数は同期呼び出しです。そのチャートで、この呼び出しより前に積まれたすべての命令の実行を、待ってから動きます。
そのため、時間がかかる場合があります。チャート上に多くのオブジェクトがあるときは、この特徴を考えに入れる必要がある、と書かれています。
- 積まれた命令の実行を待つ
- 時間がかかる場合がある
- オブジェクトが多いときは要注意
関連する関数との関係
オブジェクトの値を書き換える側の関数については、ObjectMoveとObjectSetInteger・ObjectSetDoubleの記事で整理しています。読む側と書く側を、セットで考えると理解しやすくなります。チャート側の設定を書き換える関数は、ChartSetIntegerとChartSetDoubleの記事も参考になります。
| 役割 | 関数 |
|---|---|
| 整数系の値を読む | ObjectGetInteger |
| 小数の値を読む | ObjectGetDouble |
| 文字列の値を読む | ObjectGetString |
| 整数系の値を書く | ObjectSetInteger |
| 小数の値を書く | ObjectSetDouble |
※公式ページの関数一覧をもとにした、筆者の整理です。
公式のサンプルは、どう書かれているのか?
ここでは、公式ページにあるサンプルを見ていきます。どちらも、オブジェクトを作ってから、値を読む流れになっています。
ObjectGetIntegerのサンプルは、垂直線の時刻を読む
ObjectGetIntegerのサンプルは、垂直線のオブジェクトを現在時刻で作り、作成時刻と、チャート上の時刻を読んで表示する内容です。
2つの時刻は参照で受け取る書き方で読み、オブジェクトの種類は直接返す書き方で読んでいます。種類は、列挙型に型変換して使っています。最後に、2秒待ってオブジェクトを削除します。
- 垂直線を作って時刻を読む
- 時刻は参照で受け取る書き方
- 種類は直接返す書き方で、型変換して使う
- 2秒待ってから削除する
ObjectGetDoubleのサンプルは、フィボナッチのレベルを読む
ObjectGetDoubleのサンプルは、表示中のチャートの高値と安値の間にフィボナッチのオブジェクトを作り、各レベルの値を読む内容です。
レベル数は、整数の関数で読みます。2つのアンカー点の価格は、直接返す書き方で読みます。各レベルの値は、ループの中で、参照で受け取る書き方で読んでいます。
読んだレベルの値を使い、安値に、値幅とレベル値をかけたものを足して、各レベルの価格を計算しています。サンプルの結果には、レベル0から8までの値と価格が並びます。
| サンプルの手順 | 使っている関数 |
|---|---|
| レベル数を読む | ObjectGetInteger |
| アンカー点の価格を読む | ObjectGetDouble(直接) |
| レベルの値を読む | ObjectGetDouble(参照) |
| レベルの色を変える | ObjectSetInteger |
| レベルの文字を読み書きする | ObjectGetString・ObjectSetString |
※公式のサンプルの内容を、筆者が整理しました。
ここから読み取れることと、読み取れないこと
サンプルでは、レベルの値に値幅をかけて価格を出しています。このことから、レベルの値は割合として扱われているように見えます。ただし、ページの説明文には、割合だと書かれていませんでした。
| 確認できること | 確認できないこと |
|---|---|
| ループ前にResetLastErrorを呼ぶ例がある | 毎回呼ぶ必要があるか |
| レベルの値を割合として計算している | 割合と明記した説明 |
| 結果は例として載っている | 結果が保証される値か |
※公式の説明から読み取れる内容を、筆者が整理しました。
記載のない点は、どう扱えばよいのか?
2つの関数のページには、実際に使うときに気になる点で、説明が見当たらないものがあります。確認した範囲を、整理しておきます。
存在しない名前や、不正なチャートID
存在しないオブジェクト名や、正しくないチャートIDを渡したときの動きは、確認したページに記載なしでした。エラーコードの種類も、記載なしです。
- 存在しない名前は記載なし
- 不正なチャートIDは記載なし
型の違うプロパティを指定したとき
整数のプロパティをObjectGetDoubleで読んだ場合など、型が合わないときの動きも、ページに記載なしでした。列挙型が分かれているため、通常は混ざらない作りになっています。
- 存在しない名前の扱いは記載なし
- 不正なチャートIDの扱いは記載なし
- 型の違うプロパティの扱いは記載なし
- 直接返す書き方の失敗時の値は記載なし
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、使い方を比べます。実際の結果を示すものではありません。
例の前提を、そろえる
チャートに水平線を1本引いてあり、その線の色と価格を、あとから確認したい場合を考えます。
- 水平線のオブジェクトが1本ある
- 線の色と価格を確認したい
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
色はObjectGetInteger、価格はObjectGetDouble
色はcolor型なので、ObjectGetIntegerで読みます。価格はdouble型なので、ObjectGetDoubleで読みます。同じオブジェクトでも、読む関数が分かれるのがポイントです。
| 知りたいこと(仮) | 使う関数 |
|---|---|
| 線の色 | ObjectGetInteger |
| 線の価格 | ObjectGetDouble |
| 線の名前の説明文 | ObjectGetString |
1つの関数に統一はできない
型ごとに関数が分かれているので、1つの関数ですべてを読むことはできません。読みたい値の型を先に確かめてから、関数を選ぶ流れになります。
- 先にプロパティの型を確かめる
- 型に合った関数を選ぶ
- 参照で受け取る書き方で成否を確認する
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。結局のところ、読みたい値の型で決まります。
守備範囲の広さを優先するなら、ObjectGetIntegerを選ぶ
時刻・色・種類・レベル数など、幅広い値をまとめて読みたいときは、ObjectGetIntegerが向いています。対象の型が5つあるため、読める項目が多いのが特徴です。
FX口座・ツールの比較一覧もあわせて確認してみてください。
正確さを優先するなら、ObjectGetDoubleを選ぶ
価格やレベルの値を、小数のまま読みたいときは、ObjectGetDoubleが向いています。計算にそのまま使えるのが特徴です。
- 価格を読みたい
- レベルの値を計算に使いたい
- 小数のまま扱いたい
小さく試して、動きを確かめる
いきなり多くのオブジェクトを読まず、線を1本だけ作って、色と価格を表示するところから始めましょう。そのあとで、読む項目を少しずつ増やすと、違いがよく分かります。









もう1つのコツは、読む前にResetLastErrorを呼んでおくことです。公式のサンプルにも、ループの前に呼ぶ例があります。前の呼び出しのエラーが残っていると、判断を間違えやすいためです。
- 読む前にResetLastErrorを呼ぶ
- falseのときだけGetLastErrorを見る
- 数が多いときは読む回数を減らす
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
chart_idに0を渡すと、どうなるのか?
公式ページには、0は現在のチャートを意味する、と書かれています。ほかのチャートを読みたいときは、そのチャートのIDを渡します。
- 0は現在のチャート
- ほかのチャートはIDを渡す
色や真偽の値は、どちらの関数で読むのか?
color型とbool型は、ObjectGetIntegerの対象と書かれています。小数の価格は、ObjectGetDoubleで読みます。
- 色と真偽はObjectGetInteger
- 価格はObjectGetDouble
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のObjectGetIntegerとObjectGetDouble、時間や色など整数系の値をまとめて読み取れる守備範囲の広さと価格やレベル値を小数のまま読み取れる正確さどっちを選ぶ?」
時刻・色・種類など整数系の値を読むならObjectGetInteger、価格やレベルの値を小数のまま読むならObjectGetDoubleが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










