Documentation de la bibliothèque MLV-3.1.0

◆ MLV_wait_input_box_va()

void MLV_wait_input_box_va ( 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,
va_list  pile 
)

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.

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.

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
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 l'utilisateur.
pileLa pile des complements de paramètres comme dans vaprintf.