Méthode ITfInputProcessorProfiles ::AddLanguageProfile (msctf.h)

Article
03/04/2024

Crée un profil de langue qui se compose d’un service de texte spécifique et d’un identificateur de langue spécifique.

Syntaxe

HRESULT AddLanguageProfile(
  [in] REFCLSID    rclsid,
  [in] LANGID      langid,
  [in] REFGUID     guidProfile,
  [in] const WCHAR *pchDesc,
  [in] ULONG       cchDesc,
  [in] const WCHAR *pchIconFile,
  [in] ULONG       cchFile,
  [in] ULONG       uIconIndex
);

Paramètres

[in] rclsid

Contient le CLSID du service de texte.

[in] langid

Contient une valeur LANGID qui spécifie l’identificateur de langue du profil auquel le service de texte est ajouté. Si cette valeur contient -1, le service de texte est ajouté à toutes les langues.

[in] guidProfile

Contient une valeur GUID qui identifie le profil de langue. Il s’agit de la valeur obtenue par ITfInputProcessorProfiles ::GetActiveLanguageProfile lorsque le profil est actif.

[in] pchDesc

Pointeur vers une mémoire tampon WCHAR qui contient la chaîne de description du service de texte dans le profil. Il s’agit du nom du service de texte affiché dans la barre de langue.

[in] cchDesc

Contient la longueur, en caractères, de la chaîne de description dans pchDesc. Si cette valeur contient -1, pchDesc est supposé être une chaîne terminée par NULL.

[in] pchIconFile

Pointeur vers une mémoire tampon WCHAR qui contient le chemin d’accès et le nom de fichier du fichier contenant l’icône à afficher dans la barre de langue du service de texte dans le profil. Ce fichier peut être un fichier exécutable (.exe), DLL (.dll) ou un fichier d’icône (.ico).

Ce paramètre est facultatif et peut être NULL. Dans ce cas, une icône par défaut s’affiche pour le service de texte.

[in] cchFile

Contient la longueur, en caractères, de la chaîne de fichier icône dans pchIconFile. Si cette valeur contient -1, pchIconFile est supposé être une chaîne terminée par NULL. Ce paramètre est ignoré si pchIconFile a la valeur NULL.

[in] uIconIndex

Contient l’index de base zéro de l’icône dans pchIconFile à afficher dans la barre de langue du service de texte dans le profil. Ce paramètre est ignoré si pchIconFile a la valeur NULL.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Description
S_OK	La méthode a réussi.
E_FAIL	Une erreur non spécifiée s'est produite.
E_INVALIDARG	pszDesc n’est pas valide.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msctf.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

ITfInputProcessorProfiles

ITfInputProcessorProfiles ::GetActiveLanguageProfile

Partager via