al_remove_menu_item(3alleg5)

💖 al_remove_menu_item 💖

okay bestie, welcome to the Allegro 5 API corner of the manual, where we delete menu items and feel cute doing it 🎀

---

✨ NAME ✨

al_remove_menu_item — the Allegro 5 API function that yeets an item out of a menu, no cap 🗑️✨

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro_native_dialog.h>

bool al_remove_menu_item(ALLEGRO_MENU *menu, int pos)

so you include that header, and you get this lil bool-returning function. iconic signature tbh 💅

---

🦋 DESCRIPTION 🦋

okay so here's the tea ☕ — al_remove_menu_item removes the specified item from the menu and destroys it. gone. poof. 💀

and the way that it doesn't stop there… if the item you're removing contains a sub-menu, that sub-menu gets destroyed too 😭 the whole thing, sub-menu and all, is gone.

heads up bestie: any references to it are invalidated. like, do not touch them after this. they're ghosts now 👻

so if you actually want to keep that sub-menu alive, you should first make a copy with al_clone_menu(3alleg5). clone it first, then delete. that's the move 🫶

the good news? this is safe to call on a menu that is currently being displayed ✨ so you don't have to close anything down first, it just works while it's on screen.

and it returns true if an item was actually removed. slay ✅

---

⭐ SINCE ⭐

5.1.0 — she's been here since 5.1.0, a true veteran 👑

---

🌈 SEE ALSO 🌈

• al_append_menu_item(3alleg5) — for adding items instead of removing them 🍓
• al_insert_menu_item(3alleg5) — for sliding an item into a specific spot 🧚
• al_destroy_menu(3alleg5) — for when the whole menu has to go 💅

---

and that's the whole page, bestie!! this was the Allegro reference manual doing its thing, al_remove_menu_item, 5.1.0 energy, iykyk 💜