al_popup_menu(3)

💖 NAME 💖

al_popup_menu(3) — this is the Allegro 5 API page for al_popup_menu. It lives in the Library Functions Manual, and bestie, it’s giving “context menu but make it official.” 💅

---

✨ SYNOPSIS ✨

#include <allegro5/allegro_native_dialog.h>

bool al_popup_menu(ALLEGRO_MENU *popup, ALLEGRO_DISPLAY *display)

---

🦋 DESCRIPTION 🦋

Okay so al_popup_menu displays a context menu right next to the mouse cursor. Slay. The menu must have been created with al_create_popup_menu(3) first — no improvising, bestie.

It generates events just like a regular display menu does. Iconic behavior, honestly. Also possible: the menu gets canceled without any selection being made. It happens, no cap. 😭

The display parameter indicates which window the menu is associated with — that matters when you process the menu click event — but it does not actually affect where the menu is located on the screen. So it’s not moving the menu around, it’s just telling you which window it’s tied to. Periodt. 💅

Returns true if the context menu was displayed. 🫶

Note: On Linux this function will fail if any of the mouse keys are held down. I.e. it will only reliably work if you handle it in ALLEGRO_MOUSE_BUTTON_UP events and even then only if that event corresponds to the final mouse button that was pressed. This is the caveat, bestie — read it twice. 💀

---

👑 SINCE 👑

5.1.0 — this one has been around since 5.1.0. Vintage but still cute. ✨

---

🌸 SEE ALSO 🌸

• al_create_popup_menu(3) — the one you need first, iykyk.

---

💖 That’s the whole page, bestie! Signing off from the Allegro reference manual — source/version: Allegro reference manual; date: literally not listed on the page, so I’m not inventing one, no cap 💀. al_popup_menu(3) out! 🫶