Zum Hauptinhalt springen

MatchResult:getText()

Gibt die Bezeichnung oder den Text zurück, der mit dem Treffer verknüpft ist.

Beschreibung​

Die Methode getText() gibt eine Zeichenfolgenbezeichnung zurück, die mit dem Trefferergebnis verknüpft ist. Dies ist besonders nützlich, wenn:

  • Textbasierte Suchen (OCR) durchgeführt werden, bei denen der erkannte Text zurückgegeben wird
  • Mit beschrifteten Vorlagen gearbeitet wird, bei denen Sie feststellen möchten, welche Vorlage gefunden wurde

Wenn mit dem Treffer keine Bezeichnung verknüpft ist, gibt diese Methode eine leere Zeichenkette zurück.

Signatur​

getText(): string

Rückgabe

string - Die mit dem Treffer verknüpfte Bezeichnung oder der Text, oder eine leere Zeichenkette, falls keine vorhanden ist.

Beispiel​

-- Beispiel mit OCR-Textsuche
local result = Screen:find("hello World", FinderParams():setDetectionType("TEXT"))
if result then
local text = result:getText()
toast("Gefundener Text: " .. text)
end

-- Beispiel für die Prüfung auf bestimmten Text
local result = Screen:find("submit", FinderParams():setDetectionType("TEXT"))
if result then
local label = result:getText()
if label == "submit" then
toast("Submit-Button gefunden!")
end
end