All Manuals > CAPI User Guide


11 Prompting for Input

A dialog is a window that receives some input from the user and returns it to the application. For instance, if the application wants to know where to save a file, it could prompt the user with a file dialog. Dialogs can also be cancelled, meaning that the application should cancel the current operation.

In order to let you know whether or not the dialog was cancelled, CAPI dialog functions always return two values. The first value is the return value itself, and the second value is t if the dialog returned normally and nil if the dialog was cancelled.

On Cocoa you can control whether a CAPI dialog is application-modal or window-modal. In the latter case the user can work with the application's other windows while the dialog is on screen.

The CAPI provides both a large set of predefined dialogs and the means to create your own. This chapter takes you through some example uses of the predefined dialogs, and then shows you how to create custom built dialogs.

The last section briefly describes a way to get input for completions via a special non-modal window.

11.1 Some simple dialogs

11.2 Prompting for values

11.3 Window-modal Cocoa dialogs

11.4 Dialog Owners

11.5 Creating your own dialogs

11.6 In-place completion

CAPI User Guide (Windows version) - 30 Aug 2011