Android - An Open Handset Alliance Project

android.app.LauncherActivity

Android - An Open Handset Alliance Project

Documentation

Goodies

android.app.LauncherActivity

Summary

Summary

Public Constructors

Protected Methods

Public Constructors

Protected Methods

Constants inherited from class android.app.Activity

Constants inherited from class android.content.Context

Methods inherited from class android.app.ListActivity

Methods inherited from class android.app.Activity

Methods inherited from class android.app.ApplicationContext

Constants inherited from class android.app.Activity

Constants inherited from class android.content.Context

Methods inherited from class android.app.ListActivity

Methods inherited from class android.app.Activity

Methods inherited from class android.app.ApplicationContext

android.app
public abstract class

Displays a list of all activities which can be performed for a given intent. Launches when clicked.

DIALER_DEFAULT_KEYS, DISABLE_DEFAULT_KEYS, FOCUSED_STATE_SET, RESULT_CANCELED, RESULT_FIRST_USER, RESULT_OK, SEARCH_DEFAULT_KEYS, SHORTCUT_DEFAULT_KEYS

			Value
int	DIALER_DEFAULT_KEYS	Use with setDefaultKeyMode(int) to launch the dialer during default key handling.	1	0x00000001
int	DISABLE_DEFAULT_KEYS	Use with setDefaultKeyMode(int) to turn off default handling of keys.	0	0x00000000
int[]	FOCUSED_STATE_SET
int	RESULT_CANCELED	Standard activity result: operation canceled.	0	0x00000000
int	RESULT_FIRST_USER	Start of user-defined activity results.	1	0x00000001
int	RESULT_OK	Standard activity result: operation succeeded.	-1	0xffffffff
int	SEARCH_DEFAULT_KEYS	Use with setDefaultKeyMode(int) to specify that unhandled keystrokes will start a search.	3	0x00000003
int	SHORTCUT_DEFAULT_KEYS	Use with setDefaultKeyMode(int) to execute a menu shortcut in default key handling.	2	0x00000002

ACTIVITY_SERVICE, ALARM_SERVICE, BIND_AUTO_CREATE, BIND_DEBUG_UNBIND, CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, INFLATE_SERVICE, KEYGUARD_SERVICE, LOCATION_SERVICE, MODE_APPEND, MODE_PRIVATE, MODE_WORLD_READABLE, MODE_WORLD_WRITEABLE, NOTIFICATION_SERVICE, POWER_SERVICE, SEARCH_SERVICE, WINDOW_SERVICE

			Value
String	ACTIVITY_SERVICE	Use with getSystemService(String) to retrieve a ActivityManager for interacting with the global system state.	"activity"
String	ALARM_SERVICE	Use with getSystemService(String) to retrieve a AlarmManager for receiving intents at a time of your choosing.	"alarm"
int	BIND_AUTO_CREATE	Flag for bindService(Intent, ServiceConnection, int): automatically create the service as long as the binding exists.	1	0x00000001
int	BIND_DEBUG_UNBIND	Flag for bindService(Intent, ServiceConnection, int): include debugging help for mismatched calls to unbind.	2	0x00000002
int	CONTEXT_IGNORE_SECURITY	Flag for use with createPackageContext(String, int): ignore any security restrictions on the Context being requested, allowing it to always be loaded.	2	0x00000002
int	CONTEXT_INCLUDE_CODE	Flag for use with createPackageContext(String, int): include the application code with the context.	1	0x00000001
String	INFLATE_SERVICE	Use with getSystemService(String) to retrieve a ViewInflate for inflating layout resources in this context.	"inflate"
String	KEYGUARD_SERVICE	Use with getSystemService(String) to retrieve a NotificationManager for controlling keyguard.	"keyguard"
String	LOCATION_SERVICE	Use with getSystemService(String) to retrieve a LocationManager for controlling location updates.	"location"
int	MODE_APPEND	File creation mode: for use with openFileOutput(String, int), if the file already exists then write data to the end of the existing file instead of erasing it.	32768	0x00008000
int	MODE_PRIVATE	File creation mode: the default mode, where the created file can only be accessed by the calling application (or all applications sharing the same user ID).	0	0x00000000
int	MODE_WORLD_READABLE	File creation mode: allow all other applications to have read access to the created file.	1	0x00000001
int	MODE_WORLD_WRITEABLE	File creation mode: allow all other applications to have write access to the created file.	2	0x00000002
String	NOTIFICATION_SERVICE	Use with getSystemService(String) to retrieve a NotificationManager for informing the user of background events.	"notification"
String	POWER_SERVICE	Use with getSystemService(String) to retrieve a PowerManager for controlling power management, including "wake locks," which let you keep the device on while you're running long tasks.	"power"
String	SEARCH_SERVICE	Use with getSystemService(String) to retrieve a SearchManager for handling searches.	"search"
String	WINDOW_SERVICE	Use with getSystemService(String) to retrieve a ViewManager for accessing the system's window manager.	"window"

