NAME¶

ALLEGRO_MENU_INFO - Allegro 5 API

SYNOPSIS¶

#include <allegro5/allegro_native_dialog.h>
typedef struct ALLEGRO_MENU_INFO {
    

DESCRIPTION¶

A structure that defines how to create a complete menu system. For standard menu items, the following format is used:

   { caption, id, flags, icon }
    

For special items, these macros are helpful:

ALLEGRO_START_OF_MENU(caption, id)
ALLEGRO_MENU_SEPARATOR
ALLEGRO_END_OF_MENU
    

A well-defined menu will begin with ALLEGRO_START_OF_MENU, contain one or more menu items, and end with ALLEGRO_END_OF_MENU. A menu may contain sub-menus. An example:

ALLEGRO_MENU_INFO menu_info[] = {


   ALLEGRO_START_OF_MENU("&File", 1),


      { "&Open", 2, 0, NULL },


      ALLEGRO_START_OF_MENU("Open &Recent...", 3),


         { "Recent 1", 4, 0, NULL },


         { "Recent 2", 5, 0, NULL },


         ALLEGRO_END_OF_MENU,


      ALLEGRO_MENU_SEPARATOR,


      { "E&xit", 6, 0, NULL },


      ALLEGRO_END_OF_MENU,


   ALLEGRO_START_OF_MENU("&Help", 7),


      {"&About", 8, 0, NULL },


      ALLEGRO_END_OF_MENU,


   ALLEGRO_END_OF_MENU
};
ALLEGRO_MENU *menu = al_build_menu(menu_info);
    

If you prefer, you can build the menu without the structure by using al_create_menu(3) and al_insert_menu_item(3).

SEE ALSO¶

al_build_menu(3)