al_set_display_menu(3)

okay bestie, welcome to al_set_display_menu(3) — it’s from the Library Functions Manual and it’s part of the Allegro 5 API, so buckle up 💅✨

🌸 NAME 🌸

al_set_display_menu — Allegro 5 API 🎀

⭐ SYNOPSIS ⭐

#include <allegro5/allegro_native_dialog.h>

bool al_set_display_menu(ALLEGRO_DISPLAY *display, ALLEGRO_MENU *menu)

💖 DESCRIPTION 💖

Okay so this one associates the menu with the display and shows it. Main character behavior, honestly.

If there was a previous menu associated with the display, it will be destroyed. Yep, poof. If you don’t want that to happen, you should first remove the menu with al_remove_display_menu(3). Consider this your friendly warning 🫶

If the menu is already attached to a display, it will not be attached to the new display. And if menu is NULL, the current menu will still be destroyed. Not me double-checking that one 😭

⚠️ Note: Attaching a menu may cause the window as available to your application to be resized! You should listen for a resize event, check how much space was lost, and resize the window accordingly if you want to maintain your window’s prior size. This is important, bestie — the window can get rearranged on you.

Returns true if successful. Slay ✅

🌈 SINCE 🌈

5.1.0 — iconic since day one, periodt.

🦋 SEE ALSO 🦋

• al_create_menu(3)
• al_remove_display_menu(3)

---

That’s the whole vibe check, bestie 💖 source/version: Allegro reference manual; there’s no date printed on this page, so consider this your cute sign-off 🎀