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

       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.

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

popup_dialog(3alleg4),     init_dialog(3alleg4),    centre_dialog(3alleg4),    set_dialog_color(3alleg4),
       find_dialog_focus(3alleg4), excustom(3alleg4), exgui(3alleg4), exrgbhsv(3alleg4)

Allegro                                           version 4.4.3                               do_dialog(3alleg4)

#include<allegro.h>intdo_dialog(DIALOG*dialog,intfocus_obj);