ListActivity

Class Overview

An activity that displays a list of items by binding to a data source such as an array or Cursor, and exposes event handlers when the user selects an item.

ListActivity hosts a ListView object that can be bound to different data sources, typically either an array or a Cursor holding query results. Binding, screen layout, and row layout are discussed in the following sections.

Screen Layout

ListActivity has a default layout that consists of a single, full-screen list in the center of the screen. However, if you desire, you can customize the screen layout by setting your own view layout with setContentView() in onCreate(). To do this, your own view MUST contain a ListView object with the id "@android:id/list" (or list if it's in code)

Optionally, your custom view can contain another view object of any type to display when the list view is empty. This "empty list" notifier must have an id "android:empty". Note that when an empty view is present, the list view will be hidden when there is no data to display.

The following code demonstrates an (ugly) custom screen layout. It has a list with a green background, and an alternate red "no data" message.

 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
         android:orientation="vertical"
         android:layout_width="match_parent"
         android:layout_height="match_parent"
         android:paddingLeft="8dp"
         android:paddingRight="8dp">

     <ListView android:id="@id/android:list"
               android:layout_width="match_parent"
               android:layout_height="match_parent"
               android:background="#00FF00"
               android:layout_weight="1"
               android:drawSelectorOnTop="false"/>

     <TextView android:id="@id/android:empty"
               android:layout_width="match_parent"
               android:layout_height="match_parent"
               android:background="#FF0000"
               android:text="No data"/>
 </LinearLayout>
 

Row Layout

You can specify the layout of individual rows in the list. You do this by specifying a layout resource in the ListAdapter object hosted by the activity (the ListAdapter binds the ListView to the data; more on this later).

A ListAdapter constructor takes a parameter that specifies a layout resource for each row. It also has two additional parameters that let you specify which data field to associate with which object in the row layout resource. These two parameters are typically parallel arrays.

Android provides some standard row layout resources. These are in the R.layout class, and have names such as simple_list_item_1, simple_list_item_2, and two_line_list_item. The following layout XML is the source for the resource two_line_list_item, which displays two data fields,one above the other, for each list row.

 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:layout_width="match_parent"
     android:layout_height="wrap_content"
     android:orientation="vertical">

     <TextView android:id="@+id/text1"
         android:textSize="16sp"
         android:textStyle="bold"
         android:layout_width="match_parent"
         android:layout_height="wrap_content"/>

     <TextView android:id="@+id/text2"
         android:textSize="16sp"
         android:layout_width="match_parent"
         android:layout_height="wrap_content"/>
 </LinearLayout>
 

You must identify the data bound to each TextView object in this layout. The syntax for this is discussed in the next section.

Binding to Data

You bind the ListActivity's ListView object to data using a class that implements the ListAdapter interface. Android provides two standard list adapters: SimpleAdapter for static data (Maps), and SimpleCursorAdapter for Cursor query results.

The following code from a custom ListActivity demonstrates querying the Contacts provider for all contacts, then binding the Name and Company fields to a two line row layout in the activity's ListView.

 public class MyListAdapter extends ListActivity {

     @Override
     protected void onCreate(Bundle savedInstanceState){
         super.onCreate(savedInstanceState);

         // We'll define a custom screen layout here (the one shown above), but
         // typically, you could just use the standard ListActivity layout.
         setContentView(R.layout.custom_list_activity_view);

         // Query for all people contacts using the Contacts.People convenience class.
         // Put a managed wrapper around the retrieved cursor so we don't have to worry about
         // requerying or closing it as the activity changes state.
         mCursor = this.getContentResolver().query(People.CONTENT_URI, null, null, null, null);
         startManagingCursor(mCursor);

         // Now create a new list adapter bound to the cursor.
         // SimpleListAdapter is designed for binding to a Cursor.
         ListAdapter adapter = new SimpleCursorAdapter(
                 this, // Context.
                 android.R.layout.two_line_list_item,  // Specify the row template to use (here, two columns bound to the two retrieved cursor
 rows).
                 mCursor,                                              // Pass in the cursor to bind to.
                 new String[] {People.NAME, People.COMPANY},           // Array of cursor columns to bind to.
                 new int[] {android.R.id.text1, android.R.id.text2});  // Parallel array of which template objects to bind to those columns.

         // Bind to our new adapter.
         setListAdapter(adapter);
     }
 }
 

Summary

