NAME

       al_popup_menu - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro_native_dialog.h>

              bool al_popup_menu(ALLEGRO_MENU *popup, ALLEGRO_DISPLAY *display)

DESCRIPTION

       Displays  a  context  menu next to the mouse cursor.  The menu must have been created with al_create_pop‐
       up_menu(3alleg5).  It generates events just like a regular display menu does.  It is  possible  that  the
       menu will be canceled without any selection being made.

       The display parameter indicates which window the menu is associated with (when you process the menu click
       event), but does not actually affect where the menu is located on the screen.

       Returns true if the context menu was displayed.

              Note: On Linux this function will fail if any of the mouse keys are held down.  I.e.  it will only
              reliably  work if you handle it in ALLEGRO_MOUSE_BUTTON_UP events and even then only if that event
              corresponds to the final mouse button that was pressed.

SINCE

       5.1.0

SEE ALSO

       al_create_popup_menu(3alleg5)

Allegro reference manual                                                                  al_popup_menu(3alleg5)