EasyInput - Par Dark Storm (L. GATIN)

Présentation

EasyInput est une librairie de fonctions destinée à simplifier les méthodes de saisie de texte par un utilisateur.

Elle est utilisable gratuitement, vous pouvez la télécharger sur Planète Casio.

Utilisation

Fichiers

Quoi qu'il arrive, vous avez besoin des fichiers EasyInput.c et EasyInput.h.

Selon votre compilateur, il vous faut chosir le bon fichier de syscalls :

• Pour le Fx9860 SDK : gardez le fichier EasyInput_.src ;
• Pour GCC : gardez le fichier EasyInput_.s.

Initialisation

Utilisez EI_init() pour mettre toutes les valeurs de configuration par défaut.

Ensuite, vous pouvez modifier les paramètres suivants en appelant la fonction EI_manage_config(int parameter, int value) :

• EI_SET_COLUMN : Un nombre entre 1 et 21 qui correspond à la colonne de début de la zone de texte ;
• EI_SET_ROW : Idem, mais entre 1 et 8 pour les lignes ;
• EI_SET_BOX_LENGTH : La longueur de la zone de texte, en caractères, une valeur minimale de 3 est requise pour un bon fonctionnement ;
• EI_SET_ALIGN : Le mode d'alignement du texte (EI_LEFT, EI_CENTER, EI_RIGHT) ;
• EI_SET_START_MODE : Le mode de départ du curseur (EI_NORMAL, EI_ALPHA, EI_ALPHA_LOCKED) ;
• EI_SET_Aa_KEY : Le code de la touche qui servira à changer la casse.

Exemple, pour fixer le mode de départ du curseur :

EI_manage_config(EI_SET_START_MODE, EI_ALPHA);

Si est égale à 0, la fonction retourne un pointeur sur l'élément demandé. Cela permet de récupérer les valeurs de configuration.

Exemple, récupérer la valeur de la longueur de la box :

longueur = EI_manage_config(EI_SET_LENGHT_BOX, 0);

Appel

La fonction EI_input_string(int string_length, const char *chars_allowed) retourne un pointeur sur la chaine et doit être appellée de la manière suivante :

char *my_string = NULL;
my_string = EI_input_string(21, (const char*)".0123456789");

La chaine chars_allowed contient tout les caractères dont la saisie est autorisée.

Annexes

Retrouvez plus d'informations sur ce topic.