1al_insert_menu_item(3)                                  al_insert_menu_item(3)
2
3
4

NAME

6       al_insert_menu_item - Allegro 5 API
7

SYNOPSIS

9              #include <allegro5/allegro_native_dialog.h>
10
11              int al_insert_menu_item(ALLEGRO_MENU *parent, int pos, char const *title,
12                 uint16_t id, int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu)
13

DESCRIPTION

15       Inserts  a  menu item at the spot specified.  See the introductory text
16       for a detailed explanation of how the pos parameter is interpreted.
17
18       The parent menu can be a popup menu or a regular  menu.   To  underline
19       one character in the title, prefix it with an ampersand.
20
21       The flags can be any combination of:
22
23       ALLEGRO_MENU_ITEM_DISABLED
24              The item is “grayed out” and cannot be selected.
25
26       ALLEGRO_MENU_ITEM_CHECKBOX
27              The  item is a check box.  This flag can only be set at the time
28              the menu is created.  If a check box is clicked, it  will  auto‐
29              matically be toggled.
30
31       ALLEGRO_MENU_ITEM_CHECKED
32              The  item  is  checked.  If set, ALLEGRO_MENU_ITEM_CHECKBOX will
33              automatically be set as well.
34
35       The icon is not yet supported.
36
37       The submenu parameter indicates that this item contains a  child  menu.
38       The  child  menu must have previously been created with al_create_menu,
39       and not be associated with any other menu.
40
41       Returns true on success.
42

SINCE

44       5.1.0
45

SEE ALSO

47       al_append_menu_item(3), al_remove_menu_item(3)
48
49
50
51Allegro reference manual                                al_insert_menu_item(3)
Impressum