Fin de documentation de MMover

1 files changed, 28 insertions, 4 deletions

diff --git a/doc/manuel_utilisateur.txt b/doc/manuel_utilisateur.txt
index b72365d..47cee2f 100644
--- a/doc/manuel_utilisateur.txt
+++ b/doc/manuel_utilisateur.txt
@@ -725,14 +725,38 @@ Les valeurs modifiables par mconfigure sont :
 	  déplacement souhaité. Elle doit retourner un vecteur correspondant à
 	  la correction à effectuer sur le deplacement.
 	- x, y : translation de l'objet effectuée par le MMover (la position
-	initiale correspond à (0,0))
+	  initiale correspond à (0,0))
 	- targets : objet ou tableau d'objets à déplacer
 	- visible : active ou désactive le comportement préhensible
 
+Note : pour la gestion des limites de déplacement (par x/y_min/max ou par
+allower, il ne faut pas oublier que ces limites portent sur le déplacement
+réalisé par le mover, c'est à dire les valeurs de x et y. Les contraintes ne
+portent pas sur la position à l'écran du ou des objets déplacés. Néanmoins, il
+est possible de faire coïncider (x,y) avec un point particulier d'un objet si
+cela peut rendre les traitements plus faciles.
+
 Les évènements émis sont :
-'PRESSED'
-'MOVED'
-'RELEASED'
+	- PRESSED : Notifie un début (initialisation) d'action de
+	  déplacement. Les valeurs fournies sont la position du curseur et la
+	  datation de l'évènement.
+	- MOVED : Notifie un déplacement. Les valeurs fournies sont la nouvelle
+	  position de ou des objets et la date de l'évènement. Attention, les
+	  valeurs sont les nouvelles valeurs pour x et y, donc relatives à la
+	  position initiale. On peut toujours accéder aux anciennes valeurs au
+	  travers des attributs x et y qui n'ont toujours pas été modifiés.
+	- RELEASED : Notifie une fin d'action de déplacement. Les valeurs
+	  fournies sont la position de la souris compensée des non-déplacements
+	  des objets en buttée et la date de l'évènement.
+
+Les fonctions applicables à un objet MMover sont :
+	- setPos(x, y) : permet de positionner le ou les objets à la position
+	  (x, y). Cette position est relative à la valeur courante de (x, y).
+	  Les contraintes sur les déplacements ne sont pas prise en compte,
+	  aucun évènement n'est émis.
+	- translate(dx, dy, t) : cette fontion permet de demander une
+	  translation de (dx, dy). Les contraintes de déplacement sont
+	  respectées et l'évènement MOVED est émis.
 
 __________________
 MMultiSelection.pm :