v7 man page for do_dialog

do_dialog(3alleg4)						  Allegro manual						do_dialog(3alleg4)

NAME

       do_dialog - Basic dialog manager function. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       int do_dialog(DIALOG *dialog, int focus_obj);

DESCRIPTION

       The basic dialog manager function. This displays a dialog (an array of dialog objects, terminated by one with a NULL dialog procedure), and
       sets the input focus to the focus_obj (-1 if you don't want anything to have the focus). It interprets user input and  dispatches  messages
       as  they  are  required, until one of the dialog procedures tells it to close the dialog, at which point it returns the index of the object
       that caused it to exit, or until ESC is pressed, at which point it returns -1.

SEE ALSO

       popup_dialog(3alleg4),  init_dialog(3alleg4),   centre_dialog(3alleg4),	 set_dialog_color(3alleg4),   find_dialog_focus(3alleg4),   excus-
       tom(3alleg4), exgui(3alleg4), exrgbhsv(3alleg4)

Allegro 							   version 4.4.2						do_dialog(3alleg4)