Retirer un doigt de l’écran (:off)
Déclaration
evenement_tactile:off([ coord_x, coord_y ])
Paramètres
- coord_x, coord_y
type entier, paramètre facultatif, coordonnées du point où le doigt quitte l’écran dans le système de coordonnées actuellement orienté ; par défaut, les coordonnées enregistrées par l’événement te actuel
Valeur renvoyée
- evenement_tactile
objet d’événement tactile lui-même ; la fonction touch.on permet d’obtenir un objet contrôlant le contact actuel
Description
Simule le retrait du doigt de l’écran depuis la position actuelle ou une position indiquée. L’appel libère l’objet d’événement tactile actuel et l’identifiant de doigt qu’il occupait.
Les coordonnées de cette méthode dépendent du système de coordonnées initialisé par la fonctionscreen.init.
Cette fonction peut également être appelée de la manière suivante (l’ID du doigt doit être un nombre compris entre 1 et 29) :
touch.off(id_doigt)
touch.off(id_doigt, coord_x, coord_y)
Exemple
touch.on(100, 100):off() -- Mettre un doigt en contact avec le point 100, 100, puis le retirer à la position actuelle
touch.on(100, 100):off(105, 95) -- Mettre un doigt en contact avec le point 100, 100, puis le retirer au point 105, 95
-- Autre utilisation
touch.on(1, 100, 100) -- Mettre en contact le doigt numéro 1 avec le point 100, 100
for i=1, 100 do -- Déplacer progressivement le doigt numéro 1 jusqu’au point 100, 200
touch.move(1, 100, 100 + i)
end
touch.off(1) -- Relever le doigt numéro 1