Copyright 2010-2017 Obihai Technology, Inc.
144
Main Menu Customization
The Main Menu is the first menu that appears on the phone screen when the phone starts up, unless it is hidden by
default by configuration, in which case the user would press the 'Home' key to show/hide the Main Menu. In order to
use a customized Main Menu, you must enable the option
User Preferences
::
CustomMainMenu
and also
define a <MainMenu> XML in the parameter
Screen Item
::
MainMenu
.
As shown in the picture below (for OBi1062/1032), the Main Menu area occupies the screen area between the Title Bar
area at the top and the Soft Key area at the bottom.
The Main Menu can occupy the full width of the screen when the Line Key area is hidden. When the Line Key area is
visible, however, it is shown on top of the Main Menu if they overlap. In the <MainMenu> XML, you can use the macro
$sys.lines to check if the Line Keys is visible ("1" means visible and "0" means not). You may specify the position and
dimension of the Main Menu with the usual four attributes of the <MainMenu> element: xpos, ypos, width, and height.
The pair (xpos, ypos) specifies the upper left corner of the Main Menu; the value (0, 0) coincides with the lower left
corner of the Title Bar Area.
The Main Menu is made up of a 2-dimensional array of items with a fixed number of columns based on configuration
and a number of rows based on the total number of visible items in the menu. When the number of rows exceeds what
the screen can show at one time, user can scroll up/down to view the other pages of menu items. Each item occupies a
small rectangular area with the same pixel dimension that is represented by the cell-width and cell-height attributes of
480
Title Bar Area
34
Soft Key Area
34
272
204
Main Menu Area
Line Key Area
(
xpos
,
ypos
)
width
height
Line Key Area
Line Key Area
160
cell-width
cell-height
ncol
=
‘
4
’
