![]() |
DeactivateTSMDocument |
||||
Header: | TextServices.h | Carbon status: | Supported | |
Instructs the Text Services Manager to mark the TSM document as inactive.
OSErr DeactivateTSMDocument ( TSMDocumentID idocID );
A TSM document identification number created by a prior call to the NewTSMDocument function.
A result code.
The DeactivateTSMDocument function lets you inform the Text Services Manager that a TSM document in your client application is no longer active and must temporarily stop using text service components.
The Text Services Manager calls the equivalent text service component function DeactivateTextService for any text service component associated with the TSM document being deactivated.
Once your application is initialized as a TSM-aware application, at least one TSM document must always be active when your application is active. If a situation arises in which you are a TSM-aware application but all of your TSM documents are inactive, any text service component that has a menu or palette windows will be unable to communicate with the user. The best policy is to always create a TSM document, even if only a dummy document, immediately after initializing as a TSM-aware application.
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)