to top
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.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 ()

Since: API Level 1

Public Methods

public List<LauncherActivity.ListItem> makeListItems ()

Since: API Level 3

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

public void setTitle (int titleId)

Since: 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)

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

Since: API Level 1

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

protected Intent intentForPosition (int position)

Since: 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)

Since: 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)

Since: 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)

Since: 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)

Since: API Level 5

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

protected void onSetContentView ()

Since: API Level 5

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