​MQL4（27）：处理停止级别 - 封装验证与调整函数

/**
 * @brief 验证一个价格是否有效地位亍上停止级别边界之上。
 * 适用于需要设置在 Ask 价上方的价格 (买单TP, 卖单SL, BuyStop挂单价, SellLimit挂单价)。
 * @param argSymbol       交易品种。
 * @param argVerifyPrice  需要验证的目标价格。
 * @param argOpenPrice    计算边界的基准价格 (可选)。
 * 如果为 0 (默认), 则基准为当前 Ask 价 (用于验证市价单SL/TP或挂单价本身)。
 * 如果传入挂单价, 则基准为挂单价 (用于验证该挂单的SL/TP是否距挂单价足够远)。
 * @return bool           true: 价格有效 (argVerifyPrice > UpperStopLevel); false: 价格无效。
 */
bool VerifyUpperStopLevel(string argSymbol, double argVerifyPrice,
                          double argOpenPrice = 0)
{
    // 1. 计算停止级别对应的价格距离
    double stopLevelDist = MarketInfo(argSymbol, MODE_STOPLEVEL) * Point;
    if (stopLevelDist < 0) { // 检查 MarketInfo 返回值
        Print("VerifyUpperStopLevel 错误: 无法获取 MODE_STOPLEVEL for ", argSymbol);
        return false;
    }

    // 2. 确定计算边界的基准价格 (basePrice)
    double basePrice;
    if (argOpenPrice == 0) { // 未指定基准价，使用当前 Ask
        RefreshRates(); // 确保 Ask 最新
        basePrice = MarketInfo(argSymbol, MODE_ASK);
        if (basePrice <= 0) {
             Print("VerifyUpperStopLevel 错误: 无法获取 Ask price for ", argSymbol);
             return false; // 获取 Ask 失败
        }
    } else { // 使用传入的基准价 (例如挂单价)
        basePrice = argOpenPrice;
    }

    // 3. 计算上停止级别边界 (基准价 + 停止距离)
    double upperStopLevelBoundary = NormalizeDouble(basePrice + stopLevelDist, Digits);

    // 4. 比较并返回结果 (目标价格必须严格大于上边界才有效)
    return (argVerifyPrice > upperStopLevelBoundary);
}

// 假设 sellStopLossPrice 已计算
if (!VerifyUpperStopLevel(Symbol(), sellStopLossPrice)) // 调用函数验证
{
    Alert("计算出的卖单止损价无效 (距离 Ask 过近)!");
    // ... 后续可能需要停止操作或调整价格 ...
}

/**
 * @brief 验证价格是否在上边界之上，如果无效则自动调整到边界之上(加缓冲)。
 * 适用于需要设置在 Ask 价上方的价格。
 * @param argSymbol       交易品种。
 * @param argAdjustPrice  需要验证和可能调整的价格。
 * @param argAddPips      调整时在边界基础上额外增加的缓冲点数 (pips, 可选, 默认 0)。
 * @param argOpenPrice    计算边界的基准价格 (可选, 默认 0 使用 Ask)。
 * @return double         返回调整后的有效价格；如果原始价格已有效则直接返回。获取基准价失败则返回原始价。
 */
double AdjustAboveStopLevel(string argSymbol, double argAdjustPrice, int argAddPips = 0,
                            double argOpenPrice = 0)
{
    // 1. 计算停止级别价格距离
    double stopLevelDist = MarketInfo(argSymbol, MODE_STOPLEVEL) * Point;
    if (stopLevelDist < 0) {
        Print("AdjustAboveStopLevel 错误: 无法获取 MODE_STOPLEVEL for ", argSymbol);
        return(argAdjustPrice); // 获取失败则不调整，返回原值
    }

    // 2. 确定基准价格
    double basePrice;
    if (argOpenPrice == 0) {
        RefreshRates();
        basePrice = MarketInfo(argSymbol, MODE_ASK);
        if (basePrice <= 0) {
             Print("AdjustAboveStopLevel 错误: 无法获取 Ask price for ", argSymbol);
             return(argAdjustPrice); // 获取失败不调整
        }
    } else {
        basePrice = argOpenPrice;
    }

    // 3. 计算上停止级别边界
    double upperStopLevelBoundary = NormalizeDouble(basePrice + stopLevelDist, Digits);

    // 4. 检查价格是否无效 (小于或等于边界)
    double finalPrice; // (已修正: 在 if 外声明)
    if (argAdjustPrice <= upperStopLevelBoundary)
    {
        // 价格无效，需要调整
        // 计算缓冲距离对应的价格值 (需要 PipPoint 函数，假设已定义)
        double buffer = argAddPips * PipPoint(argSymbol);
        // 调整后的价格 = 上边界 + 缓冲
        finalPrice = upperStopLevelBoundary + buffer;
        // 规范化调整后的价格
        finalPrice = NormalizeDouble(finalPrice, Digits);
        Print("价格 ", argAdjustPrice, " 无效 (未高于上边界 ", upperStopLevelBoundary, "), 自动调整为: ", finalPrice); // 日志记录调整
    }
    else // 价格本身已有效 (严格大于边界)
    {
        finalPrice = argAdjustPrice; // 无需调整，使用原始价格
    }

    // 5. 返回最终有效价格
    return(finalPrice);
}