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), excustom(3alleg4), exgui(3alleg4),
       exrgbhsv(3alleg4)