Important: The information in this document is obsolete and should not be used for new development.
InitiateTextService
The InitiateTextService function instructs a specified text service component to do whatever it needs to set up its operations and commence its performance.
FUNCTION InitiateTextService (ts: ComponentInstance): ComponentResult;
ts
- A component instance created by a prior call to the Component Manager
OpenComponent
function.DESCRIPTION
The Text Services Manager can callInitiateTextService
to any component that it has already opened with the Component ManagerOpenComponent
orOpenDefaultComponent
functions. Text service components should be prepared to handleInitiateTextService
calls at any time.Any text service component can receive multiple
InitiateTextService
calls. The Text Services Manager callsInitiateTextService
each time the user adds a text service to a TSM document, even if the text service component has already been opened. This provides an opportunity for the component to restart or to display user interface elements that the user may have closed.This function should return a
ComponentResult
value of zero if there is no error, and an error code if there is one.