|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object | +--net.rim.blackberry.api.menuitem.ApplicationMenuItemRepository
Contains the functionality necessary for registering
ApplicationMenuItem instances.
| Field Summary | ||
|
static long |
MENUITEM_ADDRESSBOOK_LIST
ApplicationMenuItem instances registered with this ID appear
when the address book is open in list mode. |
|
static long |
MENUITEM_ADDRESSCARD_EDIT
ApplicationMenuItem instances registered with this ID appear
when an address card is open in edit mode. |
|
static long |
MENUITEM_ADDRESSCARD_VIEW
ApplicationMenuItem instances registered with this ID appear
when an address card is open in view mode. |
|
static long |
MENUITEM_ALARM
ApplicationMenuItem instances registered with this ID appear
when the alarm application is running. |
|
static long |
MENUITEM_BROWSER
ApplicationMenuItem instances registered with this ID appear
when the browser application is running. |
|
static long |
MENUITEM_CALENDAR
ApplicationMenuItem instances registered with this ID appear
when the calendar is open in view mode. |
|
static long |
MENUITEM_CALENDAR_EVENT
ApplicationMenuItem instances registered with this ID appear
when a calendar event is open in view/edit mode. |
|
static long |
MENUITEM_CAMERA_PREVIEW
ApplicationMenuItem instances registered with this ID appear
when using the camera preview screen. |
|
static long |
MENUITEM_EMAIL_EDIT
ApplicationMenuItem instances registered with this ID appear
when the email application is open in edit mode. |
|
static long |
MENUITEM_EMAIL_VIEW
ApplicationMenuItem instances registered with this ID appear
when the email application is open in view mode. |
|
static long |
MENUITEM_FILE_EXPLORER
ApplicationMenuItem instances registered with this ID appear when the File Explorer application
is running. |
|
static long |
MENUITEM_FILE_EXPLORER_BROWSE
ApplicationMenuItem instances registered with this ID appear when a user uses the File Explorer application
to browse files and folders. |
|
static long |
MENUITEM_FILE_EXPLORER_ITEM
ApplicationMenuItem instances registered with this ID appear when a user uses the File Explorer application
to open a file. |
|
static long |
MENUITEM_GROUPADDRESS_EDIT
ApplicationMenuItem instances registered with this ID appear
when a group address entry is opened for edit. |
|
static long |
MENUITEM_GROUPADDRESS_VIEW
ApplicationMenuItem instances registered with this ID appear
when a group address entry is opened for viewing. |
|
static long |
MENUITEM_MAPS
ApplicationMenuItem instances registered with this ID appear
when the maps application is running. |
|
static long |
MENUITEM_MEMO_EDIT
ApplicationMenuItem instances registered with this ID appear
when a memo is opened for editing. |
|
static long |
MENUITEM_MEMO_LIST
ApplicationMenuItem instances registered with this ID appear
when the memo list is displayed. |
|
static long |
MENUITEM_MEMO_VIEW
ApplicationMenuItem instances registered with this ID appear
when a memo is opened for viewing. |
|
static long |
MENUITEM_MESSAGE_LIST
ApplicationMenuItem instances registered with this ID appear
when the message list is displayed. |
|
static long |
MENUITEM_MMS_EDIT
ApplicationMenuItem instances registered with this ID appear
when the MMS application is open in edit mode. |
|
static long |
MENUITEM_MMS_VIEW
ApplicationMenuItem instances registered with this ID appear
when the MMS application is open in view mode. |
|
static long |
MENUITEM_MUSIC_SERVICE_ITEM
ApplicationMenuItem instances registered with this ID appear in the services section
in the Music domain of the Media application. |
|
static long |
MENUITEM_PHONE
ApplicationMenuItem instances registered with this ID appear
when the phone application is running. |
|
static long |
MENUITEM_PHONELOG_VIEW
ApplicationMenuItem instances registered with this ID appear
when a call log is opened for viewing. |
|
static long |
MENUITEM_SEARCH
ApplicationMenuItem instances registered with this ID appear
when the search window is open. |
|
static long |
MENUITEM_SMS_EDIT
ApplicationMenuItem instances registered with this ID appear
when the SMS application is open in edit mode. |
|
static long |
MENUITEM_SMS_VIEW
ApplicationMenuItem instances registered with this ID appear
when the SMS application is open in view mode. |
|
static long |
MENUITEM_SYSTEM
ApplicationMenuItem instances registered with this ID appear
on most application menus (a system wide setting). |
|
static long |
MENUITEM_TASK_EDIT
ApplicationMenuItem instances registered with this ID appear
when a task is opened in view/edit mode. |
|
static long |
MENUITEM_TASK_LIST
ApplicationMenuItem instances registered with this ID appear
when the task list is displayed. |
|
static long |
MENUITEM_VIDEO_RECORDER
ApplicationMenuItem instances registered with this ID appear
when using the video recorder screen. |
|
static long |
MENUITEM_VIDEO_SERVICE_ITEM
ApplicationMenuItem instances registered with this ID appear in the services section
in the Video domain of the Media application. |
| Method Summary | ||
|
void |
addMenuItem(long id,
ApplicationMenuItem item)
Adds a menu item to the application menu. |
|
void |
addMenuItem(long id,
ApplicationMenuItem item,
ApplicationDescriptor application)
Adds a menu item to the application menu. |
|
void |
addMenuItem(long id,
ApplicationMenuItem item,
ApplicationDescriptor application,
Object context)
Adds a menu item to the application menu. |
|
static ApplicationMenuItemRepository |
getInstance()
Retrieves a handle to the systems application menu item repository. |
|
boolean |
removeMenuItem(long id,
ApplicationMenuItem item)
Removes a given item from a menu. |
| Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
public static final long MENUITEM_ADDRESSBOOK_LIST
ApplicationMenuItem instances registered with this ID appear
when the address book is open in list mode.
The ApplicationMenuItem.run(Object)
method is passed a Contact instance when
an application menu item is invoked in this context.
public static final long MENUITEM_ADDRESSCARD_EDIT
ApplicationMenuItem instances registered with this ID appear
when an address card is open in edit mode.
The ApplicationMenuItem.run(Object)
method is passed a Contact instance when
an application menu item is invoked in this context.
public static final long MENUITEM_ADDRESSCARD_VIEW
ApplicationMenuItem instances registered with this ID appear
when an address card is open in view mode.
The ApplicationMenuItem.run(Object)
method is passed a Contact instance when
an application menu item is invoked in this context.
public static final long MENUITEM_ALARM
ApplicationMenuItem instances registered with this ID appear
when the alarm application is running.public static final long MENUITEM_BROWSER
ApplicationMenuItem instances registered with this ID appear
when the browser application is running.public static final long MENUITEM_CALENDAR
ApplicationMenuItem instances registered with this ID appear
when the calendar is open in view mode.
The ApplicationMenuItem.run(Object)
method is passed a Event instance when
an application menu item is invoked in this context.
public static final long MENUITEM_CALENDAR_EVENT
ApplicationMenuItem instances registered with this ID appear
when a calendar event is open in view/edit mode.
The ApplicationMenuItem.run(Object)
method is passed a Event instance when
an application menu item is invoked in this context.
public static final long MENUITEM_CAMERA_PREVIEW
ApplicationMenuItem instances registered with this ID appear
when using the camera preview screen. An ApplicationDescriptor is required for this ID in addMenuItem() method.
The ApplicationMenuItem.run(Object)
method is passed a String representing the image file location when
an application menu item is invoked in this context. A typical string would have this format:
"file:///-path-.-filename-". The file can be opened by creating a FileConnection
using Connector.open(String).
public static final long MENUITEM_EMAIL_EDIT
ApplicationMenuItem instances registered with this ID appear
when the email application is open in edit mode.
The ApplicationMenuItem.run(Object)
method is passed a Message instance when
an application menu item is invoked in this context.
public static final long MENUITEM_EMAIL_VIEW
ApplicationMenuItem instances registered with this ID appear
when the email application is open in view mode.
The ApplicationMenuItem.run(Object)
method is passed a Message instance when
an application menu item is invoked in this context.
public static final long MENUITEM_FILE_EXPLORER
ApplicationMenuItem instances registered with this ID appear when the File Explorer application
is running. Registering an instance using this ID has the same effect as registering two otherwise identical
instances using MENUITEM_FILE_EXPLORER_BROWSE and MENUITEM_FILE_EXPLORER_ITEM. If you use this ID, you must
also provide an ApplicationDescriptor that describes
your application. Your application will be started to run the code in the ApplicationMenuItem.run()
method. You may also register a mime type String with your menu item as the context parameter.
If you do, your menu item will only appear when a file matching the registered mime type is in focus or being viewed.
The ApplicationMenuItem.run(Object)
method is passed a String instance (the path to the file), when
an application menu item is invoked in this context.
public static final long MENUITEM_FILE_EXPLORER_BROWSE
ApplicationMenuItem instances registered with this ID appear when a user uses the File Explorer application
to browse files and folders. If you use this ID, you must also provide an ApplicationDescriptor that describes
your application. When an application starts, the application invokes the ApplicationMenuItem.run()
method. You may also register a mime type String with your menu item as the context parameter. If you do, your menu item will only appear
when a file matching the registered mime type is in focus.
The ApplicationMenuItem.run(Object)
method is passed a String instance (the path to the file), when
an application menu item is invoked in this context.
public static final long MENUITEM_FILE_EXPLORER_ITEM
ApplicationMenuItem instances registered with this ID appear when a user uses the File Explorer application
to open a file. If you use this ID, you must also provide an ApplicationDescriptor that describes
your application. When an application starts, the application invokes the ApplicationMenuItem.run()
method. You may also register a mime type String with your menu item as the context parameter. If you do, your menu item will only appear
when a file matching the registered mime type is being viewed.
The ApplicationMenuItem.run(Object)
method is passed a String instance (the path to the file), when
an application menu item is invoked in this context.
public static final long MENUITEM_GROUPADDRESS_EDIT
ApplicationMenuItem instances registered with this ID appear
when a group address entry is opened for edit.public static final long MENUITEM_GROUPADDRESS_VIEW
ApplicationMenuItem instances registered with this ID appear
when a group address entry is opened for viewing.public static final long MENUITEM_MAPS
ApplicationMenuItem instances registered with this ID appear
when the maps application is running. An ApplicationDescriptor is required for this ID in addMenuItem() method.
The ApplicationMenuItem.run(Object)
method is passed a MapView instance when
an application menu item is invoked in this context.
public static final long MENUITEM_MEMO_EDIT
ApplicationMenuItem instances registered with this ID appear
when a memo is opened for editing.
The ApplicationMenuItem.run(Object)
method is passed a BlackBerryMemo instance when
an application menu item is invoked in this context.
public static final long MENUITEM_MEMO_LIST
ApplicationMenuItem instances registered with this ID appear
when the memo list is displayed.
The ApplicationMenuItem.run(Object)
method is passed a BlackBerryMemo instance when
an application menu item is invoked in this context.
public static final long MENUITEM_MEMO_VIEW
ApplicationMenuItem instances registered with this ID appear
when a memo is opened for viewing.
The ApplicationMenuItem.run(Object)
method is passed a BlackBerryMemo instance when
an application menu item is invoked in this context.
public static final long MENUITEM_MESSAGE_LIST
ApplicationMenuItem instances registered with this ID appear
when the message list is displayed.
The ApplicationMenuItem.run(Object)
method is passed a Message instance
or a TextMessage instance when
an application menu item is invoked in this context. If the selected message is a MMS message,
a MultipartMessage instance will be passed instead.
public static final long MENUITEM_MMS_EDIT
ApplicationMenuItem instances registered with this ID appear
when the MMS application is open in edit mode.
The ApplicationMenuItem.run(Object)
method is passed a MultipartMessage instance when
an application menu item is invoked in this context.
public static final long MENUITEM_MMS_VIEW
ApplicationMenuItem instances registered with this ID appear
when the MMS application is open in view mode.
The ApplicationMenuItem.run(Object)
method is passed a MultipartMessage instance when
an application menu item is invoked in this context.
public static final long MENUITEM_MUSIC_SERVICE_ITEM
ApplicationMenuItem instances registered with this ID appear in the services section
in the Music domain of the Media application.
The ApplicationMenuItem.run(Object) method
is invoked to launch the service or application.
public static final long MENUITEM_PHONE
ApplicationMenuItem instances registered with this ID appear
when the phone application is running.public static final long MENUITEM_PHONELOG_VIEW
ApplicationMenuItem instances registered with this ID appear
when a call log is opened for viewing.
The ApplicationMenuItem.run(Object)
method is passed a net.rim.blackberry.api.phone.phonelogs.PhoneLog instance when
an application menu item is invoked in this context.
public static final long MENUITEM_SEARCH
ApplicationMenuItem instances registered with this ID appear
when the search window is open.public static final long MENUITEM_SMS_EDIT
ApplicationMenuItem instances registered with this ID appear
when the SMS application is open in edit mode.
The ApplicationMenuItem.run(Object)
method is passed a TextMessage instance when
an application menu item is invoked in this context.
public static final long MENUITEM_SMS_VIEW
ApplicationMenuItem instances registered with this ID appear
when the SMS application is open in view mode.
The ApplicationMenuItem.run(Object)
method is passed a TextMessage instance when
an application menu item is invoked in this context.
public static final long MENUITEM_SYSTEM
ApplicationMenuItem instances registered with this ID appear
on most application menus (a system wide setting).
The ApplicationMenuItem.run(Object)
method is passed a context object that is appropriate to the application from
which the application menu item is invoked. For example, if it is invoked in
the mail application, the context object is a Message
instance.
public static final long MENUITEM_TASK_EDIT
ApplicationMenuItem instances registered with this ID appear
when a task is opened in view/edit mode.
The ApplicationMenuItem.run(Object)
method is passed a ToDo instance when
an application menu item is invoked in this context.
public static final long MENUITEM_TASK_LIST
ApplicationMenuItem instances registered with this ID appear
when the task list is displayed.
The ApplicationMenuItem.run(Object)
method is passed a ToDo instance when
an application menu item is invoked in this context.
public static final long MENUITEM_VIDEO_RECORDER
ApplicationMenuItem instances registered with this ID appear
when using the video recorder screen. An ApplicationDescriptor is required for this ID in addMenuItem() method.
The ApplicationMenuItem.run(Object)
method is passed a String representing the video image file location when
an application menu item is invoked in this context. A typical string would have this format:
"file:///-path-.-filename-". The file can be opened by creating a FileConnection
using Connector.open(String).
public static final long MENUITEM_VIDEO_SERVICE_ITEM
ApplicationMenuItem instances registered with this ID appear in the services section
in the Video domain of the Media application.
The ApplicationMenuItem.run(Object) method
is invoked to launch the service or application.
| Method Detail |
public void addMenuItem(long id,
ApplicationMenuItem item)
Note that if any of the following conditions are true then the menu item will not be added and this method will return normally.
item==nullitem.toString() returns nullitem.toString().trim().length() == 0item.toString() throws an exceptionApplicationDescriptor is required for the specified ID but is not provided (use one of the overloaded methods below instead)id - Repository ID.item - The item to add to the menu.ControlledAccessException - if access to the resource
of the specified id is forbidden by application control.
public void addMenuItem(long id,
ApplicationMenuItem item,
ApplicationDescriptor application)
Note that if any of the following conditions are true then the menu item will not be added and this method will return normally.
item==nullitem.toString() returns nullitem.toString().trim().length() == 0item.toString() throws an exceptionApplicationDescriptor is required for the specified ID but is not providedApplicationDescriptor is provided, but its module handle does not match the module handle for the application registering the menu itemid - Repository ID.item - The item to add to the menu.application - An ApplicationDescriptor that describes your application.
Required for certain repository IDs (see ID definitions for more information).ControlledAccessException - if access to the resource
of the specified id is forbidden by application control.
public void addMenuItem(long id,
ApplicationMenuItem item,
ApplicationDescriptor application,
Object context)
Note that if any of the following conditions are true then the menu item will not be added and this method will return normally.
item==nullitem.toString() returns nullitem.toString().trim().length() == 0item.toString() throws an exceptionApplicationDescriptor is required for the specified ID but is not providedApplicationDescriptor is provided, but its module handle does not match the module handle for the application registering the menu itemcontext provided is the wrong type of Object for the specified IDid - Repository ID.item - The item to add to the menu.application - An ApplicationDescriptor that describes your application.
Required for certain repository IDs (see ID definitions for more information).context - An object representing a context in which the menu item should be displayed. Only works with
certain repository IDs (see ID definitions for more information).ControlledAccessException - if access to the resource
of the specified id is forbidden by application control.public static ApplicationMenuItemRepository getInstance()
ControlledAccessException - if interprocess
communication (IPC) is forbidden by application control.
public boolean removeMenuItem(long id,
ApplicationMenuItem item)
id - The id of the ApplicationMenuItemRepository.item - The menu item to be removed; if null then this method
immediately returns false without doing anything.
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright 1999-2009 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.