/**
* Add a new menu item to the Options Menu associated to this screen.
* Platform: Android.
* Option Menus are Android specific concept. The Options Menu is launched by
* pressing the Menu key. The options menu is where you should include
* actions and other options that are relevant to the current activity
* context, such as "Search," "Compose email," or "Settings".
* When opened, the first visible portion is the icon menu, which holds
* up to six menu items. If your menu includes more than six items, Android
* places the sixth item and the rest into the overflow menu, which the user
* can open by selecting More. Those items do not display icons. On Windows
* Phone 7 the control used is the application bar.
*
* @param title The title associated for the new item. Can be left null.
* @param resourceIconID The resource id of an icon loaded into resources.
*
* @return The index on which the menu item was added in the options menu,
* an error code otherwise.
*/
int Screen::addOptionsMenuItem(const MAUtil::String title, int resourceIconID)
{
char buf[BUF_MAX];
sprintf(buf, "%d", resourceIconID);
return maWidgetScreenAddOptionsMenuItem(
getWidgetHandle(), title.c_str(), buf, 0 );
}
/**
* Add a new menu item to the Options Menu associated to this screen.
* Platform: Android and WP7.
* Option Menus are Android specific concept. The Options Menu is launched by
* pressing the Menu key. The options menu is where you should include
* actions and other options that are relevant to the current activity
* context, such as "Search," "Compose email," or "Settings".
* When opened, the first visible portion is the icon menu, which holds
* up to six menu items. If your menu includes more than six items, Android
* places the sixth item and the rest into the overflow menu, which the user
* can open by selecting More. Those items do not display icons. On Windows
* Phone 7 the control used is the application bar.
*
* @param title The title associated for the new item. Can be left null.
* @param icon The id of an icon from the Android and WP7 predefined icon set,
* these can be found under the OptionsMenuIconConstants group, or the name of
* the icon file (works only for WP7).
* @param isPath If true, indicates that the icon is based on the path, otherwise
* it is one of the predefined icon constants.
*
* Note: For Windows phone 7 the option menu icons must be added under the following folder
* structure "/ApplicationBarIcons/". By using this function you will obtain an
* application bar icon button (text + icon). Note that only 4 buttons are
* visible on an application bar. If you exceed this limit the option menu
* items will be added as application bar menu items on WP7.
*
* @return The index on which the menu item was added in the options menu,
* an error code otherwise.
*/
int Screen::addOptionsMenuItem(
const MAUtil::String title, const MAUtil::String icon, bool isPath)
{
if(isPath)
{
char platform[BUF_MAX];
maGetSystemProperty("mosync.device.OS", platform, BUF_MAX);
if(strcmp(platform, "Android") == 0)
return MAW_RES_ERROR;
else
{
return maWidgetScreenAddOptionsMenuItem(
getWidgetHandle(), title.c_str(), icon.c_str(), 0 );
}
}
else return maWidgetScreenAddOptionsMenuItem(
getWidgetHandle(), title.c_str(), icon.c_str(), 1 );
}
/**
* Add a new menu item to the Options Menu associated to this screen.
* Option Menus are Android specific concept, so this function is
* available only on this platform. The Options Menu is launched by
* pressing the Menu key. The options menu is where you should include
* actions and other options that are relevant to the current activity
* context, such as "Search," "Compose email," or "Settings".
* When opened, the first visible portion is the icon menu, which holds
* up to six menu items. If your menu includes more than six items, Android
* places the sixth item and the rest into the overflow menu, which the user
* can open by selecting More. Those items do not display icons.
* @param title The title associated for the new item. Can be left null.
* @param iconId The resource ID of the icon which will be used to lazily
* get the Drawable when this item is being shown. Can be set to -1 if
* no icon needed.
* @param iconPredefined Specifies if the icon is a project resource, or one
* of the predefined Android icons. It is false by default.
* @return The index on which the menu item was added in the options menu,
* an error code otherwise.
*/
int Screen::addOptionsMenuItem(const MAUtil::String title, int iconId, bool iconPredefined)
{
return maWidgetScreenAddOptionsMenuItem(
getWidgetHandle(), title.c_str(), iconId, (iconPredefined ? 1 : 0) );
}
/**
* Add a new menu item to the Options Menu associated to this screen.
* Platform: Android and WP7.
* Option Menus are Android specific concept. The Options Menu is launched by
* pressing the Menu key. The options menu is where you should include
* actions and other options that are relevant to the current activity
* context, such as "Search," "Compose email," or "Settings".
* When opened, the first visible portion is the icon menu, which holds
* up to six menu items. If your menu includes more than six items, Android
* places the sixth item and the rest into the overflow menu, which the user
* can open by selecting More. Those items do not display icons. On Windows
* Phone 7 the control used is the application bar.
*
* @param title The title associated for the new item.
*
* Note: On Windows phone 7, by using this function you will obtain an
* application bar menu item (text only)
*
* @return The index on which the menu item was added in the options menu,
* an error code otherwise.
*/
int Screen::addOptionsMenuItem(const MAUtil::String title)
{
return maWidgetScreenAddOptionsMenuItem(
getWidgetHandle(), title.c_str(), "", 0 );
}
