Zum Hauptinhalt springen

Textinhalt leeren (ui_element.clear_text)

Diese Funktion ist erst in Versionen nach 20260507 verfügbar.

Deklaration​

Status, Information_oder_Fehlermeldung = ui_element.clear_text(Selektor_oder_Element [, Optionen ])

Parameter​

  • Selektor_oder_Element Tabellenwert; kann ein Selektor, ein von einer Abfrage zurückgegebenes Element oder eine Koordinatentabelle { x = X-Koordinate, y = Y-Koordinate } sein.
  • Optionen Optionaler Parameter, Tabellenwert; siehe Beschreibung der allgemeinen Optionen.

Rückgabewert​

  • Status Boolescher Wert; bei Erfolg true, bei einem Fehler nil.
  • Information_oder_Fehlermeldung Bei Erfolg Aktionsinformationen als Tabellenwert, bei einem Fehler die Fehlerursache als Textwert.

Beschreibung​

Diese Schnittstelle leert ein Texteingabeziel. Ob ein bestimmtes Steuerelement das Leeren akzeptiert, hängt von der aktuellen Oberfläche der Ziel-App ab.

Beispiel​

local ui_element = require("ui_element")

ui_element.clear_text({
    title = "搜索",
    role = "text_field",
})