ObjectCreateAndSet - MetaTrader 5のためのライブラリ

添付された *mqh ファイルには、オブジェクトの作成とオブジェクトプロパティの変更のための関数が含まれています。チャート上にオブジェクトを作成したり、既存のオブジェクトのプロパティを変更するテストコードをすばやく記述する必要があるときには、特に便利です。

もう1つのファイルは、使用例のスクリプトです（テキストラベルを作成し、テキストと途中で徐々に90度回転させ色を変えます）。

I. オブジェクト作成のための関数：

これらの関数はMQL5レフェレンスに説明されている標準関数に基づいています。対応する標準関数との主な相違点は下記のとおりです。

• ツールヒントを設定したり、異なる時間枠でオブジェクトの可視性を設定するための行を追加しました。
• 座標、価格やアンカーポイントを設定せずに関数を作成する行を削除しました（VLineCreate(...) およびEventCreate(...)を除く）。
• このライブラリに実装されているオブジェクトのプロパティを設定（変更）するための関数に基づいて、プロパティの設定が成功したかどうかを確認するための条件が追加されました。

オブジェクト作成のための関数：

II. オブジェクトプロパティ設定のための関数

修飾子なしでのObjectSetDouble(...)、ObjectSetInteger(...)及びObjectSetString(...)の使用：

修飾子を持ったObjectSetDouble(...)、ObjectSetInteger(...)及びObjectSetString(...)の使用：

その他の関数：

III. 使用法：

インクルードファイルとして使用することもできますし、特定の関数をソースコードにコピーすることもできます。

第2の方法を選択した場合は、まずそれをインクルードファイルとして使用する方が良いと思います。必要な関数呼び出しがすべて実装されれば、インクルードディレクティブ（#include ...）は削除できます。

次に、コンパイラはインクルードファイルからコピーする必要のある関数を指摘します。

インクルードファイルとしての使用：

1. 添付されたObjectCreateAndSet.mqhを Includeフォルダに保存します。これにはMetaEditorのナビゲータウィンドウが使用できます。ナビゲータウィンドウでIncludeフォルダをクリックしてOpen Folder（フォルダを開く）を選びます。
   
   
2. ライブラリを自分のコードで使うにはファイルの最初の#include...行を自分のコードにコピペします。
   

   #include <ObjectCreateAndSet.mqh>

   添付されたスクリプトは、ライブラリをインクルードする例を提供します。
   
   
3. この後でコードをコンパイルします。名前の入力を開始すると、含まれている関数のツールヒントが表示されます。

図1　最初の数文字を入力した後のツールヒント内の完全な関数名

図2　ツールヒント内の関数のパラメータ

ところでMetaEditorツールバーの functions list（関数リスト）ボタンを使って現在のファイルに使われる関数のリストを手早く見ることができます。

図3　ファイルで使用される関数のリストを表示するためのボタン

ボタンを押すと、ドロップダウンリストが表示されます。特定の機能に移動するには、リスト内の名前をクリックします。

図4　ボタンを押すとファイルで関数リストが開きます（特定の機能にすばやく移動するのに便利です）。

更新：

• 2015.09.14 </ b0>：ObDelete()関数で、オブジェクトを削除するときにエラーが発生した場合、オブジェクトの名前の出力を「エキスパート」タブに追加しました。コード内のエラーを見つけやすくなりました。