Sous-routine IMInitializeKeymap

Objectif

Initialise la mappe de clés associée à une langue spécifiée.

Bibliothèque

Bibliothèque de méthodes d'entrée (libIM.a)

Syntaxe

Descriptif

La sous-routine IMInitializeKeymap initialise une mappe de clés de méthode d'entrée (imkeymap). Les sous-routines IMAIXMapping et IMSimpleMapping utilisent imkeymap pour effectuer le mappage des modificateurs d'état keysym aux chaînes. La sous-routine IMInitializeKeymap recherche la mappe imkeymap qui effectue le mappage keysym et renvoie un descripteur imkeymap, IMMap. Les chaînes renvoyées par les fonctions de mappage imkeymap sont traitées comme des octets non signés.

Les applications qui utilisent des méthodes d'entrée n'ont généralement pas besoin de gérer les imkeymaps séparément. Les imkeymaps sont gérés en interne par des méthodes d'entrée.

La sous-routine IMInitializeKeymap recherche un fichier imkeymap dont le nom est au format Nom.im. Le paramètre Nom est transmis à la sous-routine IMInitializeKeymap . Le fichier imkeymap est accessible dans les répertoires spécifiés par la variable d'environnement LOCPATH . L'emplacement par défaut des fichiers de méthode d'entrée est le répertoire /usr/lib/nls/loc . Si aucun des répertoires LOCPATH ne contient la méthode keymap spécifiée par le paramètre Name , la recherche est effectuée dans l'emplacement par défaut.

Le nom du fichier imkeymap correspond généralement au nom de l'environnement local, qui se présente sous la forme Language_territory.codesest@modificateur. Dans l'environnement AIXwindows , le modificateur est au format @im=modificateur. La sous-routine IMInitializeKeymap convertit @im= substring en @ (arobase) lors de la recherche de fichiers de méthode d'entrée chargeables.

Paramètres

Valeurs renvoyées

La sous-routine IMInitializeKeymap renvoie un descripteur de type IMMap. Le renvoi d'une valeur null indique l'occurrence d'une erreur. Le descripteur IMMap est défini dans le fichier im.h en tant que structure caddr_t . Ce descripteur est utilisé pour les fonctions de manipulation de mappe de clés.

Fichiers