Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)

Added in API level 1

public abstract class

LauncherActivity

extends ListActivity

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.view.ContextThemeWrapper
			↳	android.app.Activity
				↳	android.app.ListActivity
					↳	android.app.LauncherActivity

Class Overview

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

Summary

Nested Classes
class	LauncherActivity.IconResizer	Utility class to resize icons to match default icon size.
class	LauncherActivity.ListItem	An item in the list

[Expand]

Inherited Constants

From class android.app.Activity

From class android.content.Context

From interface android.content.ComponentCallbacks2

int	TRIM_MEMORY_BACKGROUND	Level for `onTrimMemory(int)` : the process has gone on to the LRU list.
int	TRIM_MEMORY_COMPLETE	Level for `onTrimMemory(int)` : the process is nearing the end of the background LRU list, and if more memory isn't found soon it will be killed.
int	TRIM_MEMORY_MODERATE	Level for `onTrimMemory(int)` : the process is around the middle of the background LRU list; freeing memory can help the system keep other processes running later in the list for better overall performance.
int	TRIM_MEMORY_RUNNING_CRITICAL	Level for `onTrimMemory(int)` : the process is not an expendable background process, but the device is running extremely low on memory and is about to not be able to keep any background processes running.
int	TRIM_MEMORY_RUNNING_LOW	Level for `onTrimMemory(int)` : the process is not an expendable background process, but the device is running low on memory.
int	TRIM_MEMORY_RUNNING_MODERATE	Level for `onTrimMemory(int)` : the process is not an expendable background process, but the device is running moderately low on memory.
int	TRIM_MEMORY_UI_HIDDEN	Level for `onTrimMemory(int)` : the process had been showing a user interface, and is no longer doing so.

[Expand]

Inherited Fields

From class android.app.Activity

Public Constructors
	LauncherActivity ()

Public Methods
List < LauncherActivity.ListItem >	makeListItems () Perform the query to determine which results to show and return a list of them.
void	setTitle (int titleId) Change the title associated with this activity.
void	setTitle ( CharSequence title) Change the title associated with this activity.

Protected Methods
Intent	getTargetIntent () Get the base intent to use when running `queryIntentActivities(Intent, int)` .
Intent	intentForPosition (int position) Return the actual Intent for a specific position in our `ListView` .
LauncherActivity.ListItem	itemForPosition (int position) Return the `LauncherActivity.ListItem` for a specific position in our `ListView` .
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.
List < ResolveInfo >	onQueryPackageManager ( Intent queryIntent) Perform query on package manager for list items.
void	onSetContentView () Override to call setContentView() with your own content view to customize the list layout.

[Expand]

Inherited Methods

From class android.app.ListActivity

ListAdapter	getListAdapter () Get the ListAdapter associated with this activity'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	onContentChanged () Updates the screen state (current list and other views) when the content changes.
void	onDestroy () Perform any final cleanup before an activity is destroyed.
void	onListItemClick ( ListView l, View v, int position, long id) This method will be called when an item in the list is selected.
void	onRestoreInstanceState ( Bundle state) Ensures the list view has been created before Activity restores all of the view states.
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

From class android.app.Activity

From class android.view.ContextThemeWrapper

void	applyOverrideConfiguration ( Configuration overrideConfiguration) Call to set an "override configuration" on this context -- this is a configuration that replies one or more values of the standard configuration that is applied to the context.
void	attachBaseContext ( Context newBase) Set the base context for this ContextWrapper.
Resources	getResources () Return a Resources instance for your application's package.
Object	getSystemService ( String name) Return the handle to a system-level service by name.
Resources.Theme	getTheme () Return the Theme object associated with this Context.
void	onApplyThemeResource ( Resources.Theme theme, int resid, boolean first) Called by `setTheme(int)` and `getTheme()` to apply a theme resource to the current Theme object.
void	setTheme (int resid) Set the base theme for this context.

From class android.content.ContextWrapper

From class android.content.Context

From class java.lang.Object

