Documentation de la bibliothèque MLV-2.0.2

MLV_Event MLV_wait_event ( MLV_Keyboard_button key_sym,
MLV_Keyboard_modifier key_mod,
int *  unicode,
char **  texte,
MLV_Input_box **  input_box,
int *  mouse_x,
int *  mouse_y,
MLV_Mouse_button mouse_button,
MLV_Button_state state 
)

Cette fonction suspends l'éxecution du programme jusqu'à ce qu'un évènement apparaît dans la file d'attente. Lorsqu'un nouvel évènement apparaît, la fonction.

  • remplit ses paramètres et renvoie un entier codant le type de l'évènement qui a été récupéré, si les paramètres passés en argument concernent l'évènement récupéré.
  • se rendort en l'attente d'un nouvel évènement, dans le cas contraire.

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 et le paramètre est ignoré.

Bogue:
Voir les bugs de la fonction MLV_get_event().
Paramètres
key_symCode 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_modMode 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.
unicodeCaractère codé en unicode de la lettre obtenue en combinant le code et le mode précédent
texteTexte 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_boxLa boîte de saisie qui a récupérée le texte
mouse_xCoordonnée en X de la position de la souris
mouse_yCoordonnée en Y de la position de la souris
mouse_buttonBouton de la souris qui a été appuyé ou relaché. Ce champs est défini par l'énumération MLV_Mouse_button.
stateEtat de la touche concernée par l'évènement. La valeur de ce champs est défini par l'énumération: MLV_Button_state.
Renvoie
La fonction renvoie un entier codant le type de l'évènement qui a été récupéré.