Inside Macintosh: Telephony /

Chapter 1 - Introduction to Telephony on the Macintosh / Telephone Manager Initialization Reference

Telephone Manager Initialization Functions

Configuring a Telephone Tool Through a Custom Interface

Your application can create a custom tool-settings dialog box and present it to the user using the functions described in this section. Creating a custom tool-settings dialog box is more difficult than using the standard tool-settings dialog box supplied through the TELChoose function, but can provide some additional flexibility.

When designing your configuration interface, you must design a tool-settings dialog box that presents the user with a list of all available telephone tools. You must then access the dialog item list provided by the telephone tool by using the handle returned by the TELSetupPreflight function. You then need to append the items from the list to your custom tool-settings dialog box. After you have performed the basic setup for the dialog box, you use the TELSetupSetup function to set the controls and the TELSetupFilter and TELSetupItem functions to filter and implement events handled by the telephone tool. Finally, you use the TELSetupCleanup and TELSetupPostflight function to perform any cleanup operations and to close the telephone tool file.

Note

The functions described in this section are designed to be used in the same manner as the functions described in Inside the Macintosh Communications Toolbox. You should consult that book to see how to use the CRMGetIndToolName function to determine how to create a list of telephone tools in your custom tool-settings dialog box.

---

Subtopics

TELSetupPreflight

TELSetupSetup

TELSetupFilter

TELSetupItem

TELSetupCleanup

TELSetupXCleanup

TELSetupPostflight