al_show_na...essage_box(3)

🌸 NAME 🌸

okay so this is the al_show_na...essage_box(3) page from the Library Functions Manual, bestie, and the function we are hyping up is al_show_native_message_box — Allegro 5 API. ✨

✨ SYNOPSIS ✨

              #include <allegro5/allegro_native_dialog.h>

              int al_show_native_message_box(ALLEGRO_DISPLAY *display,
                 char const *title, char const *heading, char const *text,
                 char const *buttons, int flags)

🎀 DESCRIPTION 🎀

Show a native GUI message box. This can be used for example to display an error message if creation of an initial display fails. Iconic little emergency-exit energy, no cap. 💅

The display may be NULL, otherwise the given display is treated as the parent if possible.

The message box will have a single “OK” button and use the style informative dialog boxes usually have on the native system. If the buttons parameter is not NULL, you can instead specify the button text in a string, with buttons separated by a vertical bar (|). Custom button string moment, iykyk.

Note: the buttons parameter is currently unimplemented on Windows. 💀

🚩 The flags available are 🚩

• ALLEGRO_MESSAGEBOX_WARN — the message is a warning. This may cause a different icon (or other effects).
• ALLEGRO_MESSAGEBOX_ERROR — the message is an error.
• ALLEGRO_MESSAGEBOX_QUESTION — the message is a question.
• ALLEGRO_MESSAGEBOX_OK_CANCEL — display a cancel button alongside the “OK” button. Ignored if buttons is not NULL.
• ALLEGRO_MESSAGEBOX_YES_NO — display Yes/No buttons instead of the “OK” button. Ignored if buttons is not NULL.

al_show_native_message_box(3) may be called without Allegro being installed. This is useful to report an error during initialisation of Allegro itself. Literally the “help, I am not even born yet” button, bestie. 🫶

💖 Returns 💖

• 0 if the dialog window was closed without activating a button.
• 1 if the OK or Yes button was pressed.
• 2 if the Cancel or No button was pressed.

If buttons is not NULL, the number of the pressed button is returned, starting with 1.

All of the remaining parameters must not be NULL. Do not test this one, bestie — it is giving undefined chaos. 😭

If a message box could not be created then this returns 0, as if the window was dismissed without activating a button.

🌟 Example 🌟

              int button = al_show_native_message_box(
                display,
                "Warning",
                "Are you sure?",
                "If you click yes then you are confirming that \"Yes\" "
                "is your response to the query which you have "
                "generated by the action you took to open this "
                "message box.",
                NULL,
                ALLEGRO_MESSAGEBOX_YES_NO
              );

---

mwah 💋 — from the Allegro reference manual, al_show_na...essage_box(3); no date is printed on this footer bestie. 🫶