Function TriClickText

engine/Poseidon/Game/Commands/GameStateExtTest.cpp:679–714

triClickText "text" — find control by text content and click it. Returns true on success. triClickText "needle" -> "OK" or "FAIL:not_found" / "FAIL:no_display". Returns a string (rather than a bool) so the tri runner can apply Capybara-style automatic synchronisation: if the text isn't on screen yet, the runner re-tries every poll_interval until the assertion timeout. Tests that previously had t

    C3DStatic* s = dynamic_cast<C3DStatic*>(display->GetCtrl(idc));
    if (s == nullptr)
        return GameValue(Format("FAIL:no C3DStatic with idc %d", idc));
    for (int i = 0; i < s->GetLineCount(); i++)
    {
        std::string line = (const char*)s->GetLine(i);
        std::size_t start = line.find_first_not_of(" \t\r\n");
        if (start != std::string::npos && line.compare(start, prefix.size(), prefix) == 0)
            return GameValue(RString("OK"));
    }
    return GameValue(Format("FAIL:no line starts with '%s' (%d lines)", prefix.c_str(), s->GetLineCount()));
}

/// triAssertControlLinesExclude [idc, "needle"] - assert no rendered line of the
/// active display's C3DStatic (idc) contains needle. Useful for catching explicit
/// line-break delimiters that split lines but still leak into the drawn substring.
GameValue TriAssertControlLinesExclude(const GameState* /*state*/, GameValuePar arg)
{
    const GameArrayType& a = arg;
    if (a.Size() < 2)
        return GameValue(RString("FAIL:triAssertControlLinesExclude needs [idc, needle]"));
    const int idc = static_cast<int>(static_cast<GameScalarType>(a[0]));
    std::string needle = (const char*)static_cast<RString>(a[1]);
    if (needle == "\\n")
        needle = "\n";
    else if (needle == "\\r")
        needle = "\r";
    ControlsContainer* display = GetActiveDisplayForSQF();
    if (display == nullptr)
        return GameValue(RString("FAIL:no active display"));
    C3DStatic* s = dynamic_cast<C3DStatic*>(display->GetCtrl(idc));
    if (s == nullptr)
        return GameValue(Format("FAIL:no C3DStatic with idc %d", idc));
    for (int i = 0; i < s->GetLineCount(); i++)
    {
        std::string line = (const char*)s->GetLine(i);
        if (line.find(needle) != std::string::npos)
            return GameValue(Format("FAIL:line %d contains excluded text", i));
    }
    return GameValue(RString("OK"));
}