EasyInput/README.md

51 lines
2.2 KiB
Markdown
Raw Normal View History

2016-04-22 11:34:01 +02:00
# 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](http://www.planet-casio.com/Fr/logiciels/voir_un_logiciel_casio.php?logiciel=SDK_G85_-_EasyInput_Snippets&showid=117).
## 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 <value> 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.
2016-04-22 11:36:01 +02:00
## Annexes
2016-04-22 11:34:01 +02:00
2016-04-22 11:36:01 +02:00
Retrouvez plus d'informations [sur ce topic](http://www.planet-casio.com/Fr/forums/lecture_sujet.php?id=12979).