Rect
# UiCollection
UiCollection, 控件集合, 通过选择器的`find()`, `untilFind()`方法返回的对象。
UiCollection"继承"于数组,实际上是一个UiObject的数组,因此可以使用数组的函数和属性,例如使用length属性获取UiCollection的大小,使用forEach函数来遍历UiCollection。
例如,采用forEach遍历屏幕上所有的文本控件并打印出文本内容的代码为:
```
console.show();
className("TextView").find().forEach(function(tv){
if(tv.text() != ""){
log(tv.text());
}
});
```
也可以使用传统的数组遍历方式:
```
console.show();
var uc = className("TextView").find();
for(var i = 0; i < uc.length; i++){
var tv = uc[i];
if(tv.text() != ""){
log(tv.text());
}
}
```
UiCollection的每一个元素都是UiObject,我们可以取出他的元素进行操作,例如取出第一个UiObject并点击的代码为`ui[0].click()`。如果想要对该集合的所有元素进行操作,可以直接在集合上调用相应的函数,例如`uc.click()`,该代码会对集合上所有UiObject执行点击操作并返回是否全部点击成功。
因此,UiCollection具有所有UiObject对控件操作的函数,包括`click()`, `longClick()`, `scrollForward()`等等,不再赘述。
## UiCollection.size()
* 返回 {number}
返回集合中的控件数。
历史遗留函数,相当于属性length。
## UiCollection.get(i)
* `i` {number} 索引
* 返回 [UiObject](#widgets_based_automation_uiobject)
返回集合中第i+1个控件(UiObject)。
历史遗留函数,建议直接使用数组下标的方式访问元素。
## UiCollection.each(func)
* `func` {Function} 遍历函数,参数为UiObject。
遍历集合。
历史遗留函数,相当于`forEach`。参考[forEach](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach)。
## empty()
* 返回 {Boolean}
返回控件集合是否为空。
## nonEmpty()
* 返回 {Boolean}
返回控件集合是否非空。
## UiCollection.find(selector)
* `selector` [UiSelector](#widgets_based_automation_uiselector)
* 返回 [UiCollection](#widgets_based_automation_uicollection)
根据selector所确定的条件在该控件集合的控件、子控件、孙控件...中找到所有符合条件的控件并返回找到的控件集合。
注意这会递归地遍历控件集合里所有的控件以及他们的子控件。和数组的`filter`函数不同。
例如:
```
var names = id("name").find();
//在集合
var clickableNames = names.find(clickable());
```
## UiCollection.findOne(selector)
* `selector` [UiSelector](#widgets_based_automation_uiselector)
* 返回 [UiObject](#widgets_based_automation_uiobject)
根据选择器selector在该控件集合的控件的子控件、孙控件...中搜索符合该选择器条件的控件,并返回找到的第一个控件;如果没有找到符合条件的控件则返回`null`。
# Rect
`UiObject.bounds()`, `UiObject.boundsInParent()`返回的对象。表示一个长方形(范围)。
## Rect.left
* {number}
长方形左边界的x坐标、
## Rect.right
* {number}
长方形右边界的x坐标、
## Rect.top
* {number}
长方形上边界的y坐标、
## Rect.bottom
* {number}
长方形下边界的y坐标、
## Rect.centerX()
* 返回 {number}
长方形中点x坐标。
## Rect.centerY()
* 返回 {number}
长方形中点y坐标。
## Rect.width()
* 返回 {number}
长方形宽度。通常可以作为控件宽度。
## Rect.height()
* 返回 {number}
长方形高度。通常可以作为控件高度。
## Rect.contains(r)
* r [Rect](#widgets_based_automation_rect)
返回是否包含另一个长方形r。包含指的是,长方形r在该长方形的里面(包含边界重叠的情况)。
## Rect.intersect(r)
* r [Rect](#widgets_based_automation_rect)
返回是否和另一个长方形相交。
# UiSelector进阶
未完待续。