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(3alleg), init_dialog(3alleg), centre_dialog(3alleg),
set_dialog_color(3alleg), find_dialog_focus(3alleg), excustom(3alleg),
exgui(3alleg), exrgbhsv(3alleg)