Finger vom Bildschirm nehmen (:off)

Deklaration

Touch-Ereignis:off([ X-Koordinate, Y-Koordinate ])

Parameter

• X-Koordinate, Y-Koordinate
  Ganzzahl, optional; Koordinaten des Punkts, an dem der Finger den Bildschirm verlässt, im aktuellen gedrehten Koordinatensystem; Standardwert sind die vom aktuellen te-Ereignis aufgezeichneten Koordinaten

Rückgabewert

• Touch-Ereignis
  Das Touch-Ereignisobjekt selbst. Durch den Aufruf der Funktion touch.on kann ein Ereignisobjekt zur Steuerung des aktuellen Touch-Vorgangs erhalten werden.

Beschreibung

Simuliert, dass der Finger die aktuelle oder eine angegebene Position auf dem Bildschirm verlässt. Nach dem Aufruf werden das aktuelle Touch-Ereignisobjekt und die von ihm belegte Finger-ID freigegeben.
Die Koordinatenparameter dieser Methode werden durch das von screen.init initialisierte Koordinatensystem beeinflusst.
Diese Funktion kann auch in der folgenden Form aufgerufen werden (die Finger-ID muss eine beliebige Zahl im Bereich 1 ~ 29 sein):

touch.off(Finger_ID)
touch.off(Finger_ID, X-Koordinate, Y-Koordinate)

Beispiel

touch.on(100, 100):off() -- Einen Finger am Punkt 100, 100 auf den Bildschirm setzen und ihn an der aktuellen Position wieder vom Bildschirm nehmen

touch.on(100, 100):off(105, 95) -- Einen Finger am Punkt 100, 100 auf den Bildschirm setzen und ihn an der Position 105, 95 vom Bildschirm nehmen

-- Eine weitere Verwendung
touch.on(1, 100, 100) -- Finger mit der Nummer 1 am Punkt 100, 100 auf den Bildschirm setzen
for i=1, 100 do       -- Finger mit der Nummer 1 schrittweise zum Punkt 100, 200 bewegen
    touch.move(1, 100, 100 + i)
end
touch.off(1)          -- Finger mit der Nummer 1 loslassen