Zum Hauptinhalt springen

Beschreibung der Elementfelder

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

Das von einer Abfrageschnittstelle zurückgegebene Element ist eine gewöhnliche Lua-Tabelle. Die Felder stammen aus den Informationen, die die aktuelle Oberfläche offenlegt; je nach App und Steuerelementtyp können unterschiedliche Felder zurückgegeben werden.

Häufige Felder​

  • text
    Textwert; lesbarer Titel des Elements.
  • value
    Beliebiger Typ; aktueller Wert des Elements. Bei Textfeldern ist dies normalerweise der aktuelle Text, bei Schaltern kann es 0 oder 1 sein und bei Schiebereglern ein Prozenttext.
  • identifier
    Textwert; Elementbezeichner.
  • hint
    Textwert; vom System bereitgestellter Hilfetext.
  • bundleId
    Textwert; bundle identifier der App, zu der das Element gehört.
  • x / y / width / height
    Ganzzahl; Elementbereich in physischen Pixeln.
  • centerPoint
    Tabellenwert; Mittelpunkt des Elements in physischen Pixeln, z. B. { x = 100, y = 200 }.
  • children
    Tabellenwert; Array der untergeordneten Elemente. Die Aufklapptiefe wird durch max_level gesteuert.
  • traits
    Ganzzahl; Merkmalswert des Elements.
  • traitsDescription
    Tabellenwert; Array der Merkmalsnamen des Elements, z. B. Button, StaticText, Toggle, Adjustable.
  • isVisible
    Boolescher Wert; gibt an, ob das Element sichtbar ist.
  • isSelected
    Boolescher Wert; gibt an, ob das Element ausgewählt ist.
  • isToggle
    Boolescher Wert; gibt an, ob das Element einem Schalter ähnelt.
  • isAdjustable
    Boolescher Wert; gibt an, ob das Element eine Erhöhung oder Verringerung unterstützt.
  • checked
    Boolescher Wert; Bestätigungsstatus von Schaltern, Kontrollkästchen, Optionsfeldern und ähnlichen Steuerelementen. Bei einem nicht zuverlässig lesbaren Status kann das Feld fehlen.
  • hasTextEntry
    Boolescher Wert; gibt an, ob das Element einem Texteingabeziel ähnelt.
  • isKeyboardKey
    Boolescher Wert; gibt an, ob das Element einer Tastaturtaste ähnelt.
  • absoluteValue
    Reelle Zahl; von Schiebereglern und ähnlichen anpassbaren Steuerelementen möglicherweise zurückgegebener normalisierter Wert.

Felder zum Trefferstatus​

Diese Felder können nur erscheinen, wenn include_hit_state, hit_test oder fallback_hit_test aktiviert ist oder eine Aktion überprüft wird:

  • canHit
    Boolescher Wert; gibt an, ob das Element derzeit von oben getroffen werden kann.
  • hitVerified
    Boolescher Wert; gibt an, ob der Trefferstatus bereits überprüft wurde.
  • hitTestPoint
    Tabellenwert; Trefferpunkt in physischen Pixeln.

Hinweise​

Elementfelder eignen sich zum Lesen und Bewerten des aktuellen Oberflächenstatus. Für eine stabile Positionierung sollten vorzugsweise semantische Felder wie text, role, checked und selected zu einem Selektor kombiniert werden. Nach einer Änderung der Oberfläche sollten Elemente erneut abgefragt oder ein neuer Snapshot abgerufen werden.