Beschreibung der allgemeinen Optionen

Dieses Modul ist erst in Versionen nach 20260507 verfügbar.

Mehrere ui_element-Schnittstellen akzeptieren eine Optionstabelle, um Ziel-App, Rückgabemenge, Rekursionstiefe, Trefferprüfung und Scrollschritte festzulegen.

Abfrageoptionen

local options = {
    pid = app.front_pid(),
    max_level = 2,
    max_elements = 200,
    include_hit_state = true,
}

• pid Ganzzahl; Prozessbezeichner der Ziel-App. Wenn nicht übergeben, wird normalerweise die App im Vordergrund verwendet.
• max_level Ganzzahl; Rekursionstiefe der untergeordneten Elemente. Häufig steuern 1 oder 2 die Datenmenge.
• max_elements Ganzzahl; maximale Anzahl zurückgegebener Elemente der obersten Ebene.
• fallback_children Boolescher Wert; versucht, untergeordnete Elemente zu lesen, wenn die normale Liste leer ist. Der Standardwert hängt von der Schnittstelle ab.
• include_hit_state Boolescher Wert; gibt an, ob Trefferstatusfelder ergänzt werden.
• hit_test Boolescher Wert; gibt an, ob Treffer durch Bildschirmabtastung aktiviert wird. Für gewöhnliche Skripte normalerweise nicht erforderlich.
• fallback_hit_test Boolescher Wert; gibt an, ob bei einer leeren normalen Liste Treffer durch Bildschirmabtastung versucht werden.
• hit_test_spacing Zahlenwert; Abstand der Bildschirmabtastung in logischen Koordinaten. Standardwert 40.

Aktionsoptionen

• point Tabellenwert; Koordinatenpunkt für Scrollen oder Trefferprüfung, z. B. { x = 200, y = 700 }, in physischen Pixeln.
• x / y Ganzzahl; gleichbedeutend mit point, kann direkt in der Optionstabelle stehen.
• steps Zahlenwert; Schrittparameter für Scroll-, Erhöhungs- oder Verringerungsoperationen. Die konkrete Wirkung hängt vom Zielsteuerelement ab.

Hinweise

list_text_elements() ist zur Kompatibilität mit älteren Skripten standardmäßig vorsichtiger. find(), find_all(), snapshot() und Aktionsschnittstellen eignen sich besser für die direkte Verwendung in neuen Skripten. hit_test kann ein Element liefern, das näher an der aktuellen obersten Oberfläche liegt, verursacht aber höhere Kosten und sollte nur verwendet werden, wenn eine normale Abfrage kein Element findet.