LauncherActivity()

abstract	Intent	getTargetIntent()
	void	onCreate(Bundle icicle)
		Called when the activity is starting.
	void	onListItemClick(ListView l, View v, int position, long id)
		This method will be called when an item in the list is selected.

getListAdapter, getListView, getSelectedItemId, getSelectedItemPosition, onCompleteThaw, onContentChanged, onKeyDown, onListItemClick, setListAdapter, setSelection

				ListAdapter	getListAdapter()
					Get the ListAdapter addociated with this acticity's ListView.
				ListView	getListView()
					Get the activity's list view widget.
				long	getSelectedItemId()
					Get the cursor row ID of the currently selected list item.
				int	getSelectedItemPosition()
					Get the position of the currently selected list item.
				void	onCompleteThaw(Bundle state)
					Ensures the list view has been created before Activity restores all of the view states.
				void	onContentChanged()
					Updates the screen state (current list and other views) when the content changes.
				boolean	onKeyDown(int keyCode, KeyEvent event)
					Called when a key was pressed down and not handled by any of the views inside of the activity.
				void	onListItemClick(ListView l, View v, int position, long id)
					This method will be called when an item in the list is selected.
				void	setListAdapter(ListAdapter adapter)
					Provide the cursor for the list view.
				void	setSelection(int position)
					Set the currently selected list item to the specified position with the adapter's data

addContentView, applyThemeResource, closeOptionsMenu, createActivityPendingResult, dispatchKeyEvent, dispatchTouchEvent, dispatchTrackballEvent, finalize, findViewById, finish, finishSubActivity, finishSubActivityFromChild, getApplication, getCallingActivity, getCallingPackage, getComponentName, getCurrentFocus, getInstanceCount, getIntent, getLocalClassName, getParent, getPreferences, getSystemService, getTaskId, getTitle, getTitleColor, getViewInflate, getWindow, getWindowManager, isEmbedded, isFinishing, isFullscreenOpaque, isTaskRoot, managedCommitUpdates, managedQuery, moveTaskBackwards, moveTaskToBack, onActivityResult, onChildTitleChanged, onCompleteThaw, onConfigurationChanged, onContentChanged, onContextItemSelected, onContextMenuClosed, onCreate, onCreateDescription, onCreateOptionsMenu, onCreatePanelMenu, onCreatePanelView, onCreateThumbnail, onDestroy, onFreeze, onKeyDown, onKeyMultiple, onKeyUp, onMenuItemSelected, onNewIntent, onOptionsItemSelected, onOptionsMenuClosed, onPanelClosed, onPause, onPostCreate, onPostResume, onPrepareOptionsMenu, onPreparePanel, onRestart, onResume, onSearchRequested, onStart, onStop, onTitleChanged, onTouchEvent, onTrackballEvent, onWindowAttributesChanged, onWindowFocusChanged, openOptionsMenu, requestWindowFeature, runOnUIThread, setContentView, setContentView, setContentView, setDefaultKeyMode, setFeatureDrawable, setFeatureDrawableAlpha, setFeatureDrawableResource, setFeatureDrawableUri, setIntent, setPersistent, setProgress, setProgressBarIndeterminate, setProgressBarVisibility, setResult, setResult, setResult, setSecondaryProgress, setTitle, setTitle, setTitleColor, startActivity, startActivityFromChild, startManagingCursor, startSearch, startSubActivity, startSubActivityIfNeeded, stopManagingCursor, takeKeyEvents

