Partager via

Méthode ITfThreadMgrEx ::ActivateEx (msctf.h)

  • Article

La méthode ITfThreadMgrEx ::ActivateEx est utilisée par une application pour initialiser et activer TSF pour le thread appelant. Contrairement à ITfThreadMgr ::Activate, ITfThreadMgrEx ::ActivateEx peut prendre un indicateur pour spécifier la façon dont TSF est activé.

Syntaxe

HRESULT ActivateEx(
  [out] TfClientId *ptid,
  [in]  DWORD      dwFlags
);

Paramètres

[out] ptid

[out] Pointeur vers une valeur TfClientId qui reçoit un identificateur client.

[in] dwFlags

Valeur Signification
TF_TMAE_NOACTIVATETIP
 Les services de texte ne seront pas activés tant que ITfThreadMgrEx ::ActivateEx est appelé. Ils sont activés lorsque le thread appelant est mis au point de manière asynchrone.
TF_TMAE_SECUREMODE
 TSF est activé en mode sécurisé. Seuls les services de texte qui prennent en charge le mode sécurisé seront activés.
TF_TMAE_UIELEMENTENABLEDONLY
 TSF active uniquement les services de texte classés dans GUID_TFCAT_TIPCAP_UIELEMENTENABLED.
TF_TMAE_COMLESS
 TSF n’utilise pas COM. TSF active uniquement les services de texte classés dans GUID_TFCAT_TIPCAP_COMLESS.
TF_TMAE_NOACTIVATEKEYBOARDLAYOUT
 TSF ne synchronise pas la disposition actuelle du clavier alors que ITfThreadMgrEx ::ActivateEx() est appelé. La disposition du clavier est ajustée lorsque le thread appelant obtient le focus. Cet indicateur doit être utilisé avec TF_TMAE_NOACTIVATETIP.

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
 Un ou plusieurs paramètres ne sont pas valides.

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

ITfThreadMgr ::Activate

ITfThreadMgrEx