Added in API level 1
Deprecated since API level 13

public class

TabActivity

extends ActivityGroup

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.view.ContextThemeWrapper
			↳	android.app.Activity
				↳	android.app.ActivityGroup
					↳	android.app.TabActivity

This class was deprecated in API level 13.
New applications should use Fragments instead of this class; to continue to run on older devices, you can use the v4 support library which provides a version of the Fragment API that is compatible down to DONUT .

Class Overview

For apps developing against HONEYCOMB or later, tabs are typically presented in the UI using the new ActionBar.newTab() and related APIs for placing tabs within their action bar area.

A replacement for TabActivity can also be implemented by directly using TabHost. You will need to define a layout that correctly uses a TabHost with a TabWidget as well as an area in which to display your tab content. A typical example would be:

       <android.support.v4.app.FragmentTabHost
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@android:id/tabhost"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <LinearLayout
        android:orientation="vertical"
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <TabWidget
            android:id="@android:id/tabs"
            android:orientation="horizontal"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:layout_weight="0"/>

        <FrameLayout
            android:id="@android:id/tabcontent"
            android:layout_width="0dp"
            android:layout_height="0dp"
            android:layout_weight="0"/>

        <FrameLayout
            android:id="@+id/realtabcontent"
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:layout_weight="1"/>

    </LinearLayout>
</android.support.v4.app.FragmentTabHost>

The implementation needs to take over responsibility for switching the shown content when the user switches between tabs.

        import com.example.android.supportv4.R;

import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
import android.support.v4.app.FragmentTabHost;

/**
 * This demonstrates how you can implement switching between the tabs of a
 * TabHost through fragments, using FragmentTabHost.
 */
public class FragmentTabs extends FragmentActivity {
    private FragmentTabHost mTabHost;

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

        setContentView(R.layout.fragment_tabs);
        mTabHost = (FragmentTabHost)findViewById(android.R.id.tabhost);
        mTabHost.setup(this, getSupportFragmentManager(), R.id.realtabcontent);

        mTabHost.addTab(mTabHost.newTabSpec("simple").setIndicator("Simple"),
                FragmentStackSupport.CountingFragment.class, null);
        mTabHost.addTab(mTabHost.newTabSpec("contacts").setIndicator("Contacts"),
                LoaderCursorSupport.CursorLoaderListFragment.class, null);
        mTabHost.addTab(mTabHost.newTabSpec("custom").setIndicator("Custom"),
                LoaderCustomSupport.AppListFragment.class, null);
        mTabHost.addTab(mTabHost.newTabSpec("throttle").setIndicator("Throttle"),
                LoaderThrottleSupport.ThrottledLoaderListFragment.class, null);
    }
}

Also see the Fragment Tabs Pager sample for an example of using the support library's ViewPager to allow the user to swipe the content to switch between tabs.

Summary

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

Public Methods
TabHost	getTabHost () Returns the `TabHost` the activity is using to host its tabs.
TabWidget	getTabWidget () Returns the `TabWidget` the activity is using to draw the actual tabs.
void	onContentChanged () Updates the screen state (current list and other views) when the content changes.
void	setDefaultTab ( String tag) Sets the default tab that is the first tab highlighted.
void	setDefaultTab (int index) Sets the default tab that is the first tab highlighted.

Protected Methods
void	onChildTitleChanged ( Activity childActivity, CharSequence title)
void	onPostCreate ( Bundle icicle) Called when activity start-up is complete (after `onStart()` and `onRestoreInstanceState(Bundle)` have been called).
void	onRestoreInstanceState ( Bundle state) This method is called after `onStart()` when the activity is being re-initialized from a previously saved state, given here in `savedInstanceState` .
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).

[Expand]

Inherited Methods

From class android.app.ActivityGroup

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

Added in API level 1

Public Methods

public TabHost getTabHost ()

Added in API level 1

