The ITfFnReconversion interface is implemented by a text service and is used by the TSF manager or a client to support reconversion of text provided by the text service.
The TSF manager implements this interface to provide access to this interface to other clients. This allows the TSF manager to function as a mediator between the client and the text service.
The TSF manager obtains this interface by calling the text service ITfFunctionProvider::GetFunction method with IID_ITfFnReconversion.
An application obtains this interface by calling the TSF manager ITfFunctionProvider::GetFunction method with IID_ITfFnReconversion.
Methods
The ITfFnReconversion interface inherits the methods of the IUnknown interface.
In addition, ITfFnReconversion defines the following methods.
| Method | Description |
|---|
QueryRange |
Obtains the range of text that the reconversion applies to.
|
GetReconversion |
Obtains an ITfCandidateList object for a range of text.
|
Reconvert |
Invokes the reconversion process for a range of text.
|
Remarks
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.
Requirements
| Client | Requires Windows XP, Windows 2000 Professional, or Windows NT Workstation. |
|---|
| Redistributable | Requires TSF 1.0 on Windows NT 4.0, Windows 2000 Professional and Windows MeWindows 98. |
|---|
| Header | Declared in Ctffunc.idl and Ctffunc.h. |
|---|
| DLL | Requires Msctf.dll. |
|---|
Send comments about this topic to Microsoft
Build date: 12/17/2008