Documentation de la bibliothèque MLV-3.1.0

medium/03_input_box_events.c

Ce programme montre comment il est possible de récupérer des informations provenant de l'utilisateur lorsqu'il utilise 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>
//
// Fonction qui s'occupe de l'affichage de la démonstration.
//
void affichage( int width, int height, char* texte1, char* texte2 ){
//
// Nettoie l'écran
//
//
// Affichage de la consigne
//
10, 10,
"Voici un programme qui permet de gérer deux zones de texte simultanément.\nPour quitter, il suffit d'écrire \"quit\" dans la zone de texte de droite.",
9,
);
//
// Affichage du texte qui a été récupéré par la boîte de saisie 1
//
10, 150,
texte1,
);
//
// Affichage du texte qui a été récupéré par la boîte de saisie 2
//
220, 150,
texte2,
);
//
// Dessine tout les boîtes de saisies
//
//
// Met à jour l'affichage
//
}
//
// 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;
char* texte, *texte1, *texte2;
MLV_Input_box *input_box, *input_box_1, *input_box_2;
MLV_Event event;
//
// Créé et affiche une fenêtre
//
"medium - 3 - input box events", "input box events", width, height
);
//
// Créé la première boîte de saisie.
//
input_box_1 = MLV_create_input_box(
10, 100,
200, 30,
MLV_COLOR_BLACK, "Saisie 1 : "
);
texte1 = (char*) malloc( 1*sizeof(char) ); *texte1 = '\0';
//
// Créé la seconds boîte de saisie.
//
input_box_2 = MLV_create_input_box(
220, 100,
200, 30,
MLV_COLOR_BLACK, "Saisie 2 : "
);
texte2 = (char*) malloc( 1*sizeof(char) ); *texte2 = '\0';
//
// Met à jour l'affichage
//
affichage( width, height, texte1, texte2 );
//
// Tant que le texte récupéré par la seconde boîte de saisie est différent
// de la chaîne de charactères "quit" on demande à l'utilisateur d'entrer
// du texte dans un des deux boîtes de saisies et on affiche le texte ainsi
// rentré.
//
do {
//
// Récupère un évènement
//
event = MLV_get_event(
NULL, NULL, NULL,
&texte, &input_box,
NULL, NULL, NULL,
NULL
);
//
// On traite l'évènement si il s'agit d'une boîte de saisie
//
if( event == MLV_INPUT_BOX ){
//
// On met à jour le texte associé à la boîte de saisie 1 si c'est
// la boîte de saisie 1 qui a récupéré le texte
//
if( input_box == input_box_1 ){
//
// on libère la mémoire pointée par texte1 avant
// de remplacer texte1 par le pointeur de texte2
//
free( texte1 );
texte1 = texte;
}
//
// On met à jour le texte associé à la boîte de saisie 2 si c'est
// la boîte de saisie 2 qui a récupéré le texte
//
if( input_box == input_box_2 ){
//
// on libère la mémoire pointée par texte1 avant
// de remplacer texte1 par le pointeur de texte2
//
free( texte2 );
texte2 = texte;
}
}
//
// Met à jour l'affichage
//
affichage( width, height, texte1, texte2 );
} while( strcmp( texte2, "quit" ) );
//
// Libère la mémoire utilisée par texte 1 et text 2
//
free( texte1 );
free( texte2 );
//
// Ferme toutes les boîtes de saisie.
//
MLV_free_input_box( input_box_1 );
MLV_free_input_box( input_box_2 );
//
// Ferme la fenêtre
//
return 0;
}
/*
* This file is part of the MLV Library.
*
* Copyright (C) 2010,2011,2012,2013 Adrien Boussicault, Marc Zipstein
*
*
* This Library is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This Library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this Library. If not, see <http://www.gnu.org/licenses/>.
*/
MLV_create_window
void MLV_create_window(const char *window_name, const char *icone_name, unsigned int width, unsigned int height)
Créé une fenêtre dont la taille, et les différents noms sont passés en paramètres.
MLV_Event
MLV_Event
Énumère les différents types d'évènement de la bibliothèque MLV.
Definition: MLV_event.h:46
MLV_get_event
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...
MLV_create_input_box
MLV_Input_box * MLV_create_input_box(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,...)
Cette fonction créé une boîte de saisie.
MLV_free_window
void MLV_free_window()
Ferme la fenêtre de la bibliothèque MLV.
MLV_free_input_box
void MLV_free_input_box(MLV_Input_box *input_box)
Cette fonction ferme une boîte de saisie précédement créée.
MLV_update_window
void MLV_update_window()
Met à jour l'affichage de la fenêtre.
MLV_draw_text
void MLV_draw_text(int x, int y, const char *text, MLV_Color color,...)
Imprime un texte donné à une position et une couleur données.
MLV_TEXT_CENTER
@ MLV_TEXT_CENTER
Definition: MLV_text.h:45
MLV_COLOR_GREEN
#define MLV_COLOR_GREEN
Definition: MLV_color.h:931
MLV_INPUT_BOX
@ MLV_INPUT_BOX
Definition: MLV_event.h:49
MLV_Input_box
struct _MLV_Input_box MLV_Input_box
Définition du type des boîtes de saisies.
Definition: MLV_input_box.h:47
MLV_all.h
Fichier d'entête principal incluant tous les autres fichiers entêtes de la bibliothèque MLV.
MLV_clear_window
void MLV_clear_window(MLV_Color color)
Éfface la fenêtre et la remplace par un monochrome de la couleur donnée en paramètre.
MLV_draw_adapted_text_box
void MLV_draw_adapted_text_box(int x, int y, const char *message, int sizeInterligne, MLV_Color borderColor, MLV_Color textColor, MLV_Color backgroundColor, MLV_Text_justification text_justification,...)
Dessine une boîte contenant du texte.
MLV_draw_all_input_boxes
void MLV_draw_all_input_boxes()
Cette fonction dessine tous les boîtes de saisies.
MLV_COLOR_BLACK
#define MLV_COLOR_BLACK
Definition: MLV_color.h:379