MLV_event.h(3)
Ce fichier définit les prototypes des fonctions permettant d'utiliser les évènements dans la bibliothèque MLV.
Description
MLV_event.h
NAME
MLV_event.h - Ce fichier définit les prototypes des fonctions permettant d’utiliser les évènements dans la bibliothèque MLV.
SYNOPSIS
Ãnumérations
enum
MLV_Event { MLV_NONE = 0, MLV_KEY = 1,
MLV_INPUT_BOX = 2, MLV_MOUSE_BUTTON = 3,
MLV_MOUSE_MOTION = 4 }
Ãnumère les différents types
d’évènement de la
bibliothèque MLV.
Fonctions
MLV_Event
MLV_get_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 récupère un
évènement dans la file
d’attente, remplit en fonction de
l’évènement
récupéré une partie
des paramètres de la fonction et renvoie un
entier codant le type de
l’évènement qui a
été
récupéré.
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.
MLV_Event MLV_wait_event_or_seconds
(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, int seconds)
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.
MLV_Event MLV_wait_event_or_milliseconds
(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, int milliseconds)
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 millisecondes 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.
void MLV_flush_event_queue ()
Cette fonction vide la file
d’évènements.
MLV_Event MLV_wait_keyboard_or_mouse
(MLV_Keyboard_button *sym,
MLV_Keyboard_modifier *mod, int *unicode, int
*mouse_x, int *mouse_y)
Suspend l’exécution
jusqu’Ã ce que l’utilisateur appuie
sur une touche du clavier ou sur le bouton gauche de la
souris.
MLV_Event MLV_wait_keyboard_or_mouse_or_seconds
(MLV_Keyboard_button *sym,
MLV_Keyboard_modifier *mod, int *unicode, int
*mouse_x, int *mouse_y, int seconds)
Suspend l’exécution
jusqu’Ã ce que l’utilisateur appuie
sur une touche du clavier, sur le bouton gauche de la souris
ou qu’un certain nombre de secondes
passées en paramètres se soient
écoulées.
MLV_Event MLV_wait_mouse_or_milliseconds (int *x, int
*y, int milliseconds)
Suspend l’exécution
jusqu’Ã ce que l’utilisateur clique
sur le bouton gauche de la souris.
MLV_Event MLV_wait_mouse_or_seconds (int *x, int *y, int
seconds)
Suspend l’exécution
jusqu’Ã ce que l’utilisateur clique
sur le bouton gauche de la souris où
jusqu’Ã ce qu’un nombre de
secondes, passé en paramètres, se
soient écoulées.
MLV_Event MLV_wait_keyboard_or_seconds
(MLV_Keyboard_button *sym,
MLV_Keyboard_modifier *mod, int *unicode, int
seconds)
Suspend l’exécution
jusqu’Ã ce que l’utilisateur appuie
sur une touche du clavier ou jusq’Ã ce
q’un nombre de secondes passées en
paramètres soient
écoulées.
MLV_Event MLV_wait_keyboard_or_milliseconds
(MLV_Keyboard_button *sym,
MLV_Keyboard_modifier *mod, int *unicode, int
milliseconds)
Suspend l’exécution
jusqu’Ã ce que l’utilisateur appuie
sur une touche du clavier ou jusq’Ã ce
q’un nombre de millisecondes passées en
paramètres soient
écoulées.
MLV_Event MLV_wait_keyboard_or_mouse_or_milliseconds
(MLV_Keyboard_button *sym,
MLV_Keyboard_modifier *mod, int *unicode, int
*mouse_x, int *mouse_y, int milliseconds)
Suspend l’exécution
jusqu’Ã ce que l’utilisateur appuie
sur une touche du clavier, sur le bouton gauche de la souris
ou qu’un certain nombre de millisecondes
passées en paramètres se soient
écoulées.
const char * MLV_convert_event_to_string
(MLV_Event event_code)
Convertit le code d’un
évènement en une chaîne
de caractères.
MLV_Event MLV_convert_string_to_event (const char
*event_string)
Convertit le nom d’un
évènement en son code
associé.
const char * MLV_convert_button_state_to_string
(MLV_Button_state state_code)
Convertit le code d’un état en une
chaîne de caractères.
MLV_Button_state MLV_convert_string_to_button_state
(const char *state_string)
Convertit le nom d’un état en son code
associé.
MLV_Event MLV_wait_input_box_or_milliseconds (int
milliseconds, int top_left_corner_X, int top_left_corner_Y,
int width, int height, MLV_Color borderColor,
MLV_Color textColor, MLV_Color
backgroundColor, const char *informativeMessage, char
**text,...)
Cette fonction suspend l’exécution du
programme, affiche une boîte de saisie et
attends que l’utilisateur rentre une phrase dans le
champs de la boîte ou qu’une temps (en
millisecondes) donné en paramètre
s’écoule.
MLV_Event MLV_wait_input_box_with_font_or_milliseconds
(int milliseconds, int top_left_corner_X, int
top_left_corner_Y, int width, int height, MLV_Color
borderColor, MLV_Color textColor, MLV_Color
backgroundColor, const char *informativeMessage, char
**text, const MLV_Font *font,...)
Même chose que
MLV_wait_input_box_or_milliseconds(), mais il est
possible de changer la fonte du du texte.
MLV_Event MLV_wait_particular_input_box_or_milliseconds
(int milliseconds, MLV_Input_box *input_box, char
**text)
Cette fonction suspend l’exécution du
programme jusqu’Ã ce que
l’utilisateur écrive une phrase dans le
champs de la boîte de saisie passée
en paramètre de la fonction ou qu’un
nombre de millisecondes fixées soient
écoulée.
MLV_Event MLV_wait_particular_input_box_or_seconds
(MLV_Input_box *input_box, char **text, int seconds)
Cette fonction suspend l’exécution du
programme jusqu’Ã ce que
l’utilisateur écrive une phrase dans le
champs de la boîte de saisie passée
en paramètre de la fonction ou qu’un
nombre de secondes fixées soient
écoulée.
Description détaillée
Ce fichier définit les prototypes des fonctions permettant d’utiliser les évènements dans la bibliothèque MLV.
Auteur
Adrien Boussicault
Marc Zipstein
Documentation du type de l’énumération
enum MLV_Event
Ãnumère les différents types d’évènement de la bibliothèque MLV.
Valeurs
énumérées
MLV_NONE
Aucun évènement
MLV_KEY
Evnènement provenant du clavierÂ
MLV_INPUT_BOX
Ãvènement provenant de la validation d’un texte dans une boîte de saisie.
MLV_MOUSE_BUTTON
Ãvènement provenant d’un clique de souris.
MLV_MOUSE_MOTION
Ãvènement provenant du déplacement de la souris.
Documentation des fonctions
const char * MLV_convert_button_state_to_string (MLV_Button_state state_code)
Convertit le code d’un état en une chaîne de caractères.
Paramètres
state_code le code de l’état
Renvoie
La chaîne de caractères associée au code de l’état.
const char * MLV_convert_event_to_string (MLV_Event event_code)
Convertit le code d’un évènement en une chaîne de caractères.
Paramètres
event_code le code de l’évènement
Renvoie
La chaîne de caractères associée au code de l’évènement.
MLV_Button_state MLV_convert_string_to_button_state (const char *state_string)
Convertit le nom d’un état en son code associé.
Paramètres
state_string le nom de l’état.
Renvoie
Le code de l’état associé à la chaîne de caractères.
MLV_Event MLV_convert_string_to_event (const char * event_string)
Convertit le nom d’un évènement en son code associé.
Paramètres
event_string le nom de l’évènement.
Renvoie
Le code de l’évènement associé à la chaîne de caractères.
MLV_Event MLV_get_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 récupère un évènement dans la file d’attente, remplit en fonction de l’évènement récupéré une partie des paramètres de la fonction et renvoie un entier codant le type de l’évènement qui a été récupéré. Le type des évènements est défini par :
MLV_Event
et peut valoir les valeurs suivantes:
Valeur ........... Signification
----------------------------------
MLV_NONE .......... Aucun évènement récupéré
MLV_KEY
........... Une touche du clavier a
été appuyée ou
relachée.
MLV_INPUT_BOX
..... L’utilisateur a écrit une
chaîne de
caractères et validé cette
chaîne par
la touche entrée.
MLV_MOUSE_BUTTON
.. Un des boutons de la souris a
été
appuyé.
MLV_MOUS_MOTION ... La souris a été déplacée.
Voici un tableau qui donne les champs modifiés en fonction de l’évènement qui a été récupéré.
Type Ãvènement .... Paramètres modifiés
MLV_NONE .......... AUCUN
MLV_KEY ........... key_sym, key_mod, state
MLV_INPUT_BOX ..... texte, input_box
MLV_MOUSE_BUTTON .. mouse_x, mouse_y, mouse_button, state
MLV_MOUSE_MOTION .. mouse_x, mouse_y
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
Il est possible que la récuperation du caractère unicode sous Windows ne fonctionne pas bien. En effet, aucun code de portage spécifique n’a été fait à ce sujet.
Bogue
Sous WINDOWS, le clavier est configuré en ’qwerty’.
Renvoie
La fonction renvoie un entier codant le type de l’évènement qui a été récupéré.
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ée par 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.
Exemples
advanced/09_animation.c, advanced/11_animation_book.c, medium/01_keyboard_events.c, medium/02_mouse_events.c, medium/03_input_box_events.c, medium/04_events.c, et medium/06_colors.c.
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_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.
Renvoie
La fonction renvoie un entier codant le type de l’évènement qui a été récupéré.
MLV_Event MLV_wait_event_or_milliseconds (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, int milliseconds)
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 millisecondes 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.
milliseconds Nombre de millisecondes Ã
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é.
MLV_Event MLV_wait_event_or_seconds (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, int seconds)
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é.
MLV_Event MLV_wait_input_box_or_milliseconds (int milliseconds, inttop_left_corner_X, int top_left_corner_Y, int width, int height, MLV_ColorborderColor, MLV_Color textColor, MLV_Color backgroundColor, const char *informativeMessage, char ** text, ...)
Cette fonction suspend l’exécution du programme, affiche une boîte de saisie et attends que l’utilisateur rentre une phrase dans le champs de la boîte ou qu’une temps (en millisecondes) donné en paramètre s’écoule. La boîte de saisie contient deux zones de textes. La première zone ne peut pas être éditée par l’utilisateur et sert à afficher un message d’information. La deuxième est vide et peut être éditée par l’utilisateur. Lorsque l’utilisateur appuie sur la touche entrée, le texte qui se trouve dans la zone de texte est renvoyé par la fonction grâce au paramètre text. Le texte, la taille et les couleurs de la boîte de saisie sont paramétrables. Si le temps sécoule complètement, alors text est mis à NULL.
MLV_wait_input_box() alloue lui même la mémoire associée au paramètre ’text’. Par contre, après utilisation, vous devez libérer l’espace mémoire qui a été alloué.
Paramètres
milliseconds Le temps
à attendre en millisecondes.
top_left_corner_X La coordonnée en X du
coin Nord-Ouest de la boîte de saisie.
top_left_corner_Y La coordonnée en Y du
coin Nord-Ouest de la boîte de saisie.
width La largeur de la boîte de saisie.
height La hauteur de la boîte de saisie.
borderColor La couleur de la bordure de la
boîte de saisie.
textColor La couleur du texte de la boîte de
saisie.
backgroundColor La couleur de fond de la
boîte de saisie.
informativeMessage Le message à afficher
devant la boîte de saisie.
text L’addresse où sera
placé la réponse
donnée par
Renvoie
un entier codant le type de l’évènement qui a été récupéré ( MLV_INPUT_BOX ) ou MLV_NONE si le temps s’est écoulé.
Exemples
beginner/08_mouse_keyboard_input_box_timer.c.
MLV_Event MLV_wait_input_box_with_font_or_milliseconds (int milliseconds, inttop_left_corner_X, int top_left_corner_Y, int width, int height, MLV_ColorborderColor, MLV_Color textColor, MLV_Color backgroundColor, const char *informativeMessage, char ** text, const MLV_Font * font, ...)
Même chose que MLV_wait_input_box_or_milliseconds(), mais il est possible de changer la fonte du du texte. MLV_wait_input_box_with_font_or_milliseconds() alloue lui même la mémoire associée au paramètre ’text’. Par contre, après utilisation, vous devez libérer l’espace mémoire qui a été alloué. Si le temps est écoulé, alot text est mis à NULL.
Paramètres
top_left_corner_X La
coordonnée en X du coin Nord-Ouest de la
boîte de saisie.
top_left_corner_Y La coordonnée en Y du
coin Nord-Ouest de la boîte de saisie.
width La largeur de la boîte de saisie.
height La hauteur de la boîte de saisie.
borderColor La couleur de la bordure de la
boîte de saisie.
textColor La couleur du texte de la boîte de
saisie.
backgroundColor La couleur de fond de la
boîte de saisie.
informativeMessage Le message à afficher
devant la boîte de saisie.
text L’addresse où sera
placé la réponse
donnée par l’utilisateur.
font La font du texte à utiliser.
milliseconds Le temps à attendre en
millisecondes.
Renvoie
un entier codant le type de l’évènement qui a été récupéré ( MLV_INPUT_BOX ) ou MLV_NONE si le temps s’est écoulé.
MLV_Event MLV_wait_keyboard_or_milliseconds (MLV_Keyboard_button * sym,MLV_Keyboard_modifier * mod, int * unicode, int milliseconds)
Suspend l’exécution jusqu’à ce que l’utilisateur appuie sur une touche du clavier ou jusq’à ce q’un nombre de millisecondes passées en paramètres soient écoulées. Pour plus d’informations sur le fonctionnement de cette fonction, veuillez vous reporter à la documentation de MLV_wait_keyboard().
La fonction accepte des valeurs nulles pour les pointeurs sym, mod et unicode. Dans ce cas la fonction ignore les champs en questions.
Bogue
Voir les bugs de la fonction MLV_get_event().
Paramètres
sym Le code de la
touche.
mod Le mode dans lequel se trouve le clavier.
unicode Le caractère codé en
unicode de la lettre obtenue en combinant le code et le mode
précédent.
milliseconds Le nombre de millisecondes Ã
attendre.
Renvoie
un entier codant le type de l’évènement qui a été récupéré ( MLV_KEY ), ou MLV_NONE si le temps s’est écoulé.
MLV_Event MLV_wait_keyboard_or_mouse (MLV_Keyboard_button * sym,MLV_Keyboard_modifier * mod, int * unicode, int * mouse_x, int * mouse_y)
Suspend l’exécution jusqu’à ce que l’utilisateur appuie sur une touche du clavier ou sur le bouton gauche de la souris. Cette fonction renvoie un entier codant le type de l’évènement qui a été récupéré ( clavier ou souris )
Lorsque l’utilisateur appuie sur une touche, la fonction retourne trois valeurs ( sym, mod et unicode ) correspondant respectivement au code de la touche, au mode dans lequel se trouve le clavier (majuscule etc ...) et au caractère unicode correspondnant obtenu en combinant le mode du clavier et le code de la touche appuyée.
Lorsque l’utilisateur appuie sur le bouton gauche de la souris, la fonction remplit les parametres correspondant aux coordonnées en X et Y de la position de la souris sur l’écran.
Bogue
Voir les bugs de la fonction MLV_get_event().
Paramètres
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.
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
mouse_x Coordonnée en X de la position de
la souris
mouse_y Coordonnée en Y de la position de
la souris
Renvoie
un entier codant le type de l’évènement qui a été récupéré ( MLV_KEY ou MLV_MOUSE_BUTTON )
Exemples
advanced/08_zone_click.c, et beginner/08_mouse_keyboard_input_box_timer.c.
MLV_Event MLV_wait_keyboard_or_mouse_or_milliseconds (MLV_Keyboard_button *sym, MLV_Keyboard_modifier * mod, int * unicode, int * mouse_x, int *mouse_y, int milliseconds)
Suspend l’exécution jusqu’à ce que l’utilisateur appuie sur une touche du clavier, sur le bouton gauche de la souris ou qu’un certain nombre de millisecondes passées en paramètres se soient écoulées. Cette fonction renvoie un entier codant le type de l’évènement qui a été récupéré ( clavier, souris ou aucun des deux ).
Voir les fonctions MLV_wait_keyboard_milliseconds() et MLV_wait_mouse_milliseconds() pour plus d’informations.
Bogue
Voir les bugs de la fonction MLV_get_event().
Paramètres
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.
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
mouse_x Coordonnée en X de la position de
la souris
mouse_y Coordonnée en Y de la position de
la souris
milliseconds Le nombre de milliseconde Ã
attendre avant d’arrêter la fonction
Renvoie
un entier codant le type de l’évènement qui a été récupéré ( MLV_KEY ou MLV_MOUSE_BUTTON ), ou MLV_NONE si le temps s’est écoulé.
MLV_Event MLV_wait_keyboard_or_mouse_or_seconds (MLV_Keyboard_button * sym,MLV_Keyboard_modifier * mod, int * unicode, int * mouse_x, int * mouse_y,int seconds)
Suspend l’exécution jusqu’à ce que l’utilisateur appuie sur une touche du clavier, sur le bouton gauche de la souris ou qu’un certain nombre de secondes passées en paramètres se soient écoulées. Cette fonction renvoie un entier codant le type de l’évènement qui a été récupéré ( clavier, souris ou aucun des deux ).
Voir les fonctions MLV_wait_keyboard_seconds() et MLV_wait_mouse_seconds() pour plus d’informations.
Bogue
Voir les bugs de la fonction MLV_get_event().
Paramètres
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.
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
mouse_x Coordonnée en X de la position de
la souris
mouse_y Coordonnée en Y de la position de
la souris
seconds Le nombre de seconde à attendre
avant d’arrêter la fonction
Renvoie
un entier codant le type de l’évènement qui a été récupéré ( MLV_KEY ou MLV_MOUSE_BUTTON ), ou MLV_NONE si le temps s’est écoulé.
Exemples
beginner/08_mouse_keyboard_input_box_timer.c.
MLV_Event MLV_wait_keyboard_or_seconds (MLV_Keyboard_button * sym,MLV_Keyboard_modifier * mod, int * unicode, int seconds)
Suspend l’exécution jusqu’à ce que l’utilisateur appuie sur une touche du clavier ou jusq’à ce q’un nombre de secondes passées en paramètres soient écoulées. Pour plus d’informations sur le fonctionnement de cette fonction, veuillez vous reporter à la documentation de MLV_wait_keyboard().
La fonction accepte des valeurs nulles pour les pointeurs sym, mod et unicode. Dans ce cas la fonction ignore les champs en questions.
Bogue
Voir les bugs de la fonction MLV_get_event().
Paramètres
sym Le code de la
touche.
mod Le mode dans lequel se trouve le clavier.
unicode Le caractère codé en
unicode de la lettre obtenue en combinant le code et le mode
précédent.
seconds Le nombre de secondes Ã
attendre.
Renvoie
un entier codant le type de l’évènement qui a été récupéré ( MLV_KEY ), ou MLV_NONE si le temps s’est écoulé.
Exemples
beginner/08_mouse_keyboard_input_box_timer.c.
MLV_Event MLV_wait_mouse_or_milliseconds (int * x, int * y, int milliseconds)
Suspend l’exécution jusqu’à ce que l’utilisateur clique sur le bouton gauche de la souris. Au moment où l’utilisateur clique, la fonction retourne les coordonnées de la position de la souris dans la fenêtre.
Paramètres
x
Coordonnée en X de la position de la souris
dans la fenêtre.
y Coordonnée en Y de la position de la
souris dans la fenêtre.
milliseconds Le nombre de milliseconde Ã
attendre.
Renvoie
un entier codant le type de l’évènement qui a été récupéré ( MLV_MOUSE_BUTTON ), ou MLV_NONE si le temps s’est écoulé.
MLV_Event MLV_wait_mouse_or_seconds (int * x, int * y, int seconds)
Suspend l’exécution jusqu’à ce que l’utilisateur clique sur le bouton gauche de la souris où jusqu’à ce qu’un nombre de secondes, passé en paramètres, se soient écoulées. Au moment où l’utilisateur clique, la fonction retourne les coordonnées de la position de la souris dans la fenêtre.
Paramètres
x
Coordonnée en X de la position de la souris
dans la fenêtre.
y Coordonnée en Y de la position de la
souris dans la fenêtre.
seconds Le nombre de second à attendre
avant de quitter la fonction.
Renvoie
un entier codant le type de l’évènement qui a été récupéré ( MLV_MOUSE_BUTTON ), ou MLV_NONE si le temps s’est écoulé.
Exemples
beginner/08_mouse_keyboard_input_box_timer.c.
MLV_Event MLV_wait_particular_input_box_or_milliseconds (int milliseconds,MLV_Input_box * input_box, char ** text)
Cette fonction suspend l’exécution du programme jusqu’à ce que l’utilisateur écrive une phrase dans le champs de la boîte de saisie passée en paramètre de la fonction ou qu’un nombre de millisecondes fixées soient écoulée.
Paramètres
input_box La
boîte de saisie qui doit être
observée.
text Le texte
récupéré par la
boîte de saisie.
milliseconds Le nombre de millisecondes Ã
attendre.
Renvoie
un entier codant le type de l’évènement qui a été récupéré ( MLV_INPUT_BOX ) ou MLV_NONE si le temps s’est écoulé. \
MLV_Event MLV_wait_particular_input_box_or_seconds (MLV_Input_box *input_box, char ** text, int seconds)
Cette fonction suspend l’exécution du programme jusqu’à ce que l’utilisateur écrive une phrase dans le champs de la boîte de saisie passée en paramètre de la fonction ou qu’un nombre de secondes fixées soient écoulée.
Paramètres
input_box La
boîte de saisie qui doit être
observée.
text Le texte
récupéré par la
boîte de saisie.
seconds Le nombre de secondes Ã
attendre.
Renvoie
un entier codant le type de l’évènement qui a été récupéré ( MLV_INPUT_BOX ) ou MLV_NONE si le temps s’est écoulé. \
Auteur
Généré automatiquement par Doxygen pour MLV-3.1.0 à partir du code source.