Android APIs
public class

TextSwitcher

extends ViewSwitcher
java.lang.Object
   ↳ android.view.View
     ↳ android.view.ViewGroup
       ↳ android.widget.FrameLayout
         ↳ android.widget.ViewAnimator
           ↳ android.widget.ViewSwitcher
             ↳ android.widget.TextSwitcher

Class Overview

Specialized ViewSwitcher that contains only children of type TextView. A TextSwitcher is useful to animate a label on screen. Whenever setText(CharSequence) is called, TextSwitcher animates the current text out and animates the new text in.

Summary

[Expand]
Inherited XML Attributes
From class android.widget.ViewAnimator
From class android.widget.FrameLayout
From class android.view.ViewGroup
From class android.view.View
[Expand]
Inherited Constants
From class android.view.ViewGroup
From class android.view.View
[Expand]
Inherited Fields
From class android.view.View
Public Constructors
TextSwitcher(Context context)
Creates a new empty TextSwitcher.
TextSwitcher(Context context, AttributeSet attrs)
Creates a new empty TextSwitcher for the given context and with the specified set attributes.
Public Methods
void addView(View child, int index, ViewGroup.LayoutParams params)
Adds a child view with the specified layout parameters.
CharSequence getAccessibilityClassName()
Return the class name of this object to be used for accessibility purposes.
void setCurrentText(CharSequence text)
Sets the text of the text view that is currently showing.
void setText(CharSequence text)
Sets the text of the next view and switches to the next view.
[Expand]
Inherited Methods
From class android.widget.ViewSwitcher
From class android.widget.ViewAnimator
From class android.widget.FrameLayout
From class android.view.ViewGroup
From class android.view.View
From class java.lang.Object
From interface android.view.ViewParent
From interface android.view.ViewManager
From interface android.graphics.drawable.Drawable.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.accessibility.AccessibilityEventSource

Public Constructors

public TextSwitcher (Context context)

Added in API level 1

Creates a new empty TextSwitcher.

Parameters
context Context: the application's environment

public TextSwitcher (Context context, AttributeSet attrs)

Added in API level 1

Creates a new empty TextSwitcher for the given context and with the specified set attributes.

Parameters
context Context: the application environment
attrs AttributeSet: a collection of attributes

Public Methods

public void addView (View child, int index, ViewGroup.LayoutParams params)

Added in API level 1

Adds a child view with the specified layout parameters.

Note: do not invoke this method from draw(android.graphics.Canvas), onDraw(android.graphics.Canvas), dispatchDraw(android.graphics.Canvas) or any related method.

Parameters
child View: the child view to add
index int: the position at which to add the child or -1 to add last
params ViewGroup.LayoutParams: the layout parameters to set on the child
Throws
IllegalArgumentException if child is not an instance of TextView

public CharSequence getAccessibilityClassName ()

Added in API level 23

Return the class name of this object to be used for accessibility purposes. Subclasses should only override this if they are implementing something that should be seen as a completely new class of view when used by accessibility, unrelated to the class it is deriving from. This is used to fill in AccessibilityNodeInfo.setClassName.

Returns
CharSequence

public void setCurrentText (CharSequence text)

Added in API level 1

Sets the text of the text view that is currently showing. This does not perform the animations.

Parameters
text CharSequence: the new text to display

public void setText (CharSequence text)

Added in API level 1

Sets the text of the next view and switches to the next view. This can be used to animate the old text out and animate the next text in.

Parameters
text CharSequence: the new text to display