fullscreen Use Tree Navigation

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

[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

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

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 ()