al_win_add...w_callback(3)

✨ NAME ✨

al_win_add_window_callback - Allegro 5 API

okay so bestie, this page is al_win_add...w_callback(3) from the Library Functions Manual, and it's literally all about adding a callback to a Windows display window. 💻✨

🌸 SYNOPSIS 🌸

              #include <allegro5/allegro_windows.h>

              bool al_win_add_window_callback(ALLEGRO_DISPLAY *display,
                 bool (*callback)(ALLEGRO_DISPLAY *display, UINT message, WPARAM wparam,
                 LPARAM lparam, LRESULT *result, void *userdata), void *userdata)

💅 DESCRIPTION 💅

The specified callback function is gonna intercept the window’s message before Allegro processes it. 👀 If the callback function consumes the event, then it should return true — and in that case, Allegro will not do anything with the event. periodt.

Optionally, you may use result to customize what Allegro will return in response to this event. By default, Allegro returns TRUE. 🫶

The userdata pointer can be used to supply additional context to the callback function. 🎀

The callbacks are executed in the same order they were added — first in, first served, no cap. 🔥

Returns true if the callback was added. ✅

⭐ SINCE ⭐

5.1.2 — vintage-ish but still iconic. 💖

---

— from the Allegro reference manual 🫶 · al_win_add...w_callback(3) · date/version not listed on this footer, bestie 💖