Partager via

Méthode ITfInputProcessorProfileMgr ::ActivateProfile (msctf.h)

La méthode ITfInputProcessorProfileMgr ::ActivateProfile active le profil ou la disposition du clavier du service de texte spécifié.

Syntaxe

HRESULT ActivateProfile(
  [in] DWORD    dwProfileType,
  [in] LANGID   langid,
  [in] REFCLSID clsid,
  [in] REFGUID  guidProfile,
  [in] HKL      hkl,
  [in] DWORD    dwFlags
);

Paramètres

[in] dwProfileType

[in] Type de ce profil. Il s’agit de l’une de ces valeurs.

Valeur Signification
TF_PROFILETYPE_INPUTPROCESSOR
 Il s’agit d’un service de texte.
TF_PROFILETYPE_KEYBOARDLAYOUT
 Il s’agit d’une disposition de clavier.

[in] langid

[in] ID de langue du profil à activer.

[in] clsid

[in] CLSID du service de texte du profil à activer. Cela doit être CLSID_NULL si dwProfileType est TF_PROFILETYPE_KEYBOARDLAYOUT.

[in] guidProfile

[in] GuidProfile du profil à activer. Cela doit être GUID_NULL si dwProfileType est TF_PROFILETYPE_KEYBOARDLAYOUT.

[in] hkl

[in] Poignée de la disposition du clavier. Cette valeur doit être NULL si dwProfileType est TF_PROFILETYPE_INPUTPROCESSOR.

[in] dwFlags

Combinaison des bits suivants :

Valeur Signification
TF_IPPMF_FORPROCESS
 Activez ce profil pour tous les threads du processus.
TF_IPPMF_FORSESSION
 Activez ce profil pour tous les threads du bureau actuel.
TF_IPPMF_ENABLEPROFILE
 Mettez à jour le Registre pour activer ce profil pour cet utilisateur.
TF_IPPMF_DISABLEPROFILE
TF_IPPMF_DONTCARECURRENTINPUTLANGUAGE
 Si la langue d’entrée actuelle ne correspond pas à la langue du profil demandé, TSF marque l’activation de ce profil lorsque la langue d’entrée demandée est commutée. Si cet indicateur est désactivé et que la langue d’entrée actuelle n’est pas mise en correspondance, cette méthode échoue.

Valeur retournée

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

Valeur Description
S_OK
 La méthode a réussi.
S_FALSE
 Le profil de langue n’est pas activé.
E_FAIL
 Une erreur non spécifiée s'est produite.
E_INVALIDARG
 Un ou plusieurs paramètres ne sont pas valides.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête msctf.h
DLL Msctf.dll

Voir aussi

ITfInputProcessorProfileMgr

ITfInputProcessorProfileMgr ::D eactivateProfile

  • Last updated on