al_insert_menu_item(3)

okay bestie, welcome to al_insert_menu_item(3) — that’s the title, and it lives in the Library Functions Manual as part of the Allegro 5 API. Buckle up, we’re inserting menu items with main character energy. 💅

🌸 NAME 🌸

al_insert_menu_item — Allegro 5 API. The whole vibe is “insert a menu item,” no cap. 💖

✨ SYNOPSIS ✨

#include <allegro5/allegro_native_dialog.h>

int al_insert_menu_item(ALLEGRO_MENU *parent, int pos, char const *title,
   uint16_t id, int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu)

🎀 DESCRIPTION 🎀

Inserts a menu item at the spot specified. See the introductory text for a detailed explanation of how the pos parameter is interpreted. 👀

The parent menu can be a popup menu or a regular menu. To underline one character in the title, prefix it with an ampersand. 🖍️

The flags can be any combination of:

• ALLEGRO_MENU_ITEM_DISABLED — the item is “grayed out” and cannot be selected. 💀
• ALLEGRO_MENU_ITEM_CHECKBOX — the item is a check box. This flag can only be set at the time the menu is created. If a check box is clicked, it will automatically be toggled. ✅
• ALLEGRO_MENU_ITEM_CHECKED — the item is checked. If set, ALLEGRO_MENU_ITEM_CHECKBOX will automatically be set as well. ☑️

The icon is not yet supported. 🙈

The submenu parameter indicates that this item contains a child menu. The child menu must have previously been created with al_create_menu, and not be associated with any other menu. 🧚

Returns the index at which the item was inserted (which can be different than what is implied by pos), or -1 if there was an error. 🔥

🌈 SINCE 🌈

5.1.0 — vintage but still iconic. 👑

🦋 SEE ALSO 🦋

• al_append_menu_item(3)
• al_remove_menu_item(3)

---

Cute sign-off time: source/version line is the Allegro reference manual, and the original footer didn’t list a separate date, so there’s no date to report — no cap. That’s the page, bestie! 💖✨🎀