Tip：

1.掃動過程中如果界面停留在滾動條的中間部分會先回到起點再進行滾動
2.掃動過程中設置的步長長短決定劃過內容的多少，步長越長滑過的內容就越少；步長越短劃過的內容就越長

一、UiScrollable 類介紹

1.UiScrollable類說明

1）UiScrollable是UiCollection的子類，可以使用UiBoject和UiCollection的所有API
2）UiScrollable是專門處理滾動時間的類，提供各種滾動方法

二、快速滾動

1.滾動相關概念

1）步長：步長越長，滑動越慢
2）掃動：也就是滑動，掃動幾次就是滑動幾次

2.快速滾動相關API

返回值	API	說明
boolean	flingBackward()	以步長為5(默認值)快速向上(后)滑動
boolean	flingForward()	以步長為5(默認值)快速向下(前)滑動
boolean	flingToBeginning(int maxSwipes)	自定義掃動次數以步長為5(默認值)快速滑動到開始
boolean	flingTuEnd(int maxSwipes)	自定義掃動次數以步長為5(默認值)快速滑動到結束

?

• 例如：

public void testDemo1() throws UiObjectNotFoundException{UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));//以步長為5(默認值)快速向下(前)滑動 scroll.flingForward();sleep(1000);//以步長為5(默認值)快速向上(后)滑動 scroll.flingBackward();sleep(1000);//自定義掃動次數(5)以步長為5(默認值)快速滑動到結束scroll.flingToEnd(5);sleep(1000);//自定義掃動次數(4)以步長為5(默認值)快速滑動到開始scroll.flingToBeginning(4);sleep(1000);}

?

?

三、獲取列表子元素

返回值	API	說明
UiObject	getChildByDescription(UiSelector childPattern,String text,boolean allowScrollSearch)	是否允許滾動查找獲取具備UiSelector條件元素集合后再以文本描述條件查找對象
UiObject	getChildByDescription(UiSelector childOattern,String text)	默認獲取具備UiSelector條件的元素集合后再以文本描述條件查找對象
UiObject	getChildByInstance(UiSelector childPattern,int instance)	獲取具備UiSelector條件的子集，再從子集中按照實例篩選想要的元素（不滾動）
UiObject	getChildByText(UiSelector childPattern,String text,boolean allowScrollSearch)	是否允許滾動獲取具備UiSelector條件的元素集合后再以文本條件查查找對象
UiObject	getChildByText(UiSelector childPattern,String text)	默認滾動獲取具備UiSelector條件元素集合后再以文本條件的查找對象

?

• 例如：

