إنتقل إلى المحتوى الرئيسي

MatchResult:getText()

تُعيد التسمية أو النص المرتبط بالمطابقة.

الوصف

تُعيد الدالة getText() سلسلة نصية (تسمية) مرتبطة بالنتيجة المطابقة. يكون هذا مفيدًا بشكل خاص عند:

  • إجراء عمليات بحث نصية (OCR) حيث يتم إرجاع النص المُتعرَّف عليه
  • العمل مع قوالب مُسمّاة عندما ترغب في تحديد القالب الذي تمت مطابقته

إذا لم تكن هناك تسمية مرتبطة بالمطابقة، تُعيد هذه الدالة سلسلة فارغة.

التوقيع

getText(): string

القيمة المعادة

string - التسمية أو النص المرتبط بالمطابقة، أو سلسلة فارغة إن لم يوجد.

مثال

-- Example with OCR text search
local result = Screen:find("hello World", FinderParams():setDetectionType("TEXT"))
if result then
local text = result:getText()
toast("Found text: " .. text)
end

-- Example checking for specific text
local result = Screen:find("submit", FinderParams():setDetectionType("TEXT"))
if result then
local label = result:getText()
if label == "submit" then
toast("Found submit button!")
end
end