ITfInputProcessorProfileActivationSink::OnActivated method

The ITfInputProcessorProfileActivationSink::OnActivated method is a callback that is called when an input processor profile is activated or deactivated.

Syntax


HRESULT OnActivated(
  [in]  DWORD dwProfileType,
  [in]  LANGID langid,
  [in]  REFCLSID rclsid,
  [in]  REFGUID catid,
  [in]  REFGUID guidProfile,
  [in]  HKL hkl,
  [in]  DWORD dwFlags
);

Parameters

dwProfileType [in]

[in] The type of this profile. This is one of these values.

ValueMeaning
TF_PROFILETYPE_INPUTPROCESSOR

This is a text service.

TF_PROFILETYPE_KEYBOARDLAYOUT

This is a keyboard layout.

 

langid [in]

[in] Specifies the language id of the profile.

rclsid [in]

[in] Specifies the CLSID of the text service. If dwProfileType is TF_PROFILETYPE_KEYBOARDLAYOUT, this is CLSID_NULL.

catid [in]

[in] Specifies the category of this text service. This category is GUID_TFCAT_TIP_KEYBOARD, GUID_TFCAT_TIP_SPEECH, GUID_TFCAT_TIP_HANDWRITING or something in GUID_TFCAT_CATEGORY_OF_TIP. If dwProfileType is TF_PROFILETYPE_KEYBOARDLAYOUT, this is GUID_NULL.

guidProfile [in]

[in] Specifies the GUID to identify the profile. If dwProfileType is TF_PROFILETYPE_KEYBOARDLAYOUT, this is GUID_NULL.

hkl [in]

[in] Specifies the keyboard layout handle of this profile. If dwProfileType is TF_PROFILETYPE_ INPUTPROCESSOR, this is NULL.

dwFlags [in]

[in]

ValueMeaning
TF_IPSINK_FLAG_ACTIVE

This is on if this profile is activated.

 

Return value

The TSF manager ignores the return value of this method.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Redistributable

TSF 1.0 on Windows 2000 Professional

Header

Msctf.h

IDL

Msctf.idl

DLL

Msctf.dll

 

 

Community Additions

ADD
Show:
© 2014 Microsoft