Legacy Document

Inside Macintosh: Text /

Chapter 7 - Text Services Manager / Text Services Manager Reference

Text Service Component Routines / Providing a Text Service

DeactivateTextService

The DeactivateTextService function 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.

FUNCTION DeactivateTextService (ts: ComponentInstance): 
                                ComponentResult;

ts

A component instance created by a prior call to the Component Manager OpenComponent function.

DESCRIPTION

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 component's 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.