UiAutomator（5）--UiScrollable API

UiAutomator（5）--UiScrollable API

一、UiScrollable介绍

   1.UiScrollable是UiCollection的子类

   2.UiScrollable专门处理滚动事件，提供各种滚动方法

二、API使用

   1.快速滚动API

     （1）flingBackward():以步长为5快速向后滑动

     （2）flingForward():以步长为5快速向前滑动

     （3）flingToBeginning(int maxSwipes):自定义扫动次数以步长为5快速滑动到开启

     （4）flingToEnd(int maxSwipes):自定义扫动次数以步长为5快速滑动到结束

    

   2.获取列表子元素API

     （1）getChildByDescrption(UiSeletor childPattern,String text,boolean allowScrollSearch):是否允许滚动查找获取具备UiSelector条件匀速集合后再以文本描述条件查找对象

     （2）getChildByDescription(UiSelector childPattern,String text,int instance):默认滚动获取具备UiSelector条件的元素集合后再以文本描述条件查找对象

     （3）getChildByInstance(UiSelector childPattern,int instance):获取具备UiSelector条件的子集，再从子集中按照实例筛选想要的元素（不滚动）

     （4）getChildByText(UiSelector childPattern,String text,boolean allowScrollSearch):是否允许滚动获取具备UiSelector条件的元素集合后再以文本条件查找对象

     （5）getChildByText(UiSelector childPattern,String text):默认滚动获取具备UiSelector条件元素集合后再以文本条件的查找对象

   3.获取与设置最大滚动次数常量值API

     （1）getMaxSearchSwipes():返回值为int，获取执行搜索滑动过程中的最大滑动次数，默认常量为30

     （2）setMaxSearchSwipes(int swipes):设置最大可扫动次数

   4.滑动区域校准常量设置与获取API

     （1）getSwipeDeadZonePercentage():默认常量值为0.1，10%，返回值为double

     （2）setSwipeDeadZonePercentage(double swipeDeadZonePercentage):设置一个部件的大小，在滑动时，视为无接触区的百分比。

         校准常量指的是，滑动操作坐标时的偏移量，用来取偏移比例。

   

   5.向前与向后滚动API

     （1）scrollBackward(int steps):自定义步长向后滑动

     （2）scrllBackward():以默认步长5s向后滑动

     （3）scrollDecriptionIntoView(String text):滚动到描述所在位置，并且尽量让它居于屏幕中央

     （4）scrollForward():以默认步长5s向前滚动

     （5）scrollForward(int steps):自定义步长向前滚动

 

   6.滚动到某个对象API

     （1）scrollIntoView(UiSelector selector):滚动到条件元素所在位置，并且尽量让其居于屏幕中央

     （2）scrolIntoView(UiObject obj):滚动到对象所在位置，并且尽量让其居于屏幕中央

     （3）scrollTextIntoView(String text):滚动到文本对象所在位置，并且尽量让其居于屏幕中央

     （4）scrollToBeginning(int maxSwipes):滚动到开始位置

     （5）scrollToBeginning(int maxSwipes,int steps):自定义扫动距离与步长滚动到开始位置

     （6）scrollToEnd(int maxSwipes,int steps):自定义扫动距离与步长滚动到结束位置

     （7）scrollToEnd(int maxSwipes):自定义扫动距离滚动到结束位置

  

    7.设置滚动方向API

     （1）setAsHorizontalList():设置滚动方向设置为水平滚动

     （2）setAsVerticalList():设置滚动方向为纵向滚动