![]() |
DeactivateTextService |
||||
Header: | TextServices.h | Carbon status: | Supported | |
Lets a text service component know that its associated document window is becoming inactive. This allows time for the text service component to prepare for deactivation.
ComponentResult DeactivateTextService ( ComponentInstance ts );
A component instance created by a prior call to the Component Manager OpenComponent function.
If you are writing a text service component, it must implement a function for this call.
When it receives a DeactivateTextService call, the text service component is responsible for saving whatever state information it needs to save, so that it can restore the proper information when it becomes active again. A component other than an input method should also hide all its floating windows and menus. However, an input-method component should not hide its windows in response to this call. If the subsequent document being activated is using the same components service, it would be irritating to the user to hide and then immediately redisplay the same windows. An input-method component should hide its windows only in response to a HidePaletteWindows call.
An input method should not confirm any unconfirmed text in the active input area, but should save it until reactivated.
The Text Services Manager makes this call either on its own or in response to application-interface calls it receives from client applications.
Client applications also may make this call, but the Text Services Manager does not play a role in the connection between the client application making the call and the text service component receiving it. If you are an application making this call, you need to know the component instance of the component whose function you are calling.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)