PATH Mac OS 8 and 9 Developer Documentation > Text Encoding Conversion Manager
Programming With the Text Encoding Conversion Manager

---

SetFallbackUnicodeToTextRun

Associates an application-defined fallback handler with a specific Unicode converter object for multiple text runs to be used with the function ConvertFromUnicodeToTextRun or ConvertFromUnicodeToScriptCodeRun.

iUnicodeToTextInfo

The Unicode converter object with which the fallback handler is to be associated. You use the function CreateUnicodeToTextRunInfo, CreateUnicodeToTextRunInfoByEncoding, or CreateUnicodeToTextRunInfoByScriptCode to obtain a Unicode converter object to specify for this parameter.

iFallback

A universal procedure pointer to the application-defined fallback routine. For a description of the function prototype that your fallback handler must adhere to, see UnicodeToTextFallbackProcPtr. For a description of how to create your own fallback handler, see MyUnicodeToTextFallbackProc. You should use the NewUnicodeToTextFallbackProc macro described in the discussion of the function SetFallbackUnicodeToText.

iControlFlags

Control flags that stipulate which fallback handler the Unicode Converter should call--the application-defined fallback handler or the default handler--if a fallback handler is required, and the sequence in which the Unicode Converter should call the fallback handlers if either can be used when the other fails or is unavailable. Control flags can also specify whether the application-defined fallback handler can move memory. See Fallback-Handler Control Flags .

iInfoPtr

The address of a block of memory to be passed to the application-defined fallback handler. The Unicode Converter passes this pointer to the application-defined fallback handler as the last parameter when it calls the fallback handler. Your application can use this block to store data required by your fallback handler whenever it is called. This is similar in use to a reference constant (refcon). If you don't need to use a memory block, specify NULL for this parameter.

function result

A result code. See Text Encoding Conversion Manager Result Codes in the chapter Basic Text Types Reference