About placing items in the pop-up menus
Pop-up menus display menu items in a 3-by-3, 3-by-2, or 3-by-1 grid depending on the number of items. By default, the pop-up menu always includes an item to open the full menu. You can provide up to eight additional items. If you provide more than eight items, the additional items are not displayed. You can add additional items to the full menu instead.
The first item that you add to the vector of CommandItem elements is the default item in the pop-up menu. The default item appears highlighted in the center of the grid when the BlackBerry® device user opens the pop-up menu. The other items are positioned in the pop-up menu based on the order that you add them.
If the number of items that you add to the pop-up menu leaves empty cells in the grid, filler items are added to the menu. The first filler item is an option to switch applications. The second filler item is an option to return to the Home screen.