Returns the TabHost the activity is using to host its tabs.

Returns

the TabHost the activity is using to host its tabs.

public TabWidget getTabWidget ()

Added in API level 1

Returns the TabWidget the activity is using to draw the actual tabs.

Returns

the TabWidget the activity is using to draw the actual tabs.

public void onContentChanged ()

Added in API level 1

Updates the screen state (current list and other views) when the content changes.

public void setDefaultTab ( String tag)

Added in API level 1

Sets the default tab that is the first tab highlighted.

Parameters

tag	the name of the default tab

public void setDefaultTab (int index)

Added in API level 1

Sets the default tab that is the first tab highlighted.

Parameters

index	the index of the default tab

Protected Methods

protected void onChildTitleChanged ( Activity childActivity, CharSequence title)

Added in API level 1

protected void onPostCreate ( Bundle icicle)

Added in API level 1

Called when activity start-up is complete (after onStart() and onRestoreInstanceState(Bundle) have been called). Applications will generally not implement this method; it is intended for system classes to do final initialization after application code has run.

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 onRestoreInstanceState ( Bundle state)

Added in API level 1

This method is called after onStart() when the activity is being re-initialized from a previously saved state, given here in savedInstanceState . Most implementations will simply use onCreate(Bundle) to restore their state, but it is sometimes convenient to do it here after all of the initialization has been done or to allow subclasses to decide whether to use your default implementation. The default implementation of this method performs a restore of any view state that had previously been frozen by onSaveInstanceState(Bundle) .

This method is called between onStart() and onPostCreate(Bundle) .

Parameters

state	the data most recently supplied in `onSaveInstanceState(Bundle)` .

protected void onSaveInstanceState ( Bundle outState)

Added in API level 1

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

This method is called before an activity may be killed so that when it comes back some time in the future it can restore its state. For example, if activity B is launched in front of activity A, and at some point activity A is killed to reclaim resources, activity A will have a chance to save the current state of its user interface via this method so that when the user returns to activity A, the state of the user interface can be restored via onCreate(Bundle) or onRestoreInstanceState(Bundle) .

Do not confuse this method with activity lifecycle callbacks such as onPause() , which is always called when an activity is being placed in the background or on its way to destruction, or onStop() which is called before destruction. One example of when onPause() and onStop() is called and not this method is when a user navigates back from activity B to activity A: there is no need to call onSaveInstanceState(Bundle) on B because that particular instance will never be restored, so the system avoids calling it. An example when onPause() is called and not onSaveInstanceState(Bundle) is when activity B is launched in front of activity A: the system may avoid calling onSaveInstanceState(Bundle) on activity A if it isn't killed during the lifetime of B since the state of the user interface of A will stay intact.

The default implementation takes care of most of the UI per-instance state for you by calling onSaveInstanceState() on each view in the hierarchy that has an id, and by saving the id of the currently focused view (all of which is restored by the default implementation of onRestoreInstanceState(Bundle) ). If you override this method to save additional information not captured by each individual view, you will likely want to call through to the default implementation, otherwise be prepared to save all of the state of each view yourself.

If called, this method will occur before onStop() . There are no guarantees about whether it will occur before or after onPause() .

Parameters

outState	Bundle in which to place your saved state.

Results

Interfaces

Classes

Exceptions

TabActivity

Class Overview

Summary

Public Constructors

public TabActivity ()

Public Methods

public TabHost getTabHost ()

Returns

public TabWidget getTabWidget ()

Returns

public void onContentChanged ()

See Also

public void setDefaultTab ( String tag)

Parameters

public void setDefaultTab (int index)

Parameters

Protected Methods

protected void onChildTitleChanged ( Activity childActivity, CharSequence title)

protected void onPostCreate ( Bundle icicle)

Parameters

protected void onRestoreInstanceState ( Bundle state)

Parameters

protected void onSaveInstanceState ( Bundle outState)

Parameters