[Expand] Inherited Constants
From class android.app.Activity int DEFAULT_KEYS_DIALER Use with setDefaultKeyMode(int) to launch the dialer during default key handling. int DEFAULT_KEYS_DISABLE Use with setDefaultKeyMode(int) to turn off default handling of keys. int DEFAULT_KEYS_SEARCH_GLOBAL Use with setDefaultKeyMode(int) to specify that unhandled keystrokes will start a global search (typically web search, but some platforms may define alternate methods for global search) See android.app.SearchManager for more details. int DEFAULT_KEYS_SEARCH_LOCAL Use with setDefaultKeyMode(int) to specify that unhandled keystrokes will start an application-defined search. int DEFAULT_KEYS_SHORTCUT Use with setDefaultKeyMode(int) to execute a menu shortcut in default key handling. int RESULT_CANCELED Standard activity result: operation canceled. int RESULT_FIRST_USER Start of user-defined activity results. int RESULT_OK Standard activity result: operation succeeded.
From class android.content.Context String ACCESSIBILITY_SERVICE Use with getSystemService(String) to retrieve a AccessibilityManager for giving the user feedback for UI events through the registered event listeners. String ACCOUNT_SERVICE Use with getSystemService(String) to retrieve a AccountManager for receiving intents at a time of your choosing. String ACTIVITY_SERVICE Use with getSystemService(String) to retrieve a ActivityManager for interacting with the global system state. String ALARM_SERVICE Use with getSystemService(String) to retrieve a AlarmManager for receiving intents at a time of your choosing. String AUDIO_SERVICE Use with getSystemService(String) to retrieve a AudioManager for handling management of volume, ringer modes and audio routing. int BIND_AUTO_CREATE Flag for bindService(Intent, ServiceConnection, int): automatically create the service as long as the binding exists. int BIND_DEBUG_UNBIND Flag for bindService(Intent, ServiceConnection, int): include debugging help for mismatched calls to unbind. int BIND_NOT_FOREGROUND Flag for bindService(Intent, ServiceConnection, int): don't allow this binding to raise the target service's process to the foreground scheduling priority. String CLIPBOARD_SERVICE Use with getSystemService(String) to retrieve a ClipboardManager for accessing and modifying the contents of the global clipboard. String CONNECTIVITY_SERVICE Use with getSystemService(String) to retrieve a ConnectivityManager for handling management of network connections. 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. int CONTEXT_INCLUDE_CODE Flag for use with createPackageContext(String, int): include the application code with the context. int CONTEXT_RESTRICTED Flag for use with createPackageContext(String, int): a restricted context may disable specific features. String DEVICE_POLICY_SERVICE Use with getSystemService(String) to retrieve a DevicePolicyManager for working with global device policy management. String DOWNLOAD_SERVICE Use with getSystemService(String) to retrieve a DownloadManager for requesting HTTP downloads. String DROPBOX_SERVICE Use with getSystemService(String) to retrieve a DropBoxManager instance for recording diagnostic logs. String INPUT_METHOD_SERVICE Use with getSystemService(String) to retrieve a InputMethodManager for accessing input methods. String KEYGUARD_SERVICE Use with getSystemService(String) to retrieve a NotificationManager for controlling keyguard. String LAYOUT_INFLATER_SERVICE Use with getSystemService(String) to retrieve a LayoutInflater for inflating layout resources in this context. String LOCATION_SERVICE Use with getSystemService(String) to retrieve a LocationManager for controlling location updates. 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. int MODE_MULTI_PROCESS SharedPreference loading flag: when set, the file on disk will be checked for modification even if the shared preferences instance is already loaded in this process. 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). int MODE_WORLD_READABLE File creation mode: allow all other applications to have read access to the created file. int MODE_WORLD_WRITEABLE File creation mode: allow all other applications to have write access to the created file. String NFC_SERVICE Use with getSystemService(String) to retrieve a NfcManager for using NFC. String NOTIFICATION_SERVICE Use with getSystemService(String) to retrieve a NotificationManager for informing the user of background events. 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. String SEARCH_SERVICE Use with getSystemService(String) to retrieve a SearchManager for handling searches. String SENSOR_SERVICE Use with getSystemService(String) to retrieve a SensorManager for accessing sensors. String STORAGE_SERVICE Use with getSystemService(String) to retrieve a StorageManager for accessing system storage functions. String TELEPHONY_SERVICE Use with getSystemService(String) to retrieve a TelephonyManager for handling management the telephony features of the device. String UI_MODE_SERVICE Use with getSystemService(String) to retrieve a UiModeManager for controlling UI modes. String VIBRATOR_SERVICE Use with getSystemService(String) to retrieve a Vibrator for interacting with the vibration hardware. String WALLPAPER_SERVICE Use with getSystemService(String) to retrieve a com.android.server.WallpaperService for accessing wallpapers. String WIFI_SERVICE Use with getSystemService(String) to retrieve a WifiManager for handling management of Wi-Fi access. String WINDOW_SERVICE Use with getSystemService(String) to retrieve a WindowManager for accessing the system's window manager.

[Expand] Inherited Fields
From class android.app.Activity protected static final int[] FOCUSED_STATE_SET

