Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / frameworks / base / bba3270c34c9ee5e70a02d39e398114600d6a553 / . / docs / html / reference / android / support / test / uiautomator / UiObject.html
blob: 6c1a0da760ae2211533d0c907c0653a327db0e5d [file] [log] [blame]
Quddus Chong489218c2015-02-26 16:38:46 -0800[diff] [blame]1<!DOCTYPE html>
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
Quddus Chong900831f2015-04-17 15:01:16 -0700[diff] [blame]98
Quddus Chong489218c2015-02-26 16:38:46 -0800[diff] [blame]99<html>
100<head>
101
102
103<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
104<meta name="viewport" content="width=device-width" />
105
106<link rel="shortcut icon" type="image/x-icon" href="../../../../../favicon.ico" />
107<title>UiObject | Android Developers</title>
108
109<!-- STYLESHEETS -->
110<link rel="stylesheet"
111href="http://fonts.googleapis.com/css?family=Roboto+Condensed">
112<link rel="stylesheet" href="http://fonts.googleapis.com/css?family=Roboto:light,regular,medium,thin,italic,mediumitalic,bold"
113 title="roboto">
Quddus Chong900831f2015-04-17 15:01:16 -0700[diff] [blame]114<link href="../../../../../assets/css/default.css?v=5" rel="stylesheet" type="text/css">
Quddus Chong489218c2015-02-26 16:38:46 -0800[diff] [blame]115
116
117<!-- FULLSCREEN STYLESHEET -->
118<link href="../../../../../assets/css/fullscreen.css" rel="stylesheet" class="fullscreen"
119type="text/css">
120
121
122<!-- JAVASCRIPT -->
123<script src="http://www.google.com/jsapi" type="text/javascript"></script>
124<script src="../../../../../assets/js/android_3p-bundle.js" type="text/javascript"></script>
125<script type="text/javascript">
126 var toRoot = "../../../../../";
127 var metaTags = [];
128 var devsite = false;
129</script>
Quddus Chong900831f2015-04-17 15:01:16 -0700[diff] [blame]130<script src="../../../../../assets/js/docs.js?v=3" type="text/javascript"></script>
131
132
Quddus Chong489218c2015-02-26 16:38:46 -0800[diff] [blame]133
134<script>
135 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
136 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
137 m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
138 })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
139
140 ga('create', 'UA-5831155-1', 'android.com');
141 ga('create', 'UA-49880327-2', 'android.com', {'name': 'universal'}); // New tracker);
142 ga('send', 'pageview');
143 ga('universal.send', 'pageview'); // Send page view for new tracker.
144</script>
145
146</head>
147
148<body class="gc-documentation
149 develop reference" itemscope itemtype="http://schema.org/Article">
150 <div id="doc-api-level" class="" style="display:none"></div>
151 <a name="top"></a>
152
153
154<a name="top"></a>
155
Quddus Chong900831f2015-04-17 15:01:16 -0700[diff] [blame]156<!-- dialog to prompt lang pref change when loaded from hardcoded URL
157<div id="langMessage" style="display:none">
158 <div>
159 <div class="lang en">
160 <p>You requested a page in English, would you like to proceed with this language setting?</p>
161 </div>
162 <div class="lang es">
163 <p>You requested a page in Spanish (Español), would you like to proceed with this language setting?</p>
164 </div>
165 <div class="lang ja">
166 <p>You requested a page in Japanese (日本語), would you like to proceed with this language setting?</p>
167 </div>
168 <div class="lang ko">
169 <p>You requested a page in Korean (한국어), would you like to proceed with this language setting?</p>
170 </div>
171 <div class="lang ru">
172 <p>You requested a page in Russian (Русский), would you like to proceed with this language setting?</p>
173 </div>
174 <div class="lang zh-cn">
175 <p>You requested a page in Simplified Chinese (简体中文), would you like to proceed with this language setting?</p>
176 </div>
177 <div class="lang zh-tw">
178 <p>You requested a page in Traditional Chinese (繁體中文), would you like to proceed with this language setting?</p>
179 </div>
180 <a href="#" class="button yes" onclick="return false;">
181 <span class="lang en">Yes</span>
182 <span class="lang es">Sí</span>
183 <span class="lang ja">Yes</span>
184 <span class="lang ko">Yes</span>
185 <span class="lang ru">Yes</span>
186 <span class="lang zh-cn">是的</span>
187 <span class="lang zh-tw">没有</span>
188 </a>
189 <a href="#" class="button" onclick="$('#langMessage').hide();return false;">
190 <span class="lang en">No</span>
191 <span class="lang es">No</span>
192 <span class="lang ja">No</span>
193 <span class="lang ko">No</span>
194 <span class="lang ru">No</span>
195 <span class="lang zh-cn">没有</span>
196 <span class="lang zh-tw">没有</span>
197 </a>
198 </div>
199</div> -->
200
201
Quddus Chong489218c2015-02-26 16:38:46 -0800[diff] [blame]202 <!-- Header -->
203 <div id="header-wrapper">
204 <div id="header">
205
206
207
208
209 <div class="wrap" id="header-wrap">
210 <div class="col-3 logo">
211 <a href="../../../../../index.html">
212 <img src="../../../../../assets/images/dac_logo.png"
213 srcset="../../../../../assets/images/dac_logo@2x.png 2x"
214 width="123" height="25" alt="Android Developers" />
215 </a>
216 <div class="btn-quicknav" id="btn-quicknav">
217 <a href="#" class="arrow-inactive">Quicknav</a>
218 <a href="#" class="arrow-active">Quicknav</a>
219 </div>
220 </div>
221 <ul class="nav-x col-9">
222 <li class="design">
223 <a href="../../../../../design/index.html"
224 zh-tw-lang="設計"
225 zh-cn-lang="设计"
226 ru-lang="Проектирование"
227 ko-lang="디자인"
228 ja-lang="設計"
229 es-lang="Diseñar"
230 >Design</a></li>
231 <li class="develop"><a href="../../../../../develop/index.html"
232 zh-tw-lang="開發"
233 zh-cn-lang="开发"
234 ru-lang="Разработка"
235 ko-lang="개발"
236 ja-lang="開発"
237 es-lang="Desarrollar"
238 >Develop</a></li>
239 <li class="distribute last"><a href="../../../../../distribute/index.html"
240 zh-tw-lang="發佈"
241 zh-cn-lang="分发"
242 ru-lang="Распространение"
243 ko-lang="배포"
244 ja-lang="配布"
245 es-lang="Distribuir"
246 >Distribute</a></li>
247 </ul>
248
249
250
251
252<div class="menu-container">
253 <div class="moremenu">
254 <div id="more-btn"></div>
255 </div>
256 <div class="morehover" id="moremenu">
257 <div class="top"></div>
258 <div class="mid">
259 <div class="header">Links</div>
260 <ul>
261 <li><a href="https://play.google.com/apps/publish/" target="_googleplay">Google Play Developer Console</a></li>
262 <li><a href="http://android-developers.blogspot.com/">Android Developers Blog</a></li>
263 <li><a href="../../../../../about/index.html">About Android</a></li>
264 </ul>
265 <div class="header">Android Sites</div>
266 <ul>
267 <li><a href="http://www.android.com">Android.com</a></li>
268 <li class="active"><a>Android Developers</a></li>
269 <li><a href="http://source.android.com">Android Open Source Project</a></li>
270 </ul>
271
272
273
274
275 <br class="clearfix" />
276 </div><!-- end 'mid' -->
277 <div class="bottom"></div>
278 </div><!-- end 'moremenu' -->
279
280 <div class="search" id="search-container">
281 <div class="search-inner">
282 <div id="search-btn"></div>
283 <div class="left"></div>
284 <form onsubmit="return submit_search()">
285 <input id="search_autocomplete" type="text" value="" autocomplete="off" name="q"
286 onfocus="search_focus_changed(this, true)" onblur="search_focus_changed(this, false)"
287 onkeydown="return search_changed(event, true, '../../../../../')"
288 onkeyup="return search_changed(event, false, '../../../../../')" />
289 </form>
290 <div class="right"></div>
291 <a class="close hide">close</a>
292 <div class="left"></div>
293 <div class="right"></div>
294 </div><!-- end search-inner -->
295 </div><!-- end search-container -->
296
297 <div class="search_filtered_wrapper reference">
298 <div class="suggest-card reference no-display">
299 <ul class="search_filtered">
300 </ul>
301 </div>
302 </div>
303
304 <div class="search_filtered_wrapper docs">
305 <div class="suggest-card dummy no-display">&nbsp;</div>
306 <div class="suggest-card develop no-display">
307 <ul class="search_filtered">
308 </ul>
309 <div class="child-card guides no-display">
310 </div>
311 <div class="child-card training no-display">
312 </div>
313 <div class="child-card samples no-display">
314 </div>
315 </div>
316 <div class="suggest-card design no-display">
317 <ul class="search_filtered">
318 </ul>
319 </div>
320 <div class="suggest-card distribute no-display">
321 <ul class="search_filtered">
322 </ul>
323 </div>
324 </div>
325</div><!-- end menu-container (search and menu widget) -->
326
327
328
329 <!-- Expanded quicknav -->
330 <div id="quicknav" class="col-13">
331 <ul>
332 <li class="about">
333 <ul>
334 <li><a href="../../../../../about/index.html">About</a></li>
335 <li><a href="../../../../../wear/index.html">Wear</a></li>
336 <li><a href="../../../../../tv/index.html">TV</a></li>
337 <li><a href="../../../../../auto/index.html">Auto</a></li>
338 </ul>
339 </li>
340 <li class="design">
341 <ul>
342 <li><a href="../../../../../design/index.html">Get Started</a></li>
343 <li><a href="../../../../../design/devices.html">Devices</a></li>
344 <li><a href="../../../../../design/style/index.html">Style</a></li>
345 <li><a href="../../../../../design/patterns/index.html">Patterns</a></li>
346 <li><a href="../../../../../design/building-blocks/index.html">Building Blocks</a></li>
347 <li><a href="../../../../../design/downloads/index.html">Downloads</a></li>
348 <li><a href="../../../../../design/videos/index.html">Videos</a></li>
349 </ul>
350 </li>
351 <li class="develop">
352 <ul>
353 <li><a href="../../../../../training/index.html"
354 zh-tw-lang="訓練課程"
355 zh-cn-lang="培训"
356 ru-lang="Курсы"
357 ko-lang="교육"
358 ja-lang="トレーニング"
359 es-lang="Capacitación"
360 >Training</a></li>
361 <li><a href="../../../../../guide/index.html"
362 zh-tw-lang="API 指南"
363 zh-cn-lang="API 指南"
364 ru-lang="Руководства по API"
365 ko-lang="API 가이드"
366 ja-lang="API ガイド"
367 es-lang="Guías de la API"
368 >API Guides</a></li>
369 <li><a href="../../../../../reference/packages.html"
370 zh-tw-lang="參考資源"
371 zh-cn-lang="参考"
372 ru-lang="Справочник"
373 ko-lang="참조문서"
374 ja-lang="リファレンス"
375 es-lang="Referencia"
376 >Reference</a></li>
377 <li><a href="../../../../../sdk/index.html"
378 zh-tw-lang="相關工具"
379 zh-cn-lang="工具"
380 ru-lang="Инструменты"
381 ko-lang="도구"
382 ja-lang="ツール"
383 es-lang="Herramientas"
384 >Tools</a>
385 </li>
386 <li><a href="../../../../../google/index.html">Google Services</a>
387 </li>
388
389 </ul>
390 </li>
391 <li class="distribute last">
392 <ul>
393 <li><a href="../../../../../distribute/googleplay/index.html">Google Play</a></li>
394 <li><a href="../../../../../distribute/essentials/index.html">Essentials</a></li>
395 <li><a href="../../../../../distribute/users/index.html">Get Users</a></li>
396 <li><a href="../../../../../distribute/engage/index.html">Engage &amp; Retain</a></li>
397 <li><a href="../../../../../distribute/monetize/index.html">Monetize</a></li>
Quddus Chong900831f2015-04-17 15:01:16 -0700[diff] [blame]398 <li><a href="../../../../../distribute/analyze/index.html">Analyze</a></li>
Quddus Chong489218c2015-02-26 16:38:46 -0800[diff] [blame]399 <li><a href="../../../../../distribute/tools/index.html">Tools &amp; Reference</a></li>
400 <li><a href="../../../../../distribute/stories/index.html">Developer Stories</a></li>
401 </ul>
402 </li>
403 </ul>
404 </div><!-- /Expanded quicknav -->
405 </div><!-- end header-wrap.wrap -->
406 </div><!-- end header -->
407
408
409 <!-- Secondary x-nav -->
410 <div id="nav-x">
411 <div class="wrap" style="position:relative;z-index:1">
412
413
Quddus Chong489218c2015-02-26 16:38:46 -0800[diff] [blame]414
Quddus Chong489218c2015-02-26 16:38:46 -0800[diff] [blame]415
416
417 <ul class="nav-x col-9 develop" style="width:100%">
418 <li class="training"><a href="../../../../../training/index.html"
419 zh-tw-lang="訓練課程"
420 zh-cn-lang="培训"
421 ru-lang="Курсы"
422 ko-lang="교육"
423 ja-lang="トレーニング"
424 es-lang="Capacitación"
425 >Training</a></li>
426 <li class="guide"><a href="../../../../../guide/index.html"
427 zh-tw-lang="API 指南"
428 zh-cn-lang="API 指南"
429 ru-lang="Руководства по API"
430 ko-lang="API 가이드"
431 ja-lang="API ガイド"
432 es-lang="Guías de la API"
433 >API Guides</a></li>
434 <li class="reference"><a href="../../../../../reference/packages.html"
435 zh-tw-lang="參考資源"
436 zh-cn-lang="参考"
437 ru-lang="Справочник"
438 ko-lang="참조문서"
439 ja-lang="リファレンス"
440 es-lang="Referencia"
441 >Reference</a></li>
442 <li class="tools"><a href="../../../../../sdk/index.html"
443 zh-tw-lang="相關工具"
444 zh-cn-lang="工具"
445 ru-lang="Инструменты"
446 ko-lang="도구"
447 ja-lang="ツール"
448 es-lang="Herramientas"
449 >Tools</a></li>
450 <li class="google"><a href="../../../../../google/index.html"
451 >Google Services</a>
452 </li>
453
454 </ul>
455 </div>
456 </div>
457 <!-- /Sendondary x-nav DEVELOP -->
458
459
460
461 <div id="searchResults" class="wrap" style="display:none;">
462 <h2 id="searchTitle">Results</h2>
463 <div id="leftSearchControl" class="search-control">Loading...</div>
464 </div>
465 </div> <!--end header-wrapper -->
466
467 <div id="sticky-header">
468 <div>
469 <a class="logo" href="#top"></a>
470 <a class="top" href="#top"></a>
471 <ul class="breadcrumb">
472
473 <li class="current">UiObject</li>
474 </ul>
475 </div>
476 </div>
477
478
479
480
481
482 <div class="wrap clearfix" id="body-content">
483 <div class="col-4" id="side-nav" itemscope itemtype="http://schema.org/SiteNavigationElement">
484 <div id="devdoc-nav">
485 <div id="api-nav-header">
486 <div id="api-level-toggle">
487 <label for="apiLevelCheckbox" class="disabled"
488 title="Select your target API level to dim unavailable APIs">API level: </label>
489 <div class="select-wrapper">
490 <select id="apiLevelSelector">
491 <!-- option elements added by buildApiLevelSelector() -->
492 </select>
493 </div>
494 </div><!-- end toggle -->
495 <div id="api-nav-title">Android APIs</div>
496 </div><!-- end nav header -->
497 <script>
498 var SINCE_DATA = [ ];
499 buildApiLevelSelector();
500 </script>
501
502 <div id="swapper">
503 <div id="nav-panels">
504 <div id="resize-packages-nav">
505 <div id="packages-nav" class="scroll-pane">
506
507 <ul>
508
509 <li class="api apilevel-">
510 <a href="../../../../../reference/android/support/test/package-summary.html">android.support.test</a></li>
511 <li class="api apilevel-">
Quddus Chong900831f2015-04-17 15:01:16 -0700[diff] [blame]512 <a href="../../../../../reference/android/support/test/annotation/package-summary.html">android.support.test.annotation</a></li>
513 <li class="api apilevel-">
Quddus Chong489218c2015-02-26 16:38:46 -0800[diff] [blame]514 <a href="../../../../../reference/android/support/test/espresso/package-summary.html">android.support.test.espresso</a></li>
515 <li class="api apilevel-">
516 <a href="../../../../../reference/android/support/test/espresso/action/package-summary.html">android.support.test.espresso.action</a></li>
517 <li class="api apilevel-">
518 <a href="../../../../../reference/android/support/test/espresso/assertion/package-summary.html">android.support.test.espresso.assertion</a></li>
519 <li class="api apilevel-">
520 <a href="../../../../../reference/android/support/test/espresso/base/package-summary.html">android.support.test.espresso.base</a></li>
521 <li class="api apilevel-">
522 <a href="../../../../../reference/android/support/test/espresso/contrib/package-summary.html">android.support.test.espresso.contrib</a></li>
523 <li class="api apilevel-">
Quddus Chong900831f2015-04-17 15:01:16 -0700[diff] [blame]524 <a href="../../../../../reference/android/support/test/espresso/intent/package-summary.html">android.support.test.espresso.intent</a></li>
525 <li class="api apilevel-">
526 <a href="../../../../../reference/android/support/test/espresso/intent/matcher/package-summary.html">android.support.test.espresso.intent.matcher</a></li>
527 <li class="api apilevel-">
528 <a href="../../../../../reference/android/support/test/espresso/intent/rule/package-summary.html">android.support.test.espresso.intent.rule</a></li>
529 <li class="api apilevel-">
Quddus Chong489218c2015-02-26 16:38:46 -0800[diff] [blame]530 <a href="../../../../../reference/android/support/test/espresso/matcher/package-summary.html">android.support.test.espresso.matcher</a></li>
531 <li class="api apilevel-">
532 <a href="../../../../../reference/android/support/test/espresso/util/package-summary.html">android.support.test.espresso.util</a></li>
533 <li class="api apilevel-">
534 <a href="../../../../../reference/android/support/test/filters/package-summary.html">android.support.test.filters</a></li>
535 <li class="api apilevel-">
Quddus Chong900831f2015-04-17 15:01:16 -0700[diff] [blame]536 <a href="../../../../../reference/android/support/test/rule/package-summary.html">android.support.test.rule</a></li>
537 <li class="api apilevel-">
Quddus Chong489218c2015-02-26 16:38:46 -0800[diff] [blame]538 <a href="../../../../../reference/android/support/test/runner/package-summary.html">android.support.test.runner</a></li>
539 <li class="api apilevel-">
Quddus Chong900831f2015-04-17 15:01:16 -0700[diff] [blame]540 <a href="../../../../../reference/android/support/test/runner/intent/package-summary.html">android.support.test.runner.intent</a></li>
541 <li class="api apilevel-">
Quddus Chong489218c2015-02-26 16:38:46 -0800[diff] [blame]542 <a href="../../../../../reference/android/support/test/runner/lifecycle/package-summary.html">android.support.test.runner.lifecycle</a></li>
543 <li class="selected api apilevel-">
544 <a href="../../../../../reference/android/support/test/uiautomator/package-summary.html">android.support.test.uiautomator</a></li>
545 </ul><br/>
546
547 </div> <!-- end packages-nav -->
548 </div> <!-- end resize-packages -->
549 <div id="classes-nav" class="scroll-pane">
550
551
552
553 <ul>
554
555
556 <li><h2>Interfaces</h2>
557 <ul>
558 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/IAutomationSupport.html">IAutomationSupport</a></li>
559 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/UiWatcher.html">UiWatcher</a></li>
560 </ul>
561 </li>
562
563 <li><h2>Classes</h2>
564 <ul>
565 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/By.html">By</a></li>
566 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/BySelector.html">BySelector</a></li>
567 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/Configurator.html">Configurator</a></li>
568 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/EventCondition.html">EventCondition</a></li>
569 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/SearchCondition.html">SearchCondition</a></li>
570 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/UiAutomatorInstrumentationTestRunner.html">UiAutomatorInstrumentationTestRunner</a></li>
571 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/UiAutomatorTestCase.html">UiAutomatorTestCase</a></li>
572 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/UiCollection.html">UiCollection</a></li>
573 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/UiDevice.html">UiDevice</a></li>
574 <li class="selected api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html">UiObject</a></li>
575 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/UiObject2.html">UiObject2</a></li>
576 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/UiObject2Condition.html">UiObject2Condition</a></li>
577 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html">UiScrollable</a></li>
578 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/UiSelector.html">UiSelector</a></li>
579 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/Until.html">Until</a></li>
580 </ul>
581 </li>
582
583 <li><h2>Enums</h2>
584 <ul>
585 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/Direction.html">Direction</a></li>
586 </ul>
587 </li>
588
589 <li><h2>Exceptions</h2>
590 <ul>
591 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/StaleObjectException.html">StaleObjectException</a></li>
592 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></li>
593 </ul>
594 </li>
595
596 </ul><br/>
597
598
599 </div><!-- end classes -->
600 </div><!-- end nav-panels -->
601 <div id="nav-tree" style="display:none" class="scroll-pane">
602 <div id="tree-list"></div>
603 </div><!-- end nav-tree -->
604 </div><!-- end swapper -->
605 <div id="nav-swap">
606 <a class="fullscreen">fullscreen</a>
607 <a href='#' onclick='swapNav();return false;'><span id='tree-link'>Use Tree Navigation</span><span id='panel-link' style='display:none'>Use Panel Navigation</span></a>
608 </div>
609 </div> <!-- end devdoc-nav -->
610 </div> <!-- end side-nav -->
611 <script type="text/javascript">
612 // init fullscreen based on user pref
613 var fullscreen = readCookie("fullscreen");
614 if (fullscreen != 0) {
615 if (fullscreen == "false") {
616 toggleFullscreen(false);
617 } else {
618 toggleFullscreen(true);
619 }
620 }
621 // init nav version for mobile
622 if (isMobile) {
623 swapNav(); // tree view should be used on mobile
624 $('#nav-swap').hide();
625 } else {
626 chooseDefaultNav();
627 if ($("#nav-tree").is(':visible')) {
628 init_default_navtree("../../../../../");
629 }
630 }
631 // scroll the selected page into view
632 $(document).ready(function() {
633 scrollIntoView("packages-nav");
634 scrollIntoView("classes-nav");
635 });
636 </script>
637
638
639
640
641
642<div class="col-12" id="doc-col">
643
644<div id="api-info-block">
645
646
647
648
649
650
651
652
653
654
655
656<div class="sum-details-links">
657
658Summary:
659
660
661
662
663
664 <a href="#constants">Constants</a>
665
666
667
668
669
670
671 &#124; <a href="#pubctors">Ctors</a>
672
673
674
675
676 &#124; <a href="#pubmethods">Methods</a>
677
678
679
680 &#124; <a href="#promethods">Protected Methods</a>
681
682
683
684 &#124; <a href="#inhmethods">Inherited Methods</a>
685
686&#124; <a href="#" onclick="return toggleAllClassInherited()" id="toggleAllClassInherited">[Expand All]</a>
687
688</div><!-- end sum-details-links -->
689<div class="api-level">
690
691
692
693
694</div>
695</div><!-- end api-info-block -->
696
697
698<!-- ======== START OF CLASS DATA ======== -->
699
700<div id="jd-header">
701 public
702
703
704
705 class
706<h1 itemprop="name">UiObject</h1>
707
708
709
710
711 extends Object<br/>
712
713
714
715
716
717
718
719
720
721
722
723
724</div><!-- end header -->
725
726<div id="naMessage"></div>
727
728<div id="jd-content" class="api apilevel-">
729<table class="jd-inheritance-table">
730
731
732 <tr>
733
734 <td colspan="2" class="jd-inheritance-class-cell">java.lang.Object</td>
735 </tr>
736
737
738 <tr>
739
740 <td class="jd-inheritance-space">&nbsp;&nbsp;&nbsp;&#x21b3;</td>
741
742 <td colspan="1" class="jd-inheritance-class-cell">android.support.test.uiautomator.UiObject</td>
743 </tr>
744
745
746</table>
747
748
749
750
751<table class="jd-sumtable jd-sumtable-subclasses"><tr><td colspan="12" style="border:none;margin:0;padding:0;">
752
753 <a href="#" onclick="return toggleInherited(this, null)" id="subclasses-direct" class="jd-expando-trigger closed"
754 ><img id="subclasses-direct-trigger"
755 src="../../../../../assets/images/triangle-closed.png"
756 class="jd-expando-trigger-img" /></a>Known Direct Subclasses
757
758 <div id="subclasses-direct">
759 <div id="subclasses-direct-list"
760 class="jd-inheritedlinks"
761
762 >
763
764
765 <a href="../../../../../reference/android/support/test/uiautomator/UiCollection.html">UiCollection</a>
766
767
768 </div>
769 <div id="subclasses-direct-summary"
770 style="display: none;"
771 >
772
773 <table class="jd-sumtable-expando">
774
775 <tr class="alt-color api apilevel-" >
776 <td class="jd-linkcol"><a href="../../../../../reference/android/support/test/uiautomator/UiCollection.html">UiCollection</a></td>
777 <td class="jd-descrcol" width="100%">
778 Used to enumerate a container's UI elements for the purpose of counting,
779 or targeting a sub elements by a child's text or description.&nbsp;
780
781
782
783 </td>
784 </tr>
785
786
787 </table>
788
789 </div>
790 </div>
791</td></tr></table>
792
793
794
795<table class="jd-sumtable jd-sumtable-subclasses"><tr><td colspan="12" style="border:none;margin:0;padding:0;">
796
797 <a href="#" onclick="return toggleInherited(this, null)" id="subclasses-indirect" class="jd-expando-trigger closed"
798 ><img id="subclasses-indirect-trigger"
799 src="../../../../../assets/images/triangle-closed.png"
800 class="jd-expando-trigger-img" /></a>Known Indirect Subclasses
801
802 <div id="subclasses-indirect">
803 <div id="subclasses-indirect-list"
804 class="jd-inheritedlinks"
805
806 >
807
808
809 <a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html">UiScrollable</a>
810
811
812 </div>
813 <div id="subclasses-indirect-summary"
814 style="display: none;"
815 >
816
817 <table class="jd-sumtable-expando">
818
819 <tr class="alt-color api apilevel-" >
820 <td class="jd-linkcol"><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html">UiScrollable</a></td>
821 <td class="jd-descrcol" width="100%">
822 UiScrollable is a <code><a href="../../../../../reference/android/support/test/uiautomator/UiCollection.html">UiCollection</a></code> and provides support for searching
823 for items in scrollable layout elements.&nbsp;
824
825
826
827 </td>
828 </tr>
829
830
831 </table>
832
833 </div>
834 </div>
835</td></tr></table>
836
837
838<div class="jd-descr">
839
840
841<h2>Class Overview</h2>
842<p itemprop="articleBody">A UiObject is a representation of a view. It is not in any way directly bound to a
843 view as an object reference. A UiObject contains information to help it
844 locate a matching view at runtime based on the <code><a href="../../../../../reference/android/support/test/uiautomator/UiSelector.html">UiSelector</a></code> properties specified in
845 its constructor. Once you create an instance of a UiObject, it can
846 be reused for different views that match the selector criteria.</p>
847
848
849
850
851
852</div><!-- jd-descr -->
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869<div class="jd-descr">
870
871
872<h2>Summary</h2>
873
874
875
876
877
878
879
880
881
882
883
884
885
886<!-- =========== ENUM CONSTANT SUMMARY =========== -->
887<table id="constants" class="jd-sumtable"><tr><th colspan="12">Constants</th></tr>
888
889
890
891 <tr class="alt-color api apilevel-" >
892 <td class="jd-typecol">int</td>
893 <td class="jd-linkcol"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#FINGER_TOUCH_HALF_WIDTH">FINGER_TOUCH_HALF_WIDTH</a></td>
894 <td class="jd-descrcol" width="100%">
895
896
897
898
899 </td>
900 </tr>
901
902
903 <tr class=" api apilevel-" >
904 <td class="jd-typecol">int</td>
905 <td class="jd-linkcol"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#SWIPE_MARGIN_LIMIT">SWIPE_MARGIN_LIMIT</a></td>
906 <td class="jd-descrcol" width="100%">
907
908
909
910
911 </td>
912 </tr>
913
914
915 <tr class="alt-color api apilevel-" >
916 <td class="jd-typecol">long</td>
917 <td class="jd-linkcol"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#WAIT_FOR_EVENT_TMEOUT">WAIT_FOR_EVENT_TMEOUT</a></td>
918 <td class="jd-descrcol" width="100%">
919 <em>
920 This constant is deprecated.
921 use <code><a href="../../../../../reference/android/support/test/uiautomator/Configurator.html#setScrollAcknowledgmentTimeout(long)">setScrollAcknowledgmentTimeout(long)</a></code>
922</em>
923
924
925
926 </td>
927 </tr>
928
929
930 <tr class=" api apilevel-" >
931 <td class="jd-typecol">long</td>
932 <td class="jd-linkcol"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#WAIT_FOR_SELECTOR_POLL">WAIT_FOR_SELECTOR_POLL</a></td>
933 <td class="jd-descrcol" width="100%">
934
935
936
937
938 </td>
939 </tr>
940
941
942 <tr class="alt-color api apilevel-" >
943 <td class="jd-typecol">long</td>
944 <td class="jd-linkcol"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#WAIT_FOR_SELECTOR_TIMEOUT">WAIT_FOR_SELECTOR_TIMEOUT</a></td>
945 <td class="jd-descrcol" width="100%">
946 <em>
947 This constant is deprecated.
948 use <code><a href="../../../../../reference/android/support/test/uiautomator/Configurator.html#setWaitForSelectorTimeout(long)">setWaitForSelectorTimeout(long)</a></code>
949</em>
950
951
952
953 </td>
954 </tr>
955
956
957 <tr class=" api apilevel-" >
958 <td class="jd-typecol">long</td>
959 <td class="jd-linkcol"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#WAIT_FOR_WINDOW_TMEOUT">WAIT_FOR_WINDOW_TMEOUT</a></td>
960 <td class="jd-descrcol" width="100%">
961
962
963
964
965 </td>
966 </tr>
967
968
969
970</table>
971
972
973
974
975
976
977
978
979
980
981
982
983<!-- ======== CONSTRUCTOR SUMMARY ======== -->
984<table id="pubctors" class="jd-sumtable"><tr><th colspan="12">Public Constructors</th></tr>
985
986
987
988
989 <tr class="alt-color api apilevel-" >
990 <td class="jd-typecol"><nobr>
991
992
993
994
995
996 </nobr>
997 </td>
998 <td class="jd-linkcol" width="100%"><nobr>
999 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#UiObject(android.support.test.uiautomator.UiSelector)">UiObject</a></span>(<a href="../../../../../reference/android/support/test/uiautomator/UiSelector.html">UiSelector</a> selector)</nobr>
1000
1001 <div class="jd-descrdiv">
1002 <em>
1003 This constructor is deprecated.
1004 Use <code><a href="../../../../../reference/android/support/test/uiautomator/UiDevice.html#findObject(android.support.test.uiautomator.UiSelector)">findObject(UiSelector)</a></code> instead. This version hides
1005 UiObject's dependency on UiDevice and is prone to misuse.</em>
1006
1007
1008
1009 </div>
1010
1011 </td></tr>
1012
1013
1014
1015</table>
1016
1017
1018
1019
1020
1021
1022<!-- ========== METHOD SUMMARY =========== -->
1023<table id="pubmethods" class="jd-sumtable"><tr><th colspan="12">Public Methods</th></tr>
1024
1025
1026
1027
1028 <tr class="alt-color api apilevel-" >
1029 <td class="jd-typecol"><nobr>
1030
1031
1032
1033
1034
1035 void</nobr>
1036 </td>
1037 <td class="jd-linkcol" width="100%"><nobr>
1038 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#clearTextField()">clearTextField</a></span>()</nobr>
1039
1040 <div class="jd-descrdiv">
1041 Clears the existing text contents in an editable field.
1042
1043
1044
1045 </div>
1046
1047 </td></tr>
1048
1049
1050
1051 <tr class=" api apilevel-" >
1052 <td class="jd-typecol"><nobr>
1053
1054
1055
1056
1057
1058 boolean</nobr>
1059 </td>
1060 <td class="jd-linkcol" width="100%"><nobr>
1061 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#click()">click</a></span>()</nobr>
1062
1063 <div class="jd-descrdiv">
1064 Performs a click at the center of the visible bounds of the UI element represented
1065 by this UiObject.
1066
1067
1068
1069 </div>
1070
1071 </td></tr>
1072
1073
1074
1075 <tr class="alt-color api apilevel-" >
1076 <td class="jd-typecol"><nobr>
1077
1078
1079
1080
1081
1082 boolean</nobr>
1083 </td>
1084 <td class="jd-linkcol" width="100%"><nobr>
1085 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#clickAndWaitForNewWindow(long)">clickAndWaitForNewWindow</a></span>(long timeout)</nobr>
1086
1087 <div class="jd-descrdiv">
1088 Performs a click at the center of the visible bounds of the UI element represented
1089 by this UiObject and waits for window transitions.
1090
1091
1092
1093 </div>
1094
1095 </td></tr>
1096
1097
1098
1099 <tr class=" api apilevel-" >
1100 <td class="jd-typecol"><nobr>
1101
1102
1103
1104
1105
1106 boolean</nobr>
1107 </td>
1108 <td class="jd-linkcol" width="100%"><nobr>
1109 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#clickAndWaitForNewWindow()">clickAndWaitForNewWindow</a></span>()</nobr>
1110
1111 <div class="jd-descrdiv">
1112 Waits for window transitions that would typically take longer than the
1113 usual default timeouts.
1114
1115
1116
1117 </div>
1118
1119 </td></tr>
1120
1121
1122
1123 <tr class="alt-color api apilevel-" >
1124 <td class="jd-typecol"><nobr>
1125
1126
1127
1128
1129
1130 boolean</nobr>
1131 </td>
1132 <td class="jd-linkcol" width="100%"><nobr>
1133 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#clickBottomRight()">clickBottomRight</a></span>()</nobr>
1134
1135 <div class="jd-descrdiv">
1136 Clicks the bottom and right corner of the UI element
1137
1138
1139
1140 </div>
1141
1142 </td></tr>
1143
1144
1145
1146 <tr class=" api apilevel-" >
1147 <td class="jd-typecol"><nobr>
1148
1149
1150
1151
1152
1153 boolean</nobr>
1154 </td>
1155 <td class="jd-linkcol" width="100%"><nobr>
1156 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#clickTopLeft()">clickTopLeft</a></span>()</nobr>
1157
1158 <div class="jd-descrdiv">
1159 Clicks the top and left corner of the UI element
1160
1161
1162
1163 </div>
1164
1165 </td></tr>
1166
1167
1168
1169 <tr class="alt-color api apilevel-" >
1170 <td class="jd-typecol"><nobr>
1171
1172
1173
1174
1175
1176 boolean</nobr>
1177 </td>
1178 <td class="jd-linkcol" width="100%"><nobr>
1179 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#dragTo(android.support.test.uiautomator.UiObject, int)">dragTo</a></span>(<a href="../../../../../reference/android/support/test/uiautomator/UiObject.html">UiObject</a> destObj, int steps)</nobr>
1180
1181 <div class="jd-descrdiv">
1182 Drags this object to a destination UiObject.
1183
1184
1185
1186 </div>
1187
1188 </td></tr>
1189
1190
1191
1192 <tr class=" api apilevel-" >
1193 <td class="jd-typecol"><nobr>
1194
1195
1196
1197
1198
1199 boolean</nobr>
1200 </td>
1201 <td class="jd-linkcol" width="100%"><nobr>
1202 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#dragTo(int, int, int)">dragTo</a></span>(int destX, int destY, int steps)</nobr>
1203
1204 <div class="jd-descrdiv">
1205 Drags this object to arbitrary coordinates.
1206
1207
1208
1209 </div>
1210
1211 </td></tr>
1212
1213
1214
1215 <tr class="alt-color api apilevel-" >
1216 <td class="jd-typecol"><nobr>
1217
1218
1219
1220
1221
1222 boolean</nobr>
1223 </td>
1224 <td class="jd-linkcol" width="100%"><nobr>
1225 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#exists()">exists</a></span>()</nobr>
1226
1227 <div class="jd-descrdiv">
1228 Check if view exists.
1229
1230
1231
1232 </div>
1233
1234 </td></tr>
1235
1236
1237
1238 <tr class=" api apilevel-" >
1239 <td class="jd-typecol"><nobr>
1240
1241
1242
1243
1244
1245 Rect</nobr>
1246 </td>
1247 <td class="jd-linkcol" width="100%"><nobr>
1248 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#getBounds()">getBounds</a></span>()</nobr>
1249
1250 <div class="jd-descrdiv">
1251 Returns the view's <code>bounds</code> property.
1252
1253
1254
1255 </div>
1256
1257 </td></tr>
1258
1259
1260
1261 <tr class="alt-color api apilevel-" >
1262 <td class="jd-typecol"><nobr>
1263
1264
1265
1266
1267
1268 <a href="../../../../../reference/android/support/test/uiautomator/UiObject.html">UiObject</a></nobr>
1269 </td>
1270 <td class="jd-linkcol" width="100%"><nobr>
1271 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#getChild(android.support.test.uiautomator.UiSelector)">getChild</a></span>(<a href="../../../../../reference/android/support/test/uiautomator/UiSelector.html">UiSelector</a> selector)</nobr>
1272
1273 <div class="jd-descrdiv">
1274 Creates a new UiObject for a child view that is under the present UiObject.
1275
1276
1277
1278 </div>
1279
1280 </td></tr>
1281
1282
1283
1284 <tr class=" api apilevel-" >
1285 <td class="jd-typecol"><nobr>
1286
1287
1288
1289
1290
1291 int</nobr>
1292 </td>
1293 <td class="jd-linkcol" width="100%"><nobr>
1294 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#getChildCount()">getChildCount</a></span>()</nobr>
1295
1296 <div class="jd-descrdiv">
1297 Counts the child views immediately under the present UiObject.
1298
1299
1300
1301 </div>
1302
1303 </td></tr>
1304
1305
1306
1307 <tr class="alt-color api apilevel-" >
1308 <td class="jd-typecol"><nobr>
1309
1310
1311
1312
1313
1314 String</nobr>
1315 </td>
1316 <td class="jd-linkcol" width="100%"><nobr>
1317 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#getClassName()">getClassName</a></span>()</nobr>
1318
1319 <div class="jd-descrdiv">
1320 Retrieves the <code>className</code> property of the UI element.
1321
1322
1323
1324 </div>
1325
1326 </td></tr>
1327
1328
1329
1330 <tr class=" api apilevel-" >
1331 <td class="jd-typecol"><nobr>
1332
1333
1334
1335
1336
1337 String</nobr>
1338 </td>
1339 <td class="jd-linkcol" width="100%"><nobr>
1340 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#getContentDescription()">getContentDescription</a></span>()</nobr>
1341
1342 <div class="jd-descrdiv">
1343 Reads the <code>content_desc</code> property of the UI element
1344
1345
1346
1347 </div>
1348
1349 </td></tr>
1350
1351
1352
1353 <tr class="alt-color api apilevel-" >
1354 <td class="jd-typecol"><nobr>
1355
1356
1357
1358
1359
1360 <a href="../../../../../reference/android/support/test/uiautomator/UiObject.html">UiObject</a></nobr>
1361 </td>
1362 <td class="jd-linkcol" width="100%"><nobr>
1363 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#getFromParent(android.support.test.uiautomator.UiSelector)">getFromParent</a></span>(<a href="../../../../../reference/android/support/test/uiautomator/UiSelector.html">UiSelector</a> selector)</nobr>
1364
1365 <div class="jd-descrdiv">
1366 Creates a new UiObject for a sibling view or a child of the sibling view,
1367 relative to the present UiObject.
1368
1369
1370
1371 </div>
1372
1373 </td></tr>
1374
1375
1376
1377 <tr class=" api apilevel-" >
1378 <td class="jd-typecol"><nobr>
1379
1380
1381
1382
1383
1384 String</nobr>
1385 </td>
1386 <td class="jd-linkcol" width="100%"><nobr>
1387 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#getPackageName()">getPackageName</a></span>()</nobr>
1388
1389 <div class="jd-descrdiv">
1390 Reads the view's <code>package</code> property
1391
1392
1393
1394 </div>
1395
1396 </td></tr>
1397
1398
1399
1400 <tr class="alt-color api apilevel-" >
1401 <td class="jd-typecol"><nobr>
1402
1403
1404 final
1405
1406
1407 <a href="../../../../../reference/android/support/test/uiautomator/UiSelector.html">UiSelector</a></nobr>
1408 </td>
1409 <td class="jd-linkcol" width="100%"><nobr>
1410 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#getSelector()">getSelector</a></span>()</nobr>
1411
1412 <div class="jd-descrdiv">
1413 Debugging helper.
1414
1415
1416
1417 </div>
1418
1419 </td></tr>
1420
1421
1422
1423 <tr class=" api apilevel-" >
1424 <td class="jd-typecol"><nobr>
1425
1426
1427
1428
1429
1430 String</nobr>
1431 </td>
1432 <td class="jd-linkcol" width="100%"><nobr>
1433 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#getText()">getText</a></span>()</nobr>
1434
1435 <div class="jd-descrdiv">
1436 Reads the <code>text</code> property of the UI element
1437
1438
1439
1440 </div>
1441
1442 </td></tr>
1443
1444
1445
1446 <tr class="alt-color api apilevel-" >
1447 <td class="jd-typecol"><nobr>
1448
1449
1450
1451
1452
1453 Rect</nobr>
1454 </td>
1455 <td class="jd-linkcol" width="100%"><nobr>
1456 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#getVisibleBounds()">getVisibleBounds</a></span>()</nobr>
1457
1458 <div class="jd-descrdiv">
1459 Returns the visible bounds of the view.
1460
1461
1462
1463 </div>
1464
1465 </td></tr>
1466
1467
1468
1469 <tr class=" api apilevel-" >
1470 <td class="jd-typecol"><nobr>
1471
1472
1473
1474
1475
1476 boolean</nobr>
1477 </td>
1478 <td class="jd-linkcol" width="100%"><nobr>
1479 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#isCheckable()">isCheckable</a></span>()</nobr>
1480
1481 <div class="jd-descrdiv">
1482 Checks if the UI element's <code>checkable</code> property is currently true.
1483
1484
1485
1486 </div>
1487
1488 </td></tr>
1489
1490
1491
1492 <tr class="alt-color api apilevel-" >
1493 <td class="jd-typecol"><nobr>
1494
1495
1496
1497
1498
1499 boolean</nobr>
1500 </td>
1501 <td class="jd-linkcol" width="100%"><nobr>
1502 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#isChecked()">isChecked</a></span>()</nobr>
1503
1504 <div class="jd-descrdiv">
1505 Check if the UI element's <code>checked</code> property is currently true
1506
1507
1508
1509 </div>
1510
1511 </td></tr>
1512
1513
1514
1515 <tr class=" api apilevel-" >
1516 <td class="jd-typecol"><nobr>
1517
1518
1519
1520
1521
1522 boolean</nobr>
1523 </td>
1524 <td class="jd-linkcol" width="100%"><nobr>
1525 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#isClickable()">isClickable</a></span>()</nobr>
1526
1527 <div class="jd-descrdiv">
1528 Checks if the UI element's <code>clickable</code> property is currently true.
1529
1530
1531
1532 </div>
1533
1534 </td></tr>
1535
1536
1537
1538 <tr class="alt-color api apilevel-" >
1539 <td class="jd-typecol"><nobr>
1540
1541
1542
1543
1544
1545 boolean</nobr>
1546 </td>
1547 <td class="jd-linkcol" width="100%"><nobr>
1548 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#isEnabled()">isEnabled</a></span>()</nobr>
1549
1550 <div class="jd-descrdiv">
1551 Checks if the UI element's <code>enabled</code> property is currently true.
1552
1553
1554
1555 </div>
1556
1557 </td></tr>
1558
1559
1560
1561 <tr class=" api apilevel-" >
1562 <td class="jd-typecol"><nobr>
1563
1564
1565
1566
1567
1568 boolean</nobr>
1569 </td>
1570 <td class="jd-linkcol" width="100%"><nobr>
1571 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#isFocusable()">isFocusable</a></span>()</nobr>
1572
1573 <div class="jd-descrdiv">
1574 Check if the UI element's <code>focusable</code> property is currently true.
1575
1576
1577
1578 </div>
1579
1580 </td></tr>
1581
1582
1583
1584 <tr class="alt-color api apilevel-" >
1585 <td class="jd-typecol"><nobr>
1586
1587
1588
1589
1590
1591 boolean</nobr>
1592 </td>
1593 <td class="jd-linkcol" width="100%"><nobr>
1594 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#isFocused()">isFocused</a></span>()</nobr>
1595
1596 <div class="jd-descrdiv">
1597 Check if the UI element's <code>focused</code> property is currently true
1598
1599
1600
1601 </div>
1602
1603 </td></tr>
1604
1605
1606
1607 <tr class=" api apilevel-" >
1608 <td class="jd-typecol"><nobr>
1609
1610
1611
1612
1613
1614 boolean</nobr>
1615 </td>
1616 <td class="jd-linkcol" width="100%"><nobr>
1617 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#isLongClickable()">isLongClickable</a></span>()</nobr>
1618
1619 <div class="jd-descrdiv">
1620 Check if the view's <code>long-clickable</code> property is currently true
1621
1622
1623
1624 </div>
1625
1626 </td></tr>
1627
1628
1629
1630 <tr class="alt-color api apilevel-" >
1631 <td class="jd-typecol"><nobr>
1632
1633
1634
1635
1636
1637 boolean</nobr>
1638 </td>
1639 <td class="jd-linkcol" width="100%"><nobr>
1640 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#isScrollable()">isScrollable</a></span>()</nobr>
1641
1642 <div class="jd-descrdiv">
1643 Check if the view's <code>scrollable</code> property is currently true
1644
1645
1646
1647 </div>
1648
1649 </td></tr>
1650
1651
1652
1653 <tr class=" api apilevel-" >
1654 <td class="jd-typecol"><nobr>
1655
1656
1657
1658
1659
1660 boolean</nobr>
1661 </td>
1662 <td class="jd-linkcol" width="100%"><nobr>
1663 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#isSelected()">isSelected</a></span>()</nobr>
1664
1665 <div class="jd-descrdiv">
1666 Checks if the UI element's <code>selected</code> property is currently true.
1667
1668
1669
1670 </div>
1671
1672 </td></tr>
1673
1674
1675
1676 <tr class="alt-color api apilevel-" >
1677 <td class="jd-typecol"><nobr>
1678
1679
1680
1681
1682
1683 boolean</nobr>
1684 </td>
1685 <td class="jd-linkcol" width="100%"><nobr>
1686 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#longClick()">longClick</a></span>()</nobr>
1687
1688 <div class="jd-descrdiv">
1689 Long clicks the center of the visible bounds of the UI element
1690
1691
1692
1693 </div>
1694
1695 </td></tr>
1696
1697
1698
1699 <tr class=" api apilevel-" >
1700 <td class="jd-typecol"><nobr>
1701
1702
1703
1704
1705
1706 boolean</nobr>
1707 </td>
1708 <td class="jd-linkcol" width="100%"><nobr>
1709 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#longClickBottomRight()">longClickBottomRight</a></span>()</nobr>
1710
1711 <div class="jd-descrdiv">
1712 Long clicks bottom and right corner of the UI element
1713
1714
1715
1716 </div>
1717
1718 </td></tr>
1719
1720
1721
1722 <tr class="alt-color api apilevel-" >
1723 <td class="jd-typecol"><nobr>
1724
1725
1726
1727
1728
1729 boolean</nobr>
1730 </td>
1731 <td class="jd-linkcol" width="100%"><nobr>
1732 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#longClickTopLeft()">longClickTopLeft</a></span>()</nobr>
1733
1734 <div class="jd-descrdiv">
1735 Long clicks on the top and left corner of the UI element
1736
1737
1738
1739 </div>
1740
1741 </td></tr>
1742
1743
1744
1745 <tr class=" api apilevel-" >
1746 <td class="jd-typecol"><nobr>
1747
1748
1749
1750
1751
1752 boolean</nobr>
1753 </td>
1754 <td class="jd-linkcol" width="100%"><nobr>
1755 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#performMultiPointerGesture(android.view.MotionEvent.PointerCoords[]...)">performMultiPointerGesture</a></span>(PointerCoords... touches)</nobr>
1756
1757 <div class="jd-descrdiv">
1758 Performs a multi-touch gesture.
1759
1760
1761
1762 </div>
1763
1764 </td></tr>
1765
1766
1767
1768 <tr class="alt-color api apilevel-" >
1769 <td class="jd-typecol"><nobr>
1770
1771
1772
1773
1774
1775 boolean</nobr>
1776 </td>
1777 <td class="jd-linkcol" width="100%"><nobr>
1778 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#performTwoPointerGesture(android.graphics.Point, android.graphics.Point, android.graphics.Point, android.graphics.Point, int)">performTwoPointerGesture</a></span>(Point startPoint1, Point startPoint2, Point endPoint1, Point endPoint2, int steps)</nobr>
1779
1780 <div class="jd-descrdiv">
1781 Generates a two-pointer gesture with arbitrary starting and ending points.
1782
1783
1784
1785 </div>
1786
1787 </td></tr>
1788
1789
1790
1791 <tr class=" api apilevel-" >
1792 <td class="jd-typecol"><nobr>
1793
1794
1795
1796
1797
1798 boolean</nobr>
1799 </td>
1800 <td class="jd-linkcol" width="100%"><nobr>
1801 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#pinchIn(int, int)">pinchIn</a></span>(int percent, int steps)</nobr>
1802
1803 <div class="jd-descrdiv">
1804 Performs a two-pointer gesture, where each pointer moves diagonally
1805 toward the other, from the edges to the center of this UiObject .
1806
1807
1808
1809 </div>
1810
1811 </td></tr>
1812
1813
1814
1815 <tr class="alt-color api apilevel-" >
1816 <td class="jd-typecol"><nobr>
1817
1818
1819
1820
1821
1822 boolean</nobr>
1823 </td>
1824 <td class="jd-linkcol" width="100%"><nobr>
1825 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#pinchOut(int, int)">pinchOut</a></span>(int percent, int steps)</nobr>
1826
1827 <div class="jd-descrdiv">
1828 Performs a two-pointer gesture, where each pointer moves diagonally
1829 opposite across the other, from the center out towards the edges of the
1830 this UiObject.
1831
1832
1833
1834 </div>
1835
1836 </td></tr>
1837
1838
1839
1840 <tr class=" api apilevel-" >
1841 <td class="jd-typecol"><nobr>
1842
1843
1844
1845
1846
1847 boolean</nobr>
1848 </td>
1849 <td class="jd-linkcol" width="100%"><nobr>
1850 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#setText(java.lang.String)">setText</a></span>(String text)</nobr>
1851
1852 <div class="jd-descrdiv">
1853 Sets the text in an editable field, after clearing the field's content.
1854
1855
1856
1857 </div>
1858
1859 </td></tr>
1860
1861
1862
1863 <tr class="alt-color api apilevel-" >
1864 <td class="jd-typecol"><nobr>
1865
1866
1867
1868
1869
1870 boolean</nobr>
1871 </td>
1872 <td class="jd-linkcol" width="100%"><nobr>
1873 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#swipeDown(int)">swipeDown</a></span>(int steps)</nobr>
1874
1875 <div class="jd-descrdiv">
1876 Performs the swipe down action on the UiObject.
1877
1878
1879
1880 </div>
1881
1882 </td></tr>
1883
1884
1885
1886 <tr class=" api apilevel-" >
1887 <td class="jd-typecol"><nobr>
1888
1889
1890
1891
1892
1893 boolean</nobr>
1894 </td>
1895 <td class="jd-linkcol" width="100%"><nobr>
1896 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#swipeLeft(int)">swipeLeft</a></span>(int steps)</nobr>
1897
1898 <div class="jd-descrdiv">
1899 Performs the swipe left action on the UiObject.
1900
1901
1902
1903 </div>
1904
1905 </td></tr>
1906
1907
1908
1909 <tr class="alt-color api apilevel-" >
1910 <td class="jd-typecol"><nobr>
1911
1912
1913
1914
1915
1916 boolean</nobr>
1917 </td>
1918 <td class="jd-linkcol" width="100%"><nobr>
1919 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#swipeRight(int)">swipeRight</a></span>(int steps)</nobr>
1920
1921 <div class="jd-descrdiv">
1922 Performs the swipe right action on the UiObject.
1923
1924
1925
1926 </div>
1927
1928 </td></tr>
1929
1930
1931
1932 <tr class=" api apilevel-" >
1933 <td class="jd-typecol"><nobr>
1934
1935
1936
1937
1938
1939 boolean</nobr>
1940 </td>
1941 <td class="jd-linkcol" width="100%"><nobr>
1942 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#swipeUp(int)">swipeUp</a></span>(int steps)</nobr>
1943
1944 <div class="jd-descrdiv">
1945 Performs the swipe up action on the UiObject.
1946
1947
1948
1949 </div>
1950
1951 </td></tr>
1952
1953
1954
1955 <tr class="alt-color api apilevel-" >
1956 <td class="jd-typecol"><nobr>
1957
1958
1959
1960
1961
1962 boolean</nobr>
1963 </td>
1964 <td class="jd-linkcol" width="100%"><nobr>
1965 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#waitForExists(long)">waitForExists</a></span>(long timeout)</nobr>
1966
1967 <div class="jd-descrdiv">
1968 Waits a specified length of time for a view to become visible.
1969
1970
1971
1972 </div>
1973
1974 </td></tr>
1975
1976
1977
1978 <tr class=" api apilevel-" >
1979 <td class="jd-typecol"><nobr>
1980
1981
1982
1983
1984
1985 boolean</nobr>
1986 </td>
1987 <td class="jd-linkcol" width="100%"><nobr>
1988 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#waitUntilGone(long)">waitUntilGone</a></span>(long timeout)</nobr>
1989
1990 <div class="jd-descrdiv">
1991 Waits a specified length of time for a view to become undetectable.
1992
1993
1994
1995 </div>
1996
1997 </td></tr>
1998
1999
2000
2001</table>
2002
2003
2004
2005
2006<!-- ========== METHOD SUMMARY =========== -->
2007<table id="promethods" class="jd-sumtable"><tr><th colspan="12">Protected Methods</th></tr>
2008
2009
2010
2011
2012 <tr class="alt-color api apilevel-" >
2013 <td class="jd-typecol"><nobr>
2014
2015
2016
2017
2018
2019 AccessibilityNodeInfo</nobr>
2020 </td>
2021 <td class="jd-linkcol" width="100%"><nobr>
2022 <span class="sympad"><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#findAccessibilityNodeInfo(long)">findAccessibilityNodeInfo</a></span>(long timeout)</nobr>
2023
2024 <div class="jd-descrdiv">
2025 Finds a matching UI element in the accessibility hierarchy, by
2026 using the selector for this UiObject.
2027
2028
2029
2030 </div>
2031
2032 </td></tr>
2033
2034
2035
2036</table>
2037
2038
2039
2040
2041
2042<!-- ========== METHOD SUMMARY =========== -->
2043<table id="inhmethods" class="jd-sumtable"><tr><th>
2044 <a href="#" class="toggle-all" onclick="return toggleAllInherited(this, null)">[Expand]</a>
2045 <div style="clear:left;">Inherited Methods</div></th></tr>
2046
2047
2048<tr class="api apilevel-" >
2049<td colspan="12">
2050 <a href="#" onclick="return toggleInherited(this, null)" id="inherited-methods-java.lang.Object" class="jd-expando-trigger closed"
2051 ><img id="inherited-methods-java.lang.Object-trigger"
2052 src="../../../../../assets/images/triangle-closed.png"
2053 class="jd-expando-trigger-img" /></a>
2054From class
2055
2056 java.lang.Object
2057
2058<div id="inherited-methods-java.lang.Object">
2059 <div id="inherited-methods-java.lang.Object-list"
2060 class="jd-inheritedlinks">
2061 </div>
2062 <div id="inherited-methods-java.lang.Object-summary" style="display: none;">
2063 <table class="jd-sumtable-expando">
2064
2065
2066
2067
2068 <tr class="alt-color api apilevel-" >
2069 <td class="jd-typecol"><nobr>
2070
2071
2072
2073
2074
2075 Object</nobr>
2076 </td>
2077 <td class="jd-linkcol" width="100%"><nobr>
2078 <span class="sympad">clone</span>()</nobr>
2079
2080 </td></tr>
2081
2082
2083
2084 <tr class=" api apilevel-" >
2085 <td class="jd-typecol"><nobr>
2086
2087
2088
2089
2090
2091 boolean</nobr>
2092 </td>
2093 <td class="jd-linkcol" width="100%"><nobr>
2094 <span class="sympad">equals</span>(Object arg0)</nobr>
2095
2096 </td></tr>
2097
2098
2099
2100 <tr class="alt-color api apilevel-" >
2101 <td class="jd-typecol"><nobr>
2102
2103
2104
2105
2106
2107 void</nobr>
2108 </td>
2109 <td class="jd-linkcol" width="100%"><nobr>
2110 <span class="sympad">finalize</span>()</nobr>
2111
2112 </td></tr>
2113
2114
2115
2116 <tr class=" api apilevel-" >
2117 <td class="jd-typecol"><nobr>
2118
2119
2120 final
2121
2122
2123 Class&lt;?&gt;</nobr>
2124 </td>
2125 <td class="jd-linkcol" width="100%"><nobr>
2126 <span class="sympad">getClass</span>()</nobr>
2127
2128 </td></tr>
2129
2130
2131
2132 <tr class="alt-color api apilevel-" >
2133 <td class="jd-typecol"><nobr>
2134
2135
2136
2137
2138
2139 int</nobr>
2140 </td>
2141 <td class="jd-linkcol" width="100%"><nobr>
2142 <span class="sympad">hashCode</span>()</nobr>
2143
2144 </td></tr>
2145
2146
2147
2148 <tr class=" api apilevel-" >
2149 <td class="jd-typecol"><nobr>
2150
2151
2152 final
2153
2154
2155 void</nobr>
2156 </td>
2157 <td class="jd-linkcol" width="100%"><nobr>
2158 <span class="sympad">notify</span>()</nobr>
2159
2160 </td></tr>
2161
2162
2163
2164 <tr class="alt-color api apilevel-" >
2165 <td class="jd-typecol"><nobr>
2166
2167
2168 final
2169
2170
2171 void</nobr>
2172 </td>
2173 <td class="jd-linkcol" width="100%"><nobr>
2174 <span class="sympad">notifyAll</span>()</nobr>
2175
2176 </td></tr>
2177
2178
2179
2180 <tr class=" api apilevel-" >
2181 <td class="jd-typecol"><nobr>
2182
2183
2184
2185
2186
2187 String</nobr>
2188 </td>
2189 <td class="jd-linkcol" width="100%"><nobr>
2190 <span class="sympad">toString</span>()</nobr>
2191
2192 </td></tr>
2193
2194
2195
2196 <tr class="alt-color api apilevel-" >
2197 <td class="jd-typecol"><nobr>
2198
2199
2200 final
2201
2202
2203 void</nobr>
2204 </td>
2205 <td class="jd-linkcol" width="100%"><nobr>
2206 <span class="sympad">wait</span>()</nobr>
2207
2208 </td></tr>
2209
2210
2211
2212 <tr class=" api apilevel-" >
2213 <td class="jd-typecol"><nobr>
2214
2215
2216 final
2217
2218
2219 void</nobr>
2220 </td>
2221 <td class="jd-linkcol" width="100%"><nobr>
2222 <span class="sympad">wait</span>(long arg0, int arg1)</nobr>
2223
2224 </td></tr>
2225
2226
2227
2228 <tr class="alt-color api apilevel-" >
2229 <td class="jd-typecol"><nobr>
2230
2231
2232 final
2233
2234
2235 void</nobr>
2236 </td>
2237 <td class="jd-linkcol" width="100%"><nobr>
2238 <span class="sympad">wait</span>(long arg0)</nobr>
2239
2240 </td></tr>
2241
2242
2243</table>
2244 </div>
2245</div>
2246</td></tr>
2247
2248
2249</table>
2250
2251
2252</div><!-- jd-descr (summary) -->
2253
2254<!-- Details -->
2255
2256
2257
2258
2259
2260
2261
2262
2263<!-- XML Attributes -->
2264
2265
2266<!-- Enum Values -->
2267
2268
2269<!-- Constants -->
2270
2271
2272<!-- ========= ENUM CONSTANTS DETAIL ======== -->
2273<h2>Constants</h2>
2274
2275
2276
2277
2278<A NAME="FINGER_TOUCH_HALF_WIDTH"></A>
2279
2280<div class="jd-details api apilevel-">
2281 <h4 class="jd-details-title">
2282 <span class="normal">
2283 protected
2284 static
2285 final
2286 int
2287 </span>
2288 FINGER_TOUCH_HALF_WIDTH
2289 </h4>
2290 <div class="api-level">
2291
2292
2293
2294
2295 </div>
2296 <div class="jd-details-descr">
2297
2298
2299
2300
2301 <div class="jd-tagdata jd-tagdescr"><p></p></div>
2302
2303
2304 <div class="jd-tagdata">
2305 <span class="jd-tagtitle">Constant Value: </span>
2306 <span>
2307
2308 20
2309 (0x00000014)
2310
2311 </span>
2312 </div>
2313
2314 </div>
2315</div>
2316
2317
2318
2319<A NAME="SWIPE_MARGIN_LIMIT"></A>
2320
2321<div class="jd-details api apilevel-">
2322 <h4 class="jd-details-title">
2323 <span class="normal">
2324 protected
2325 static
2326 final
2327 int
2328 </span>
2329 SWIPE_MARGIN_LIMIT
2330 </h4>
2331 <div class="api-level">
2332
2333
2334
2335
2336 </div>
2337 <div class="jd-details-descr">
2338
2339
2340
2341
2342 <div class="jd-tagdata jd-tagdescr"><p></p></div>
2343
2344
2345 <div class="jd-tagdata">
2346 <span class="jd-tagtitle">Constant Value: </span>
2347 <span>
2348
2349 5
2350 (0x00000005)
2351
2352 </span>
2353 </div>
2354
2355 </div>
2356</div>
2357
2358
2359
2360<A NAME="WAIT_FOR_EVENT_TMEOUT"></A>
2361
2362<div class="jd-details api apilevel-">
2363 <h4 class="jd-details-title">
2364 <span class="normal">
2365 protected
2366 static
2367 final
2368 long
2369 </span>
2370 WAIT_FOR_EVENT_TMEOUT
2371 </h4>
2372 <div class="api-level">
2373
2374
2375
2376
2377 </div>
2378 <div class="jd-details-descr">
2379
2380
2381
2382 <p>
2383 <p class="caution"><strong>
2384 This constant is deprecated.</strong><br/>
2385 use <code><a href="../../../../../reference/android/support/test/uiautomator/Configurator.html#setScrollAcknowledgmentTimeout(long)">setScrollAcknowledgmentTimeout(long)</a></code>
2386
2387 </p>
2388 <div class="jd-tagdata jd-tagdescr"><p></p></div>
2389
2390
2391 <div class="jd-tagdata">
2392 <span class="jd-tagtitle">Constant Value: </span>
2393 <span>
2394
2395 3000
2396 (0x0000000000000bb8)
2397
2398 </span>
2399 </div>
2400
2401 </div>
2402</div>
2403
2404
2405
2406<A NAME="WAIT_FOR_SELECTOR_POLL"></A>
2407
2408<div class="jd-details api apilevel-">
2409 <h4 class="jd-details-title">
2410 <span class="normal">
2411 protected
2412 static
2413 final
2414 long
2415 </span>
2416 WAIT_FOR_SELECTOR_POLL
2417 </h4>
2418 <div class="api-level">
2419
2420
2421
2422
2423 </div>
2424 <div class="jd-details-descr">
2425
2426
2427
2428
2429 <div class="jd-tagdata jd-tagdescr"><p></p></div>
2430
2431
2432 <div class="jd-tagdata">
2433 <span class="jd-tagtitle">Constant Value: </span>
2434 <span>
2435
2436 1000
2437 (0x00000000000003e8)
2438
2439 </span>
2440 </div>
2441
2442 </div>
2443</div>
2444
2445
2446
2447<A NAME="WAIT_FOR_SELECTOR_TIMEOUT"></A>
2448
2449<div class="jd-details api apilevel-">
2450 <h4 class="jd-details-title">
2451 <span class="normal">
2452 protected
2453 static
2454 final
2455 long
2456 </span>
2457 WAIT_FOR_SELECTOR_TIMEOUT
2458 </h4>
2459 <div class="api-level">
2460
2461
2462
2463
2464 </div>
2465 <div class="jd-details-descr">
2466
2467
2468
2469 <p>
2470 <p class="caution"><strong>
2471 This constant is deprecated.</strong><br/>
2472 use <code><a href="../../../../../reference/android/support/test/uiautomator/Configurator.html#setWaitForSelectorTimeout(long)">setWaitForSelectorTimeout(long)</a></code>
2473
2474 </p>
2475 <div class="jd-tagdata jd-tagdescr"><p></p></div>
2476
2477
2478 <div class="jd-tagdata">
2479 <span class="jd-tagtitle">Constant Value: </span>
2480 <span>
2481
2482 10000
2483 (0x0000000000002710)
2484
2485 </span>
2486 </div>
2487
2488 </div>
2489</div>
2490
2491
2492
2493<A NAME="WAIT_FOR_WINDOW_TMEOUT"></A>
2494
2495<div class="jd-details api apilevel-">
2496 <h4 class="jd-details-title">
2497 <span class="normal">
2498 protected
2499 static
2500 final
2501 long
2502 </span>
2503 WAIT_FOR_WINDOW_TMEOUT
2504 </h4>
2505 <div class="api-level">
2506
2507
2508
2509
2510 </div>
2511 <div class="jd-details-descr">
2512
2513
2514
2515
2516 <div class="jd-tagdata jd-tagdescr"><p></p></div>
2517
2518
2519 <div class="jd-tagdata">
2520 <span class="jd-tagtitle">Constant Value: </span>
2521 <span>
2522
2523 5500
2524 (0x000000000000157c)
2525
2526 </span>
2527 </div>
2528
2529 </div>
2530</div>
2531
2532
2533
2534
2535<!-- Fields -->
2536
2537
2538<!-- Public ctors -->
2539
2540
2541<!-- ========= CONSTRUCTOR DETAIL ======== -->
2542<h2>Public Constructors</h2>
2543
2544
2545
2546<A NAME="UiObject(android.support.test.uiautomator.UiSelector)"></A>
2547
2548<div class="jd-details api apilevel-">
2549 <h4 class="jd-details-title">
2550 <span class="normal">
2551 public
2552
2553
2554
2555
2556
2557 </span>
2558 <span class="sympad">UiObject</span>
2559 <span class="normal">(<a href="../../../../../reference/android/support/test/uiautomator/UiSelector.html">UiSelector</a> selector)</span>
2560 </h4>
2561 <div class="api-level">
2562 <div></div>
2563
2564
2565
2566 </div>
2567 <div class="jd-details-descr">
2568
2569
2570
2571 <p>
2572 <p class="caution"><strong>
2573 This constructor is deprecated.</strong><br/>
2574 Use <code><a href="../../../../../reference/android/support/test/uiautomator/UiDevice.html#findObject(android.support.test.uiautomator.UiSelector)">findObject(UiSelector)</a></code> instead. This version hides
2575 UiObject's dependency on UiDevice and is prone to misuse.
2576 </p>
2577 <div class="jd-tagdata jd-tagdescr"><p>Constructs a UiObject to represent a view that matches the specified
2578 selector criteria.</p></div>
2579
2580 </div>
2581</div>
2582
2583
2584
2585
2586
2587<!-- ========= CONSTRUCTOR DETAIL ======== -->
2588<!-- Protected ctors -->
2589
2590
2591
2592<!-- ========= METHOD DETAIL ======== -->
2593<!-- Public methdos -->
2594
2595<h2>Public Methods</h2>
2596
2597
2598
2599<A NAME="clearTextField()"></A>
2600
2601<div class="jd-details api apilevel-">
2602 <h4 class="jd-details-title">
2603 <span class="normal">
2604 public
2605
2606
2607
2608
2609 void
2610 </span>
2611 <span class="sympad">clearTextField</span>
2612 <span class="normal">()</span>
2613 </h4>
2614 <div class="api-level">
2615 <div></div>
2616
2617
2618
2619 </div>
2620 <div class="jd-details-descr">
2621
2622
2623
2624
2625 <div class="jd-tagdata jd-tagdescr"><p>Clears the existing text contents in an editable field.
2626
2627 The <code><a href="../../../../../reference/android/support/test/uiautomator/UiSelector.html">UiSelector</a></code> of this object must reference a UI element that is editable.
2628
2629 When you call this method, the method sets focus on the editable field, selects all of its
2630 existing content, and clears it by sending a DELETE key press</p></div>
2631 <div class="jd-tagdata">
2632 <h5 class="jd-tagtitle">Throws</h5>
2633 <table class="jd-tagtable">
2634 <tr>
2635 <th></td>
2636 <td>UiObjectNotFoundException</td>
2637 </tr>
2638 <tr>
2639 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
2640 <td></td>
2641 </tr>
2642 </table>
2643 </div>
2644
2645 </div>
2646</div>
2647
2648
2649<A NAME="click()"></A>
2650
2651<div class="jd-details api apilevel-">
2652 <h4 class="jd-details-title">
2653 <span class="normal">
2654 public
2655
2656
2657
2658
2659 boolean
2660 </span>
2661 <span class="sympad">click</span>
2662 <span class="normal">()</span>
2663 </h4>
2664 <div class="api-level">
2665 <div></div>
2666
2667
2668
2669 </div>
2670 <div class="jd-details-descr">
2671
2672
2673
2674
2675 <div class="jd-tagdata jd-tagdescr"><p>Performs a click at the center of the visible bounds of the UI element represented
2676 by this UiObject.</p></div>
2677 <div class="jd-tagdata">
2678 <h5 class="jd-tagtitle">Returns</h5>
2679 <ul class="nolist"><li>true id successful else false</li></ul>
2680 </div>
2681 <div class="jd-tagdata">
2682 <h5 class="jd-tagtitle">Throws</h5>
2683 <table class="jd-tagtable">
2684 <tr>
2685 <th></td>
2686 <td>UiObjectNotFoundException</td>
2687 </tr>
2688 <tr>
2689 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
2690 <td></td>
2691 </tr>
2692 </table>
2693 </div>
2694
2695 </div>
2696</div>
2697
2698
2699<A NAME="clickAndWaitForNewWindow(long)"></A>
2700
2701<div class="jd-details api apilevel-">
2702 <h4 class="jd-details-title">
2703 <span class="normal">
2704 public
2705
2706
2707
2708
2709 boolean
2710 </span>
2711 <span class="sympad">clickAndWaitForNewWindow</span>
2712 <span class="normal">(long timeout)</span>
2713 </h4>
2714 <div class="api-level">
2715 <div></div>
2716
2717
2718
2719 </div>
2720 <div class="jd-details-descr">
2721
2722
2723
2724
2725 <div class="jd-tagdata jd-tagdescr"><p>Performs a click at the center of the visible bounds of the UI element represented
2726 by this UiObject and waits for window transitions.
2727
2728 This method differ from <code><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#click()">click()</a></code> only in that this method waits for a
2729 a new window transition as a result of the click. Some examples of a window transition:
2730 <li>launching a new activity</li>
2731 <li>bringing up a pop-up menu</li>
2732 <li>bringing up a dialog</li></p></div>
2733 <div class="jd-tagdata">
2734 <h5 class="jd-tagtitle">Parameters</h5>
2735 <table class="jd-tagtable">
2736 <tr>
2737 <th>timeout</td>
2738 <td>timeout before giving up on waiting for a new window</td>
2739 </tr>
2740 </table>
2741 </div>
2742 <div class="jd-tagdata">
2743 <h5 class="jd-tagtitle">Returns</h5>
2744 <ul class="nolist"><li>true if the event was triggered, else false</li></ul>
2745 </div>
2746 <div class="jd-tagdata">
2747 <h5 class="jd-tagtitle">Throws</h5>
2748 <table class="jd-tagtable">
2749 <tr>
2750 <th></td>
2751 <td>UiObjectNotFoundException</td>
2752 </tr>
2753 <tr>
2754 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
2755 <td></td>
2756 </tr>
2757 </table>
2758 </div>
2759
2760 </div>
2761</div>
2762
2763
2764<A NAME="clickAndWaitForNewWindow()"></A>
2765
2766<div class="jd-details api apilevel-">
2767 <h4 class="jd-details-title">
2768 <span class="normal">
2769 public
2770
2771
2772
2773
2774 boolean
2775 </span>
2776 <span class="sympad">clickAndWaitForNewWindow</span>
2777 <span class="normal">()</span>
2778 </h4>
2779 <div class="api-level">
2780 <div></div>
2781
2782
2783
2784 </div>
2785 <div class="jd-details-descr">
2786
2787
2788
2789
2790 <div class="jd-tagdata jd-tagdescr"><p>Waits for window transitions that would typically take longer than the
2791 usual default timeouts.
2792 See <code><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#clickAndWaitForNewWindow(long)">clickAndWaitForNewWindow(long)</a></code></p></div>
2793 <div class="jd-tagdata">
2794 <h5 class="jd-tagtitle">Returns</h5>
2795 <ul class="nolist"><li>true if the event was triggered, else false</li></ul>
2796 </div>
2797 <div class="jd-tagdata">
2798 <h5 class="jd-tagtitle">Throws</h5>
2799 <table class="jd-tagtable">
2800 <tr>
2801 <th></td>
2802 <td>UiObjectNotFoundException</td>
2803 </tr>
2804 <tr>
2805 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
2806 <td></td>
2807 </tr>
2808 </table>
2809 </div>
2810
2811 </div>
2812</div>
2813
2814
2815<A NAME="clickBottomRight()"></A>
2816
2817<div class="jd-details api apilevel-">
2818 <h4 class="jd-details-title">
2819 <span class="normal">
2820 public
2821
2822
2823
2824
2825 boolean
2826 </span>
2827 <span class="sympad">clickBottomRight</span>
2828 <span class="normal">()</span>
2829 </h4>
2830 <div class="api-level">
2831 <div></div>
2832
2833
2834
2835 </div>
2836 <div class="jd-details-descr">
2837
2838
2839
2840
2841 <div class="jd-tagdata jd-tagdescr"><p>Clicks the bottom and right corner of the UI element</p></div>
2842 <div class="jd-tagdata">
2843 <h5 class="jd-tagtitle">Returns</h5>
2844 <ul class="nolist"><li>true on success</li></ul>
2845 </div>
2846 <div class="jd-tagdata">
2847 <h5 class="jd-tagtitle">Throws</h5>
2848 <table class="jd-tagtable">
2849 <tr>
2850 <th></td>
2851 <td>UiObjectNotFoundException</td>
2852 </tr>
2853 <tr>
2854 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
2855 <td></td>
2856 </tr>
2857 </table>
2858 </div>
2859
2860 </div>
2861</div>
2862
2863
2864<A NAME="clickTopLeft()"></A>
2865
2866<div class="jd-details api apilevel-">
2867 <h4 class="jd-details-title">
2868 <span class="normal">
2869 public
2870
2871
2872
2873
2874 boolean
2875 </span>
2876 <span class="sympad">clickTopLeft</span>
2877 <span class="normal">()</span>
2878 </h4>
2879 <div class="api-level">
2880 <div></div>
2881
2882
2883
2884 </div>
2885 <div class="jd-details-descr">
2886
2887
2888
2889
2890 <div class="jd-tagdata jd-tagdescr"><p>Clicks the top and left corner of the UI element</p></div>
2891 <div class="jd-tagdata">
2892 <h5 class="jd-tagtitle">Returns</h5>
2893 <ul class="nolist"><li>true on success</li></ul>
2894 </div>
2895 <div class="jd-tagdata">
2896 <h5 class="jd-tagtitle">Throws</h5>
2897 <table class="jd-tagtable">
2898 <tr>
2899 <th></td>
2900 <td>UiObjectNotFoundException</td>
2901 </tr>
2902 <tr>
2903 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
2904 <td></td>
2905 </tr>
2906 </table>
2907 </div>
2908
2909 </div>
2910</div>
2911
2912
2913<A NAME="dragTo(android.support.test.uiautomator.UiObject, int)"></A>
2914
2915<div class="jd-details api apilevel-">
2916 <h4 class="jd-details-title">
2917 <span class="normal">
2918 public
2919
2920
2921
2922
2923 boolean
2924 </span>
2925 <span class="sympad">dragTo</span>
2926 <span class="normal">(<a href="../../../../../reference/android/support/test/uiautomator/UiObject.html">UiObject</a> destObj, int steps)</span>
2927 </h4>
2928 <div class="api-level">
2929 <div></div>
2930
2931
2932
2933 </div>
2934 <div class="jd-details-descr">
2935
2936
2937
2938
2939 <div class="jd-tagdata jd-tagdescr"><p>Drags this object to a destination UiObject.
2940 The number of steps specified in your input parameter can influence the
2941 drag speed, and varying speeds may impact the results. Consider
2942 evaluating different speeds when using this method in your tests.</p></div>
2943 <div class="jd-tagdata">
2944 <h5 class="jd-tagtitle">Parameters</h5>
2945 <table class="jd-tagtable">
2946 <tr>
2947 <th>destObj</td>
2948 <td>the destination UiObject.</td>
2949 </tr>
2950 <tr>
2951 <th>steps</td>
2952 <td>usually 40 steps. You can increase or decrease the steps to change the speed.</td>
2953 </tr>
2954 </table>
2955 </div>
2956 <div class="jd-tagdata">
2957 <h5 class="jd-tagtitle">Returns</h5>
2958 <ul class="nolist"><li>true if successful</li></ul>
2959 </div>
2960 <div class="jd-tagdata">
2961 <h5 class="jd-tagtitle">Throws</h5>
2962 <table class="jd-tagtable">
2963 <tr>
2964 <th></td>
2965 <td>UiObjectNotFoundException</td>
2966 </tr>
2967 <tr>
2968 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
2969 <td></td>
2970 </tr>
2971 </table>
2972 </div>
2973
2974 </div>
2975</div>
2976
2977
2978<A NAME="dragTo(int, int, int)"></A>
2979
2980<div class="jd-details api apilevel-">
2981 <h4 class="jd-details-title">
2982 <span class="normal">
2983 public
2984
2985
2986
2987
2988 boolean
2989 </span>
2990 <span class="sympad">dragTo</span>
2991 <span class="normal">(int destX, int destY, int steps)</span>
2992 </h4>
2993 <div class="api-level">
2994 <div></div>
2995
2996
2997
2998 </div>
2999 <div class="jd-details-descr">
3000
3001
3002
3003
3004 <div class="jd-tagdata jd-tagdescr"><p>Drags this object to arbitrary coordinates.
3005 The number of steps specified in your input parameter can influence the
3006 drag speed, and varying speeds may impact the results. Consider
3007 evaluating different speeds when using this method in your tests.</p></div>
3008 <div class="jd-tagdata">
3009 <h5 class="jd-tagtitle">Parameters</h5>
3010 <table class="jd-tagtable">
3011 <tr>
3012 <th>destX</td>
3013 <td>the X-axis coordinate.</td>
3014 </tr>
3015 <tr>
3016 <th>destY</td>
3017 <td>the Y-axis coordinate.</td>
3018 </tr>
3019 <tr>
3020 <th>steps</td>
3021 <td>usually 40 steps. You can increase or decrease the steps to change the speed.</td>
3022 </tr>
3023 </table>
3024 </div>
3025 <div class="jd-tagdata">
3026 <h5 class="jd-tagtitle">Returns</h5>
3027 <ul class="nolist"><li>true if successful</li></ul>
3028 </div>
3029 <div class="jd-tagdata">
3030 <h5 class="jd-tagtitle">Throws</h5>
3031 <table class="jd-tagtable">
3032 <tr>
3033 <th></td>
3034 <td>UiObjectNotFoundException</td>
3035 </tr>
3036 <tr>
3037 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3038 <td></td>
3039 </tr>
3040 </table>
3041 </div>
3042
3043 </div>
3044</div>
3045
3046
3047<A NAME="exists()"></A>
3048
3049<div class="jd-details api apilevel-">
3050 <h4 class="jd-details-title">
3051 <span class="normal">
3052 public
3053
3054
3055
3056
3057 boolean
3058 </span>
3059 <span class="sympad">exists</span>
3060 <span class="normal">()</span>
3061 </h4>
3062 <div class="api-level">
3063 <div></div>
3064
3065
3066
3067 </div>
3068 <div class="jd-details-descr">
3069
3070
3071
3072
3073 <div class="jd-tagdata jd-tagdescr"><p>Check if view exists.
3074
3075 This methods performs a <code><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#waitForExists(long)">waitForExists(long)</a></code> with zero timeout. This
3076 basically returns immediately whether the view represented by this UiObject
3077 exists or not. If you need to wait longer for this view, then see
3078 <code><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#waitForExists(long)">waitForExists(long)</a></code>.</p></div>
3079 <div class="jd-tagdata">
3080 <h5 class="jd-tagtitle">Returns</h5>
3081 <ul class="nolist"><li>true if the view represented by this UiObject does exist</li></ul>
3082 </div>
3083
3084 </div>
3085</div>
3086
3087
3088<A NAME="getBounds()"></A>
3089
3090<div class="jd-details api apilevel-">
3091 <h4 class="jd-details-title">
3092 <span class="normal">
3093 public
3094
3095
3096
3097
3098 Rect
3099 </span>
3100 <span class="sympad">getBounds</span>
3101 <span class="normal">()</span>
3102 </h4>
3103 <div class="api-level">
3104 <div></div>
3105
3106
3107
3108 </div>
3109 <div class="jd-details-descr">
3110
3111
3112
3113
3114 <div class="jd-tagdata jd-tagdescr"><p>Returns the view's <code>bounds</code> property. See <code><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#getVisibleBounds()">getVisibleBounds()</a></code></p></div>
3115 <div class="jd-tagdata">
3116 <h5 class="jd-tagtitle">Returns</h5>
3117 <ul class="nolist"><li>Rect</li></ul>
3118 </div>
3119 <div class="jd-tagdata">
3120 <h5 class="jd-tagtitle">Throws</h5>
3121 <table class="jd-tagtable">
3122 <tr>
3123 <th></td>
3124 <td>UiObjectNotFoundException</td>
3125 </tr>
3126 <tr>
3127 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3128 <td></td>
3129 </tr>
3130 </table>
3131 </div>
3132
3133 </div>
3134</div>
3135
3136
3137<A NAME="getChild(android.support.test.uiautomator.UiSelector)"></A>
3138
3139<div class="jd-details api apilevel-">
3140 <h4 class="jd-details-title">
3141 <span class="normal">
3142 public
3143
3144
3145
3146
3147 <a href="../../../../../reference/android/support/test/uiautomator/UiObject.html">UiObject</a>
3148 </span>
3149 <span class="sympad">getChild</span>
3150 <span class="normal">(<a href="../../../../../reference/android/support/test/uiautomator/UiSelector.html">UiSelector</a> selector)</span>
3151 </h4>
3152 <div class="api-level">
3153 <div></div>
3154
3155
3156
3157 </div>
3158 <div class="jd-details-descr">
3159
3160
3161
3162
3163 <div class="jd-tagdata jd-tagdescr"><p>Creates a new UiObject for a child view that is under the present UiObject.</p></div>
3164 <div class="jd-tagdata">
3165 <h5 class="jd-tagtitle">Parameters</h5>
3166 <table class="jd-tagtable">
3167 <tr>
3168 <th>selector</td>
3169 <td>for child view to match</td>
3170 </tr>
3171 </table>
3172 </div>
3173 <div class="jd-tagdata">
3174 <h5 class="jd-tagtitle">Returns</h5>
3175 <ul class="nolist"><li>a new UiObject representing the child view</li></ul>
3176 </div>
3177 <div class="jd-tagdata">
3178 <h5 class="jd-tagtitle">Throws</h5>
3179 <table class="jd-tagtable">
3180 <tr>
3181 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3182 <td></td>
3183 </tr>
3184 </table>
3185 </div>
3186
3187 </div>
3188</div>
3189
3190
3191<A NAME="getChildCount()"></A>
3192
3193<div class="jd-details api apilevel-">
3194 <h4 class="jd-details-title">
3195 <span class="normal">
3196 public
3197
3198
3199
3200
3201 int
3202 </span>
3203 <span class="sympad">getChildCount</span>
3204 <span class="normal">()</span>
3205 </h4>
3206 <div class="api-level">
3207 <div></div>
3208
3209
3210
3211 </div>
3212 <div class="jd-details-descr">
3213
3214
3215
3216
3217 <div class="jd-tagdata jd-tagdescr"><p>Counts the child views immediately under the present UiObject.</p></div>
3218 <div class="jd-tagdata">
3219 <h5 class="jd-tagtitle">Returns</h5>
3220 <ul class="nolist"><li>the count of child views.</li></ul>
3221 </div>
3222 <div class="jd-tagdata">
3223 <h5 class="jd-tagtitle">Throws</h5>
3224 <table class="jd-tagtable">
3225 <tr>
3226 <th></td>
3227 <td>UiObjectNotFoundException</td>
3228 </tr>
3229 <tr>
3230 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3231 <td></td>
3232 </tr>
3233 </table>
3234 </div>
3235
3236 </div>
3237</div>
3238
3239
3240<A NAME="getClassName()"></A>
3241
3242<div class="jd-details api apilevel-">
3243 <h4 class="jd-details-title">
3244 <span class="normal">
3245 public
3246
3247
3248
3249
3250 String
3251 </span>
3252 <span class="sympad">getClassName</span>
3253 <span class="normal">()</span>
3254 </h4>
3255 <div class="api-level">
3256 <div></div>
3257
3258
3259
3260 </div>
3261 <div class="jd-details-descr">
3262
3263
3264
3265
3266 <div class="jd-tagdata jd-tagdescr"><p>Retrieves the <code>className</code> property of the UI element.</p></div>
3267 <div class="jd-tagdata">
3268 <h5 class="jd-tagtitle">Returns</h5>
3269 <ul class="nolist"><li>class name of the current node represented by this UiObject</li></ul>
3270 </div>
3271 <div class="jd-tagdata">
3272 <h5 class="jd-tagtitle">Throws</h5>
3273 <table class="jd-tagtable">
3274 <tr>
3275 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3276 <td>if no match was found</td>
3277 </tr>
3278 </table>
3279 </div>
3280
3281 </div>
3282</div>
3283
3284
3285<A NAME="getContentDescription()"></A>
3286
3287<div class="jd-details api apilevel-">
3288 <h4 class="jd-details-title">
3289 <span class="normal">
3290 public
3291
3292
3293
3294
3295 String
3296 </span>
3297 <span class="sympad">getContentDescription</span>
3298 <span class="normal">()</span>
3299 </h4>
3300 <div class="api-level">
3301 <div></div>
3302
3303
3304
3305 </div>
3306 <div class="jd-details-descr">
3307
3308
3309
3310
3311 <div class="jd-tagdata jd-tagdescr"><p>Reads the <code>content_desc</code> property of the UI element</p></div>
3312 <div class="jd-tagdata">
3313 <h5 class="jd-tagtitle">Returns</h5>
3314 <ul class="nolist"><li>value of node attribute "content_desc"</li></ul>
3315 </div>
3316 <div class="jd-tagdata">
3317 <h5 class="jd-tagtitle">Throws</h5>
3318 <table class="jd-tagtable">
3319 <tr>
3320 <th></td>
3321 <td>UiObjectNotFoundException</td>
3322 </tr>
3323 <tr>
3324 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3325 <td></td>
3326 </tr>
3327 </table>
3328 </div>
3329
3330 </div>
3331</div>
3332
3333
3334<A NAME="getFromParent(android.support.test.uiautomator.UiSelector)"></A>
3335
3336<div class="jd-details api apilevel-">
3337 <h4 class="jd-details-title">
3338 <span class="normal">
3339 public
3340
3341
3342
3343
3344 <a href="../../../../../reference/android/support/test/uiautomator/UiObject.html">UiObject</a>
3345 </span>
3346 <span class="sympad">getFromParent</span>
3347 <span class="normal">(<a href="../../../../../reference/android/support/test/uiautomator/UiSelector.html">UiSelector</a> selector)</span>
3348 </h4>
3349 <div class="api-level">
3350 <div></div>
3351
3352
3353
3354 </div>
3355 <div class="jd-details-descr">
3356
3357
3358
3359
3360 <div class="jd-tagdata jd-tagdescr"><p>Creates a new UiObject for a sibling view or a child of the sibling view,
3361 relative to the present UiObject.</p></div>
3362 <div class="jd-tagdata">
3363 <h5 class="jd-tagtitle">Parameters</h5>
3364 <table class="jd-tagtable">
3365 <tr>
3366 <th>selector</td>
3367 <td>for a sibling view or children of the sibling view</td>
3368 </tr>
3369 </table>
3370 </div>
3371 <div class="jd-tagdata">
3372 <h5 class="jd-tagtitle">Returns</h5>
3373 <ul class="nolist"><li>a new UiObject representing the matched view</li></ul>
3374 </div>
3375 <div class="jd-tagdata">
3376 <h5 class="jd-tagtitle">Throws</h5>
3377 <table class="jd-tagtable">
3378 <tr>
3379 <th></td>
3380 <td>UiObjectNotFoundException</td>
3381 </tr>
3382 <tr>
3383 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3384 <td></td>
3385 </tr>
3386 </table>
3387 </div>
3388
3389 </div>
3390</div>
3391
3392
3393<A NAME="getPackageName()"></A>
3394
3395<div class="jd-details api apilevel-">
3396 <h4 class="jd-details-title">
3397 <span class="normal">
3398 public
3399
3400
3401
3402
3403 String
3404 </span>
3405 <span class="sympad">getPackageName</span>
3406 <span class="normal">()</span>
3407 </h4>
3408 <div class="api-level">
3409 <div></div>
3410
3411
3412
3413 </div>
3414 <div class="jd-details-descr">
3415
3416
3417
3418
3419 <div class="jd-tagdata jd-tagdescr"><p>Reads the view's <code>package</code> property</p></div>
3420 <div class="jd-tagdata">
3421 <h5 class="jd-tagtitle">Returns</h5>
3422 <ul class="nolist"><li>true if it is else false</li></ul>
3423 </div>
3424 <div class="jd-tagdata">
3425 <h5 class="jd-tagtitle">Throws</h5>
3426 <table class="jd-tagtable">
3427 <tr>
3428 <th></td>
3429 <td>UiObjectNotFoundException</td>
3430 </tr>
3431 <tr>
3432 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3433 <td></td>
3434 </tr>
3435 </table>
3436 </div>
3437
3438 </div>
3439</div>
3440
3441
3442<A NAME="getSelector()"></A>
3443
3444<div class="jd-details api apilevel-">
3445 <h4 class="jd-details-title">
3446 <span class="normal">
3447 public
3448
3449 final
3450
3451
3452 <a href="../../../../../reference/android/support/test/uiautomator/UiSelector.html">UiSelector</a>
3453 </span>
3454 <span class="sympad">getSelector</span>
3455 <span class="normal">()</span>
3456 </h4>
3457 <div class="api-level">
3458 <div></div>
3459
3460
3461
3462 </div>
3463 <div class="jd-details-descr">
3464
3465
3466
3467
3468 <div class="jd-tagdata jd-tagdescr"><p>Debugging helper. A test can dump the properties of a selector as a string
3469 to its logs if needed. <code>getSelector().toString();</code></p></div>
3470 <div class="jd-tagdata">
3471 <h5 class="jd-tagtitle">Returns</h5>
3472 <ul class="nolist"><li><code><a href="../../../../../reference/android/support/test/uiautomator/UiSelector.html">UiSelector</a></code></li></ul>
3473 </div>
3474
3475 </div>
3476</div>
3477
3478
3479<A NAME="getText()"></A>
3480
3481<div class="jd-details api apilevel-">
3482 <h4 class="jd-details-title">
3483 <span class="normal">
3484 public
3485
3486
3487
3488
3489 String
3490 </span>
3491 <span class="sympad">getText</span>
3492 <span class="normal">()</span>
3493 </h4>
3494 <div class="api-level">
3495 <div></div>
3496
3497
3498
3499 </div>
3500 <div class="jd-details-descr">
3501
3502
3503
3504
3505 <div class="jd-tagdata jd-tagdescr"><p>Reads the <code>text</code> property of the UI element</p></div>
3506 <div class="jd-tagdata">
3507 <h5 class="jd-tagtitle">Returns</h5>
3508 <ul class="nolist"><li>text value of the current node represented by this UiObject</li></ul>
3509 </div>
3510 <div class="jd-tagdata">
3511 <h5 class="jd-tagtitle">Throws</h5>
3512 <table class="jd-tagtable">
3513 <tr>
3514 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3515 <td>if no match could be found</td>
3516 </tr>
3517 </table>
3518 </div>
3519
3520 </div>
3521</div>
3522
3523
3524<A NAME="getVisibleBounds()"></A>
3525
3526<div class="jd-details api apilevel-">
3527 <h4 class="jd-details-title">
3528 <span class="normal">
3529 public
3530
3531
3532
3533
3534 Rect
3535 </span>
3536 <span class="sympad">getVisibleBounds</span>
3537 <span class="normal">()</span>
3538 </h4>
3539 <div class="api-level">
3540 <div></div>
3541
3542
3543
3544 </div>
3545 <div class="jd-details-descr">
3546
3547
3548
3549
3550 <div class="jd-tagdata jd-tagdescr"><p>Returns the visible bounds of the view.
3551
3552 If a portion of the view is visible, only the bounds of the visible portion are
3553 reported.</p></div>
3554 <div class="jd-tagdata">
3555 <h5 class="jd-tagtitle">Returns</h5>
3556 <ul class="nolist"><li>Rect</li></ul>
3557 </div>
3558 <div class="jd-tagdata">
3559 <h5 class="jd-tagtitle">Throws</h5>
3560 <table class="jd-tagtable">
3561 <tr>
3562 <th></td>
3563 <td>UiObjectNotFoundException</td>
3564 </tr>
3565 <tr>
3566 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3567 <td></td>
3568 </tr>
3569 </table>
3570 </div>
3571 <div class="jd-tagdata">
3572 <h5 class="jd-tagtitle">See Also</h5>
3573 <ul class="nolist"><li><code><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#getBounds()">getBounds()</a></code></li>
3574 </ul>
3575 </div>
3576
3577 </div>
3578</div>
3579
3580
3581<A NAME="isCheckable()"></A>
3582
3583<div class="jd-details api apilevel-">
3584 <h4 class="jd-details-title">
3585 <span class="normal">
3586 public
3587
3588
3589
3590
3591 boolean
3592 </span>
3593 <span class="sympad">isCheckable</span>
3594 <span class="normal">()</span>
3595 </h4>
3596 <div class="api-level">
3597 <div></div>
3598
3599
3600
3601 </div>
3602 <div class="jd-details-descr">
3603
3604
3605
3606
3607 <div class="jd-tagdata jd-tagdescr"><p>Checks if the UI element's <code>checkable</code> property is currently true.</p></div>
3608 <div class="jd-tagdata">
3609 <h5 class="jd-tagtitle">Returns</h5>
3610 <ul class="nolist"><li>true if it is else false</li></ul>
3611 </div>
3612 <div class="jd-tagdata">
3613 <h5 class="jd-tagtitle">Throws</h5>
3614 <table class="jd-tagtable">
3615 <tr>
3616 <th></td>
3617 <td>UiObjectNotFoundException</td>
3618 </tr>
3619 <tr>
3620 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3621 <td></td>
3622 </tr>
3623 </table>
3624 </div>
3625
3626 </div>
3627</div>
3628
3629
3630<A NAME="isChecked()"></A>
3631
3632<div class="jd-details api apilevel-">
3633 <h4 class="jd-details-title">
3634 <span class="normal">
3635 public
3636
3637
3638
3639
3640 boolean
3641 </span>
3642 <span class="sympad">isChecked</span>
3643 <span class="normal">()</span>
3644 </h4>
3645 <div class="api-level">
3646 <div></div>
3647
3648
3649
3650 </div>
3651 <div class="jd-details-descr">
3652
3653
3654
3655
3656 <div class="jd-tagdata jd-tagdescr"><p>Check if the UI element's <code>checked</code> property is currently true</p></div>
3657 <div class="jd-tagdata">
3658 <h5 class="jd-tagtitle">Returns</h5>
3659 <ul class="nolist"><li>true if it is else false</li></ul>
3660 </div>
3661 <div class="jd-tagdata">
3662 <h5 class="jd-tagtitle">Throws</h5>
3663 <table class="jd-tagtable">
3664 <tr>
3665 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3666 <td></td>
3667 </tr>
3668 </table>
3669 </div>
3670
3671 </div>
3672</div>
3673
3674
3675<A NAME="isClickable()"></A>
3676
3677<div class="jd-details api apilevel-">
3678 <h4 class="jd-details-title">
3679 <span class="normal">
3680 public
3681
3682
3683
3684
3685 boolean
3686 </span>
3687 <span class="sympad">isClickable</span>
3688 <span class="normal">()</span>
3689 </h4>
3690 <div class="api-level">
3691 <div></div>
3692
3693
3694
3695 </div>
3696 <div class="jd-details-descr">
3697
3698
3699
3700
3701 <div class="jd-tagdata jd-tagdescr"><p>Checks if the UI element's <code>clickable</code> property is currently true.</p></div>
3702 <div class="jd-tagdata">
3703 <h5 class="jd-tagtitle">Returns</h5>
3704 <ul class="nolist"><li>true if it is else false</li></ul>
3705 </div>
3706 <div class="jd-tagdata">
3707 <h5 class="jd-tagtitle">Throws</h5>
3708 <table class="jd-tagtable">
3709 <tr>
3710 <th></td>
3711 <td>UiObjectNotFoundException</td>
3712 </tr>
3713 <tr>
3714 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3715 <td></td>
3716 </tr>
3717 </table>
3718 </div>
3719
3720 </div>
3721</div>
3722
3723
3724<A NAME="isEnabled()"></A>
3725
3726<div class="jd-details api apilevel-">
3727 <h4 class="jd-details-title">
3728 <span class="normal">
3729 public
3730
3731
3732
3733
3734 boolean
3735 </span>
3736 <span class="sympad">isEnabled</span>
3737 <span class="normal">()</span>
3738 </h4>
3739 <div class="api-level">
3740 <div></div>
3741
3742
3743
3744 </div>
3745 <div class="jd-details-descr">
3746
3747
3748
3749
3750 <div class="jd-tagdata jd-tagdescr"><p>Checks if the UI element's <code>enabled</code> property is currently true.</p></div>
3751 <div class="jd-tagdata">
3752 <h5 class="jd-tagtitle">Returns</h5>
3753 <ul class="nolist"><li>true if it is else false</li></ul>
3754 </div>
3755 <div class="jd-tagdata">
3756 <h5 class="jd-tagtitle">Throws</h5>
3757 <table class="jd-tagtable">
3758 <tr>
3759 <th></td>
3760 <td>UiObjectNotFoundException</td>
3761 </tr>
3762 <tr>
3763 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3764 <td></td>
3765 </tr>
3766 </table>
3767 </div>
3768
3769 </div>
3770</div>
3771
3772
3773<A NAME="isFocusable()"></A>
3774
3775<div class="jd-details api apilevel-">
3776 <h4 class="jd-details-title">
3777 <span class="normal">
3778 public
3779
3780
3781
3782
3783 boolean
3784 </span>
3785 <span class="sympad">isFocusable</span>
3786 <span class="normal">()</span>
3787 </h4>
3788 <div class="api-level">
3789 <div></div>
3790
3791
3792
3793 </div>
3794 <div class="jd-details-descr">
3795
3796
3797
3798
3799 <div class="jd-tagdata jd-tagdescr"><p>Check if the UI element's <code>focusable</code> property is currently true.</p></div>
3800 <div class="jd-tagdata">
3801 <h5 class="jd-tagtitle">Returns</h5>
3802 <ul class="nolist"><li>true if it is else false</li></ul>
3803 </div>
3804 <div class="jd-tagdata">
3805 <h5 class="jd-tagtitle">Throws</h5>
3806 <table class="jd-tagtable">
3807 <tr>
3808 <th></td>
3809 <td>UiObjectNotFoundException</td>
3810 </tr>
3811 <tr>
3812 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3813 <td></td>
3814 </tr>
3815 </table>
3816 </div>
3817
3818 </div>
3819</div>
3820
3821
3822<A NAME="isFocused()"></A>
3823
3824<div class="jd-details api apilevel-">
3825 <h4 class="jd-details-title">
3826 <span class="normal">
3827 public
3828
3829
3830
3831
3832 boolean
3833 </span>
3834 <span class="sympad">isFocused</span>
3835 <span class="normal">()</span>
3836 </h4>
3837 <div class="api-level">
3838 <div></div>
3839
3840
3841
3842 </div>
3843 <div class="jd-details-descr">
3844
3845
3846
3847
3848 <div class="jd-tagdata jd-tagdescr"><p>Check if the UI element's <code>focused</code> property is currently true</p></div>
3849 <div class="jd-tagdata">
3850 <h5 class="jd-tagtitle">Returns</h5>
3851 <ul class="nolist"><li>true if it is else false</li></ul>
3852 </div>
3853 <div class="jd-tagdata">
3854 <h5 class="jd-tagtitle">Throws</h5>
3855 <table class="jd-tagtable">
3856 <tr>
3857 <th></td>
3858 <td>UiObjectNotFoundException</td>
3859 </tr>
3860 <tr>
3861 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3862 <td></td>
3863 </tr>
3864 </table>
3865 </div>
3866
3867 </div>
3868</div>
3869
3870
3871<A NAME="isLongClickable()"></A>
3872
3873<div class="jd-details api apilevel-">
3874 <h4 class="jd-details-title">
3875 <span class="normal">
3876 public
3877
3878
3879
3880
3881 boolean
3882 </span>
3883 <span class="sympad">isLongClickable</span>
3884 <span class="normal">()</span>
3885 </h4>
3886 <div class="api-level">
3887 <div></div>
3888
3889
3890
3891 </div>
3892 <div class="jd-details-descr">
3893
3894
3895
3896
3897 <div class="jd-tagdata jd-tagdescr"><p>Check if the view's <code>long-clickable</code> property is currently true</p></div>
3898 <div class="jd-tagdata">
3899 <h5 class="jd-tagtitle">Returns</h5>
3900 <ul class="nolist"><li>true if it is else false</li></ul>
3901 </div>
3902 <div class="jd-tagdata">
3903 <h5 class="jd-tagtitle">Throws</h5>
3904 <table class="jd-tagtable">
3905 <tr>
3906 <th></td>
3907 <td>UiObjectNotFoundException</td>
3908 </tr>
3909 <tr>
3910 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3911 <td></td>
3912 </tr>
3913 </table>
3914 </div>
3915
3916 </div>
3917</div>
3918
3919
3920<A NAME="isScrollable()"></A>
3921
3922<div class="jd-details api apilevel-">
3923 <h4 class="jd-details-title">
3924 <span class="normal">
3925 public
3926
3927
3928
3929
3930 boolean
3931 </span>
3932 <span class="sympad">isScrollable</span>
3933 <span class="normal">()</span>
3934 </h4>
3935 <div class="api-level">
3936 <div></div>
3937
3938
3939
3940 </div>
3941 <div class="jd-details-descr">
3942
3943
3944
3945
3946 <div class="jd-tagdata jd-tagdescr"><p>Check if the view's <code>scrollable</code> property is currently true</p></div>
3947 <div class="jd-tagdata">
3948 <h5 class="jd-tagtitle">Returns</h5>
3949 <ul class="nolist"><li>true if it is else false</li></ul>
3950 </div>
3951 <div class="jd-tagdata">
3952 <h5 class="jd-tagtitle">Throws</h5>
3953 <table class="jd-tagtable">
3954 <tr>
3955 <th></td>
3956 <td>UiObjectNotFoundException</td>
3957 </tr>
3958 <tr>
3959 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
3960 <td></td>
3961 </tr>
3962 </table>
3963 </div>
3964
3965 </div>
3966</div>
3967
3968
3969<A NAME="isSelected()"></A>
3970
3971<div class="jd-details api apilevel-">
3972 <h4 class="jd-details-title">
3973 <span class="normal">
3974 public
3975
3976
3977
3978
3979 boolean
3980 </span>
3981 <span class="sympad">isSelected</span>
3982 <span class="normal">()</span>
3983 </h4>
3984 <div class="api-level">
3985 <div></div>
3986
3987
3988
3989 </div>
3990 <div class="jd-details-descr">
3991
3992
3993
3994
3995 <div class="jd-tagdata jd-tagdescr"><p>Checks if the UI element's <code>selected</code> property is currently true.</p></div>
3996 <div class="jd-tagdata">
3997 <h5 class="jd-tagtitle">Returns</h5>
3998 <ul class="nolist"><li>true if it is else false</li></ul>
3999 </div>
4000 <div class="jd-tagdata">
4001 <h5 class="jd-tagtitle">Throws</h5>
4002 <table class="jd-tagtable">
4003 <tr>
4004 <th></td>
4005 <td>UiObjectNotFoundException</td>
4006 </tr>
4007 <tr>
4008 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
4009 <td></td>
4010 </tr>
4011 </table>
4012 </div>
4013
4014 </div>
4015</div>
4016
4017
4018<A NAME="longClick()"></A>
4019
4020<div class="jd-details api apilevel-">
4021 <h4 class="jd-details-title">
4022 <span class="normal">
4023 public
4024
4025
4026
4027
4028 boolean
4029 </span>
4030 <span class="sympad">longClick</span>
4031 <span class="normal">()</span>
4032 </h4>
4033 <div class="api-level">
4034 <div></div>
4035
4036
4037
4038 </div>
4039 <div class="jd-details-descr">
4040
4041
4042
4043
4044 <div class="jd-tagdata jd-tagdescr"><p>Long clicks the center of the visible bounds of the UI element</p></div>
4045 <div class="jd-tagdata">
4046 <h5 class="jd-tagtitle">Returns</h5>
4047 <ul class="nolist"><li>true if operation was successful</li></ul>
4048 </div>
4049 <div class="jd-tagdata">
4050 <h5 class="jd-tagtitle">Throws</h5>
4051 <table class="jd-tagtable">
4052 <tr>
4053 <th></td>
4054 <td>UiObjectNotFoundException</td>
4055 </tr>
4056 <tr>
4057 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
4058 <td></td>
4059 </tr>
4060 </table>
4061 </div>
4062
4063 </div>
4064</div>
4065
4066
4067<A NAME="longClickBottomRight()"></A>
4068
4069<div class="jd-details api apilevel-">
4070 <h4 class="jd-details-title">
4071 <span class="normal">
4072 public
4073
4074
4075
4076
4077 boolean
4078 </span>
4079 <span class="sympad">longClickBottomRight</span>
4080 <span class="normal">()</span>
4081 </h4>
4082 <div class="api-level">
4083 <div></div>
4084
4085
4086
4087 </div>
4088 <div class="jd-details-descr">
4089
4090
4091
4092
4093 <div class="jd-tagdata jd-tagdescr"><p>Long clicks bottom and right corner of the UI element</p></div>
4094 <div class="jd-tagdata">
4095 <h5 class="jd-tagtitle">Returns</h5>
4096 <ul class="nolist"><li>true if operation was successful</li></ul>
4097 </div>
4098 <div class="jd-tagdata">
4099 <h5 class="jd-tagtitle">Throws</h5>
4100 <table class="jd-tagtable">
4101 <tr>
4102 <th></td>
4103 <td>UiObjectNotFoundException</td>
4104 </tr>
4105 <tr>
4106 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
4107 <td></td>
4108 </tr>
4109 </table>
4110 </div>
4111
4112 </div>
4113</div>
4114
4115
4116<A NAME="longClickTopLeft()"></A>
4117
4118<div class="jd-details api apilevel-">
4119 <h4 class="jd-details-title">
4120 <span class="normal">
4121 public
4122
4123
4124
4125
4126 boolean
4127 </span>
4128 <span class="sympad">longClickTopLeft</span>
4129 <span class="normal">()</span>
4130 </h4>
4131 <div class="api-level">
4132 <div></div>
4133
4134
4135
4136 </div>
4137 <div class="jd-details-descr">
4138
4139
4140
4141
4142 <div class="jd-tagdata jd-tagdescr"><p>Long clicks on the top and left corner of the UI element</p></div>
4143 <div class="jd-tagdata">
4144 <h5 class="jd-tagtitle">Returns</h5>
4145 <ul class="nolist"><li>true if operation was successful</li></ul>
4146 </div>
4147 <div class="jd-tagdata">
4148 <h5 class="jd-tagtitle">Throws</h5>
4149 <table class="jd-tagtable">
4150 <tr>
4151 <th></td>
4152 <td>UiObjectNotFoundException</td>
4153 </tr>
4154 <tr>
4155 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
4156 <td></td>
4157 </tr>
4158 </table>
4159 </div>
4160
4161 </div>
4162</div>
4163
4164
4165<A NAME="performMultiPointerGesture(android.view.MotionEvent.PointerCoords[]...)"></A>
4166
4167<div class="jd-details api apilevel-">
4168 <h4 class="jd-details-title">
4169 <span class="normal">
4170 public
4171
4172
4173
4174
4175 boolean
4176 </span>
4177 <span class="sympad">performMultiPointerGesture</span>
4178 <span class="normal">(PointerCoords... touches)</span>
4179 </h4>
4180 <div class="api-level">
4181 <div></div>
4182
4183
4184
4185 </div>
4186 <div class="jd-details-descr">
4187
4188
4189
4190
4191 <div class="jd-tagdata jd-tagdescr"><p>Performs a multi-touch gesture. You must specify touch coordinates for
4192 at least 2 pointers. Each pointer must have all of its touch steps
4193 defined in an array of <code><a href="../../../../../reference/android/view/MotionEvent.PointerCoords.html">MotionEvent.PointerCoords</a></code>. You can use this method to
4194 specify complex gestures, like circles and irregular shapes, where each
4195 pointer may take a different path.
4196
4197 To create a single point on a pointer's touch path:
4198 <code>
4199 PointerCoords p = new PointerCoords();
4200 p.x = stepX;
4201 p.y = stepY;
4202 p.pressure = 1;
4203 p.size = 1;
4204 </code></p></div>
4205 <div class="jd-tagdata">
4206 <h5 class="jd-tagtitle">Parameters</h5>
4207 <table class="jd-tagtable">
4208 <tr>
4209 <th>touches</td>
4210 <td>represents the pointers' paths. Each <code><a href="../../../../../reference/android/view/MotionEvent.PointerCoords.html">MotionEvent.PointerCoords</a></code>
4211 array represents a different pointer. Each <code><a href="../../../../../reference/android/view/MotionEvent.PointerCoords.html">MotionEvent.PointerCoords</a></code> in an
4212 array element represents a touch point on a pointer's path.</td>
4213 </tr>
4214 </table>
4215 </div>
4216 <div class="jd-tagdata">
4217 <h5 class="jd-tagtitle">Returns</h5>
4218 <ul class="nolist"><li><code>true</code> if all touch events for this gesture are injected successfully,
4219 <code>false</code> otherwise</li></ul>
4220 </div>
4221
4222 </div>
4223</div>
4224
4225
4226<A NAME="performTwoPointerGesture(android.graphics.Point, android.graphics.Point, android.graphics.Point, android.graphics.Point, int)"></A>
4227
4228<div class="jd-details api apilevel-">
4229 <h4 class="jd-details-title">
4230 <span class="normal">
4231 public
4232
4233
4234
4235
4236 boolean
4237 </span>
4238 <span class="sympad">performTwoPointerGesture</span>
4239 <span class="normal">(Point startPoint1, Point startPoint2, Point endPoint1, Point endPoint2, int steps)</span>
4240 </h4>
4241 <div class="api-level">
4242 <div></div>
4243
4244
4245
4246 </div>
4247 <div class="jd-details-descr">
4248
4249
4250
4251
4252 <div class="jd-tagdata jd-tagdescr"><p>Generates a two-pointer gesture with arbitrary starting and ending points.</p></div>
4253 <div class="jd-tagdata">
4254 <h5 class="jd-tagtitle">Parameters</h5>
4255 <table class="jd-tagtable">
4256 <tr>
4257 <th>startPoint1</td>
4258 <td>start point of pointer 1</td>
4259 </tr>
4260 <tr>
4261 <th>startPoint2</td>
4262 <td>start point of pointer 2</td>
4263 </tr>
4264 <tr>
4265 <th>endPoint1</td>
4266 <td>end point of pointer 1</td>
4267 </tr>
4268 <tr>
4269 <th>endPoint2</td>
4270 <td>end point of pointer 2</td>
4271 </tr>
4272 <tr>
4273 <th>steps</td>
4274 <td>the number of steps for the gesture. Steps are injected
4275 about 5 milliseconds apart, so 100 steps may take around 0.5 seconds to complete.</td>
4276 </tr>
4277 </table>
4278 </div>
4279 <div class="jd-tagdata">
4280 <h5 class="jd-tagtitle">Returns</h5>
4281 <ul class="nolist"><li><code>true</code> if all touch events for this gesture are injected successfully,
4282 <code>false</code> otherwise</li></ul>
4283 </div>
4284
4285 </div>
4286</div>
4287
4288
4289<A NAME="pinchIn(int, int)"></A>
4290
4291<div class="jd-details api apilevel-">
4292 <h4 class="jd-details-title">
4293 <span class="normal">
4294 public
4295
4296
4297
4298
4299 boolean
4300 </span>
4301 <span class="sympad">pinchIn</span>
4302 <span class="normal">(int percent, int steps)</span>
4303 </h4>
4304 <div class="api-level">
4305 <div></div>
4306
4307
4308
4309 </div>
4310 <div class="jd-details-descr">
4311
4312
4313
4314
4315 <div class="jd-tagdata jd-tagdescr"><p>Performs a two-pointer gesture, where each pointer moves diagonally
4316 toward the other, from the edges to the center of this UiObject .</p></div>
4317 <div class="jd-tagdata">
4318 <h5 class="jd-tagtitle">Parameters</h5>
4319 <table class="jd-tagtable">
4320 <tr>
4321 <th>percent</td>
4322 <td>percentage of the object's diagonal length for the pinch gesture</td>
4323 </tr>
4324 <tr>
4325 <th>steps</td>
4326 <td>the number of steps for the gesture. Steps are injected
4327 about 5 milliseconds apart, so 100 steps may take around 0.5 seconds to complete.</td>
4328 </tr>
4329 </table>
4330 </div>
4331 <div class="jd-tagdata">
4332 <h5 class="jd-tagtitle">Returns</h5>
4333 <ul class="nolist"><li><code>true</code> if all touch events for this gesture are injected successfully,
4334 <code>false</code> otherwise</li></ul>
4335 </div>
4336 <div class="jd-tagdata">
4337 <h5 class="jd-tagtitle">Throws</h5>
4338 <table class="jd-tagtable">
4339 <tr>
4340 <th></td>
4341 <td>UiObjectNotFoundException</td>
4342 </tr>
4343 <tr>
4344 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
4345 <td></td>
4346 </tr>
4347 </table>
4348 </div>
4349
4350 </div>
4351</div>
4352
4353
4354<A NAME="pinchOut(int, int)"></A>
4355
4356<div class="jd-details api apilevel-">
4357 <h4 class="jd-details-title">
4358 <span class="normal">
4359 public
4360
4361
4362
4363
4364 boolean
4365 </span>
4366 <span class="sympad">pinchOut</span>
4367 <span class="normal">(int percent, int steps)</span>
4368 </h4>
4369 <div class="api-level">
4370 <div></div>
4371
4372
4373
4374 </div>
4375 <div class="jd-details-descr">
4376
4377
4378
4379
4380 <div class="jd-tagdata jd-tagdescr"><p>Performs a two-pointer gesture, where each pointer moves diagonally
4381 opposite across the other, from the center out towards the edges of the
4382 this UiObject.</p></div>
4383 <div class="jd-tagdata">
4384 <h5 class="jd-tagtitle">Parameters</h5>
4385 <table class="jd-tagtable">
4386 <tr>
4387 <th>percent</td>
4388 <td>percentage of the object's diagonal length for the pinch gesture</td>
4389 </tr>
4390 <tr>
4391 <th>steps</td>
4392 <td>the number of steps for the gesture. Steps are injected
4393 about 5 milliseconds apart, so 100 steps may take around 0.5 seconds to complete.</td>
4394 </tr>
4395 </table>
4396 </div>
4397 <div class="jd-tagdata">
4398 <h5 class="jd-tagtitle">Returns</h5>
4399 <ul class="nolist"><li><code>true</code> if all touch events for this gesture are injected successfully,
4400 <code>false</code> otherwise</li></ul>
4401 </div>
4402 <div class="jd-tagdata">
4403 <h5 class="jd-tagtitle">Throws</h5>
4404 <table class="jd-tagtable">
4405 <tr>
4406 <th></td>
4407 <td>UiObjectNotFoundException</td>
4408 </tr>
4409 <tr>
4410 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
4411 <td></td>
4412 </tr>
4413 </table>
4414 </div>
4415
4416 </div>
4417</div>
4418
4419
4420<A NAME="setText(java.lang.String)"></A>
4421
4422<div class="jd-details api apilevel-">
4423 <h4 class="jd-details-title">
4424 <span class="normal">
4425 public
4426
4427
4428
4429
4430 boolean
4431 </span>
4432 <span class="sympad">setText</span>
4433 <span class="normal">(String text)</span>
4434 </h4>
4435 <div class="api-level">
4436 <div></div>
4437
4438
4439
4440 </div>
4441 <div class="jd-details-descr">
4442
4443
4444
4445
4446 <div class="jd-tagdata jd-tagdescr"><p>Sets the text in an editable field, after clearing the field's content.
4447
4448 <p>
4449 The <code><a href="../../../../../reference/android/support/test/uiautomator/UiSelector.html">UiSelector</a></code> selector of this object must reference a UI element that is editable.
4450
4451 <p>
4452 When you call this method, the method sets focus on the editable field, clears its existing
4453 content, then injects your specified text into the field.
4454
4455 <p>
4456 If you want to capture the original contents of the field, call <code><a href="../../../../../reference/android/support/test/uiautomator/UiObject.html#getText()">getText()</a></code> first.
4457 You can then modify the text and use this method to update the field.
4458
4459 <p><strong>Improvements: </strong>
4460 Post API Level 19 (KitKat release), the underlying implementation is updated to a dedicated
4461 set text accessibility action, and it also now supports Unicode.</p></div>
4462 <div class="jd-tagdata">
4463 <h5 class="jd-tagtitle">Parameters</h5>
4464 <table class="jd-tagtable">
4465 <tr>
4466 <th>text</td>
4467 <td>string to set</td>
4468 </tr>
4469 </table>
4470 </div>
4471 <div class="jd-tagdata">
4472 <h5 class="jd-tagtitle">Returns</h5>
4473 <ul class="nolist"><li>true if operation is successful</li></ul>
4474 </div>
4475 <div class="jd-tagdata">
4476 <h5 class="jd-tagtitle">Throws</h5>
4477 <table class="jd-tagtable">
4478 <tr>
4479 <th></td>
4480 <td>UiObjectNotFoundException</td>
4481 </tr>
4482 <tr>
4483 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
4484 <td></td>
4485 </tr>
4486 </table>
4487 </div>
4488
4489 </div>
4490</div>
4491
4492
4493<A NAME="swipeDown(int)"></A>
4494
4495<div class="jd-details api apilevel-">
4496 <h4 class="jd-details-title">
4497 <span class="normal">
4498 public
4499
4500
4501
4502
4503 boolean
4504 </span>
4505 <span class="sympad">swipeDown</span>
4506 <span class="normal">(int steps)</span>
4507 </h4>
4508 <div class="api-level">
4509 <div></div>
4510
4511
4512
4513 </div>
4514 <div class="jd-details-descr">
4515
4516
4517
4518
4519 <div class="jd-tagdata jd-tagdescr"><p>Performs the swipe down action on the UiObject.
4520 The swipe gesture can be performed over any surface. The targeted
4521 UI element does not need to be scrollable.
4522 See also:
4523 <ul>
4524 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollToBeginning(int)">scrollToBeginning(int)</a></code></li>
4525 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollToEnd(int)">scrollToEnd(int)</a></code></li>
4526 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollBackward()">scrollBackward()</a></code></li>
4527 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollForward()">scrollForward()</a></code></li>
4528 </ul></p></div>
4529 <div class="jd-tagdata">
4530 <h5 class="jd-tagtitle">Parameters</h5>
4531 <table class="jd-tagtable">
4532 <tr>
4533 <th>steps</td>
4534 <td>indicates the number of injected move steps into the system. Steps are
4535 injected about 5ms apart. So a 100 steps may take about 1/2 second to complete.</td>
4536 </tr>
4537 </table>
4538 </div>
4539 <div class="jd-tagdata">
4540 <h5 class="jd-tagtitle">Returns</h5>
4541 <ul class="nolist"><li>true if successful</li></ul>
4542 </div>
4543 <div class="jd-tagdata">
4544 <h5 class="jd-tagtitle">Throws</h5>
4545 <table class="jd-tagtable">
4546 <tr>
4547 <th></td>
4548 <td>UiObjectNotFoundException</td>
4549 </tr>
4550 <tr>
4551 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
4552 <td></td>
4553 </tr>
4554 </table>
4555 </div>
4556
4557 </div>
4558</div>
4559
4560
4561<A NAME="swipeLeft(int)"></A>
4562
4563<div class="jd-details api apilevel-">
4564 <h4 class="jd-details-title">
4565 <span class="normal">
4566 public
4567
4568
4569
4570
4571 boolean
4572 </span>
4573 <span class="sympad">swipeLeft</span>
4574 <span class="normal">(int steps)</span>
4575 </h4>
4576 <div class="api-level">
4577 <div></div>
4578
4579
4580
4581 </div>
4582 <div class="jd-details-descr">
4583
4584
4585
4586
4587 <div class="jd-tagdata jd-tagdescr"><p>Performs the swipe left action on the UiObject.
4588 The swipe gesture can be performed over any surface. The targeted
4589 UI element does not need to be scrollable.
4590 See also:
4591 <ul>
4592 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollToBeginning(int)">scrollToBeginning(int)</a></code></li>
4593 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollToEnd(int)">scrollToEnd(int)</a></code></li>
4594 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollBackward()">scrollBackward()</a></code></li>
4595 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollForward()">scrollForward()</a></code></li>
4596 </ul></p></div>
4597 <div class="jd-tagdata">
4598 <h5 class="jd-tagtitle">Parameters</h5>
4599 <table class="jd-tagtable">
4600 <tr>
4601 <th>steps</td>
4602 <td>indicates the number of injected move steps into the system. Steps are
4603 injected about 5ms apart. So a 100 steps may take about 1/2 second to complete.</td>
4604 </tr>
4605 </table>
4606 </div>
4607 <div class="jd-tagdata">
4608 <h5 class="jd-tagtitle">Returns</h5>
4609 <ul class="nolist"><li>true if successful</li></ul>
4610 </div>
4611 <div class="jd-tagdata">
4612 <h5 class="jd-tagtitle">Throws</h5>
4613 <table class="jd-tagtable">
4614 <tr>
4615 <th></td>
4616 <td>UiObjectNotFoundException</td>
4617 </tr>
4618 <tr>
4619 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
4620 <td></td>
4621 </tr>
4622 </table>
4623 </div>
4624
4625 </div>
4626</div>
4627
4628
4629<A NAME="swipeRight(int)"></A>
4630
4631<div class="jd-details api apilevel-">
4632 <h4 class="jd-details-title">
4633 <span class="normal">
4634 public
4635
4636
4637
4638
4639 boolean
4640 </span>
4641 <span class="sympad">swipeRight</span>
4642 <span class="normal">(int steps)</span>
4643 </h4>
4644 <div class="api-level">
4645 <div></div>
4646
4647
4648
4649 </div>
4650 <div class="jd-details-descr">
4651
4652
4653
4654
4655 <div class="jd-tagdata jd-tagdescr"><p>Performs the swipe right action on the UiObject.
4656 The swipe gesture can be performed over any surface. The targeted
4657 UI element does not need to be scrollable.
4658 See also:
4659 <ul>
4660 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollToBeginning(int)">scrollToBeginning(int)</a></code></li>
4661 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollToEnd(int)">scrollToEnd(int)</a></code></li>
4662 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollBackward()">scrollBackward()</a></code></li>
4663 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollForward()">scrollForward()</a></code></li>
4664 </ul></p></div>
4665 <div class="jd-tagdata">
4666 <h5 class="jd-tagtitle">Parameters</h5>
4667 <table class="jd-tagtable">
4668 <tr>
4669 <th>steps</td>
4670 <td>indicates the number of injected move steps into the system. Steps are
4671 injected about 5ms apart. So a 100 steps may take about 1/2 second to complete.</td>
4672 </tr>
4673 </table>
4674 </div>
4675 <div class="jd-tagdata">
4676 <h5 class="jd-tagtitle">Returns</h5>
4677 <ul class="nolist"><li>true if successful</li></ul>
4678 </div>
4679 <div class="jd-tagdata">
4680 <h5 class="jd-tagtitle">Throws</h5>
4681 <table class="jd-tagtable">
4682 <tr>
4683 <th></td>
4684 <td>UiObjectNotFoundException</td>
4685 </tr>
4686 <tr>
4687 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
4688 <td></td>
4689 </tr>
4690 </table>
4691 </div>
4692
4693 </div>
4694</div>
4695
4696
4697<A NAME="swipeUp(int)"></A>
4698
4699<div class="jd-details api apilevel-">
4700 <h4 class="jd-details-title">
4701 <span class="normal">
4702 public
4703
4704
4705
4706
4707 boolean
4708 </span>
4709 <span class="sympad">swipeUp</span>
4710 <span class="normal">(int steps)</span>
4711 </h4>
4712 <div class="api-level">
4713 <div></div>
4714
4715
4716
4717 </div>
4718 <div class="jd-details-descr">
4719
4720
4721
4722
4723 <div class="jd-tagdata jd-tagdescr"><p>Performs the swipe up action on the UiObject.
4724 See also:
4725 <ul>
4726 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollToBeginning(int)">scrollToBeginning(int)</a></code></li>
4727 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollToEnd(int)">scrollToEnd(int)</a></code></li>
4728 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollBackward()">scrollBackward()</a></code></li>
4729 <li><code><a href="../../../../../reference/android/support/test/uiautomator/UiScrollable.html#scrollForward()">scrollForward()</a></code></li>
4730 </ul></p></div>
4731 <div class="jd-tagdata">
4732 <h5 class="jd-tagtitle">Parameters</h5>
4733 <table class="jd-tagtable">
4734 <tr>
4735 <th>steps</td>
4736 <td>indicates the number of injected move steps into the system. Steps are
4737 injected about 5ms apart. So a 100 steps may take about 1/2 second to complete.</td>
4738 </tr>
4739 </table>
4740 </div>
4741 <div class="jd-tagdata">
4742 <h5 class="jd-tagtitle">Returns</h5>
4743 <ul class="nolist"><li>true of successful</li></ul>
4744 </div>
4745 <div class="jd-tagdata">
4746 <h5 class="jd-tagtitle">Throws</h5>
4747 <table class="jd-tagtable">
4748 <tr>
4749 <th></td>
4750 <td>UiObjectNotFoundException</td>
4751 </tr>
4752 <tr>
4753 <th><a href="../../../../../reference/android/support/test/uiautomator/UiObjectNotFoundException.html">UiObjectNotFoundException</a></td>
4754 <td></td>
4755 </tr>
4756 </table>
4757 </div>
4758
4759 </div>
4760</div>
4761
4762
4763<A NAME="waitForExists(long)"></A>
4764
4765<div class="jd-details api apilevel-">
4766 <h4 class="jd-details-title">
4767 <span class="normal">
4768 public
4769
4770
4771
4772
4773 boolean
4774 </span>
4775 <span class="sympad">waitForExists</span>
4776 <span class="normal">(long timeout)</span>
4777 </h4>
4778 <div class="api-level">
4779 <div></div>
4780
4781
4782
4783 </div>
4784 <div class="jd-details-descr">
4785
4786
4787
4788
4789 <div class="jd-tagdata jd-tagdescr"><p>Waits a specified length of time for a view to become visible.
4790
4791 This method waits until the view becomes visible on the display, or
4792 until the timeout has elapsed. You can use this method in situations where
4793 the content that you want to select is not immediately displayed.</p></div>
4794 <div class="jd-tagdata">
4795 <h5 class="jd-tagtitle">Parameters</h5>
4796 <table class="jd-tagtable">
4797 <tr>
4798 <th>timeout</td>
4799 <td>the amount of time to wait (in milliseconds)</td>
4800 </tr>
4801 </table>
4802 </div>
4803 <div class="jd-tagdata">
4804 <h5 class="jd-tagtitle">Returns</h5>
4805 <ul class="nolist"><li>true if the view is displayed, else false if timeout elapsed while waiting</li></ul>
4806 </div>
4807
4808 </div>
4809</div>
4810
4811
4812<A NAME="waitUntilGone(long)"></A>
4813
4814<div class="jd-details api apilevel-">
4815 <h4 class="jd-details-title">
4816 <span class="normal">
4817 public
4818
4819
4820
4821
4822 boolean
4823 </span>
4824 <span class="sympad">waitUntilGone</span>
4825 <span class="normal">(long timeout)</span>
4826 </h4>
4827 <div class="api-level">
4828 <div></div>
4829
4830
4831
4832 </div>
4833 <div class="jd-details-descr">
4834
4835
4836
4837
4838 <div class="jd-tagdata jd-tagdescr"><p>Waits a specified length of time for a view to become undetectable.
4839
4840 This method waits until a view is no longer matchable, or until the
4841 timeout has elapsed.
4842
4843 A view becomes undetectable when the <code><a href="../../../../../reference/android/support/test/uiautomator/UiSelector.html">UiSelector</a></code> of the object is
4844 unable to find a match because the element has either changed its state or is no
4845 longer displayed.
4846
4847 You can use this method when attempting to wait for some long operation
4848 to compete, such as downloading a large file or connecting to a remote server.</p></div>
4849 <div class="jd-tagdata">
4850 <h5 class="jd-tagtitle">Parameters</h5>
4851 <table class="jd-tagtable">
4852 <tr>
4853 <th>timeout</td>
4854 <td>time to wait (in milliseconds)</td>
4855 </tr>
4856 </table>
4857 </div>
4858 <div class="jd-tagdata">
4859 <h5 class="jd-tagtitle">Returns</h5>
4860 <ul class="nolist"><li>true if the element is gone before timeout elapsed, else false if timeout elapsed
4861 but a matching element is still found.</li></ul>
4862 </div>
4863
4864 </div>
4865</div>
4866
4867
4868
4869
4870
4871<!-- ========= METHOD DETAIL ======== -->
4872
4873<h2>Protected Methods</h2>
4874
4875
4876
4877<A NAME="findAccessibilityNodeInfo(long)"></A>
4878
4879<div class="jd-details api apilevel-">
4880 <h4 class="jd-details-title">
4881 <span class="normal">
4882 protected
4883
4884
4885
4886
4887 AccessibilityNodeInfo
4888 </span>
4889 <span class="sympad">findAccessibilityNodeInfo</span>
4890 <span class="normal">(long timeout)</span>
4891 </h4>
4892 <div class="api-level">
4893 <div></div>
4894
4895
4896
4897 </div>
4898 <div class="jd-details-descr">
4899
4900
4901
4902
4903 <div class="jd-tagdata jd-tagdescr"><p>Finds a matching UI element in the accessibility hierarchy, by
4904 using the selector for this UiObject.</p></div>
4905 <div class="jd-tagdata">
4906 <h5 class="jd-tagtitle">Parameters</h5>
4907 <table class="jd-tagtable">
4908 <tr>
4909 <th>timeout</td>
4910 <td>in milliseconds</td>
4911 </tr>
4912 </table>
4913 </div>
4914 <div class="jd-tagdata">
4915 <h5 class="jd-tagtitle">Returns</h5>
4916 <ul class="nolist"><li>AccessibilityNodeInfo if found else null</li></ul>
4917 </div>
4918
4919 </div>
4920</div>
4921
4922
4923
4924
4925
4926<!-- ========= END OF CLASS DATA ========= -->
4927<A NAME="navbar_top"></A>
4928
4929<div id="footer" class="wrap" >
4930
4931
4932 <div id="copyright">
4933
4934 Except as noted, this content is licensed under <a
4935 href="http://www.apache.org/licenses/LICENSE-2.0">Apache 2.0</a>.
4936 For details and restrictions, see the <a href="../../../../../license.html">
4937 Content License</a>.
4938 </div>
4939 <div id="build_info">
4940
4941 Android &nbsp;r &mdash;
4942<script src="../../../../../timestamp.js" type="text/javascript"></script>
4943<script>document.write(BUILD_TIMESTAMP)</script>
4944
4945 </div>
4946
4947
4948 <div id="footerlinks">
4949
4950 <p>
4951 <a href="../../../../../about/index.html">About Android</a>&nbsp;&nbsp;|&nbsp;
4952 <a href="../../../../../legal.html">Legal</a>&nbsp;&nbsp;|&nbsp;
4953 <a href="../../../../../support.html">Support</a>
4954 </p>
4955 </div>
4956
4957</div> <!-- end footer -->
4958</div> <!-- jd-content -->
4959
4960</div><!-- end doc-content -->
4961
4962</div> <!-- end body-content -->
4963
4964
4965
4966
4967
4968
4969</body>
4970</html>