1al_popup_menu(3) al_popup_menu(3)
2
3
4
6 al_popup_menu - Allegro 5 API
7
9 #include <allegro5/allegro_native_dialog.h>
10
11 bool al_popup_menu(ALLEGRO_MENU *popup, ALLEGRO_DISPLAY *display)
12
14 Displays a context menu next to the mouse cursor. The menu must have
15 been created with al_create_popup_menu(3). It generates events just
16 like a regular display menu does. It is possible that the menu will be
17 canceled without any selection being made.
18
19 The display parameter indicates which window the menu is associated
20 with (when you process the menu click event), but does not actually af‐
21 fect where the menu is located on the screen.
22
23 Returns true if the context menu was displayed.
24
25 Note: On Linux this function will fail if any of the mouse keys
26 are held down. I.e. it will only reliably work if you handle
27 it in ALLEGRO_MOUSE_BUTTON_UP events and even then only if that
28 event corresponds to the final mouse button that was pressed.
29
31 5.1.0
32
34 al_create_popup_menu(3)
35
36
37
38Allegro reference manual al_popup_menu(3)