Legacy Document

Inside Macintosh: Text /

Chapter 7 - Text Services Manager / Text Services Manager Reference

Text Service Component Routines / Identifying the Supported Scripts and Languages

GetScriptLanguageSupport

The GetScriptLanguageSupport function determines which languages and scripts a specified text service component supports, including its primary language and script.

FUNCTION GetScriptLanguageSupport (ts: ComponentInstance; 
                                   VAR scriptHandle: 
                                   ScriptLanguageSupportHandle): 
                                   ComponentResult;

ts

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

scriptHandle

A handle to a script-language support record. The handle must be either NIL or a valid handle. If it is NIL, the text service component allocates a new handle. If it is already a valid handle, the text service component resizes it as necessary.

DESCRIPTION

The GetScriptLanguageSupport function lets a caller find out all scripts and languages that your text service component supports. GetScriptLanguageSupport should return a list of scripts and languages in the scriptHandle return parameter. The ComponentResult return value should contain 0 if the list is correct, or an error value if an error occurred.

The component should list all its supported scripts and languages, starting with the primary script and language as specified in the componentFlags field of its component description record. See page 7-15.

The result is returned in a handle to a script-language support record. See "Identifying the Supported Scripts and Languages" on page 7-42 for a description of the script-language support record.

SEE ALSO

For sample code that shows a text service component responding to the GetScriptLanguageSupport function, see Listing 7-10 on page 7-43.