public void testDemo2() throws UiObjectNotFoundException{//getChildByText()//1.找到集合UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));//2.使用默認滾動獲取并點擊對象(class.text定位)UiObject Jian1016=scroll.getChildByText(new UiSelector().className("android.view.View"), "Jian1016");Jian1016.click();UiDevice.getInstance().pressBack();//3.允許滾動獲取并點擊對象(class.text定位)UiObject Jian1017=scroll.getChildByText(new UiSelector().className("android.view.View"), "Jian1017",true);Jian1017.click();UiDevice.getInstance().pressBack();//4.不允許滾動獲取并點擊對象(class.text定位);當不允許滾動查找對象的時候若當前界面沒有則報錯UiObject Jian1020=scroll.getChildByText(new UiSelector().className("android.view.View"), "Jian1020",false);Jian1020.click();//getChildByInstance()//需要注意的是他沒有滾動查找選項，他只會按照當前界面顯示instance位置情況進行查找，如果超出當前界面instance數量則報錯UiObject Jian1=scroll.getChildByInstance(new UiSelector().className("android.view.View"), 1);Jian1.click(); }

?

?

四、獲取與設置最大滾動次數常量值

返回值	API	說明
int	getMaxSearchSwipes()	獲取執行搜索滑動過程中的最大滑動次數，默認常量為30 (若30次找不到則報錯)
UiScrollable	setMaxSearchSwipes(int swipes)	設置最大可掃動次數(超出設置次數還未搜索到則報錯)

?

• 例如：

public void testDemo3() throws UiObjectNotFoundException{//getMaxSearchSwipes()//1.找到聯系人列表集合UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));//2.找到以text為條件進行查找UiObject text=new UiObject(new UiSelector().text("Jian1001"));//3.滾動并查找textview(默認滾動30次) scroll.scrollIntoView(text);//5.點擊 text.click();//6.輸出getMaxSearchSwipes()的默認滾動次數 System.out.println(scroll.getMaxSearchSwipes());//setMaxSearchSwipes(int swipes)//1.找到聯系人列表集合UiScrollable scroll1=new UiScrollable(new UiSelector().className("android.widget.ListView"));//2.找到以text為條件進行查找UiObject text1=new UiObject(new UiSelector().text("Jian1001"));//3.設置最大滾動次數為3scroll1.setMaxSearchSwipes(3);//4.滾動并查找對象 scroll1.scrollIntoView(text1);//5.點擊 text1.click();}

?

?

五、滑動區域校準常量設置與獲取

1.校準概念

• 校準常量指滑動操作坐標時候的偏移量，用來取偏移比例

2.相關API

返回值	API	說明
double	getSwipeDeadZonePercentage()	默認常量值為0.1也就是10%區域不滑動
UiScrollable	setSwieDeadZonePercentage(double swipeDeadZonePercentage)	設置一個不見的大小，在滑動時，視為無接觸區的百分比(也就是不滑動區域的百分比)

?

• 例如：

public void testDemo4() throws UiObjectNotFoundException{//1.找到聯系人列表集合UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));//2.聲明變量deaddouble dead=scroll.getSwipeDeadZonePercentage();//3.輸出變量默認值(getSwipeDeadZonePercentage()的默認值) System.out.println(dead);//4.自定義(不滑動區域為20%)(setSwipeDeadZonePercentage())scroll.setSwipeDeadZonePercentage(0.2); //如果加到0.5(50%)則不進行滑動變成點擊操作了 //5.進行滑動操作 scroll.scrollForward();}

?

?

六、向前與向后滾動

返回值	API	說明
boolean	scrollBackward(int steps)	自定義步長向后(上)滾動
boolean	scrollBackward()	以默認步長55向后(上)滾動
boolean	scrollForward()	以默認步長55向前(下)滾動
boolean	scrollForward(int steps)	自定義步長向前(下)滾動

?

• 例如：

public void testDemo5() throws UiObjectNotFoundException{//1.找到聯系人列表集合UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));scroll.scrollForward();//默認向前(下)滾動scroll.scrollForward(20);//自定義步長(20)向前(下)滾動scroll.scrollBackward();//默認向后(上)滾動scroll.scrollBackward(20);//自定義步長(20)向后(上)滾動 }

?

?

七、滾動到某個對象

1.相關API

返回值	API	說明
boolean	scrollIntoView(UiSelector selector)	滾動到條件元素所在位置，并且盡量讓其居于屏幕中央
boolean	scrollIntoView(UiObject obj)	滾動到對象所在位置，并且盡量讓其居于屏幕中央
boolean	scrollTextIntoView(String text)	滾動到文本對象所在位置，并且盡量讓其居于屏幕中央
boolean	scrollDescriptionIntoView(String text)	滾動到描述所在位置，并且盡量讓其居于屏幕中央
boolean	scrollToBeginning(int maxSwipes)	自定義掃動次數滾動到開始位置(使用默認步長)
boolean	scrollToBeginning(int maxSwipes,int steps)	自定義掃動次數與步長滾動到開始位置
boolean	scrollToEnd(int maxSwipes,int steps)	自定義掃動次數與步長滾動到結束位置
boolean	scrollToEnd(int maxSwipes)	自定義掃動次數滾動到結束位置(使用默認步長)

?

• 例如：

public void testDemo6() throws UiObjectNotFoundException{//scrollIntoView(UiSelector selector)//1.找到聯系人列表集合UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));//2.使用UiSelector條件定位對象UiSelector selector=new UiSelector().text("Jian1015");//3.滾動操作 scroll.scrollIntoView(selector);//scrollIntoView(UiObject obj)//1.找到聯系人列表集合UiScrollable scroll1=new UiScrollable(new UiSelector().className("android.widget.ListView"));//2.使用UiObject條件定位對象UiObject obj=new UiObject(new UiSelector().text("Jian1100"));//3.滾動操作 scroll1.scrollIntoView(obj);//scrollTextIntoView(String text) //1.找到聯系人列表集合UiScrollable scroll2=new UiScrollable(new UiSelector().className("android.widget.ListView"));//2.通過文本進行滾動查找操作scroll2.scrollTextIntoView("Jian1100");//scrollDescriptionIntoView(String text)//1.找到聯系人列表集合UiScrollable scroll3=new UiScrollable(new UiSelector().className("android.widget.ListView"));//2.通過描述進行滾動查找操作scroll3.scrollDescriptionIntoView("Jian1011的快速聯系人照片");//1.找到聯系人列表集合UiScrollable scroll4=new UiScrollable(new UiSelector().className("android.widget.ListView"));//2.自定義掃動次數滾動到開始位置(使用默認步長)scroll4.scrollToBeginning(5);//3.自定義掃動次數滾動到結束位置(使用默認步長)scroll4.scrollToEnd(5);//4.自定義掃動次數與步長滾動到開始位置scroll4.scrollToBeginning(5, 10);//5.自定義掃動次數與步長滾動到結束位置scroll4.scrollToEnd(5, 10); }

?

?

八、設置滾動方向

1.相關API

返回值	API	說明
UiScrollable	setAsHorizontalList()	設置滾動方向，設置為水平滾動
UiScrollable	setAsVerticalList()	設置滾動方向，設置為縱向滾動

?

• 例如：

public void testDemo7() throws UiObjectNotFoundException{//1.找到聯系人列表集合(與前面滾動例子中的className不同)UiScrollable scroll4=new UiScrollable(new UiSelector().className("android.widget.FrameLayout"));//2.設置為水平滾動 scroll4.setAsHorizontalList();//3.前(右)后(左)各滾動一次 scroll4.scrollForward();sleep(2000);scroll4.scrollBackward();sleep(2000);//4.設置為縱向滾動 scroll4.setAsVerticalList();//5.前后各滾動一次 scroll4.scrollForward();sleep(2000);scroll4.scrollBackward();sleep(2000);}

轉載于:https://www.cnblogs.com/JianXu/p/5225008.html

總結

以上是生活随笔為你收集整理的5.UiScrollable API 详细介绍的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。