.\" Automatically generated by Pandoc 2.2.1
.\"
.TH "al_set_display_menu" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_set_display_menu \- Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include\ <allegro5/allegro_native_dialog.h>

bool\ al_set_display_menu(ALLEGRO_DISPLAY\ *display,\ ALLEGRO_MENU\ *menu)
\f[]
.fi
.SH DESCRIPTION
.PP
Associates the \f[C]menu\f[] with the \f[C]display\f[] and shows it.
If there was a previous menu associated with the display, it will be
destroyed.
If you don't want that to happen, you should first remove the menu with
al_remove_display_menu(3alleg5).
.PP
If the menu is already attached to a display, it will not be attached to
the new display.
If \f[C]menu\f[] is \f[C]NULL\f[], the current menu will still be
destroyed.
.RS
.PP
\f[I]Note:\f[] 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's prior size.
.RE
.PP
Returns true if successful.
.SH SINCE
.PP
5.1.0
.SH SEE ALSO
.PP
al_create_menu(3alleg5), al_remove_display_menu(3alleg5)