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

bool al_set_display_menu(ALLEGRO_DISPLAY *display, ALLEGRO_MENU *menu)
.EE
.SH DESCRIPTION
Associates the \f[CR]menu\f[R] with the \f[CR]display\f[R] and shows it.
If there was a previous menu associated with the display, it will be
destroyed.
If you don\[cq]t want that to happen, you should first remove the menu
with al_remove_display_menu(3).
.PP
If the menu is already attached to a display, it will not be attached to
the new display.
If \f[CR]menu\f[R] is \f[CR]NULL\f[R], the current menu will still be
destroyed.
.RS
.PP
\f[I]Note:\f[R] Attaching a menu may cause the window as available to
your application to be resized!
You should listen for a resize event, check how much space was lost, and
resize the window accordingly if you want to maintain your window\[cq]s
prior size.
.RE
.PP
Returns true if successful.
.SH SINCE
5.1.0
.SH SEE ALSO
al_create_menu(3), al_remove_display_menu(3)