MQL4(MT4) ObjectGetShiftByValueの使い方

ObjectGetShiftByValue関数は、MetaTrader 4 (MT4) プラットフォームのMQL4言語で、指定された価格におけるチャート上の特定のオブジェクトのバーポジション（時間軸上の位置）を取得するために使用されます。この関数は、価格レベルがオブジェクトにどのように対応しているかを知りたい場合に便利です。

ObjectGetShiftByValue関数の使用法

この関数は、指定された価格レベルに対応するチャート上の特定のオブジェクトの時間軸（バーのインデックス）上の位置を取得します。特に、トレンドラインや水平線などの価格に依存するオブジェクトにおいて、指定された価格がそのオブジェクトにどのように対応しているかを知りたい場合に使用します。

int ObjectGetShiftByValue(
   string object_name,   // オブジェクト名
   double value          // 価格
);

• object_name: バーポジションを取得したいオブジェクトの名前です。
• value: 対応するバーポジションを知りたい価格レベルです。

使用例: 水平線オブジェクトにおける特定の価格レベルのバーポジションを取得

以下の例では、”MyHorizontalLine”という名前の水平線オブジェクトに対して、指定された価格レベル1.1500におけるバーポジションを取得し、それを出力します。

void OnStart()
{
    string objectName = "MyHorizontalLine"; // 水平線オブジェクトの名前
    double priceLevel = 1.1500; // 取得したい価格レベル

    // 指定価格における水平線のバーポジションを取得
    int shift = ObjectGetShiftByValue(objectName, priceLevel);

    if(shift != -1)
    {
        Print("価格 ", priceLevel, " における '", objectName, "' のバーポジション: ", shift);
    }
    else
    {
        Print("指定された価格に対応するバーポジションが見つかりませんでした。");
    }
}

注意点

• オブジェクトの種類: この関数は、価格レベルに依存するオブジェクト（例えば、水平線、トレンドラインなど）に対してのみ意味があります。価格レベルが関係ないオブジェクト（テキストオブジェクトなど）には使用できません。
• 戻り値の解釈: 関数が-1を返した場合、指定された価格に対応するバーポジションが見つからなかったことを意味します。これは、価格がオブジェクトの範囲外であるか、その他の理由で計算できない場合に発生します。
• オブジェクトの存在: 指定されたオブジェクト名がチャート上に存在し、正しい名前が使用されていることを確認してください。存在しないオブジェクト名が指定された場合、関数は有効なバーポジションを返すことができません。

ObjectGetShiftByValue関数を使用することで、特定の価格レベルにおけるオブジェクトの位置をプログラム的に把握し、分析や戦略の決定に役立てることが可能です。