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



Allegro                           version 4.4.3               do_dialog(3alleg4)