WearableListView

public class WearableListView
extends RecyclerView

java.lang.Object
   ↳ android.view.View
     ↳ android.view.ViewGroup
       ↳ android.support.v7.widget.RecyclerView
         ↳ android.support.wearable.view.WearableListView


ListView的替代版本,经过优化,易于在小屏幕可穿戴设备上使用。 它显示一个可垂直滚动的项目列表,并在用户停止滚动时自动捕捉到最近的项目。

为了快速WearableListView.Adapter ,您需要实现一个WearableListView.Adapter的子类,它将创建视图并将其绑定到WearableListView.ViewHolder对象。 如果您希望在视图成为WearableListView的核心项目时添加更多视觉处理,请让它们实现WearableListView.OnCenterProximityListener界面。

Summary

Nested classes

class WearableListView.Adapter

为WearableListView提供数据的适配器的基类。

interface WearableListView.ClickListener

监听WearableListView上的点击事件的接口。

interface WearableListView.OnCenterProximityListener

WearableListView子级成为或不再是中心项目时接收回调的接口。

interface WearableListView.OnCentralPositionChangedListener

监听器接口可以添加到WearableListView中,以便在中央项目更改时得到通知。

interface WearableListView.OnScrollListener

用于监听WearableListView内容滚动的界面。

class WearableListView.ViewHolder

包装在列表视图中显示的项目周围。

Inherited constants

From class android.support.v7.widget.RecyclerView
From class android.view.ViewGroup
From class android.view.View

Inherited fields

From class android.view.ViewGroup
From class android.view.View

Public constructors

WearableListView(Context context)
WearableListView(Context context, AttributeSet attrs)
WearableListView(Context context, AttributeSet attrs, int defStyleAttr)

Public methods

void addOnCentralPositionChangedListener(WearableListView.OnCentralPositionChangedListener listener)

添加一个侦听器,当列表的中心项发生变化时将会调用该侦听器。

void addOnScrollListener(WearableListView.OnScrollListener listener)

添加将在列表视图的内容滚动时调用的侦听器。

void animateToCenter()

自动启动一个动画,将列表对齐到以最接近中间的元素为中心。

boolean fling(int velocityX, int velocityY)
int getBaseline()
int getCentralViewTop()

当这样的视图完全居中时,返回列表中心 View顶部。

WearableListView.ViewHolder getChildViewHolder(View child)
boolean getMaximizeSingleItem()

确定WearableListView中只有一个项目时是否布置单个项目,以使其高度填充整个WearableListView。

boolean isAtTop()
boolean isGestureNavigationEnabled()

确定是否启用手腕手势列表导航。

boolean onInterceptTouchEvent(MotionEvent event)
boolean onKeyDown(int keyCode, KeyEvent event)
boolean onTouchEvent(MotionEvent event)
void removeOnCentralPositionChangedListener(WearableListView.OnCentralPositionChangedListener listener)

删除列表中心项目更改时将调用的侦听器。

void removeOnScrollListener(WearableListView.OnScrollListener listener)

删除滚动事件的侦听器。

void resetLayoutManager()

清除定位列表项目的布局管理器的状态。

void setAdapter(Adapter adapter)
void setClickListener(WearableListView.ClickListener clickListener)

添加一个侦听器,当用户点击WearableListView或其项目时将会调用该侦听器。

void setEnableGestureNavigation(boolean enabled)

设置是否启用手腕手势列表导航。

void setGreedyTouchMode(boolean greedy)

控制WearableListView是否应拦截所有触摸事件并防止父母接收它们。

void setInitialOffset(int top)

默认情况下,列表的第一个元素最初位于屏幕的中心。

void setMaximizeSingleItem(boolean maximizeSingleItem)

当设置为true时,如果WearableListView中只有一个项目,它将填充整个WearableListView。

void smoothScrollToPosition(int position, RecyclerView.SmoothScroller smoothScroller)

Protected methods

void onAttachedToWindow()
void onDetachedFromWindow()

Inherited methods

From class android.support.v7.widget.RecyclerView
From class android.view.ViewGroup
From class android.view.View
From class java.lang.Object
From interface android.support.v4.view.ScrollingView
From interface android.support.v4.view.NestedScrollingChild
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

WearableListView

WearableListView (Context context)

Parameters
context Context

WearableListView

WearableListView (Context context,
                AttributeSet attrs)

Parameters
context Context
attrs AttributeSet

WearableListView

