Android APIs
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
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
From interface android.view.LayoutInflater.Factory2
From interface android.view.Window.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.View.OnCreateContextMenuListener
From interface android.content.ComponentCallbacks2
From interface android.view.LayoutInflater.Factory
From interface android.content.ComponentCallbacks

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.

Returns
List<LauncherActivity.ListItem>

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.

Parameters
titleId int

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.

Parameters
title CharSequence

Protected Methods

protected Intent getTargetIntent ()

Added in API level 1

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

Returns
Intent

protected Intent intentForPosition (int position)

Added in API level 3

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

Parameters
position int: The item whose Intent to return
Returns
Intent

protected LauncherActivity.ListItem itemForPosition (int position)

Added in API level 4

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

Parameters
position int: The item to return
Returns
LauncherActivity.ListItem

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 Bundle: 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 ListView: The ListView where the click happened
v View: The view that was clicked within the ListView
position int: The position of the view in the list
id long: 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.

Parameters
queryIntent Intent
Returns
List<ResolveInfo>

protected void onSetContentView ()

Added in API level 5

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