do_dialog(3)

🌸 do_dialog(3) — the vibe ✨

okay bestie, welcome to the do_dialog(3) page, aka the Allegro manual's own basic dialog manager. It's giving "make the dialog happen" energy, and we're gonna get you all the deets without losing a single crumb. 🫶

✨ NAME ✨

do_dialog — the basic dialog manager function from the Allegro game programming library. 💅

🦋 SYNOPSIS 🦋

#include <allegro.h>

int do_dialog(DIALOG *dialog, int focus_obj);

💖 DESCRIPTION 💖

So, do_dialog is the basic dialog manager function. It displays a dialog — which is an array of dialog objects, terminated by one with a NULL dialog procedure — and it sets the input focus to focus_obj. If you don't want anything to have the focus, pass -1. no cap, that's the move.

Then it interprets user input and dispatches messages as they are required. It keeps doing that until one of the dialog procedures tells it to close the dialog. At that point, do_dialog returns the index of the object that caused it to exit. 👑

OR, if ESC is pressed, it returns -1. That's the emergency exit, bestie. 🚪💨

🌈 SEE ALSO 🌈

• popup_dialog(3)
• init_dialog(3)
• centre_dialog(3)
• set_dialog_color(3)
• find_dialog_focus(3)
• excustom(3)
• exgui(3)
• exrgbhsv(3)

mwah 💋 that's the page, bestie. Footer sign-off: Allegro manual, version 4.4.3, page do_dialog(3). The footer didn't give a date, so we're not making one up — periodt. ✨