WearableListView (Context context,
                AttributeSet attrs,
                int defStyleAttr)

Parameters
context Context
attrs AttributeSet
defStyleAttr int

Public methods

addOnCentralPositionChangedListener

void addOnCentralPositionChangedListener (WearableListView.OnCentralPositionChangedListener listener)

添加一个侦听器,当列表的中心项发生变化时将会调用该侦听器。

Parameters
listener WearableListView.OnCentralPositionChangedListener

addOnScrollListener

void addOnScrollListener (WearableListView.OnScrollListener listener)

添加将在列表视图的内容滚动时调用的侦听器。

Parameters
listener WearableListView.OnScrollListener

animateToCenter

void animateToCenter ()

自动启动一个动画,将列表对齐到以最接近中间的元素为中心。

fling

boolean fling (int velocityX,
                int velocityY)

Parameters
velocityX int
velocityY int
Returns
boolean

getBaseline

int getBaseline ()

Returns
int the position of the center child's baseline; -1 if no center child exists or if the center child does not return a valid baseline.

getCentralViewTop

int getCentralViewTop ()

当这个视图完全居中时,返回列表中央的顶部View 这是一个或多或少的静态值,您可以使用它将其他视图与中央视图对齐。

Returns
int

getChildViewHolder

WearableListView.ViewHolder getChildViewHolder (View child)

Parameters
child View
Returns
WearableListView.ViewHolder

getMaximizeSingleItem

boolean getMaximizeSingleItem ()

确定WearableListView中只有一个项目时是否布置单个项目,以使其高度填充整个WearableListView。

Returns
boolean

isAtTop

boolean isAtTop ()

Returns
boolean true if the list is scrolled all the way to the top.

isGestureNavigationEnabled

boolean isGestureNavigationEnabled ()

确定是否启用手腕手势列表导航。

Returns
boolean

onInterceptTouchEvent

boolean onInterceptTouchEvent (MotionEvent event)

Parameters
event MotionEvent
Returns
boolean

onKeyDown

boolean onKeyDown (int keyCode,
                KeyEvent event)

Parameters
keyCode int
event KeyEvent
Returns
boolean

onTouchEvent

boolean onTouchEvent (MotionEvent event)

Parameters
event MotionEvent
Returns
boolean

removeOnCentralPositionChangedListener

void removeOnCentralPositionChangedListener (WearableListView.OnCentralPositionChangedListener listener)

删除列表中心项目更改时将调用的侦听器。

Parameters
listener WearableListView.OnCentralPositionChangedListener

removeOnScrollListener

void removeOnScrollListener (WearableListView.OnScrollListener listener)

删除滚动事件的侦听器。

Parameters
listener WearableListView.OnScrollListener

resetLayoutManager

void resetLayoutManager ()

清除定位列表项目的布局管理器的状态。

setAdapter

void setAdapter (Adapter adapter)

Parameters
adapter Adapter

setClickListener

void setClickListener (WearableListView.ClickListener clickListener)

添加一个侦听器,当用户点击WearableListView或其项目时将会调用该侦听器。

Parameters
clickListener WearableListView.ClickListener

setEnableGestureNavigation

void setEnableGestureNavigation (boolean enabled)

设置是否启用手腕手势列表导航。

Parameters
enabled boolean

setGreedyTouchMode

void setGreedyTouchMode (boolean greedy)

控制WearableListView是否应拦截所有触摸事件并防止父母接收它们。

Parameters
greedy boolean: If true it will intercept all touch events.

setInitialOffset

void setInitialOffset (int top)

默认情况下,列表的第一个元素最初位于屏幕的中心。 此方法允许开发人员指定不同的偏移量,例如在用户被允许使用之前隐藏WearableListView。

Parameters
top int: How far the elements should be pushed down.

setMaximizeSingleItem

void setMaximizeSingleItem (boolean maximizeSingleItem)

当设置为true时,如果WearableListView中只有一个项目,它将填充整个WearableListView。 设置为false时,将使用默认行为,单个项目将只填充屏幕的三分之一。

Parameters
maximizeSingleItem boolean

smoothScrollToPosition

void smoothScrollToPosition (int position,
                RecyclerView.SmoothScroller smoothScroller)

Parameters
position int
smoothScroller RecyclerView.SmoothScroller

Protected methods

onAttachedToWindow

void onAttachedToWindow ()

onDetachedFromWindow

void onDetachedFromWindow ()