ImmGetConversionListA, fonction (imm.h)

Article
11/20/2024

Récupère la liste des résultats de conversion de caractères ou de mots sans générer de messages liés à l’IME.

Syntaxe

DWORD ImmGetConversionListA(
        HKL             unnamedParam1,
        HIMC            unnamedParam2,
  [in]  LPCSTR          lpSrc,
  [out] LPCANDIDATELIST lpDst,
  [in]  DWORD           dwBufLen,
  [in]  UINT            uFlag
);

Paramètres

unnamedParam1

unnamedParam2

[in] lpSrc

Pointeur vers une chaîne de caractères terminée par null spécifiant la source de la liste.

[out] lpDst

Pointeur vers une structure CANDIDATELIST dans laquelle la fonction récupère la liste.

[in] dwBufLen

Taille, en octets, de la mémoire tampon de sortie. L’application définit ce paramètre sur 0 si la fonction doit retourner la taille de la mémoire tampon requise pour la liste complète des résultats de conversion.

[in] uFlag

Indicateur d’action. Ce paramètre peut avoir l’une des valeurs suivantes.

Valeur	Signification
GCL_CONVERSION	La chaîne source est la chaîne de lecture. La fonction copie la chaîne de résultat dans la mémoire tampon de destination.
GCL_REVERSECONVERSION	La chaîne source est la chaîne de résultat. La fonction copie la chaîne de lecture dans la mémoire tampon de destination.
GCL_REVERSE_LENGTH	La chaîne source est la chaîne de résultat. La fonction retourne la taille, en octets, de la chaîne de lecture créée si GCL_REVERSECONVERSION est spécifiée.

Valeur de retour

Retourne le nombre d’octets copiés dans la mémoire tampon de sortie. Si l’application définit le paramètre dwBufLen sur 0, la fonction retourne la taille, en octets, de la mémoire tampon de sortie requise.

Remarques

Note

L’en-tête imm.h définit ImmGetConversionList comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement], prise en charge linguistique de l’Asie de l’Est installée.
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	imm.h (include Immdev.h, Windows.h)
bibliothèque	Imm32.lib
DLL	Imm32.dll

Voir aussi

CANDIDATELIST

du gestionnaire de méthodes d’entrée

fonctions Input Method Manager

Partager via