Skip to main content

Files, UI & OCR

Specialized types used for system interaction, screen automation, and text recognition.


📂 Files & Folders (Path)

A path represents a location on your computer's file system.

Properties

PropertyDescription
IsFileReturns true if the path points to an actual file.
IsDirectoryReturns true if the path points to a folder.
GetFileNameReturns the name of the file without its extension (e.g., "status_report").
GetFullFileNameReturns the name of the file with its extension (e.g., "status_report.pdf").
GetFileExtentionReturns just the file extension (e.g., ".pdf").
GetDirectoryReturns the path of the folder that contains this file.
GetTypeReturns "path".

Operators

You can combine paths using the + operator: ${FolderPath} + "filename.txt".


🖱️ Coordinates (Point)

Represents a specific position on the screen using X and Y coordinates.

Properties

PropertyDescription
GetXThe horizontal position (pixels from the left edge).
GetYThe vertical position (pixels from the top edge).
GetTypeReturns "point".

Functions

FunctionDescription
Translate(x, y)Shifts the point by the specified X and Y amounts.
Multiply(x, y)Multiplies the current X and Y values.

🖥️ UI Elements (Element)

Represents an application or web element that Talos has detected.

Properties

PropertyDescription
GetNameThe name or title of the element.
GetIdThe unique internal ID of the element.
GetXPATHThe selector used by Talos to find this element.
GetMethodThe detection technology (e.g., UIA, Web).
GetTypeReturns "element".

Functions

FunctionDescription
WalkXPATH(path)Returns a new XPATH based on walking relative to the current one. To "walk" on an XPath you can use '..' operator to navigate backwards

📝 OCR Results (OCRResult)

Contains the results from a text recognition (OCR) scan on a document or screen.

Properties

PropertyDescription
GetTypeReturns "ocrresult".

Functions

FunctionDescription
Contains(text)Returns true if the scanned text contains the specified word or phrase.
IndexOf(text)Returns the position of the specified text within the scan results.
At(index)Returns the specific text block found at the given position.
GetTextAtPosition(x, y)Returns the text located at specific screen coordinates.