UiCollection

public class UiCollection
extends UiObject

java.lang.Object
↳	android.support.test.uiautomator.UiObject
	↳	android.support.test.uiautomator.UiCollection

Known Direct Subclasses

UiScrollable

用于枚举容器的UI元素以进行计数，或者用子元素的文本或描述来定位子元素。

Summary

Inherited constants

From class android.support.test.uiautomator.UiObject

Public constructors
`UiCollection(UiSelector selector)` 按照选择器的描述构造一个实例

Public methods
`UiObject`	`getChildByDescription(UiSelector childPattern, String text)` 在此UiCollection `UiSelector`选择器的约束范围内搜索子UI元素。
`UiObject`	`getChildByInstance(UiSelector childPattern, int instance)` 在此UiCollection `UiSelector`选择器的约束范围内搜索子UI元素。
`UiObject`	`getChildByText(UiSelector childPattern, String text)` 在此UiCollection `UiSelector`选择器的约束范围内搜索子UI元素。
`int`	`getChildCount(UiSelector childPattern)` 计数匹配 `childPattern`参数的子UI元素实例。

Inherited methods

From class android.support.test.uiautomator.UiObject

`void`	`clearTextField()` 清除可编辑字段中的现有文本内容。
`boolean`	`click()` 在由此UiObject表示的UI元素的可见边界的中心执行单击。
`boolean`	`clickAndWaitForNewWindow()` 等待通常需要比通常默认超时更长的窗口转换。
`boolean`	`clickAndWaitForNewWindow(long timeout)` 在由此UiObject表示的UI元素的可见边界的中心执行单击操作，并等待窗口转换。
`boolean`	`clickBottomRight()` 点击UI元素的右下角
`boolean`	`clickTopLeft()` 点击UI元素的左上角
`boolean`	`dragTo(UiObject destObj, int steps)` 将此对象拖到目标UiObject。
`boolean`	`dragTo(int destX, int destY, int steps)` 将该对象拖到任意坐标。
`boolean`	`exists()` 检查视图是否存在。
`AccessibilityNodeInfo`	`findAccessibilityNodeInfo(long timeout)` 通过使用此UiObject的选择器在可访问性层次结构中查找匹配的UI元素。
`Rect`	`getBounds()` 返回视图的 `bounds`属性。
`UiObject`	`getChild(UiSelector selector)` 为当前UiObject下的子视图创建一个新的UiObject。
`int`	`getChildCount()` 立即计算当前UiObject下的子视图。
`String`	`getClassName()` 检索UI元素的 `className`属性。
`String`	`getContentDescription()` 读取UI元素的 `content_desc`属性
`UiObject`	`getFromParent(UiSelector selector)` 相对于当前的UiObject，为同级视图或兄弟视图的子级创建新的UiObject。
`String`	`getPackageName()` 读取视图的 `package`属性
`final UiSelector`	`getSelector()` 调试助手。
`String`	`getText()` 读取UI元素的 `text`属性
`Rect`	`getVisibleBounds()` 返回视图的可见边界。
`boolean`	`isCheckable()` 检查UI元素的 `checkable`属性当前是否为真。
`boolean`	`isChecked()` 检查UI元素的 `checked`属性当前是否为真
`boolean`	`isClickable()` 检查UI元素的 `clickable`属性当前是否为true。
`boolean`	`isEnabled()` 检查UI元素的 `enabled`属性当前是否为真。
`boolean`	`isFocusable()` 检查UI元素的 `focusable`属性当前是否为真。
`boolean`	`isFocused()` 检查UI元素的 `focused`属性当前是否为true
`boolean`	`isLongClickable()` 检查视图的 `long-clickable`属性当前是否为真
`boolean`	`isScrollable()` 检查视图的 `scrollable`属性当前是否为真
`boolean`	`isSelected()` 检查UI元素的 `selected`属性当前是否为真。
`boolean`	`longClick()` 长按一下UI元素可见边界的中心
`boolean`	`longClickBottomRight()` 长按UI元素的右下角
`boolean`	`longClickTopLeft()` 长按一下UI元素的左上角
`boolean`	`performMultiPointerGesture(PointerCoords... touches)` 执行多点触控手势。
`boolean`	`performTwoPointerGesture(Point startPoint1, Point startPoint2, Point endPoint1, Point endPoint2, int steps)` 生成任意起点和终点的双指手势。
`boolean`	`pinchIn(int percent, int steps)` 执行一个双指针手势，每个指针从对角线向另一个对象移动，从边缘到这个UiObject的中心。
`boolean`	`pinchOut(int percent, int steps)` 执行一个双指针手势，每个指针在对角线上相对移动，从中心向外朝向此UiObject的边缘。
`boolean`	`setText(String text)` 清除字段内容后，在可编辑字段中设置文本。
`boolean`	`swipeDown(int steps)` 对UiObject执行滑动操作。
`boolean`	`swipeLeft(int steps)` 在UiObject上执行滑动左操作。
`boolean`	`swipeRight(int steps)` 对UiObject执行滑动右键操作。
`boolean`	`swipeUp(int steps)` 对UiObject执行滑动操作。
`boolean`	`waitForExists(long timeout)` 等待指定的时间长度以使视图变为可见。
`boolean`	`waitUntilGone(long timeout)` 等待指定的时间长度以使视图变得无法检测。

