! Hardware-Maustaste betätigen (:click)

Diese Methode ist erst in Versionen nach 20260805 verfügbar.

Deklaration

Status, Fehlermeldung = Mausobjekt:click(Taste[, Drückdauer_in_Millisekunden])

Parameter

• Taste
  Ganzzahl oder Textwert; es können 1 ~ 32 oder vordefinierte Tastenbezeichnungen übergeben werden. Einzelheiten siehe Tastenbeschreibung von :down.
• Drückdauer_in_Millisekunden
  Nichtnegative endliche reelle Zahl, optional; Zeit, während der die Taste gedrückt bleibt, in Millisekunden, Standardwert 60

Rückgabewert

• Status
  Boolescher Wert; bei erfolgreichem Klick true, bei einem Fehler false
• Fehlermeldung
  Textwert; Grund für den fehlgeschlagenen Klick

Beschreibung

Drückt und löst die angegebene Taste. Nur die Zieltaste wird verändert; andere bereits gedrückte Tasten werden nicht losgelassen. Wenn die Zieltaste bereits gedrückt ist, gibt der Aufruf einen Fehler zurück, um den Ziehstatus nicht zu beschädigen. Während der Drückdauer gibt diese Methode den aktuellen Lua-Ausführungsthread frei. Während dieser Freigabe geben andere Operationen desselben Mausobjekts false, "hardware mouse is busy" zurück; verschiedene Mausobjekte können weiterhin unabhängig bedient werden.

Beispiel

local m = assert(mouse.connect())
assert(m:click("right"))
assert(m:click(13, 100))
assert(m:click(32))
assert(m:disconnect())