applyThemeResource, bindService, broadcastIntent, broadcastIntent, broadcastIntent, broadcastIntentSerialized, broadcastStickyIntent, checkCallingOrSelfPermission, checkCallingPermission, checkPermission, clearWallpaper, closeExternalStorageFiles, createDatabase, createPackageContext, deleteDatabase, deleteFile, fileList, finalize, getAssets, getClassLoader, getContentResolver, getDatabasePath, getDir, getFileStreamPath, getFilesDir,

java.lang.Object

android.content.Context

android.app.ApplicationContext

ViewInflate.Factory

android.app.Activity

KeyEvent.Callback Window.Callback

android.app.ListActivity

android.app.LauncherActivity

		void	addContentView(View view, LayoutParams params)
			Add an additional content view to the activity.
		void	applyThemeResource(Theme theme, int resid, boolean first)
			Called by setTheme(int) and getTheme() to apply a theme resource to the current Theme object.
		void	closeOptionsMenu()
			Closes the options menu.
		ActivityPendingResult	createActivityPendingResult(int requestCode, boolean multiple)
			Create a new ActivityPendingResult object, which you can hand to others for them to use to send result data back to your onActivityResult(int, int, String, Bundle) callback.
		boolean	dispatchKeyEvent(KeyEvent event)
			Called to process key events.
		boolean	dispatchTouchEvent(MotionEvent ev)
			Called to process touch screen events.
		boolean	dispatchTrackballEvent(MotionEvent ev)
			Called to process trackball events.
		void	finalize()
			Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
		View	findViewById(int id)
			Finds a view that was identified by the id attribute from the XML that was processed in onCreate(Bundle).
		void	finish()
			Call this when your activity is done and should be closed.
		void	finishSubActivity(int requestCode)
			Force finish another activity that you had previously started with startSubActivity(Intent, int).
		void	finishSubActivityFromChild(Activity child, int requestCode)
			This is called when a child activity of this one calls its finishSubActivity().
final		Application	getApplication()
			Return the application that owns this activity.
		ComponentName	getCallingActivity()
			Return the name of the activity that invoked this activity.
		String	getCallingPackage()
			Return the name of the package that invoked this activity.
		ComponentName	getComponentName()
			Returns complete component name of this activity.
		View	getCurrentFocus()
			Calls getCurrentFocus() on the Window of this Activity to return the currently focused view.
	static	long	getInstanceCount()
		Intent	getIntent()
			Return the intent that started this activity.
		String	getLocalClassName()
			Returns class name for this activity with the package prefix removed.
final		Activity	getParent()
			Return the parent activity if this view is embedded.
		SharedPreferences	getPreferences(int mode)
			Retrieve a SharedPreferences object for accessing preferences that are private to this activity.
		Object	getSystemService(String name)
			Return the handle to a system-level service by name.
		int	getTaskId()
			Return the identifier of the task this activity is in.
final		CharSequence	getTitle()
final		int	getTitleColor()
		ViewInflate	getViewInflate()
			Convenience for calling getViewInflate().
		Window	getWindow()
			Retrieve the current Window for the activity.
		WindowManager	getWindowManager()
			Retrieve the window manager for showing custom windows.
final		boolean	isEmbedded()
			Is this activity embedded inside of another activity?
		boolean	isFinishing()
			Check to see whether this activity is in the process of finishing, either because you called finish() on it or someone else has requested that it finished.
		boolean	isFullscreenOpaque()
			Returns whether this activity's UI is full-screen and opaque.
		boolean	isTaskRoot()
			Return whether this activity is the root of a task.
		void	managedCommitUpdates(Cursor c)
			Wrapper around commitUpdates() that takes care of noting that the Cursor needs to be requeried.
