MQL4(MT4) ObjectSetIntegerの使い方

ObjectSetInteger関数は、MetaTrader 4 (MT4) プラットフォームのMQL4言語で、チャート上の特定のグラフィカルオブジェクトの整数型のプロパティ値を設定するために使用されます。整数型のプロパティには、オブジェクトの色、幅、Zオーダーなどが含まれます。この関数には、修飾子なしでプロパティ値を設定するバージョンと、修飾子を指定してプロパティ値を設定するバージョンの2つがあります。

修飾子なしでプロパティ値を設定

bool ObjectSetInteger(
   long chart_id,         // チャート識別子
   string object_name,    // オブジェクト名
   int prop_id,           // プロパティ
   long prop_value        // 値
);

修飾子を指定してプロパティ値を設定

bool ObjectSetInteger(
   long chart_id,          // チャート識別子
   string object_name,     // オブジェクト名
   int prop_id,            // プロパティ
   int prop_modifier,      // 修飾子
   long prop_value         // 値
);

使用例1: オブジェクトの幅を設定（修飾子なし）

チャート上の”ExampleLine”という名前のラインオブジェクトの幅を3に設定する例です。

void OnStart()
{
    long chartID = ChartID(); // 現在のチャートIDを取得
    string objectName = "ExampleLine";
    int propID = OBJPROP_WIDTH; // 幅のプロパティ識別子
    long propValue = 3; // 設定する幅

    if(ObjectSetInteger(chartID, objectName, propID, propValue))
    {
        Print("オブジェクト '", objectName, "' の幅が ", propValue, " に設定されました。");
    }
    else
    {
        Print("プロパティ値の設定に失敗しました。");
    }
}

使用例2: オブジェクトの特定のレベルの幅を設定（修飾子あり）

“FiboExample”フィボナッチリトレースメントのレベル1の幅を5に設定する例です（レベルは0から始まるため、prop_modifier=1でレベル1を指定）。

void OnStart()
{
    long chartID = ChartID();
    string objectName = "FiboExample";
    int propID = OBJPROP_LEVELWIDTH; // レベルの幅のプロパティ識別子
    int propModifier = 1; // レベル1
    long propValue = 5; // 新しい幅

    if(ObjectSetInteger(chartID, objectName, propID, propModifier, propValue))
    {
        Print("フィボナッチオブジェクト '", objectName, "' のレベル ", propModifier, " の幅が ", propValue, " に設定されました。");
    }
    else
    {
        Print("プロパティ値の設定に失敗しました。");
    }
}

注意点

• プロパティ識別子: prop_idには、設定したいプロパティの種類を指定します。例えば、OBJPROP_WIDTH、OBJPROP_COLOR、OBJPROP_ZORDERなどがあります。

– プロパティ修飾子の使用: 一部のプロパティ（例えばフィボナッチレベルの幅）では、prop_modifierを使用して特定のレベルや条件を指定する必要があります。

関数の戻り値: ObjectSetInteger関数は、操作が成功したかどうかをbool値で返します。プロパティの設定が失敗した場合（例えば、無効なchart_idやobject_nameが指定された場合）、関数はfalseを返します。この場合、GetLastError関数を使用してエラーの原因を特定することができます。

これらの関数を使用することで、プログラム的にチャートオブジェクトのプロパティ値を動的に調整し、分析や取引戦略に応じてチャートの表示をカスタマイズすることが可能になります。