Windows Dev Center

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.

ITfCategoryMgr interface

The ITfCategoryMgr interface manages categories of objects for text services. The TSF manager implements this interface.

TSF categories help organize objects identified by a globally unique identifier ( GUID ). For example, a class identifier ( CLSID ) identifies a text service, and a GUID identifies the TSF compartment, TSF properties, and TSF display attributes. To group and organize multiple GUIDs, TSF uses category identifiers ( CATIDs).

The category manager uses an internal table, accessed with keys called GUID atoms to cache the GUIDs. Access to GUIDs is efficient using these atoms. When a GUID is obtained using its atom, the GUID description and value can be obtained from the Windows registry.

Members

The ITfCategoryMgr interface inherits from the IUnknown interface. ITfCategoryMgr also has these types of members:

Methods

The ITfCategoryMgr interface has these methods.

MethodDescription
EnumCategoriesInItem

Obtains an IEnumGUID interface that enumerates all categories to which the specified GUID belongs.

EnumItemsInCategory

Obtains an IEnumGUID interface that enumerates all GUIDs included in the specified category.

FindClosestCategory

Finds the category closest to the specified GUID from a list of categories.

GetGUID

Obtains a GUID from the internal table using its atom.

GetGUIDDescription

Obtains the description of the specified GUID from the Windows registry.

GetGUIDDWORD

Obtains the DWORD value of the specified GUID from the Windows registry.

IsEqualTfGuidAtom

Determines whether the specified atom represents the specified GUID in the internal table.

RegisterCategory

Adds a specified GUID to the specified category in the Windows registry.

RegisterGUID

Adds a GUID to the internal table and obtains an atom for the GUID.

RegisterGUIDDescription

Enters a description for a GUID previously registered in the Windows registry.

RegisterGUIDDWORD

Enters a DWORD value for a GUID previously registered in the Windows registry.

UnregisterCategory

Removes a specified GUID from the specified category in the Windows registry.

UnregisterGUIDDescription

Removes the description for a GUID from the Windows registry.

UnregisterGUIDDWORD

Removes the DWORD value for a GUID from the Windows registry.

 

Examples

CoCreateInstanceCLSID



HRESULT hr;
ITfCategoryMgr *pCategoryMgr;

hr = CoCreateInstance(CLSID_TF_CategoryMgr,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_ITfCategoryMgr,
                      (void**)&pCategoryMgr);


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

See also

IUnknown
CoCreateInstance

 

 

Community Additions

Show:
© 2015 Microsoft