この記事を開いてくださったこと、心から感謝しています。チャートへ線やラベルをプログラムから置きたいと考えている人も、きっと多いはずです。
結論から言うと、オブジェクトを作る、または動かすならObjectCreate、同じ名前のオブジェクトがあるかを確かめるならObjectFindです。作る関数と、探す関数という違いがあり、動き方にも差があります。
また、エラーコードの詳しい説明など、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・戻り値・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ObjectCreateとObjectFindは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。1つはオブジェクトを作る関数で、もう1つは名前で探す関数です。
ObjectCreateは、チャートへオブジェクトを作る
ObjectCreateは、指定したチャートへ、指定した種類のオブジェクトを作る関数です。引数は、チャートID、名前、種類、ウィンドウの番号、そして時間と価格の組が続きます。
戻り値はbool型で、命令をチャートの待ち行列へ入れられたときだけ、trueになります。作る命令を送れたという意味で、作成が終わった証拠ではありません。
- 指定した種類のオブジェクトを、チャートへ作る
- 引数は、チャートID・名前・種類・ウィンドウ・座標
- 戻り値のtrueは、命令を送れたことを意味する
ObjectFindは、名前でオブジェクトを探す
ObjectFindは、指定した名前のオブジェクトが、チャートにあるかを調べる関数です。引数は、チャートIDと名前の2つだけで、とてもシンプルです。
見つかったときは、そのオブジェクトがあるウィンドウの番号を、整数で返します。メインウィンドウなら0です。見つからなかったときは、負の値を返します。
- 指定した名前のオブジェクトを、探す
- 引数は、チャートIDと名前の2つ
- 見つかったら、ウィンドウの番号を返す
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ObjectCreate | ObjectFind |
|---|---|---|
| 役割 | オブジェクトを作る | 名前で探す |
| 戻り値 | bool | int(ウィンドウの番号か負の値) |
| 引数の数 | 多い(最大で座標の組が続く) | 2つ |
| 同期か非同期か | 非同期 | 同期 |
| エラーの調べ方 | falseのとき(調べ方は記載なし) | 負の値のとき、GetLastError |
※公式の説明をもとにした、筆者の整理です。
ObjectCreateは、どんな場面で使うのか?
ObjectCreateは、チャートへ線や図形、文字などを置きたいときの、基本の関数です。公式の説明から、引数と動き方を確認します。
名前は、チャートの中で1つに決める
名前は、サブウィンドウも含めた、そのチャートの中で、重複しない必要があると書かれています。長さの上限は、公式の注記では、63文字です。
すでに同じ名前のオブジェクトがあるときは、新しく作らず、座標を変えようとする、という説明もあります。この動きが、すべての種類で同じかは、記載なしでした。
- 名前は、そのチャートの中で重複させない
- 名前の長さの上限は、63文字
- 同じ名前があると、座標を変えようとする
ウィンドウの番号は、0がメイン
ウィンドウの番号は、0がメインウィンドウで、サブウィンドウは1から数えます。指定したサブウィンドウが存在しないと、falseが返ります。
作る前に、サブウィンドウが存在するかを、確かめておくと安心です。
- 0は、メインウィンドウを意味する
- サブウィンドウは、1から数える
- 存在しないウィンドウだと、falseが返る
座標は、種類によって必要な数が変わる
時間と価格の組は、最大で30組まで並べられる書き方です。ただし、公式の説明では、30組は将来のためで、実際は引数の数の上限で決まる、と説明されています。
必要な組の数は、オブジェクトの種類で決まります。公式の一覧から、代表的なものを表にまとめます。
| 必要な組 | オブジェクトの例 |
|---|---|
| 1組 | 垂直線・水平線・矢印・文字 |
| 2組 | トレンドライン・フィボナッチ・長方形 |
| 3組 | チャネル・ピッチフォーク・三角形 |
| 5組 | エリオット波動(5波) |
※公式の一覧をもとにした、筆者の整理です。
座標でなく、距離で置く種類もある
ラベルやボタン、入力欄などは、時間と価格ではなく、画面の左上からの距離で位置を決めます。これらは、プロパティで距離を設定する作りです。
2種類の文字表示の違いは、OBJ_LABELとOBJ_TEXTの記事が参考になります。座標で置くか、距離で置くかの違いが分かります。
- ラベル・ボタン・入力欄は、距離で位置を決める
- 距離は、プロパティで設定する
- 垂直線は時間だけ、水平線は価格だけが使われる
非同期なので、trueでも作成の証拠にはならない
公式の説明では、ObjectCreateは非同期です。命令を待ち行列へ入れるだけで、実行を待たないため、trueが返っても、作成が終わったとは限りません。
結果を確かめたいときは、ObjectFindやObjectGetの関数を使うよう、案内されています。これらは、作成の命令のあとに並ぶため、結果を待つ動きになります。
- trueは、命令を送れたことだけを意味する
- 結果の確認には、ObjectFindなどを使う
- 確認の関数は、同期なので重くなることがある
ObjectFindは、どんな場面で使うのか?
ObjectFindは、同じ名前のオブジェクトが、すでにあるかを確かめたいときに使います。作る前の確認や、作ったあとの確認に向いています。
戻り値は、ウィンドウの番号か負の値
見つかったときは、ウィンドウの番号が返ります。見つからないときは、負の値が返ります。具体的な数値は、確認したページには、記載なしでした。
見つからなかった理由は、GetLastErrorで調べる、と案内されています。ただし、どの値になるかの説明は、本文にはなく、サンプルの中で、名前だけが出てきます。
| 結果 | 戻り値 |
|---|---|
| 見つかった | ウィンドウの番号(メインは0) |
| 見つからない | 負の値(具体的な数値は記載なし) |
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
同期で動くので、重くなることがある
公式の説明では、ObjectFindは同期の呼び出しです。そのチャートへ、先に送られている命令がすべて終わるのを待ってから、結果を返します。
そのため、オブジェクトが多いチャートでは、時間がかかる可能性があります。ObjectCreateのあとに続けて呼ぶと、作成の完了を待つ形になります。
- 先に送られた命令の完了を、待ってから返す
- オブジェクトが多いと、時間がかかることがある
- 作成の直後に呼ぶと、結果を待つ形になる
作ったあとの削除は、別の関数で行う
ObjectFindは、探すだけの関数で、削除はできません。名前を指定して消す関数と、まとめて消す関数の違いは、ObjectDeleteとObjectsDeleteAllの記事にまとめています。
- ObjectFindは、探すだけで、削除はできない
- 削除は、ObjectDeleteなどを使う
- 探してから消す、という流れが基本
公式のサンプルは、どう書かれているのか?
2つの関数には、それぞれ公式サンプルがあります。ObjectFindのサンプルは、2つの関数が並んで使われる、分かりやすい例です。
ObjectFindは、探して、なければ作る
ObjectFindのサンプルは、まず、チャートIDを取得し、エラーの値をリセットします。そのあと、指定した名前のオブジェクトが、メインウィンドウにあるかを確かめます。
あれば、その旨を表示して終わります。なければ、エラーの内容が、見つからないというものか、確認します。別のエラーなら、エラーの値を表示して終わります。
見つからないだけなら、垂直線を、現在の時間と価格0で作ります。作ったあとに、もう一度探して、あることを確かめてから、1秒待って、削除します。
- あるかを確かめ、なければ作る
- 作ったあとに、もう一度探して確かめる
- 最後に、削除して、画面を更新する
ObjectCreateは、5つの座標を用意して作る
ObjectCreateのサンプルは、入力で種類を選べるスクリプトです。初期値は垂直線で、描画できる足が7本より少ないと、メッセージを表示して終わります。
同じ名前のオブジェクトが残っていれば、先に削除します。そのうえで、5つの座標を用意して、ObjectCreateを呼びます。成功したら、選択できる設定にします。
ラベルやボタンなどの種類には、座標ではなく、距離とサイズを設定します。最後に、ChartRedrawで画面を更新する流れです。出力例は、確認したページには、記載なしでした。
| サンプル | 主な流れ |
|---|---|
| ObjectFind | 探して、なければ作り、もう一度探す |
| ObjectCreate | 座標を用意して作り、選択できる設定にする |
※公式サンプルの内容を、筆者が整理しました。
サンプルを写すときの注意点
ObjectFindのサンプルは、メインウィンドウにあるときだけ、あると判断します。サブウィンドウにあるオブジェクトは、番号が0ではないので、ないものとして扱われる作りです。
これは、サンプルの書き方から読み取れる点で、公式の説明に明記があるわけではありません。サブウィンドウも扱うときは、条件を、自分で見直しましょう。
- サンプルは、メインウィンドウだけを見ている
- サブウィンドウでは、条件を見直す
- 動かす前に、小さな範囲で試す
どう使い分ければよいのか?
2つは競合する関数ではなく、役割が違います。作りたいのか、あるかを確かめたいのかで、使い分けます。
作りたいなら、ObjectCreateを選ぶ
チャートへ、線やラベルなどを置きたいときは、ObjectCreateが向いています。種類と座標を指定して、自由に置けるのが特長です。
FX口座・ツールの比較一覧もあわせて確認してみてください。
確かめたいなら、ObjectFindを選ぶ
同じ名前のオブジェクトが、すでにあるかを確認したいときは、ObjectFindが向いています。作った結果を確かめるときにも、使えます。
- 作る前に、重複を確認したい
- 作ったあとに、結果を確かめたい
- オブジェクトのあるウィンドウを知りたい
組み合わせるなら、探してから作る
公式のサンプルは、探して、なければ作る、という形でした。この順番は、同じ名前を何度も作らないための、1つの形です。









もう1つのコツは、オブジェクトの名前に、決まりを作っておくことです。名前が重複しない決まりにしておくと、探すときも、消すときも、迷いにくくなります。
- 名前の決まりを、先に作っておく
- 結果は、まずログに出して確かめる
- エラーの詳しい説明は記載なしなので、小さく試す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
ObjectCreateがtrueなら、オブジェクトは作られているのか?
いいえ、trueは、命令を送れたことを意味するだけです。公式の説明では、非同期のため、作成が終わった証拠にはなりません。
- trueは、命令を送れたことだけを意味する
- 作成の確認は、ObjectFindなどで行う
ObjectFindが負の値のとき、何を調べればよいのか?
公式の説明では、GetLastErrorで、エラーを調べる、と案内されています。具体的な値の一覧は、確認したページには、記載なしでした。
- GetLastErrorで、エラーを調べる
- 値の一覧は、記載なし
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のObjectCreateとObjectFind、チャートへ線やラベルを置ける自由さと同じ名前のオブジェクトがあるか確かめられる確実さどっちを選ぶ?」
作るならObjectCreate、あるかを確かめるならObjectFindです。非同期と同期の違いを知り、記載のない点は自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










