to top
Android APIs
public class

PagerTabStrip

extends PagerTitleStrip
java.lang.Object
   ↳ android.view.View
     ↳ android.view.ViewGroup
       ↳ android.support.v4.view.PagerTitleStrip
         ↳ android.support.v4.view.PagerTabStrip

Class Overview

PagerTabStrip is an interactive indicator of the current, next, and previous pages of a ViewPager. It is intended to be used as a child view of a ViewPager widget in your XML layout. Add it as a child of a ViewPager in your layout file and set its android:layout_gravity to TOP or BOTTOM to pin it to the top or bottom of the ViewPager. The title from each page is supplied by the method getPageTitle(int) in the adapter supplied to the ViewPager.

For a non-interactive indicator, see PagerTitleStrip.

Summary

[Expand]
Inherited XML Attributes
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
PagerTabStrip(Context context)
PagerTabStrip(Context context, AttributeSet attrs)
Public Methods
boolean getDrawFullUnderline()
Return whether or not this tab strip will draw a full-width underline.
int getTabIndicatorColor()
boolean onTouchEvent(MotionEvent ev)
Implement this method to handle touch screen motion events.
void setBackgroundColor(int color)
Sets the background color for this view.
void setBackgroundDrawable(Drawable d)
This method is deprecated. use setBackground(Drawable) instead
void setBackgroundResource(int resId)
Set the background to a given resource.
void setDrawFullUnderline(boolean drawFull)
Set whether this tab strip should draw a full-width underline in the current tab indicator color.
void setPadding(int left, int top, int right, int bottom)
Sets the padding.
void setTabIndicatorColor(int color)
Set the color of the tab indicator bar.
void setTabIndicatorColorResource(int resId)
Set the color of the tab indicator bar from a color resource.
void setTextSpacing(int textSpacing)
Set the required spacing between title segments.
Protected Methods
void onDraw(Canvas canvas)
Implement this to do your drawing.
[Expand]
Inherited Methods
From class android.support.v4.view.PagerTitleStrip
From class android.view.ViewGroup
From class android.view.View
From class java.lang.Object
From interface android.graphics.drawable.Drawable.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.ViewManager
From interface android.view.ViewParent
From interface android.view.accessibility.AccessibilityEventSource

Public Constructors

public PagerTabStrip (Context context)

public PagerTabStrip (Context context, AttributeSet attrs)

Public Methods

public boolean getDrawFullUnderline ()

Return whether or not this tab strip will draw a full-width underline. This defaults to true if no background is set.

Returns
  • true if this tab strip will draw a full-width underline in the current tab indicator color.

public int getTabIndicatorColor ()

Returns
  • The current tab indicator color as an 0xRRGGBB value.

public boolean onTouchEvent (MotionEvent ev)

Implement this method to handle touch screen motion events.

If this method is used to detect click actions, it is recommended that the actions be performed by implementing and calling performClick(). This will ensure consistent system behavior, including:

  • obeying click sound preferences
  • dispatching OnClickListener calls
  • handling ACTION_CLICK when accessibility features are enabled

Parameters
ev The motion event.
Returns
  • True if the event was handled, false otherwise.

public void setBackgroundColor (int color)

Sets the background color for this view.

Parameters
color the color of the background

public void setBackgroundDrawable (Drawable d)

This method is deprecated.
use setBackground(Drawable) instead

public void setBackgroundResource (int resId)

Set the background to a given resource. The resource should refer to a Drawable object or 0 to remove the background.

Parameters
resId The identifier of the resource.

public void setDrawFullUnderline (boolean drawFull)

Set whether this tab strip should draw a full-width underline in the current tab indicator color.

Parameters
drawFull true to draw a full-width underline, false otherwise

public void setPadding (int left, int top, int right, int bottom)

Sets the padding. The view may add on the space required to display the scrollbars, depending on the style and visibility of the scrollbars. So the values returned from getPaddingLeft(), getPaddingTop(), getPaddingRight() and getPaddingBottom() may be different from the values set in this call.

Parameters
left the left padding in pixels
top the top padding in pixels
right the right padding in pixels
bottom the bottom padding in pixels

public void setTabIndicatorColor (int color)

Set the color of the tab indicator bar.

Parameters
color Color to set as an 0xRRGGBB value. The high byte (alpha) is ignored.

public void setTabIndicatorColorResource (int resId)

Set the color of the tab indicator bar from a color resource.

Parameters
resId Resource ID of a color resource to load

public void setTextSpacing (int textSpacing)

Set the required spacing between title segments.

Parameters
textSpacing Spacing between each title displayed in pixels

Protected Methods

protected void onDraw (Canvas canvas)

Implement this to do your drawing.

Parameters
canvas the canvas on which the background will be drawn