# Documentation de la bibliothèque MLV-0.6.705

- Presentation
- Téléchargement
- Installation
- Compilation
- Exemples
- API
- Liste des fonctions
- bogues
- contacts

# medium/04_events.c

Ce programme montre comment il est possible de récupérer des informations provenant de l'utilisateur lorsqu'il utilise son clavier, sa souris ou lorsqu'il valide une chaîne de caractères à l'aide d'une boîte de saisie sans bloquer l'exécution du programme.

Pour cela il utilise le système d'évènements de la bibliothèque MLV :

À chaque fois qu'un utilisateur déplace la sourris, appuie sur les touches d'un clavier, ou entre du texte dans une boîte de saisie, un événèment est créé par la bibliothèque MLV. Cet évènement est placé dans une file d'attente. Il est possible de récupérer toutes les informations concernant ces évènements en appelant la fonction MLV_get_event(). Cette fonction supprime le dernier évènement de la pile, l'analyse et renvoie, à l'aide de ses paramètres et de sa valeur de retour, toutes les informations le concernant.

    #include <MLV/MLV_all.h>

    #include <stdlib.h>
    #include <stdio.h>

    #define TAILLE_MESSAGE 100

    //
    // Fonction qui s'occupe de l'affiche de la démonstration.
    //
    void affichage(
            int nb_touche, int nb_mouse_click, int nb_mouse_motion,
            int x, int y, MLV_Mouse_button mouse_button, char* texte1, char* texte2,
            int width, int height
    ){
            int taille_interlinge = 5;
            //
            // Déclaration de l'espace mémoire associé au message.
            //
            char message[TAILLE_MESSAGE];

            //
            // Nettoie l'écran pour un nouvel affichage
            //
            MLV_draw_filled_rectangle(
                    0, 0, width, height, MLV_COLOR_BLACK
            );

            //
            // Dessine toutes les boîtes de saisie.
            //
            MLV_draw_all_input_boxes();

            //
            // Affiche un message d'information
            //
            MLV_draw_adapted_text_box(
                    10,160,
                    "Lorsque vous cliquez sur une boîte de saisie,\nles évènements concernant le clavier et la souris\nne sont plus transmis à l'utilisateur.",
                    taille_interlinge,
                    MLV_COLOR_RED, MLV_COLOR_GREEN, MLV_COLOR_BLACK,
                    MLV_TEXT_LEFT
            );

            //
            // Affiche le nombre de fois qu'une touche a été appuyée depuis le debut
            // du programme.
            //
            snprintf(
                    message, TAILLE_MESSAGE,
                    "Nombre de fois que l'on a appuyé sur une touche : %i",
                    nb_touche
            );
            MLV_draw_text( 10, 40, message, MLV_COLOR_GREEN );

            //
            // Affiche le nombre de fois que l'utilisateur à bougé la souris
            //
            snprintf(
                    message, TAILLE_MESSAGE,
                    "Nombre de fois que la souris a bougé : %i",
                    nb_mouse_motion
            );
            MLV_draw_text( 10, 60, message, MLV_COLOR_GREEN );
            snprintf( message, TAILLE_MESSAGE, "(%d,%d)", x, y );

            //
            // Affiche le nombre de fois que l'utilisateur a cliqué avec la souris
            //
            snprintf(
                    message, TAILLE_MESSAGE,
                    "Nombre de click de souris : %i",
                    nb_mouse_click
            );
            MLV_draw_text( 10, 80, message, MLV_COLOR_GREEN );

            //
            // Affiche la position de la souris sur l'écran
            //
            snprintf( message, TAILLE_MESSAGE, "(%d,%d)", x, y );
            MLV_draw_text( x, y, message, MLV_COLOR_GREEN );

            //
            // Affiche le texte récupéré par la première boîte de saisie.
            //
            MLV_draw_text(
                    10, 140,
                    texte1,
                    MLV_COLOR_GREEN
            );

            //
            // Affiche le texte récupéré par la seconde boîte de saisie.
            //
            MLV_draw_text(
                    220, 140,
                    texte2,
                    MLV_COLOR_GREEN
            );

            //
            // Met à jour la fenêtre
            //
            MLV_actualise_window();
    }

    //
    // Attention !
    // Pour pouvoir compiler ce programme sous windows et sous macintosh,
    // il faut, pour la déclaration du main, respecter strictement la syntaxe
    // suivante :
    //
    int main(int argc, char *argv[]){
            int width = 640, height = 460;    //Taille de la fenêtre

            // informations conernant les évènements de type clavier.
            MLV_Keyboard_button sym=-1;
            MLV_Keyboard_modifier mod=-1;
            MLV_Button_state state=-1;

            int x=0,y=0;            // Position de la souris
            MLV_Mouse_button mouse_button = -1;     // Code du bouton qui a été appuyé
            char* texte = NULL;             // Texte qui sera recupéré par la boîte de saisie
            char *texte1, *texte2;          // Texte qui sera recupéré par la boîte de saisie
            MLV_Input_box *input_box = NULL, *input_box_1, *input_box_2;
            MLV_Event event = MLV_NONE;        //Évènenemt

            int nb_touche = 0;   // Nombre de fois que l'utilsateur a appuyé sur une
                                 // touche du clavier
            int nb_mouse_click = 0; // Nombre de fois que l'utilisateur a cliqué sur la
                                    // souris
            int nb_mouse_motion = 0; // Nombre de fois que l'utilisateur a déplacé la
                                     // souris
            int quit = 0;

            //
            // Créé et affiche la fenêtre
            //
            MLV_create_window( "medium - 4 events", "4 events", width, height );

            //
            // Créé la première boîte de saise.
            //
            input_box_1 = MLV_create_input_box(
                    10, 100,
                    200, 30,
                    MLV_COLOR_BLUE, MLV_COLOR_GREEN,
                    MLV_COLOR_BLACK, " Saisie 1 : "
            );
            texte1 = (char*) malloc( sizeof(char) ); *texte1 = '\0';

            //
            // Créé la seconde boîte de saisie.
            //
            input_box_2 = MLV_create_input_box(
                    220, 100,
                    200, 30,
                    MLV_COLOR_BLUE, MLV_COLOR_GREEN,
                    MLV_COLOR_BLACK, " Saisie 2 : "
            );
            texte2 = (char*) malloc( sizeof(char) ); *texte2 = '\0';

            //
            // Met a jour l'affichage
            //
            affichage(
                    nb_touche, nb_mouse_click, nb_mouse_motion, x, y,
                    mouse_button, texte1, texte2, width, height
            );

            //
            // Tant que la touche shift+q n'a pas été appuyée puis relachée,
            // on compte le nombre de fois que l'utilisateur a appuyé sur une
            // touche.
            //
            do {
                    //
                    // Récupère un évènement dans la file des évènements
                    // non traités.
                    //
                    event = MLV_get_event(
                            &sym, &mod, NULL,
                            &texte, &input_box,
                            &x, &y, &mouse_button,
                            &state
                    );

                    //
                    // Traitetement des évènements
                    //
                    switch( event ){
                            case MLV_NONE : // Aucun évènement récupéré
                                    break;
                            case MLV_KEY : // L'utilisateur a utilisé le clavier
                                    //
                                    // On incrémente le compteur du nombre de fois
                                    // que l'utilisateur à appuyé sur le clavier
                                    // si une touche a été appuyée
                                    //
                                    if( state == MLV_PRESSED ){
                                            nb_touche = nb_touche + 1;
                                    }
                                    break;
                            case MLV_INPUT_BOX : // L'utilisateur a utilisé une boîte de saisie.
                                    //
                                    // Si le texte a été récupéré par la première boîte de saisie
                                    // input_box_1, on met à jour le texte
                                    // correspondant à la première boîte de saisie.
                                    //
                                    if( input_box == input_box_1 ){
                                            free( texte1 );
                                            texte1 = texte;
                                    }
                                    //
                                    // Si le texte a été récupéré par la deuxième  boîte de saisie
                                    // , on met à jour le texte
                                    // correspondant à la deuxième boîte de saisie.
                                    //
                                    if( input_box == input_box_2 ){
                                            free( texte2 );
                                            texte2 = texte;
                                    }
                                    break;
                            case MLV_MOUSE_BUTTON : // L'utilisateur a utilisé un
                                                    // bouton de la souris
                                    //
                                    // On incrémente le compteur du nombre de fois
                                    // que l'utilisateur a appuyé sur la touche
                                    // de la souris
                                    //
                                    if( state == MLV_PRESSED ){
                                            nb_mouse_click = nb_mouse_click + 1;
                                    }
                                    break;
                            case MLV_MOUSE_MOTION : // L'utilisateur a déplacé la souris
                                    //
                                    // On incrémente le compteur du nombre de fois
                                    // que l'utilisateur a déplacé la souris
                                    //
                                    nb_mouse_motion = nb_mouse_motion + 1;
                                    break;
                            default :
                                    fprintf(
                                            stderr,
                                            "Erreur : la valeur de l'évènement récupéré est impossible."
                                    );
                                    quit = 1;
                    }

                    //
                    // Mis à jour de l'affichage
                    //
                    affichage(
                            nb_touche, nb_mouse_click, nb_mouse_motion, x, y,
                            mouse_button, texte1, texte2, width, height
                    );
            } while( ! quit );

            //
            // Ferme la fenêtre
            //
            MLV_free_window();
            return 0;
    }