​MQL4（24）：封装市价单/挂单函数

/**
 * @brief 开立一个市价买单 (Buy Market Order), 不包含 SL/TP (用于 ECN 兼容)。
 * @param argSymbol         交易品种名称 (e.g., "EURUSD", 或 Symbol())
 * @param argLotSize        已验证和规范化的交易手数
 * @param argSlippagePoints 已计算好的允许滑点 (单位: points)
 * @param argMagicNumber    订单的魔术数字
 * @param argComment        订单注释 (可选, 默认值为 "Buy Order")
 * @return int              成功则返回订单号 (Ticket), 失败则返回 -1
 */
int OpenBuyOrder(string argSymbol, double argLotSize, int argSlippagePoints,
                 int argMagicNumber, string argComment = "Buy Order") // Comment 参数有默认值
{
    // 1. 等待交易环境空闲 (假设 WaitForTradeContext 是封装好的函数)
    if (!WaitForTradeContext()) return(-1);

    // 2. 获取最新的 Ask 价格 (使用 MarketInfo)
    RefreshRates(); // 确保 MarketInfo 获取的是最新价
    double price = MarketInfo(argSymbol, MODE_ASK);
    if (price <= 0) { // 简单价格验证
        Print("无法获取品种 ", argSymbol, " 的 Ask 价格!");
        return(-1);
    }

    // 3. 发送下单指令 (SL=0, TP=0, Expiration=0)
    int ticket = OrderSend(argSymbol, OP_BUY, argLotSize, price,
                          argSlippagePoints, 0, 0, // 止损和止盈设为 0
                          argComment, argMagicNumber, 0, Green); // 无到期时间, 绿色箭头

    // 4. 内置错误处理
    if (ticket == -1)
    {
        // 调用封装的错误处理函数记录详情
        HandleTradeError(StringFormat("开立市价买单 (%s)", argSymbol), GetLastError());
        /*
        // 或者直接处理:
        int errorCode = GetLastError();
        string errorDesc = ErrorDescription(errorCode); // 需要 #include <stdlib.mqh>
        Alert("开买单失败: Error ", errorCode, ": ", errorDesc);
        Print("OrderSend(Buy) failed: ", errorCode, " ", errorDesc,
              " Symbol=", argSymbol, " Lots=", argLotSize, " Price=", price, " Slippage=", argSlippagePoints);
        */
    }

    // 5. 返回操作结果 (订单号或 -1)
    return(ticket);
}

/**
 * @brief 开立一个买入止损挂单 (Buy Stop Pending Order), 可直接设置 SL/TP 和到期时间。
 * @param argSymbol         交易品种名称
 * @param argLotSize        已验证和规范化的交易手数
 * @param argPendingPrice   已验证的挂单触发价格 (必须 > Ask + StopLevel*Point)
 * @param argStopLoss       已验证的止损价格 (必须 <= argPendingPrice - StopLevel*Point)
 * @param argTakeProfit     已验证的止盈价格 (必须 >= argPendingPrice + StopLevel*Point, 或为 0)
 * @param argSlippagePoints 已计算好的允许滑点 (points) - 对挂单成交时可能有用
 * @param argMagicNumber    订单的魔术数字
 * @param argExpiration     订单到期时间 (可选, datetime 类型, 0 表示永不过期)
 * @param argComment        订单注释 (可选, 默认值为 "Buy Stop Order")
 * @return int              成功则返回订单号 (Ticket), 失败则返回 -1
 */
int OpenBuyStopOrder(string argSymbol, double argLotSize, double argPendingPrice,
                     double argStopLoss, double argTakeProfit, int argSlippagePoints,
                     int argMagicNumber, datetime argExpiration = 0, // Expiration 默认值为 0
                     string argComment = "Buy Stop Order")         // Comment 有默认值
{
    // 1. 等待交易环境空闲
    if (!WaitForTradeContext()) return(-1); // 假设 WaitForTradeContext 是封装好的等待函数

    // 2. 发送挂单指令 (类型 OP_BUYSTOP, 直接包含 SL/TP/Expiration)
    int ticket = OrderSend(argSymbol, OP_BUYSTOP, argLotSize, argPendingPrice,
                          argSlippagePoints, argStopLoss, argTakeProfit, // 直接传入 SL/TP
                          argComment, argMagicNumber, argExpiration, Green); // 传入到期时间

    // 3. 错误处理
    if (ticket == -1)
    {
        // 调用封装的错误处理函数，记录详细信息
        HandleTradeError(StringFormat("设置买入止损挂单 (%s)", argSymbol), GetLastError());
        /*
        // 或者直接处理:
        int errorCode = GetLastError();
        string errorDesc = ErrorDescription(errorCode); // 需要 #include <stdlib.mqh>
        Alert("设置 Buy Stop 失败: Error ", errorCode, ": ", errorDesc);
        // 日志记录更详细参数
        string logMessage = StringFormat(
                            "OrderSend(BuyStop) failed: Error %d: %s. Symbol=%s, Lots=%.2f, Price=%.5f, SL=%.5f, TP=%.5f, Exp=%s",
                            errorCode, errorDesc, argSymbol, argLotSize, argPendingPrice, argStopLoss, argTakeProfit,
                            TimeToStr(argExpiration, TIME_DATE|TIME_MINUTES) // 使用 TimeToStr 格式化时间
                           );
        Print(logMessage);
        */
    }

    // 4. 返回订单号或 -1
    return(ticket);
}