ViewPager
open class ViewPager : ViewGroup
kotlin.Any | |||
↳ | android.view.View | ||
↳ | android.view.ViewGroup | ||
↳ | androidx.viewpager.widget.ViewPager |
Layout manager that allows the user to flip left and right through pages of data. You supply an implementation of a PagerAdapter
to generate the pages that the view shows.
ViewPager is most often used in conjunction with android.app.Fragment
, which is a convenient way to supply and manage the lifecycle of each page. There are standard adapters implemented for using fragments with the ViewPager, which cover the most common use cases. These are androidx.fragment.app.FragmentPagerAdapter
and androidx.fragment.app.FragmentStatePagerAdapter
; each of these classes have simple code showing how to build a full user interface with them.
Views which are annotated with the DecorView
annotation are treated as part of the view pagers 'decor'. Each decor view's position can be controlled via its android:layout_gravity
attribute. For example:
<androidx.viewpager.widget.ViewPager android:layout_width="match_parent" android:layout_height="match_parent"> <androidx.viewpager.widget.PagerTitleStrip android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_gravity="top" /> </androidx.viewpager.widget.ViewPager>
For more information about how to use ViewPager, read Creating Swipe Views with Tabs.
You can find examples of using ViewPager in the API 4+ Support Demos and API 13+ Support Demos sample code.
Summary
Nested classes | |
---|---|
Annotation which allows marking of views to be decoration views when added to a view pager. |
|
open |
Layout parameters that should be supplied for views added to a ViewPager. |
abstract |
Callback interface for responding to adapter changes. |
abstract |
Callback interface for responding to changing state of the selected page. |
abstract |
A PageTransformer is invoked whenever a visible/attached page is scrolled. |
open |
This is the persistent state that is saved by ViewPager. |
open |
Simple implementation of the |
Constants | |
---|---|
static Int |
Indicates that the pager is currently being dragged by the user. |
static Int |
Indicates that the pager is in an idle, settled state. |
static Int |
Indicates that the pager is in the process of settling to a final position. |
Public constructors | |
---|---|
<init>(@NonNull context: Context, @Nullable attrs: AttributeSet?) |
Public methods | |
---|---|
open Unit |
addFocusables(views: ArrayList<View!>!, direction: Int, focusableMode: Int) We only want the current page that is being shown to be focusable. |
open Unit |
addOnAdapterChangeListener(@NonNull listener: ViewPager.OnAdapterChangeListener) Add a listener that will be invoked whenever the adapter for this ViewPager changes. |
open Unit |
addOnPageChangeListener(@NonNull listener: ViewPager.OnPageChangeListener) Add a listener that will be invoked whenever the page changes or is incrementally scrolled. |
open Unit |
addTouchables(views: ArrayList<View!>!) We only want the current page that is being shown to be touchable. |
open Unit |
addView(child: View!, index: Int, params: LayoutParams!) |
open Boolean |
arrowScroll(direction: Int) Handle scrolling in response to a left or right arrow click. |
open Boolean |
Start a fake drag of the pager. |
open Boolean |
canScrollHorizontally(direction: Int) Check if this ViewPager can be scrolled horizontally in a certain direction. |
open Unit |
Remove all listeners that are notified of any changes in scroll state or position. |
open Unit | |
open Boolean |
dispatchKeyEvent(event: KeyEvent!) |
open Boolean | |
open Unit |
draw(canvas: |