final		Cursor	managedQuery(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)
			Wrapper around query(android.net.Uri, String[], String, String[], String) that gives the resulting Cursor to call startManagingCursor(Cursor) so that the activity will manage its lifecycle for you.
		boolean	moveTaskBackwards(boolean nonRoot)
			Move the task containing this activity backwards one level in the activity stack.
		boolean	moveTaskToBack(boolean nonRoot)
			Move the task containing this activity to the back of the activity stack.
		void	onActivityResult(int requestCode, int resultCode, String data, Bundle extras)
			Called when an activity you launched exits, giving you the requestCode you started it with, the resultCode it returned, and any additional data from it.
		void	onChildTitleChanged(Activity childActivity, CharSequence title)
		void	onCompleteThaw(Bundle state)
			This method is called after onStart() when the activity is being re-initialized from a previously saved state, given here in `state`.
		void	onConfigurationChanged(Configuration newConfig)
			Called by the system when the device configuration changes while your activity is running.
		void	onContentChanged()
			This hook is called whenever the content view of the screen changes (due to a call to setContentView().
		boolean	onContextItemSelected(Item item)
			This hook is called whenever an item in a context menu is selected.
		void	onContextMenuClosed(Menu menu)
			This hook is called whenever the context menu is being closed (either by the user canceling the menu with the back/menu button, or when an item is selected).
		void	onCreate(Bundle icicle)
			Called when the activity is starting.
		CharSequence	onCreateDescription()
			Generate a new description for this activity.
		boolean	onCreateOptionsMenu(Menu menu)
			Initialize the contents of the Activity's standard options menu.
		boolean	onCreatePanelMenu(int featureId, Menu menu)
			Default implementation of onCreatePanelMenu(int, Menu) for activities.
		View	onCreatePanelView(int featureId)
			Default implementation of onCreatePanelView(int) for activities.
		boolean	onCreateThumbnail(Bitmap outBitmap, Canvas canvas)
			Generate a new thumbnail for this activity.
		void	onDestroy()
			Perform any final cleanup before an activity is destroyed.
		void	onFreeze(Bundle outState)
			Called to retrieve the current dynamic user-interface state of the activity.
		boolean	onKeyDown(int keyCode, KeyEvent event)
			Called when a key was pressed down and not handled by any of the views inside of the activity.
		boolean	onKeyMultiple(int keyCode, int repeatCount, KeyEvent event)
			Default implementation of KeyEvent.Callback.onKeyMultiple(): always returns false (doesn't handle the event).
		boolean	onKeyUp(int keyCode, KeyEvent event)
			Called when a key was released and not handled by any of the views inside of the activity.
		boolean	onMenuItemSelected(int featureId, Item item)
			Default implementation of onMenuItemSelected(int, Menu.Item) for activities.
		void	onNewIntent(Intent intent)
			This is called for activities that set launchMode to "singleTop" in their package, or if a client used the SINGLE_TOP_LAUNCH flag when calling startActivity(Intent).
		boolean	onOptionsItemSelected(Item item)
			This hook is called whenever an item in your options menu is selected.
		void	onOptionsMenuClosed(Menu menu)
			This hook is called whenever the options menu is being closed (either by the user canceling the menu with the back/menu button, or when an item is selected).
		void	onPanelClosed(int featureId, Menu menu)
			Default implementation of onPanelClosed(int, Menu) for activities.
		void	onPause()
			Called prior to a new activity becoming resumed, such as when the user is starting a new activity.
		void	onPostCreate(Bundle icicle)
			Called when activity start-up is complete (after onStart() and onCompleteThaw(Bundle) have been called).
		void	onPostResume()
			Called when activity resume is complete (after onResume() has been called).
		boolean	onPrepareOptionsMenu(Menu menu)
			Prepare the Screen's standard options menu to be displayed.
		boolean	onPreparePanel(int featureId, View view, Menu menu)
			Default implementation of onPreparePanel(int, View, Menu) for activities.
		void	onRestart()
			Called after onStart() when the current activity is being re-displayed to the user (the user has navigated back to it).
		void	onResume()
			Called after onCompleteThaw(Bundle), onRestart(), or onPause(), for your activity to start interacting with the user.
		boolean	onSearchRequested()
			This hook is called when the user signals the desire to start a search.
		void	onStart()
			Called after onCreate(Bundle) or onStop() when the current activity is now being displayed to the user.
		void	onStop()
			Called when you are no longer visible to the user.
		void	onTitleChanged(CharSequence title, int color)
		boolean	onTouchEvent(MotionEvent event)
			Called when a touch screen event was not handled by any of the views under it.
		boolean	onTrackballEvent(MotionEvent event)
			Called when the trackball was moved and not handled by any of the views inside of the activity.
		void	onWindowAttributesChanged(LayoutParams params)
			This is called whenever the current window attributes change.
		void	onWindowFocusChanged(boolean hasFocus)
			This hook is called whenever the window focus changes.
		void	openOptionsMenu()
			Opens the options menu.
final		boolean	requestWindowFeature(int featureId)
			Enable extended window features.
final		void	runOnUIThread(Runnable action)
			Runs the specified action on the UI thread.
		void	setContentView(int layoutResID)
			Set the activity content from a layout resource.
		void	setContentView(View view, LayoutParams params)
			Set the activity content to an explicit view.
		void	setContentView(View view)
			Set the activity content to an explicit view.
final		void	setDefaultKeyMode(int mode)
			Select the default key handling for this activity.
final		void	setFeatureDrawable(int featureId, Drawable drawable)
			Convenience for calling setFeatureDrawable(int, Drawable).
final		void	setFeatureDrawableAlpha(int featureId, int alpha)
			Convenience for calling setFeatureDrawableAlpha(int, int).
final		void	setFeatureDrawableResource(int featureId, int resId)
			Convenience for calling setFeatureDrawableResource(int, int).
final		void	setFeatureDrawableUri(int featureId, Uri uri)
			Convenience for calling setFeatureDrawableUri(int, Uri).
		void	setIntent(Intent newIntent)
			Change the intent returned by getIntent().
		void	setPersistent(boolean isPersistent)
			Control whether this activity is required to be persistent.
final		void	setProgress(int progress)
			Sets the progress for the progress bars in the title.
final		void	setProgressBarIndeterminate(boolean indeterminate)
			Sets whether the horizontal progress bar in the title should be indeterminate (the circular is always indeterminate).
final		void	setProgressBarVisibility(boolean visible)
			Sets the visibility of the progress bars in the title.
final		void	setResult(int resultCode, String data, Bundle extras)
			Call this to set the result that your activity will return to its caller.
final		void	setResult(int resultCode, String data)
			Call this to set the result that your activity will return to its caller.
final		void	setResult(int resultCode)
			Call this to set the result that your activity will return to its caller.
final		void	setSecondaryProgress(int secondaryProgress)
			Sets the secondary progress for the progress bar in the title.
		void	setTitle(int titleId)
			Change the title associated with this activity.
		void	setTitle(CharSequence title)
			Change the title associated with this activity.
		void	setTitleColor(int textColor)
		void	startActivity(Intent intent)
			Launch a new activity.
		void	startActivityFromChild(Activity child, Intent intent, int requestCode)
			This is called when a child activity of this one calls its startActivity(Intent) or startSubActivity(Intent, int) method.
		void	startManagingCursor(Cursor c)
			This method allows the activity to take care of managing the given Cursor's lifecycle for you based on the activity's lifecycle.
		void	startSearch(String initialQuery, Bundle appSearchData)
			This hook is called to launch the search UI.
		void	startSubActivity(Intent intent, int requestCode)
			Launch a sub-activity.
		boolean	startSubActivityIfNeeded(Intent intent, int requestCode)
			A special variation to launch an activity only if a new activity instance is needed to handle the given Intent.
		void	stopManagingCursor(Cursor c)
			Given a Cursor that was previously given to startManagingCursor(Cursor), stop the activity's management of that cursor.
		void	takeKeyEvents(boolean get)
			Request that key events come to this activity.


e.g. "intent" or "activity"