From class java.lang.Object

Public constructors

UiCollection

UiCollection (UiSelector selector)

按照选择器的描述构造一个实例

Public methods

getChildByDescription

UiObject getChildByDescription (UiSelector childPattern, 
                String text)

在此UiCollection UiSelector选择器的约束范围内搜索子UI元素。它会查找匹配childPattern参数的childPattern ，该参数在其子层次结构中具有内容描述文本的任何位置具有子UI元素。返回的UiObject将指向匹配搜索的childPattern实例，而不是匹配内容描述的标识子元素。

Parameters
`childPattern`	`UiSelector`: `UiSelector` selector of the child pattern to match and return
`text`	`String`: String of the identifying child contents of of the `childPattern`

Returns
`UiObject`	`UiObject` pointing at and instance of `childPattern`

Throws
	UiObjectNotFoundException
`UiObjectNotFoundException`

getChildByInstance

UiObject getChildByInstance (UiSelector childPattern, 
                int instance)

在此UiCollection UiSelector选择器的约束范围内搜索子UI元素。它会查找与childPattern参数匹配的childPattern ，该子参数在其子层次结构中指定的instance处具有子UI元素。该操作仅针对可见项目执行，并且在这种情况下不执行滚动。

Parameters
`childPattern`	`UiSelector`: `UiSelector` selector of the child pattern to match and return
`instance`	`int`: int the desired matched instance of this `childPattern`

Returns
`UiObject`	`UiObject` pointing at and instance of `childPattern`

Throws
`UiObjectNotFoundException`

getChildByText

UiObject getChildByText (UiSelector childPattern, 
                String text)

在此UiCollection UiSelector选择器的约束范围内搜索子UI元素。它会查找匹配childPattern参数的childPattern ，该参数在其子层次结构中具有文本属性= text任何位置具有子UI元素。返回的UiObject将指向匹配搜索的childPattern实例，而不是匹配text属性的识别子元素。

Parameters
`childPattern`	`UiSelector`: `UiSelector` selector of the child pattern to match and return
`text`	`String`: String of the identifying child contents of of the `childPattern`

Returns
`UiObject`	`UiObject` pointing at and instance of `childPattern`

Throws
	UiObjectNotFoundException
`UiObjectNotFoundException`

getChildCount

int getChildCount (UiSelector childPattern)

计算与childPattern参数匹配的子UI元素实例。该方法返回当前可见的匹配UI元素的数量。计数不包括在屏幕外的可滚动列表的项目。

Parameters
`childPattern`	`UiSelector`: a `UiSelector` that represents the matching child UI elements to count

Returns
`int`	the number of matched childPattern under the current `UiCollection`

UiCollection

Summary

Inherited constants

Public constructors

Public methods

Inherited methods

Public constructors

UiCollection

Public methods

getChildByDescription

getChildByInstance

getChildByText

getChildCount

Interfaces

Classes

Enums

Exceptions