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.
| Method | Description |
|---|---|
| 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 |
|
|
IDL |
|
|
DLL |
|
See also