MQL4(MT4) ObjectGetIntegerの使い方

ObjectGetInteger関数は、MetaTrader 4 (MT4) プラットフォームのMQL4言語で、チャート上の特定のグラフィカルオブジェクトに設定された整数型のプロパティ値を取得するために使用されます。この関数は、オブジェクトの色、スタイル、幅など、整数型で表されるプロパティを取得する際に便利です。関数には2つの形式があります。

1. 即時にプロパティ値を返す形式

この形式は、関数が直接long型のプロパティ値を返します。

long ObjectGetInteger(
   long chart_id,         // チャート識別子
   string object_name,    // オブジェクト名
   int prop_id,           // プロパティ識別子
   int prop_modifier=0    // プロパティ修飾子（必要な場合）
);

使用例1: オブジェクトのZオーダーを取得

void OnStart()
{
    long chartID = ChartID(); // 現在のチャートIDを取得
    string objectName = "ExampleObject"; // オブジェクト名
    int propID = OBJPROP_ZORDER; // Zオーダーのプロパティ識別子

    long zOrder = ObjectGetInteger(chartID, objectName, propID);
    Print("オブジェクト '", objectName, "' のZオーダー: ", zOrder);
}

2. 成功時にtrueを返し、プロパティ値を参照によって受け取る形式

この形式は、関数が成功したかどうかをbool値で返し、プロパティ値を関数の最後のパラメータである参照変数に設定します。

bool ObjectGetInteger(
   long chart_id,         // チャート識別子
   string object_name,    // オブジェクト名
   int prop_id,           // プロパティ識別子
   int prop_modifier,     // プロパティ修飾子
   long& long_var         // ここにプロパティ値を受け取る
);

使用例2: 成功時にオブジェクトの幅を取得

void OnStart()
{
    long chartID = ChartID();
    string objectName = "ExampleLine";
    int propID = OBJPROP_WIDTH; // オブジェクトの幅のプロパティ識別子
    long lineWidth;

    if(ObjectGetInteger(chartID, objectName, propID, 0, lineWidth))
    {
        Print("オブジェクト '", objectName, "' の幅: ", lineWidth);
    }
    else
    {
        Print("オブジェクト '", objectName, "' の幅の取得に失敗しました。");
    }
}

注意点

• プロパティ識別子: prop_idには、取得したいプロパティの種類を指定します。これはOBJPROP_WIDTH（幅）、OBJPROP_COLOR（色）、OBJPROP_ZORDER（Zオーダー）など、オブジェクトの種類に応じたプロパティです。
• プロパティ修飾子: 一部のプロパティではprop_modifierを指定する必要があります。たとえば、テキストオブジェクトのフォントサイズを取得する場合などです。
• チャート識別子: chart_idは、特定のチャートを指定するために使用されます。ChartID()関数を使用して現在のチャートのIDを取得できます。
• エラーハンドリング: 第2の形式を使用する場合、関数がfalseを返したら、GetLastError関数を使用してエラーをチェックすることが推奨されます。

これらの点に注意しながらObjectGetInteger関数を使用することで、プログラム的にチャートオブジェクトの整数型プロパティ値を取得し、分析や取引戦略に活用することが可能になります。