ITfCandidateList interface (ctffunc.h)

The ITfCandidateList interface is implemented by a text service and is used by the TSF manager or a client (application or other text service) to obtain and manipulate candidate string objects.

The TSF manager implements this interface to provide access to this interface to other clients. This enables the TSF manager to function as a mediator between the client and the text service.

To obtain an instance of this interface the TSF manager or client can call ITfFnReconversion::GetReconversion.

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

The ITfCandidateList interface has these methods.

When a text service must interpret text before it is inserted into a context, there might be more than one possible interpretation of the text. Speech input is an example of this. If the spoken word is "there", other possible interpretations might be "their" or "they're". The text service will insert the most appropriate text, but there is still some chance of error involved. Text reconversion is the process of allowing the user to select alternate text for the inserted text. The alternate text objects are known as candidates.

ITfFnReconversion::GetReconversion

IUnknown