Object	clone () Creates and returns a copy of this `Object` .
boolean	equals ( Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize () Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class <?>	getClass () Returns the unique instance of `Class` that represents this object's class.
int	hashCode () Returns an integer hash code for this object.
final void	notify () Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll () Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString () Returns a string containing a concise, human-readable description of this object.
final void	wait () Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait (long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait (long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

From interface android.content.ComponentCallbacks

From interface android.content.ComponentCallbacks2

From interface android.view.KeyEvent.Callback

abstract boolean	onKeyDown (int keyCode, KeyEvent event) Called when a key down event has occurred.
abstract boolean	onKeyLongPress (int keyCode, KeyEvent event) Called when a long press has occurred.
abstract boolean	onKeyMultiple (int keyCode, int count, KeyEvent event) Called when multiple down/up pairs of the same key have occurred in a row.
abstract boolean	onKeyUp (int keyCode, KeyEvent event) Called when a key up event has occurred.

From interface android.view.LayoutInflater.Factory

From interface android.view.LayoutInflater.Factory2

From interface android.view.View.OnCreateContextMenuListener

From interface android.view.Window.Callback

Public Constructors

public LauncherActivity ()

Added in API level 1

Public Methods

public List < LauncherActivity.ListItem > makeListItems ()

Added in API level 3

Perform the query to determine which results to show and return a list of them.

public void setTitle (int titleId)

Added in API level 1

Change the title associated with this activity. If this is a top-level activity, the title for its window will change. If it is an embedded activity, the parent can do whatever it wants with it.

public void setTitle ( CharSequence title)

Added in API level 1

Change the title associated with this activity. If this is a top-level activity, the title for its window will change. If it is an embedded activity, the parent can do whatever it wants with it.

Protected Methods

protected Intent getTargetIntent ()

Added in API level 1

Get the base intent to use when running queryIntentActivities(Intent, int) .

protected Intent intentForPosition (int position)

Added in API level 3

Return the actual Intent for a specific position in our ListView .

Parameters

position	The item whose Intent to return

protected LauncherActivity.ListItem itemForPosition (int position)

Added in API level 4

Return the LauncherActivity.ListItem for a specific position in our ListView .

Parameters

position	The item to return

protected void onCreate ( Bundle icicle)

Added in API level 1

Called when the activity is starting. This is where most initialization should go: calling setContentView(int) to inflate the activity's UI, using findViewById(int) to programmatically interact with widgets in the UI, calling managedQuery(android.net.Uri, String[], String, String[], String) to retrieve cursors for data being displayed, etc.

You can call finish() from within this function, in which case onDestroy() will be immediately called without any of the rest of the activity lifecycle ( onStart() , onResume() , onPause() , etc) executing.

Derived classes must call through to the super class's implementation of this method. If they do not, an exception will be thrown.

Parameters

icicle	If the activity is being re-initialized after previously being shut down then this Bundle contains the data it most recently supplied in `onSaveInstanceState(Bundle)` . *Note: Otherwise it is null.*

protected void onListItemClick ( ListView l, View v, int position, long id)

Added in API level 1

This method will be called when an item in the list is selected. Subclasses should override. Subclasses can call getListView().getItemAtPosition(position) if they need to access the data associated with the selected item.

Parameters

l	The ListView where the click happened
v	The view that was clicked within the ListView
position	The position of the view in the list
id	The row id of the item that was clicked

protected List < ResolveInfo > onQueryPackageManager ( Intent queryIntent)

Added in API level 5

Perform query on package manager for list items. The default implementation queries for activities.

protected void onSetContentView ()

Added in API level 5

Override to call setContentView() with your own content view to customize the list layout.

Results

Interfaces

Classes

Exceptions

LauncherActivity

Class Overview

Summary

Public Constructors

public LauncherActivity ()

Public Methods

public List < LauncherActivity.ListItem > makeListItems ()

public void setTitle (int titleId)

public void setTitle ( CharSequence title)

Protected Methods

protected Intent getTargetIntent ()

protected Intent intentForPosition (int position)

Parameters

protected LauncherActivity.ListItem itemForPosition (int position)

Parameters

protected void onCreate ( Bundle icicle)

Parameters

protected void onListItemClick ( ListView l, View v, int position, long id)

Parameters

protected List < ResolveInfo > onQueryPackageManager ( Intent queryIntent)

protected void onSetContentView ()