The Icon Menu is one of three menus in JUI. It acts similar to the home screens on Blackberry mobiles.

To add an Icon Menu add

iconmenu_t menu;

menu = iconmenu_create(component_count, components, icon_width, icon_height);

iconmenu_draw(&menu);

iconmenu_select(&menu, 0);

iconmenu_run(&menu);

iconmenu_create creates the iconmenu _t structure given the number of components, pointer to the components, and the with and height of each component.

iconmenu_draw clears and draws the menu on the screen, if you need to redraw at any point then you can just call this again.

iconmenu_select moves the selection cursor to the position specified, if you don't call this the cursor will not be show until the user moves the selection.

iconmenu_scroll moves the selection cursor by a specified amount forward (positive values) or backward (negative values).

iconmenu_up moves the selection cursor up one row.

iconmenu_down moves the selection cursor down one row.

iconmenu_right moves the selection cursor right one icon.

iconmenu_left moves the selection cursor left one icon.

iconmenu_run enters the main loop for the icon menu and does not return.