​MQL4（25）：封装平仓/删除挂单函数

/**
 * @brief 关闭一个指定的市价买单 (Buy Market Order)。
 * @param argSymbol         订单的交易品种名称 (用于获取当前价格)
 * @param argCloseTicket    要关闭的买单的订单号 (Ticket)
 * @param argSlippagePoints 允许的滑点 (单位: points)
 * @return bool             true: 平仓指令成功发送; false: 操作失败或订单无需/无法关闭
 */
bool CloseBuyOrder(string argSymbol, int argCloseTicket, int argSlippagePoints)
{
    bool closedSuccess = false; // 初始化函数返回值，默认为失败

    // 1. 尝试选中指定的订单
    if (OrderSelect(argCloseTicket, SELECT_BY_TICKET))
    {
        // 2. 确认订单是【未平仓】的【市价买单】
        if (OrderCloseTime() == 0 && OrderType() == OP_BUY)
        {
            // 3. 等待交易环境空闲 (假设 WaitForTradeContext 是封装好的函数)
            if (!WaitForTradeContext()) {
                Print("等待交易环境超时，无法关闭订单 #", argCloseTicket);
                return(false); // 等待失败，直接返回 false
            }

            // 4. 准备平仓所需参数
            double lotsToClose = OrderLots(); // 获取订单的全部手数进行平仓
            RefreshRates(); // 获取最新的市场报价
            // !!! 关键修正：平掉买单必须使用当前的【买价 Bid】 !!!
            double closePrice = MarketInfo(argSymbol, MODE_BID); // 使用 MarketInfo 获取指定品种的 Bid 价

            // 5. 发送平仓指令
            closedSuccess = OrderClose(argCloseTicket, lotsToClose, closePrice, argSlippagePoints, Red); // 使用红色箭头标记

            // 6. 处理平仓指令的发送结果
            if (!closedSuccess)
            {
                // 调用统一的错误处理函数记录错误详情
                HandleTradeError(StringFormat("关闭买单 #%d", argCloseTicket), GetLastError());
                /*
                // 或者直接在此处理:
                int errorCode = GetLastError();
                string errorDesc = ErrorDescription(errorCode); // 需要 #include <stdlib.mqh>
                Alert("关闭买单失败: Error ", errorCode, ": ", errorDesc);
                Print("OrderClose(Buy) failed for #", argCloseTicket, ". Error: ", errorCode, " ", errorDesc,
                      ". Bid=", closePrice); // 记录使用的 Bid 价
                */
            }
            else
            {
                Print("成功发送平仓指令 for 买单 #", argCloseTicket);
                // 注意：这里仅表示指令发送成功，不代表已最终成交。
            }
        }
        // else Print("订单 #", argCloseTicket, " 不是一个未平仓的买单."); // 可选的调试信息
    }
    // else Print("无法选中订单 #", argCloseTicket, ", Error: ", GetLastError()); // 可选的调试信息

    // 返回平仓指令是否成功发送
    return(closedSuccess);
}

/**
 * @brief 关闭 (删除) 一个指定的、尚未成交的挂单。
 * @param argSymbol         订单的交易品种名称 (主要用于错误日志记录当前价格)
 * @param argCloseTicket    要删除的挂单的订单号 (Ticket)
 * @return bool             true: 删除指令成功发送; false: 操作失败或订单无需/无法删除
 */
bool ClosePendingOrder(string argSymbol, int argCloseTicket)
{
    bool deletedSuccess = false; // 初始化返回值

    // 1. 尝试选中指定的订单
    if (OrderSelect(argCloseTicket, SELECT_BY_TICKET))
    {
        // 2. 确认订单是【未成交】的【挂单】
        int orderType = OrderType();
        if (OrderCloseTime() == 0 && (orderType >= OP_BUYSTOP && orderType <= OP_SELLLIMIT))
        {
            // 3. 等待交易环境 (假设 WaitForTradeContext 是封装好的函数) if (!WaitForTradeContext()) return(false); // 4. 发送删除指令 deletedSuccess = OrderDelete(argCloseTicket, Red); // 红色箭头标记 // 5. 处理删除指令的发送结果 if (!deletedSuccess) { // 调用统一的错误处理函数 (假设 HandleTradeError 已定义) HandleTradeError(StringFormat("删除挂单 #%d", argCloseTicket), GetLastError()); /* // 或者直接处理: int errorCode = GetLastError(); string errorDesc = ErrorDescription(errorCode); // 需要 #include <stdlib.mqh> Alert("删除挂单失败: Error ", errorCode, ": ", errorDesc); RefreshRates(); Print("OrderDelete failed for #", argCloseTicket, ". Error: ", errorCode, " ", errorDesc, ". Bid=", MarketInfo(argSymbol, MODE_BID), " Ask=", MarketInfo(argSymbol, MODE_ASK)); */ } else { Print("成功发送删除指令 for 挂单 #", argCloseTicket); } } // else { Print("订单 #", argCloseTicket, " 不是未成交挂单."); } // 可选调试 } // else { Print("无法选中订单 #", argCloseTicket, ", Error: ", GetLastError()); } // 可选调试 // 返回删除指令是否成功发送 return(deletedSuccess); }