Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ITfThreadMgrEx::ActivateEx method

The ITfThreadMgrEx::ActivateEx method is used by an application to initialize and activate TSF for the calling thread. Unlike ITfThreadMgr::Activate, ITfThreadMgrEx::ActivateEx can take a flag to specify how TSF is activated.

Syntax


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

Parameters

ptid [out]

[out] Pointer to a TfClientId value that receives a client identifier.

dwFlags [in]
ValueMeaning
TF_TMAE_NOACTIVATETIP

Text services will not be activated while ITfThreadMgrEx::ActivateEx is called. They will be activated when the calling thread has focus asynchronously.

TF_TMAE_SECUREMODE

TSF is activated in secure mode. Only text services that support the secure mode will be activated.

TF_TMAE_UIELEMENTENABLEDONLY

TSF activates only text services that are categorized in GUID_TFCAT_TIPCAP_UIELEMENTENABLED.

TF_TMAE_COMLESS

TSF does not use COM. TSF activate only text services that are categorized in GUID_TFCAT_TIPCAP_COMLESS.

TF_TMAE_NOACTIVATEKEYBOARDLAYOUT

TSF does not sync the current keyboard layout while ITfThreadMgrEx::ActivateEx() is called. The keyboard layout will be adjusted when the calling thread gets focus. This flag must be used with TF_TMAE_NOACTIVATETIP.

 

Return value

This method can return one of these values.

ValueDescription
S_OK

The method was successful.

E_FAIL

An unspecified error occurred.

E_INVALIDARG

One or more parameters are invalid.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Redistributable

TSF 1.0 on Windows 2000 Professional

Header

Msctf.h

IDL

Msctf.idl

DLL

Msctf.dll

See also

ITfThreadMgrEx
ITfThreadMgr::Activate

 

 

Show:
© 2017 Microsoft