d_menu_proc(3alleg4)

📦 version 4.4.3.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 d_menu_proc — the menu bar bestie 💖

okay so real talk, this is from the Allegro manual, section 3alleg4 — it's a dialog procedure, and it's literally the glow-up your dialog needs when you want a whole menu bar situation going on up top. 🌈

✨ SYNOPSIS ✨

#include <allegro.h>

int d_menu_proc(int msg, DIALOG *d, int c);

🎀 DESCRIPTION 🎀

So what is this? It's a menu bar object, bestie. The way that it drops down child menus when you click on it? Obsessed. And not just clicking — if you hit alt+key and that combo matches one of the shortcuts chillin' in the menu, it'll pop open too. Keyboard girlies are fed. 💅

ngl it ignores a lot of the fields in the dialog structure. Like, it's giving independent. Specifically:

  • the color is taken from the gui_*_color variables, not from you
  • the width and height are calculated automatically
heads up: the w and h fields from the DIALOG are only used as a minimum size. So don't think you're in charge, because you're not. 😭

Now, the dp field? It points to an array of menu structures — go check out do_menu() for more info on that, iykyk. 🦋

Here's the cute part: the top level menu shows up as a horizontal bar, slay. But when child menus drop down from it, they switch into the normal vertical format that do_menu() uses. Main character energy with range. 👑

And when a menu item gets selected, the return value from the menu callback function is passed right back to the dialog manager. So your callbacks should return one of these, no cap:

  • D_O_K
  • D_REDRAW
  • D_CLOSE

That's it, that's the vibe check. 🫶

🔥 SEE ALSO 🔥

Allegro version 4.4.3 — mwah, go build something iconic with it, bestie. 💖✨🎀🦋🌸

📦 where this page comes from