Carbon


SetDefaultInputMethod

Header: TextServices.h Carbon status: Supported

Assigns a default (input method) text service component to a given script and language.

OSErr SetDefaultInputMethod (
    Component ts, 
    ScriptLanguageRecord *slRecordPtr
);
Parameter descriptions
ts

The component identifier of the input method text service component to be associated with the script and language combination given in the slRecord parameter.

slRecordPtr

A pointer to a script-language structure that describes the script and language combination to be associated with the input method text service component specified in the ts parameter.

function result

A result code. If the script code and language code specified in the script-language structure are incompatible, SetDefaultInputMethod returns the error paramErr.

DISCUSSION

The operating system uses SetDefaultInputMethod to associate an input method text service component with a given script and language. The operating system calls this function when the user expresses input method preferences through the Keyboard menu, Keyboard control panel, or other device. The associations made with this function are permanent; that is, they persist after restart.

You can use the text service component function GetScriptLanguageSupport to determine which additional scripts and languages a text service component supports.

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)