[Expand] Inherited Methods
From class android.app.Activity void addContentView(View view, ViewGroup.LayoutParams params) Add an additional content view to the activity. void closeContextMenu() Programmatically closes the most recently opened context menu, if showing. void closeOptionsMenu() Progammatically closes the options menu. PendingIntent createPendingResult(int requestCode, Intent data, int flags) Create a new PendingIntent object which you can hand to others for them to use to send result data back to your onActivityResult(int, int, Intent) callback. final void dismissDialog(int id) Dismiss a dialog that was previously shown via showDialog(int). boolean dispatchKeyEvent(KeyEvent event) Called to process key events. boolean dispatchKeyShortcutEvent(KeyEvent event) Called to process a key shortcut event. boolean dispatchPopulateAccessibilityEvent(AccessibilityEvent event) Called to process population of AccessibilityEvents. boolean dispatchTouchEvent(MotionEvent ev) Called to process touch screen events. boolean dispatchTrackballEvent(MotionEvent ev) Called to process trackball events. void dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args) Print the Activity's state into the given stream. 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 finishActivity(int requestCode) Force finish another activity that you had previously started with startActivityForResult(Intent, int). void finishActivityFromChild(Activity child, int requestCode) This is called when a child activity of this one calls its finishActivity(). void finishFromChild(Activity child) This is called when a child activity of this one calls its finish() method. ActionBar getActionBar() Retrieve a reference to this activity's ActionBar. 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. int getChangingConfigurations() If this activity is being destroyed because it can not handle a configuration parameter being changed (and thus its onConfigurationChanged(Configuration) method is not being called), then you can use this method to discover the set of changes that have occurred while in the process of being destroyed. 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. FragmentManager getFragmentManager() Return the FragmentManager for interacting with fragments associated with this activity. Intent getIntent() Return the intent that started this activity. Object getLastNonConfigurationInstance() Retrieve the non-configuration instance data that was previously returned by onRetainNonConfigurationInstance(). LayoutInflater getLayoutInflater() Convenience for calling getLayoutInflater(). LoaderManager getLoaderManager() Return the LoaderManager for this fragment, creating it if needed. String getLocalClassName() Returns class name for this activity with the package prefix removed. MenuInflater getMenuInflater() Returns a MenuInflater with this context. final Activity getParent() Return the parent activity if this view is an embedded child. SharedPreferences getPreferences(int mode) Retrieve a SharedPreferences object for accessing preferences that are private to this activity. int getRequestedOrientation() Return the current requested orientation of the 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() final int getVolumeControlStream() Gets the suggested audio stream whose volume should be changed by the harwdare volume controls. int getWallpaperDesiredMinimumHeight() This method is deprecated. Use WallpaperManager.getDesiredMinimumHeight() instead. int getWallpaperDesiredMinimumWidth() This method is deprecated. Use WallpaperManager.getDesiredMinimumWidth() instead. Window getWindow() Retrieve the current Window for the activity. WindowManager getWindowManager() Retrieve the window manager for showing custom windows. boolean hasWindowFocus() Returns true if this activity's main window currently has window focus. void invalidateOptionsMenu() Declare that the options menu has changed, so should be recreated. boolean isChangingConfigurations() Check to see whether this activity is in the process of being destroyed in order to be recreated with a new configuration. final boolean isChild() 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 isTaskRoot() Return whether this activity is the root of a task. final Cursor managedQuery(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) This method is deprecated. Use CursorLoader instead. boolean moveTaskToBack(boolean nonRoot) Move the task containing this activity to the back of the activity stack. void onActionModeFinished(ActionMode mode) Notifies the activity that an action mode has finished. void onActionModeStarted(ActionMode mode) Notifies the Activity that an action mode has been started. void onActivityResult(int requestCode, int resultCode, Intent data) 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 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 onAttachFragment(Fragment fragment) Called when a Fragment is being attached to this activity, immediately after the call to its Fragment.onAttach() method and before Fragment.onCreate(). void onAttachedToWindow() Called when the main window associated with the activity has been attached to the window manager. void onBackPressed() Called when the activity has detected the user's press of the back key. void onChildTitleChanged(Activity childActivity, CharSequence title) 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 Window.setContentView or Window.addContentView). boolean onContextItemSelected(MenuItem 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 savedInstanceState) Called when the activity is starting. void onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo) Called when a context menu for the view is about to be shown. CharSequence onCreateDescription() Generate a new description for this activity. Dialog onCreateDialog(int id) This method is deprecated. Old no-arguments version of onCreateDialog(int, Bundle). Dialog onCreateDialog(int id, Bundle args) Callback for creating dialogs that are managed (saved and restored) for you by the 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. View onCreateView(View parent, String name, Context context, AttributeSet attrs) Standard implementation of onCreateView(View, String, Context, AttributeSet) used when inflating with the LayoutInflater returned by getSystemService(String). View onCreateView(String name, Context context, AttributeSet attrs) Standard implementation of onCreateView(String, Context, AttributeSet) used when inflating with the LayoutInflater returned by getSystemService(String). void onDestroy() Perform any final cleanup before an activity is destroyed. void onDetachedFromWindow() Called when the main window associated with the activity has been detached from the window manager. 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 onKeyLongPress(int keyCode, KeyEvent event) Default implementation of KeyEvent.Callback.onKeyLongPress(): always returns false (doesn't handle the event). boolean onKeyMultiple(int keyCode, int repeatCount, KeyEvent event) Default implementation of KeyEvent.Callback.onKeyMultiple(): always returns false (doesn't handle the event). boolean onKeyShortcut(int keyCode, KeyEvent event) Called when a key shortcut event is not handled by any of the views in the Activity. boolean onKeyUp(int keyCode, KeyEvent event) Called when a key was released and not handled by any of the views inside of the activity. void onLowMemory() This is called when the overall system is running low on memory, and would like actively running process to try to tighten their belt. boolean onMenuItemSelected(int featureId, MenuItem item) Default implementation of onMenuItemSelected(int, MenuItem) for activities. boolean onMenuOpened(int featureId, Menu menu) Called when a panel's menu is opened by the user. void onNewIntent(Intent intent) This is called for activities that set launchMode to "singleTop" in their package, or if a client used the FLAG_ACTIVITY_SINGLE_TOP flag when calling startActivity(Intent). boolean onOptionsItemSelected(MenuItem 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 as part of the activity lifecycle when an activity is going into the background, but has not (yet) been killed. void onPostCreate(Bundle savedInstanceState) Called when activity start-up is complete (after onStart() and onRestoreInstanceState(Bundle) have been called). void onPostResume() Called when activity resume is complete (after onResume() has been called). void onPrepareDialog(int id, Dialog dialog) This method is deprecated. Old no-arguments version of onPrepareDialog(int, Dialog, Bundle). void onPrepareDialog(int id, Dialog dialog, Bundle args) Provides an opportunity to prepare a managed dialog before it is being shown. 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 onStop() when the current activity is being re-displayed to the user (the user has navigated back to it). void onRestoreInstanceState(Bundle savedInstanceState) This method is called after onStart() when the activity is being re-initialized from a previously saved state, given here in savedInstanceState. void onResume() Called after onRestoreInstanceState(Bundle), onRestart(), or onPause(), for your activity to start interacting with the user. Object onRetainNonConfigurationInstance() Called by the system, as part of destroying an activity due to a configuration change, when it is known that a new instance will immediately be created for the new configuration. void onSaveInstanceState(Bundle outState) Called to retrieve per-instance state from an activity before being killed so that the state can be restored in onCreate(Bundle) or onRestoreInstanceState(Bundle) (the Bundle populated by this method will be passed to both). boolean onSearchRequested() This hook is called when the user signals the desire to start a search. void onStart() Called after onCreate(Bundle) — or after onRestart() when the activity had been stopped, but is now again 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 onUserInteraction() Called whenever a key, touch, or trackball event is dispatched to the activity. void onUserLeaveHint() Called as part of the activity lifecycle when an activity is about to go into the background as the result of user choice. void onWindowAttributesChanged(WindowManager.LayoutParams params) This is called whenever the current window attributes change. void onWindowFocusChanged(boolean hasFocus) Called when the current Window of the activity gains or loses focus. ActionMode onWindowStartingActionMode(ActionMode.Callback callback) Give the Activity a chance to control the UI for an action mode requested by the system. void openContextMenu(View view) Programmatically opens the context menu for a particular view. void openOptionsMenu() Programmatically opens the options menu. void overridePendingTransition(int enterAnim, int exitAnim) Call immediately after one of the flavors of startActivity(Intent) or finish() to specify an explicit transition animation to perform next. void recreate() Cause this Activity to be recreated with a new instance. void registerForContextMenu(View view) Registers a context menu to be shown for the given view (multiple views can show the context menu). final void removeDialog(int id) Removes any internal references to a dialog managed by this Activity. 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) Set the activity content to an explicit view. void setContentView(View view, ViewGroup.LayoutParams params) 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 setFinishOnTouchOutside(boolean finish) Sets whether this activity is finished when touched outside its window's bounds. void setIntent(Intent newIntent) Change the intent returned by getIntent(). 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 setProgressBarIndeterminateVisibility(boolean visible) Sets the visibility of the indeterminate progress bar in the title. final void setProgressBarVisibility(boolean visible) Sets the visibility of the progress bar in the title. void setRequestedOrientation(int requestedOrientation) Change the desired orientation of this activity. final void setResult(int resultCode) Call this to set the result that your activity will return to its caller. final void setResult(int resultCode, Intent data) 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 setVisible(boolean visible) Control whether this activity's main window is visible. final void setVolumeControlStream(int streamType) Suggests an audio stream whose volume should be changed by the hardware volume controls. final boolean showDialog(int id, Bundle args) Show a dialog managed by this activity. final void showDialog(int id) Simple version of showDialog(int, Bundle) that does not take any arguments. ActionMode startActionMode(ActionMode.Callback callback) Start an action mode. void startActivities(Intent[] intents) Launch a new activity. void startActivity(Intent intent) Launch a new activity. void startActivityForResult(Intent intent, int requestCode) Launch an activity for which you would like a result when it finished. void startActivityFromChild(Activity child, Intent intent, int requestCode) This is called when a child activity of this one calls its startActivity(Intent) or startActivityForResult(Intent, int) method. void startActivityFromFragment(Fragment fragment, Intent intent, int requestCode) This is called when a Fragment in this activity calls its startActivity(Intent) or startActivityForResult(Intent, int) method. boolean startActivityIfNeeded(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 startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags) Like startActivity(Intent), but taking a IntentSender to start; see startIntentSenderForResult(IntentSender, int, Intent, int, int, int) for more information. void startIntentSenderForResult(IntentSender intent, int requestCode, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags) Like startActivityForResult(Intent, int), but allowing you to use a IntentSender to describe the activity to be started. void startIntentSenderFromChild(Activity child, IntentSender intent, int requestCode, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags) Like startActivityFromChild(Activity, Intent, int), but taking a IntentSender; see startIntentSenderForResult(IntentSender, int, Intent, int, int, int) for more information. void startManagingCursor(Cursor c) This method is deprecated. Use CursorLoader instead. boolean startNextMatchingActivity(Intent intent) Special version of starting an activity, for use when you are replacing other activity components. void startSearch(String initialQuery, boolean selectInitialQuery, Bundle appSearchData, boolean globalSearch) This hook is called to launch the search UI. void stopManagingCursor(Cursor c) This method is deprecated. Use CursorLoader instead. void takeKeyEvents(boolean get) Request that key events come to this activity. void triggerSearch(String query, Bundle appSearchData) Similar to startSearch(String, boolean, Bundle, boolean), but actually fires off the search query after invoking the search dialog. void unregisterForContextMenu(View view) Prevents a context menu to be shown for the given view.
From class android.view.ContextThemeWrapper void attachBaseContext(Context newBase) Set the base context for this ContextWrapper. 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 void attachBaseContext(Context base) Set the base context for this ContextWrapper. boolean bindService(Intent service, ServiceConnection conn, int flags) Connect to an application service, creating it if needed. int checkCallingOrSelfPermission(String permission) Determine whether the calling process of an IPC or you have been granted a particular permission. int checkCallingOrSelfUriPermission(Uri uri, int modeFlags) Determine whether the calling process of an IPC or you has been granted permission to access a specific URI. int checkCallingPermission(String permission) Determine whether the calling process of an IPC you are handling has been granted a particular permission. int checkCallingUriPermission(Uri uri, int modeFlags) Determine whether the calling process and user ID has been granted permission to access a specific URI. int checkPermission(String permission, int pid, int uid) Determine whether the given permission is allowed for a particular process and user ID running in the system. int checkUriPermission(Uri uri, int pid, int uid, int modeFlags) Determine whether a particular process and user ID has been granted permission to access a specific URI. int checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags) Check both a Uri and normal permission. void clearWallpaper() This method is deprecated. Use WallpaperManager.clear() instead. Context createPackageContext(String packageName, int flags) Return a new Context object for the given application name. String[] databaseList() Returns an array of strings naming the private databases associated with this Context's application package. boolean deleteDatabase(String name) Delete an existing private SQLiteDatabase associated with this Context's application package. boolean deleteFile(String name) Delete the given private file associated with this Context's application package. void enforceCallingOrSelfPermission(String permission, String message) If neither you nor the calling process of an IPC you are handling has been granted a particular permission, throw a SecurityException. void enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message) If the calling process of an IPC or you has not been granted permission to access a specific URI, throw SecurityException. void enforceCallingPermission(String permission, String message) If the calling process of an IPC you are handling has not been granted a particular permission, throw a SecurityException. void enforceCallingUriPermission(Uri uri, int modeFlags, String message) If the calling process and user ID has not been granted permission to access a specific URI, throw SecurityException. void enforcePermission(String permission, int pid, int uid, String message) If the given permission is not allowed for a particular process and user ID running in the system, throw a SecurityException. void enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message) If a particular process and user ID has not been granted permission to access a specific URI, throw SecurityException. void enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message) Enforce both a Uri and normal permission. String[] fileList() Returns an array of strings naming the private files associated with this Context's application package. Context getApplicationContext() Return the context of the single, global Application object of the current process. ApplicationInfo getApplicationInfo() Return the full application info for this context's package. AssetManager getAssets() Return an AssetManager instance for your application's package. Context getBaseContext() File getCacheDir() Returns the absolute path to the application specific cache directory on the filesystem. ClassLoader getClassLoader() Return a class loader you can use to retrieve classes in this package. ContentResolver getContentResolver() Return a ContentResolver instance for your application's package. File getDatabasePath(String name) Returns the absolute path on the filesystem where a database created with openOrCreateDatabase(String, int, SQLiteDatabase.CursorFactory) is stored. File getDir(String name, int mode) Retrieve, creating if needed, a new directory in which the application can place its own custom data files. File getExternalCacheDir() Returns the absolute path to the directory on the external filesystem (that is somewhere on Environment.getExternalStorageDirectory() where the application can place cache files it owns. File getExternalFilesDir(String type) Returns the absolute path to the directory on the external filesystem (that is somewhere on Environment.getExternalStorageDirectory()) where the application can place persistent files it owns. File getFileStreamPath(String name) Returns the absolute path on the filesystem where a file created with openFileOutput(String, int) is stored. File getFilesDir() Returns the absolute path to the directory on the filesystem where files created with openFileOutput(String, int) are stored. Looper getMainLooper() Return the Looper for the main thread of the current process. File getObbDir() Return the directory where this application's OBB files (if there are any) can be found. String getPackageCodePath() Return the full path to this context's primary Android package. PackageManager getPackageManager() Return PackageManager instance to find global package information. String getPackageName() Return the name of this application's package. String getPackageResourcePath() Return the full path to this context's primary Android package. Resources getResources() Return a Resources instance for your application's package. SharedPreferences getSharedPreferences(String name, int mode) Retrieve and hold the contents of the preferences file 'name', returning a SharedPreferences through which you can retrieve and modify its values. 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. Drawable getWallpaper() This method is deprecated. Use WallpaperManager.get() instead. int getWallpaperDesiredMinimumHeight() This method is deprecated. Use WallpaperManager.getDesiredMinimumHeight() instead. int getWallpaperDesiredMinimumWidth() This method is deprecated. Use WallpaperManager.getDesiredMinimumWidth() instead. void grantUriPermission(String toPackage, Uri uri, int modeFlags) Grant permission to access a specific Uri to another package, regardless of whether that package has general permission to access the Uri's content provider. boolean isRestricted() Indicates whether this Context is restricted. FileInputStream openFileInput(String name) Open a private file associated with this Context's application package for reading. FileOutputStream openFileOutput(String name, int mode) Open a private file associated with this Context's application package for writing. SQLiteDatabase openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory) Open a new private SQLiteDatabase associated with this Context's application package. SQLiteDatabase openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler) Open a new private SQLiteDatabase associated with this Context's application package. Drawable peekWallpaper() This method is deprecated. Use WallpaperManager.peek() instead. Intent registerReceiver(BroadcastReceiver receiver, IntentFilter filter) Register a BroadcastReceiver to be run in the main activity thread. Intent registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler) Register to receive intent broadcasts, to run in the context of scheduler. void removeStickyBroadcast(Intent intent) Remove the data previously sent with sendStickyBroadcast(Intent), so that it is as if the sticky broadcast had never happened. void revokeUriPermission(Uri uri, int modeFlags) Remove all permissions to access a particular content provider Uri that were previously added with grantUriPermission(String, Uri, int). void sendBroadcast(Intent intent) Broadcast the given intent to all interested BroadcastReceivers. void sendBroadcast(Intent intent, String receiverPermission) Broadcast the given intent to all interested BroadcastReceivers, allowing an optional required permission to be enforced. void sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras) Version of sendBroadcast(Intent) that allows you to receive data back from the broadcast. void sendOrderedBroadcast(Intent intent, String receiverPermission) Broadcast the given intent to all interested BroadcastReceivers, delivering them one at a time to allow more preferred receivers to consume the broadcast before it is delivered to less preferred receivers. void sendStickyBroadcast(Intent intent) Perform a sendBroadcast(Intent) that is "sticky," meaning the Intent you are sending stays around after the broadcast is complete, so that others can quickly retrieve that data through the return value of registerReceiver(BroadcastReceiver, IntentFilter). void sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras) Version of sendStickyBroadcast(Intent) that allows you to receive data back from the broadcast. void setTheme(int resid) Set the base theme for this context. void setWallpaper(Bitmap bitmap) This method is deprecated. Use WallpaperManager.set() instead. void setWallpaper(InputStream data) This method is deprecated. Use WallpaperManager.set() instead. void startActivities(Intent[] intents) Launch multiple new activities. void startActivity(Intent intent) Launch a new activity. boolean startInstrumentation(ComponentName className, String profileFile, Bundle arguments) Start executing an Instrumentation class. void startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags) Like startActivity(Intent), but taking a IntentSender to start. ComponentName startService(Intent service) Request that a given application service be started. boolean stopService(Intent name) Request that a given application service be stopped. void unbindService(ServiceConnection conn) Disconnect from an application service. void unregisterReceiver(BroadcastReceiver receiver) Unregister a previously registered BroadcastReceiver.
From class android.content.Context abstract boolean bindService(Intent service, ServiceConnection conn, int flags) Connect to an application service, creating it if needed. abstract int checkCallingOrSelfPermission(String permission) Determine whether the calling process of an IPC or you have been granted a particular permission. abstract int checkCallingOrSelfUriPermission(Uri uri, int modeFlags) Determine whether the calling process of an IPC or you has been granted permission to access a specific URI. abstract int checkCallingPermission(String permission) Determine whether the calling process of an IPC you are handling has been granted a particular permission. abstract int checkCallingUriPermission(Uri uri, int modeFlags) Determine whether the calling process and user ID has been granted permission to access a specific URI. abstract int checkPermission(String permission, int pid, int uid) Determine whether the given permission is allowed for a particular process and user ID running in the system. abstract int checkUriPermission(Uri uri, int pid, int uid, int modeFlags) Determine whether a particular process and user ID has been granted permission to access a specific URI. abstract int checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags) Check both a Uri and normal permission. abstract void clearWallpaper() This method is deprecated. Use WallpaperManager.clear() instead. abstract Context createPackageContext(String packageName, int flags) Return a new Context object for the given application name. abstract String[] databaseList() Returns an array of strings naming the private databases associated with this Context's application package. abstract boolean deleteDatabase(String name) Delete an existing private SQLiteDatabase associated with this Context's application package. abstract boolean deleteFile(String name) Delete the given private file associated with this Context's application package. abstract void enforceCallingOrSelfPermission(String permission, String message) If neither you nor the calling process of an IPC you are handling has been granted a particular permission, throw a SecurityException. abstract void enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message) If the calling process of an IPC or you has not been granted permission to access a specific URI, throw SecurityException. abstract void enforceCallingPermission(String permission, String message) If the calling process of an IPC you are handling has not been granted a particular permission, throw a SecurityException. abstract void enforceCallingUriPermission(Uri uri, int modeFlags, String message) If the calling process and user ID has not been granted permission to access a specific URI, throw SecurityException. abstract void enforcePermission(String permission, int pid, int uid, String message) If the given permission is not allowed for a particular process and user ID running in the system, throw a SecurityException. abstract void enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message) If a particular process and user ID has not been granted permission to access a specific URI, throw SecurityException. abstract void enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message) Enforce both a Uri and normal permission. abstract String[] fileList() Returns an array of strings naming the private files associated with this Context's application package. abstract Context getApplicationContext() Return the context of the single, global Application object of the current process. abstract ApplicationInfo getApplicationInfo() Return the full application info for this context's package. abstract AssetManager getAssets() Return an AssetManager instance for your application's package. abstract File getCacheDir() Returns the absolute path to the application specific cache directory on the filesystem. abstract ClassLoader getClassLoader() Return a class loader you can use to retrieve classes in this package. abstract ContentResolver getContentResolver() Return a ContentResolver instance for your application's package. abstract File getDatabasePath(String name) Returns the absolute path on the filesystem where a database created with openOrCreateDatabase(String, int, SQLiteDatabase.CursorFactory) is stored. abstract File getDir(String name, int mode) Retrieve, creating if needed, a new directory in which the application can place its own custom data files. abstract File getExternalCacheDir() Returns the absolute path to the directory on the external filesystem (that is somewhere on Environment.getExternalStorageDirectory() where the application can place cache files it owns. abstract File getExternalFilesDir(String type) Returns the absolute path to the directory on the external filesystem (that is somewhere on Environment.getExternalStorageDirectory()) where the application can place persistent files it owns. abstract File getFileStreamPath(String name) Returns the absolute path on the filesystem where a file created with openFileOutput(String, int) is stored. abstract File getFilesDir() Returns the absolute path to the directory on the filesystem where files created with openFileOutput(String, int) are stored. abstract Looper getMainLooper() Return the Looper for the main thread of the current process. abstract File getObbDir() Return the directory where this application's OBB files (if there are any) can be found. abstract String getPackageCodePath() Return the full path to this context's primary Android package. abstract PackageManager getPackageManager() Return PackageManager instance to find global package information. abstract String getPackageName() Return the name of this application's package. abstract String getPackageResourcePath() Return the full path to this context's primary Android package. abstract Resources getResources() Return a Resources instance for your application's package. abstract SharedPreferences getSharedPreferences(String name, int mode) Retrieve and hold the contents of the preferences file 'name', returning a SharedPreferences through which you can retrieve and modify its values. final String getString(int resId) Return a localized string from the application's package's default string table. final String getString(int resId, Object... formatArgs) Return a localized formatted string from the application's package's default string table, substituting the format arguments as defined in Formatter and format(String, Object...). abstract Object getSystemService(String name) Return the handle to a system-level service by name. final CharSequence getText(int resId) Return a localized, styled CharSequence from the application's package's default string table. abstract Resources.Theme getTheme() Return the Theme object associated with this Context. abstract Drawable getWallpaper() This method is deprecated. Use WallpaperManager.get() instead. abstract int getWallpaperDesiredMinimumHeight() This method is deprecated. Use WallpaperManager.getDesiredMinimumHeight() instead. abstract int getWallpaperDesiredMinimumWidth() This method is deprecated. Use WallpaperManager.getDesiredMinimumWidth() instead. abstract void grantUriPermission(String toPackage, Uri uri, int modeFlags) Grant permission to access a specific Uri to another package, regardless of whether that package has general permission to access the Uri's content provider. boolean isRestricted() Indicates whether this Context is restricted. final TypedArray obtainStyledAttributes(int[] attrs) Retrieve styled attribute information in this Context's theme. final TypedArray obtainStyledAttributes(AttributeSet set, int[] attrs) Retrieve styled attribute information in this Context's theme. final TypedArray obtainStyledAttributes(int resid, int[] attrs) Retrieve styled attribute information in this Context's theme. final TypedArray obtainStyledAttributes(AttributeSet set, int[] attrs, int defStyleAttr, int defStyleRes) Retrieve styled attribute information in this Context's theme. abstract FileInputStream openFileInput(String name) Open a private file associated with this Context's application package for reading. abstract FileOutputStream openFileOutput(String name, int mode) Open a private file associated with this Context's application package for writing. abstract SQLiteDatabase openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory) Open a new private SQLiteDatabase associated with this Context's application package. abstract SQLiteDatabase openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler) Open a new private SQLiteDatabase associated with this Context's application package. abstract Drawable peekWallpaper() This method is deprecated. Use WallpaperManager.peek() instead. abstract Intent registerReceiver(BroadcastReceiver receiver, IntentFilter filter) Register a BroadcastReceiver to be run in the main activity thread. abstract Intent registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler) Register to receive intent broadcasts, to run in the context of scheduler. abstract void removeStickyBroadcast(Intent intent) Remove the data previously sent with sendStickyBroadcast(Intent), so that it is as if the sticky broadcast had never happened. abstract void revokeUriPermission(Uri uri, int modeFlags) Remove all permissions to access a particular content provider Uri that were previously added with grantUriPermission(String, Uri, int). abstract void sendBroadcast(Intent intent) Broadcast the given intent to all interested BroadcastReceivers. abstract void sendBroadcast(Intent intent, String receiverPermission) Broadcast the given intent to all interested BroadcastReceivers, allowing an optional required permission to be enforced. abstract void sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras) Version of sendBroadcast(Intent) that allows you to receive data back from the broadcast. abstract void sendOrderedBroadcast(Intent intent, String receiverPermission) Broadcast the given intent to all interested BroadcastReceivers, delivering them one at a time to allow more preferred receivers to consume the broadcast before it is delivered to less preferred receivers. abstract void sendStickyBroadcast(Intent intent) Perform a sendBroadcast(Intent) that is "sticky," meaning the Intent you are sending stays around after the broadcast is complete, so that others can quickly retrieve that data through the return value of registerReceiver(BroadcastReceiver, IntentFilter). abstract void sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras) Version of sendStickyBroadcast(Intent) that allows you to receive data back from the broadcast. abstract void setTheme(int resid) Set the base theme for this context. abstract void setWallpaper(Bitmap bitmap) This method is deprecated. Use WallpaperManager.set() instead. abstract void setWallpaper(InputStream data) This method is deprecated. Use WallpaperManager.set() instead. abstract void startActivities(Intent[] intents) Launch multiple new activities. abstract void startActivity(Intent intent) Launch a new activity. abstract boolean startInstrumentation(ComponentName className, String profileFile, Bundle arguments) Start executing an Instrumentation class. abstract void startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags) Like startActivity(Intent), but taking a IntentSender to start. abstract ComponentName startService(Intent service) Request that a given application service be started. abstract boolean stopService(Intent service) Request that a given application service be stopped. abstract void unbindService(ServiceConnection conn) Disconnect from an application service. abstract void unregisterReceiver(BroadcastReceiver receiver) Unregister a previously registered BroadcastReceiver.
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() Called before the object's memory is reclaimed by the VM. 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 abstract void onConfigurationChanged(Configuration newConfig) Called by the system when the device configuration changes while your component is running. abstract void onLowMemory() This is called when the overall system is running low on memory, and would like actively running process to try to tighten their belt.
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 abstract View onCreateView(String name, Context context, AttributeSet attrs) Hook you can supply that is called when inflating from a LayoutInflater.
From interface android.view.LayoutInflater.Factory2 abstract View onCreateView(View parent, String name, Context context, AttributeSet attrs) Version of onCreateView(String, Context, AttributeSet) that also supplies the parent that the view created view will be placed in.
From interface android.view.View.OnCreateContextMenuListener abstract void onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo) Called when the context menu for this view is being built.
From interface android.view.Window.Callback abstract boolean dispatchKeyEvent(KeyEvent event) Called to process key events. abstract boolean dispatchKeyShortcutEvent(KeyEvent event) Called to process a key shortcut event. abstract boolean dispatchPopulateAccessibilityEvent(AccessibilityEvent event) Called to process population of AccessibilityEvents. abstract boolean dispatchTouchEvent(MotionEvent event) Called to process touch screen events. abstract boolean dispatchTrackballEvent(MotionEvent event) Called to process trackball events. abstract void onActionModeFinished(ActionMode mode) Called when an action mode has been finished. abstract void onActionModeStarted(ActionMode mode) Called when an action mode has been started. abstract void onAttachedToWindow() Called when the window has been attached to the window manager. abstract void onContentChanged() This hook is called whenever the content view of the screen changes (due to a call to Window.setContentView or Window.addContentView). abstract boolean onCreatePanelMenu(int featureId, Menu menu) Initialize the contents of the menu for panel 'featureId'. abstract View onCreatePanelView(int featureId) Instantiate the view to display in the panel for 'featureId'. abstract void onDetachedFromWindow() Called when the window has been attached to the window manager. abstract boolean onMenuItemSelected(int featureId, MenuItem item) Called when a panel's menu item has been selected by the user. abstract boolean onMenuOpened(int featureId, Menu menu) Called when a panel's menu is opened by the user. abstract void onPanelClosed(int featureId, Menu menu) Called when a panel is being closed. abstract boolean onPreparePanel(int featureId, View view, Menu menu) Prepare a panel to be displayed. abstract boolean onSearchRequested() Called when the user signals the desire to start a search. abstract void onWindowAttributesChanged(WindowManager.LayoutParams attrs) This is called whenever the current window attributes change. abstract void onWindowFocusChanged(boolean hasFocus) This hook is called whenever the window focus changes. abstract ActionMode onWindowStartingActionMode(ActionMode.Callback callback) Called when an action mode is being started for this window.