Documentation de la bibliothèque MLV-3.1.0

◆ MLV_wait_input_box_or_milliseconds()

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.

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
millisecondsLe temps à attendre en millisecondes.
top_left_corner_XLa coordonnée en X du coin Nord-Ouest de la boîte de saisie.
top_left_corner_YLa coordonnée en Y du coin Nord-Ouest de la boîte de saisie.
widthLa largeur de la boîte de saisie.
heightLa hauteur de la boîte de saisie.
borderColorLa couleur de la bordure de la boîte de saisie.
textColorLa couleur du texte de la boîte de saisie.
backgroundColorLa couleur de fond de la boîte de saisie.
informativeMessageLe message à afficher devant la boîte de saisie.
textL'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.