Metodo ITfThreadMgrEx::ActivateEx (msctf.h)

  • Articolo

Il metodo ITfThreadMgrEx::ActivateEx viene usato da un'applicazione per inizializzare e attivare TSF per il thread chiamante. A differenza di ITfThreadMgr::Activate, ITfThreadMgrEx::ActivateEx può accettare un flag per specificare la modalità di attivazione del TSF.

Sintassi

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

Parametri

[out] ptid

[out] Puntatore a un valore TfClientId che riceve un identificatore client.

[in] dwFlags

Valore Significato
TF_TMAE_NOACTIVATETIP
 I servizi di testo non verranno attivati mentre viene chiamato ITfThreadMgrEx::ActivateEx. Verranno attivati quando il thread chiamante ha lo stato attivo in modo asincrono.
TF_TMAE_SECUREMODE
 TSF viene attivato in modalità protetta. Verranno attivati solo i servizi di testo che supportano la modalità protetta.
TF_TMAE_UIELEMENTENABLEDONLY
 TSF attiva solo i servizi di testo classificati in GUID_TFCAT_TIPCAP_UIELEMENTENABLED.
TF_TMAE_COMLESS
 TSF non usa COM. TSF attiva solo i servizi di testo classificati in GUID_TFCAT_TIPCAP_COMLESS.
TF_TMAE_NOACTIVATEKEYBOARDLAYOUT
 TSF non sincronizza il layout della tastiera corrente mentre viene chiamato ITfThreadMgrEx::ActivateEx(). Il layout della tastiera verrà regolato quando il thread chiamante ottiene lo stato attivo. Questo flag deve essere usato con TF_TMAE_NOACTIVATETIP.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Descrizione
S_OK
 Il metodo è stato eseguito correttamente.
E_FAIL
 Si è verificato un errore non specificato.
E_INVALIDARG
 Uno o più parametri non sono validi.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione msctf.h
DLL Msctf.dll
Componente ridistribuibile TSF 1.0 in Windows 2000 Professional

Vedi anche

ITfThreadMgr::Activate

ITfThreadMgrEx