.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "al_remove_menu_item" "3" "" "Allegro reference manual"
.SH NAME
al_remove_menu_item \- Allegro 5 API
.SH SYNOPSIS
.IP
.EX
#include \f[B]<allegro5/allegro_native_dialog.h>\f[R]

bool al_remove_menu_item(ALLEGRO_MENU *menu, int pos)
.EE
.SH DESCRIPTION
Removes the specified item from the menu and destroys it.
If the item contains a sub\-menu, it too is destroyed.
Any references to it are invalidated.
If you want to preserve that sub\-menu, you should first make a copy
with al_clone_menu(3).
.PP
This is safe to call on a menu that is currently being displayed.
.PP
Returns \f[CR]true\f[R] if an item was removed.
.SH SINCE
5.1.0
.SH SEE ALSO
al_append_menu_item(3), al_insert_menu_item(3), al_destroy_menu(3)