Cette fonction suspends l'éxecution du programme jusqu'à ce qu'un évènement apparaît dans la file d'attente ou jusqu'à ce qu'un certain nombre de secondes se soient écoulées. Si le temps s'est complètement écoulé, la fonction renvoie MLV_NONE. Si un nouvel évènement apparaît et que les paramètres passés en arguments sont en rapport avec l'évènement récupéré, alors la fonction remplit les paramètres et renvoie un entier codant le type de l'évènement qui a été récupéré. Si un nouvel évènement apparaît et qu'il n'est pas en rapport avec les paramètres de la fonction, alors il se rendort dans l'attente d'un nouvel évènement ou de la fin du temps.
Pour plus d'informations sur les différents types d'évènements et leurs liens avec les paramètres de la fonction, veuillez consulter la documentation de la fonction MLV_get_event().
L'utilisateur n'est pas obligé d'utiliser un champs s'il n'en a pas l'utilité. Dans ce cas, il peut mettre la valeur NULL. Le champs est alors ignoré.
- Bogue:
- Voir les bugs de la fonction MLV_get_event().
- Paramètres
-
| key_sym | Code de la touche qui a été appuyée ou relachée. La valeur de ce champs est définie par l'énumération : MLV_Keyboard_button. |
| key_mod | Mode dans lequel se trouve le clavier lorsqu'une touche est appuyée ou relachée. La valeur de ce champs est définie par l'énumération : MLV_Keyboard_modifier. |
| unicode | Caractère codé en unicode de la lettre obtenue en combinant le code et le mode précédent |
| texte | Texte récupéré par la boîte de saisie. L'allocation est affecté par la la fonction elle même. La désallocation est à la charge de l'utilisateur. |
| input_box | La boîte de saisie qui a récupérée le texte |
| mouse_x | Coordonnée en X de la position de la souris |
| mouse_y | Coordonnée en Y de la position de la souris |
| mouse_button | Bouton de la souris qui a été appuyé ou relaché. Ce champs est défini par l'énumération MLV_Mouse_button. |
| state | Etat de la touche concernée par l'évènement. La valeur de ce champs est défini par l'énumération: MLV_Button_state. |
| seconds | Nombre de secondes à attendre avant de terminer l'execution de la fonction en renvoyant MLV_NONE. |
- Renvoie
- La fonction renvoie un entier codant le type de l'évènement qui a été récupéré ou MLV_NONE si le temps s'est écoulé.
