navigator_anonymous_enum

Event codes for navigator service events.

Synopsis:

#include <bps/navigator.h>
 
 enum {
      NAVIGATOR_INVOKE = 0x01   
      NAVIGATOR_EXIT = 0x02   
      NAVIGATOR_WINDOW_STATE = 0x03   
      NAVIGATOR_SWIPE_DOWN = 0x04   
      NAVIGATOR_SWIPE_START = 0x05   
      NAVIGATOR_LOW_MEMORY = 0x06   
      NAVIGATOR_ORIENTATION_CHECK = 0x07   
      NAVIGATOR_ORIENTATION = 0x08   
      NAVIGATOR_BACK = 0x09   
      NAVIGATOR_WINDOW_ACTIVE = 0x0a   
      NAVIGATOR_WINDOW_INACTIVE = 0x0b   
      NAVIGATOR_ORIENTATION_DONE = 0x0c   
      NAVIGATOR_ORIENTATION_RESULT = 0x0d   
      NAVIGATOR_WINDOW_LOCK = 0x0e   
      NAVIGATOR_WINDOW_UNLOCK = 0x0f   
      NAVIGATOR_INVOKE_TARGET = 0x10   
      NAVIGATOR_INVOKE_QUERY_RESULT = 0x11   
      NAVIGATOR_INVOKE_VIEWER = 0x12   
      NAVIGATOR_OTHER = 0xff   
};

Data:

NAVIGATOR_INVOKE
Indicates that the application is a registered URL handler, and the navigator is invoking a URL type on the application.
For example, a web browser might need to handle http://... invoke request from another application, and load the website that is associated with the request.
NAVIGATOR_EXIT
Indicates that the user has quit the application, the device is rebooting, or some other event has occurred that results in the application needing to terminate.
After this type of event is received, the application has a short amount of time (3 seconds) to terminate itself. If the application has not terminated after this time has elapsed, the navigator terminates the application.
NAVIGATOR_WINDOW_STATE
Indicates that the state of the application window has changed.
For example, the application window might have changed to full screen from a thumbnail. The navigator_window_state_t enumeration defines the possible states that an application window can be in.
NAVIGATOR_SWIPE_DOWN
Indicates that the user has performed a downward swipe gesture from the top of the device screen.
By convention, this gesture displays a menu.
NAVIGATOR_SWIPE_START
Indicates that the user has started a swipe gesture.
This type of event is generated if the application has requested swipe start events by calling navigator_request_swipe_start(). For example, if an application calls navigator_request_swipe_start() and the user performs a downward swipe gesture from the top of the device screen, the application receives a NAVIGATOR_SWIPE_START event followed by a series of touch events. This functionality can be useful if the application wants to respond more appropriately to swipe gestures (for example, by displaying the menu in sync with the user's downward swipe gesture).
NAVIGATOR_LOW_MEMORY
Indicates that the device is low on memory.
To prevent degraded performance and a potentially poor user experience, an application should respond to this event by freeing any memory that it isn't using.
NAVIGATOR_ORIENTATION_CHECK
Indicates that the device has rotated.
An application should respond to this event by calling navigator_orientation_check_response() and indicating whether it intends to rotate along with the device rotation. If the application indicates that it intends to rotate, the navigator sends a follow-up NAVIGATOR_ORIENTATION event when it is time for the application to resize its screen.
NAVIGATOR_ORIENTATION
Indicates that an application should resize its screen in response to the rotation of the device.
This event is generated if the application has called navigator_orientation_check_response() and indicated that it intends to rotate. After the application is finished resizing its screen, the application should call navigator_done_orientation() to let the navigator know that the application is finished rotating.
NAVIGATOR_BACK
Indicates that the user has performed a swipe gesture from the bottom left of the device screen towards the top right.
NAVIGATOR_WINDOW_ACTIVE
Indicates that the application window has become active (for example, if the application window changes to full screen from being hidden).
NAVIGATOR_WINDOW_INACTIVE
Indicates that the application window has become inactive (for example, if the application window changes to hidden from being full screen).
NAVIGATOR_ORIENTATION_DONE
Indicates that the device has finished rotating.
NAVIGATOR_ORIENTATION_RESULT
Indicates that a request to change the orientation with navigator_set_orientation() has completed.
NAVIGATOR_WINDOW_LOCK
Indicates that the corporate or enterprise application is locked.
When locked, the window changes to a lock icon and cannot be used. To use the window again, the user must unlock it by touching the window and then typing a password.
NAVIGATOR_WINDOW_UNLOCK
Indicates that the corporate or enterprise application is unlocked.
When an application is first launched, it is considered unlocked. No message is sent whe the application starts.
NAVIGATOR_INVOKE_TARGET
Indicates an invocation for the target was received.
Application should retrieve invocation properties through navigator_invoke_event_get_invocation() method.
NAVIGATOR_INVOKE_QUERY_RESULT
Indicates an invocation query result was received.
Application should retrieve invocation query result through navigator_invoke_event_get_query_result() method.
NAVIGATOR_INVOKE_VIEWER
Indicates a viewer invocation was received.
Application should retrieve viewer invocation through navigator_invoke_event_get_query_result() method.
NAVIGATOR_OTHER
Indicates that the event is not any of the above event types.
It could be a custom event.

Library:

libbps

Description:

This enumeration defines the event codes for the types of events that the navigator service may return. Note that a reply is expected when your application receives a NAVIGATOR_ORIENTATION or NAVIGATOR_ORIENTATION_CHECK event. See the navigator_orientation_check_response() and navigator_done_orientation() functions for more information.