Carbon


ActivateTextService

Header: TextServices.h Carbon status: Supported

Notifies a text service component that its associated document window is becoming active. This allows the text service component to display any associated floating windows.

ComponentResult ActivateTextService (
    ComponentInstance ts
);
Parameter descriptions
ts

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

DISCUSSION

If you are writing a text service component, it must implement a function for this call.

The appropriate response to ActivateTextService is for the text service component to restore its active state, including displaying all floating windows if they have been hidden. If it is an input method, it should specify the redisplay of any unconfirmed text currently in the active input area.

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.

AVAILABILITY

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)