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

TELSetupItem

Instructs the telephone tool to process an event associated with a specified item in the custom tool-settings dialog box.

pascal void TELSetupItem (
                     short procID,
                     Ptr theConfig,
                     short count,
                     DialogPtr theDialog,
                     short *theItem,
                     long magicCookie);

procID

The tool ID for the telephone tool being configured.

theConfig

A pointer to the configuration field in the telephone record for the telephone tool being configured.

count

The number of the first item in the dialog item list that you appended to your custom tool settings dialog box.

theDialog

A pointer to the dialog box in which configuration is taking place.

theItem

The item selected by the user in the custom tool-settings dialog box.

magicCookie

A pointer to a reserved area of memory used by the telephone tool to pass relevant dialog items and configuration settings.

DESCRIPTION

The TELSetupItem function causes a telephone tool to process an event for the specified item. The tool ID is assigned for a telephone tool through the TELGetProcID function. The dialog item list is stored in a reserved area of memory specified by the magicCookie pointer assigned through the TELSetupPreflight function. You can determine the number of items in the dialog item list by using the CountDITL function described in Inside Macintosh: Macintosh Toolbox Essentials.