android-7.0.0_r1/s

<!DOCTYPE html>
<html devsite>
<head>


    <meta name="top_category" value="develop" />

    <meta name="subcategory" value="reference" />


      <meta name="book_path" value="/reference/android/support/test/_book.yaml" />


<title>DataInteraction</title>


</head>

<body class="gc-documentation develop reference api apilevel-">
<div id="doc-api-level" class="" style="display:none"></div>


<div id="naMessage"></div>

<div id="api-info-block">
<div class="api-level">


</div>


<div class="sum-details-links">

Summary:


  <a href="#pubmethods">Methods</a>


  &#124; <a href="#inhmethods">Inherited Methods</a>

&#124; <a href="#" onclick="return toggleAllClassInherited()" id="toggleAllClassInherited">[Expand All]</a>

</div><!-- end sum-details-links -->
</div><!-- end api-info-block -->

<div class="api apilevel-" id="jd-content">

<!-- ======== START OF CLASS DATA ======== -->

<h1 class="api-title">DataInteraction</h1>
<p>
<code class="api-signature">
  public


  class
  DataInteraction
</code>
<br>


<code class="api-signature">

    extends Object


</code>

<code class="api-signature">


</code>

</p><table class="jd-inheritance-table">


  <tr>

    <td colspan="2" class="jd-inheritance-class-cell">java.lang.Object
    </td>
  </tr>


  <tr>

      <td class="jd-inheritance-space">&nbsp;&nbsp;&nbsp;&#x21b3;</td>

    <td colspan="1" class="jd-inheritance-class-cell">android.support.test.espresso.DataInteraction
    </td>
  </tr>


</table>


<br><hr>


  <p>An interface to interact with data displayed in AdapterViews.
 <p>
 This interface builds on top of <code><a href="/reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a></code> and should be the preferred way to
 interact with elements displayed inside AdapterViews.
 </p>
 <p>
 This is necessary because an AdapterView may not load all the data held by its Adapter into the
 view hierarchy until a user interaction makes it necessary. Also it is more fluent / less brittle
 to match upon the data object being rendered into the display then the rendering itself.
 </p>
 <p>
 By default, a DataInteraction takes place against any AdapterView found within the current
 screen, if you have multiple AdapterView objects displayed, you will need to narrow the selection
 by using the inAdapterView method.
 </p>
 <p>
 The check and perform method operate on the top level child of the adapter view, if you need to
 operate on a subview (eg: a Button within the list) use the onChildView method before calling
 perform or check.
 </p>

</p>


<h2 class="api-section">Summary</h2>


<!-- ========== METHOD SUMMARY =========== -->
<table id="pubmethods" class="responsive methods">
<tr><th colspan="2"><h3>Public methods</h3></th></tr>


  <tr class="api apilevel-" >


    <td><code>


        <a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></code>
    </td>

    <td width="100%">
      <code>
      <a href="/reference/android/support/test/espresso/DataInteraction.html#atPosition(java.lang.Integer)">atPosition</a>(Integer atPosition)
      </code>

        <p>Selects the view which matches the nth position on the adapter
 based on the data matcher.


</p>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        <a href="/reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a></code>
    </td>

    <td width="100%">
      <code>
      <a href="/reference/android/support/test/espresso/DataInteraction.html#check(android.support.test.espresso.ViewAssertion)">check</a>(<a href="/reference/android/support/test/espresso/ViewAssertion.html">ViewAssertion</a> assertion)
      </code>

        <p>Performs an assertion on the state of the view after we force the data to be loaded.


</p>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        <a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></code>
    </td>

    <td width="100%">
      <code>
      <a href="/reference/android/support/test/espresso/DataInteraction.html#inAdapterView(org.hamcrest.Matcher<android.view.View>)">inAdapterView</a>(Matcher&lt;View&gt; adapterMatcher)
      </code>

        <p>Selects a particular adapter view to operate on, by default we operate on any adapter view
 on the screen.


</p>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        <a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></code>
    </td>

    <td width="100%">
      <code>
      <a href="/reference/android/support/test/espresso/DataInteraction.html#inRoot(org.hamcrest.Matcher<android.support.test.espresso.Root>)">inRoot</a>(Matcher&lt;<a href="/reference/android/support/test/espresso/Root.html">Root</a>&gt; rootMatcher)
      </code>

        <p>Causes this data interaction to work within the Root specified by the given root matcher.


</p>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        <a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></code>
    </td>

    <td width="100%">
      <code>
      <a href="/reference/android/support/test/espresso/DataInteraction.html#onChildView(org.hamcrest.Matcher<android.view.View>)">onChildView</a>(Matcher&lt;View&gt; childMatcher)
      </code>

        <p>Causes perform and check methods to take place on a specific child view of the view returned
 by Adapter.getView()


</p>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        <a href="/reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a></code>
    </td>

    <td width="100%">
      <code>
      <a href="/reference/android/support/test/espresso/DataInteraction.html#perform(android.support.test.espresso.ViewAction...)">perform</a>(<a href="/reference/android/support/test/espresso/ViewAction.html">ViewAction...</a> actions)
      </code>

        <p>Performs an action on the view after we force the data to be loaded.


</p>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        <a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></code>
    </td>

    <td width="100%">
      <code>
      <a href="/reference/android/support/test/espresso/DataInteraction.html#usingAdapterViewProtocol(android.support.test.espresso.action.AdapterViewProtocol)">usingAdapterViewProtocol</a>(<a href="/reference/android/support/test/espresso/action/AdapterViewProtocol.html">AdapterViewProtocol</a> adapterViewProtocol)
      </code>

        <p>Use a different AdapterViewProtocol if the Adapter implementation does not
 satisfy the AdapterView contract like (@code ExpandableListView)


</p>

    </td>
  </tr>


</table>


<!-- ========== METHOD SUMMARY =========== -->
<table id="inhmethods" class="methods inhtable">
<tr><th><h3>Inherited methods</h3></th></tr>


<tr class="api apilevel-" >
<td colspan="2">

  <a href="#" onclick="return toggleInherited(this, null)" id="inherited-methods-java.lang.Object" class="jd-expando-trigger closed"
          ><img height="34" id="inherited-methods-java.lang.Object-trigger"
          src="/assets/images/styles/disclosure_down.png"
          class="jd-expando-trigger-img" /></a>From
class
<code>

    java.lang.Object

</code>
<div id="inherited-methods-java.lang.Object">
  <div id="inherited-methods-java.lang.Object-list"
        class="jd-inheritedlinks">
  </div>
  <div id="inherited-methods-java.lang.Object-summary" style="display: none;">
    <table class="jd-sumtable-expando responsive">


  <tr class="api apilevel-" >


    <td><code>


        Object</code>
    </td>

    <td width="100%">
      <code>
      clone()
      </code>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        boolean</code>
    </td>

    <td width="100%">
      <code>
      equals(Object arg0)
      </code>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        void</code>
    </td>

    <td width="100%">
      <code>
      finalize()
      </code>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        final

        Class&lt;?&gt;</code>
    </td>

    <td width="100%">
      <code>
      getClass()
      </code>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        int</code>
    </td>

    <td width="100%">
      <code>
      hashCode()
      </code>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        final

        void</code>
    </td>

    <td width="100%">
      <code>
      notify()
      </code>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        final

        void</code>
    </td>

    <td width="100%">
      <code>
      notifyAll()
      </code>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        String</code>
    </td>

    <td width="100%">
      <code>
      toString()
      </code>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        final

        void</code>
    </td>

    <td width="100%">
      <code>
      wait(long arg0, int arg1)
      </code>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        final

        void</code>
    </td>

    <td width="100%">
      <code>
      wait(long arg0)
      </code>

    </td>
  </tr>


  <tr class="api apilevel-" >


    <td><code>


        final

        void</code>
    </td>

    <td width="100%">
      <code>
      wait()
      </code>

    </td>
  </tr>


    </table>
  </div>
</div>
</td></tr>


</table>


<!-- XML Attributes -->


<!-- Enum Values -->


<!-- Constants -->


<!-- Fields -->


<!-- Public ctors -->


<!-- ========= CONSTRUCTOR DETAIL ======== -->
<!-- Protected ctors -->


<!-- ========= METHOD DETAIL ======== -->
<!-- Public methdos -->

<h2 class="api-section">Public methods</h2>


<A NAME="atPosition(java.lang.Integer)"></A>

<div class="api apilevel-">
    <h3 class="api-name">atPosition</h3>
    <div class="api-level">
      <div></div>


    </div>
<pre class="api-signature no-pretty-print">
<a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a> atPosition (Integer atPosition)</pre>


  <p>Selects the view which matches the nth position on the adapter
 based on the data matcher.
</p>
    <table class="responsive">
    <tr><th colspan=2>Parameters</th></tr>
      <tr>
        <td><code>atPosition</code></td>
        <td width="100%">
          <code>Integer</code>
          <!-- no parameter comment --></td>
      </tr>
    </table>
    <table class="responsive">
      <tr><th colspan=2>Returns</th></tr>
      <tr>
        <td><code><a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></code></td>
        <td width="100%"><!-- no returns description in source --></td>
      </tr>
    </table>

</div>


<A NAME="check(android.support.test.espresso.ViewAssertion)"></A>

<div class="api apilevel-">
    <h3 class="api-name">check</h3>
    <div class="api-level">
      <div></div>


    </div>
<pre class="api-signature no-pretty-print">
<a href="/reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a> check (<a href="/reference/android/support/test/espresso/ViewAssertion.html">ViewAssertion</a> assertion)</pre>


  <p>Performs an assertion on the state of the view after we force the data to be loaded.</p>
    <table class="responsive">
    <tr><th colspan=2>Parameters</th></tr>
      <tr>
        <td><code>assertion</code></td>
        <td width="100%">
          <code>ViewAssertion</code>
          <!-- no parameter comment --></td>
      </tr>
    </table>
    <table class="responsive">
      <tr><th colspan=2>Returns</th></tr>
      <tr>
        <td><code><a href="/reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a></code></td>
        <td width="100%">an <code><a href="/reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a></code> for more assertions or actions.
</td>
      </tr>
    </table>

</div>


<A NAME="inAdapterView(org.hamcrest.Matcher<android.view.View>)"></A>

<div class="api apilevel-">
    <h3 class="api-name">inAdapterView</h3>
    <div class="api-level">
      <div></div>


    </div>
<pre class="api-signature no-pretty-print">
<a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a> inAdapterView (Matcher&lt;View&gt; adapterMatcher)</pre>


  <p>Selects a particular adapter view to operate on, by default we operate on any adapter view
 on the screen.
</p>
    <table class="responsive">
    <tr><th colspan=2>Parameters</th></tr>
      <tr>
        <td><code>adapterMatcher</code></td>
        <td width="100%">
          <code>Matcher</code>
          <!-- no parameter comment --></td>
      </tr>
    </table>
    <table class="responsive">
      <tr><th colspan=2>Returns</th></tr>
      <tr>
        <td><code><a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></code></td>
        <td width="100%"><!-- no returns description in source --></td>
      </tr>
    </table>

</div>


<A NAME="inRoot(org.hamcrest.Matcher<android.support.test.espresso.Root>)"></A>

<div class="api apilevel-">
    <h3 class="api-name">inRoot</h3>
    <div class="api-level">
      <div></div>


    </div>
<pre class="api-signature no-pretty-print">
<a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a> inRoot (Matcher&lt;<a href="/reference/android/support/test/espresso/Root.html">Root</a>&gt; rootMatcher)</pre>


  <p>Causes this data interaction to work within the Root specified by the given root matcher.
</p>
    <table class="responsive">
    <tr><th colspan=2>Parameters</th></tr>
      <tr>
        <td><code>rootMatcher</code></td>
        <td width="100%">
          <code>Matcher</code>
          <!-- no parameter comment --></td>
      </tr>
    </table>
    <table class="responsive">
      <tr><th colspan=2>Returns</th></tr>
      <tr>
        <td><code><a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></code></td>
        <td width="100%"><!-- no returns description in source --></td>
      </tr>
    </table>

</div>


<A NAME="onChildView(org.hamcrest.Matcher<android.view.View>)"></A>

<div class="api apilevel-">
    <h3 class="api-name">onChildView</h3>
    <div class="api-level">
      <div></div>


    </div>
<pre class="api-signature no-pretty-print">
<a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a> onChildView (Matcher&lt;View&gt; childMatcher)</pre>


  <p>Causes perform and check methods to take place on a specific child view of the view returned
 by Adapter.getView()
</p>
    <table class="responsive">
    <tr><th colspan=2>Parameters</th></tr>
      <tr>
        <td><code>childMatcher</code></td>
        <td width="100%">
          <code>Matcher</code>
          <!-- no parameter comment --></td>
      </tr>
    </table>
    <table class="responsive">
      <tr><th colspan=2>Returns</th></tr>
      <tr>
        <td><code><a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></code></td>
        <td width="100%"><!-- no returns description in source --></td>
      </tr>
    </table>

</div>


<A NAME="perform(android.support.test.espresso.ViewAction...)"></A>

<div class="api apilevel-">
    <h3 class="api-name">perform</h3>
    <div class="api-level">
      <div></div>


    </div>
<pre class="api-signature no-pretty-print">
<a href="/reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a> perform (<a href="/reference/android/support/test/espresso/ViewAction.html">ViewAction...</a> actions)</pre>


  <p>Performs an action on the view after we force the data to be loaded.</p>
    <table class="responsive">
    <tr><th colspan=2>Parameters</th></tr>
      <tr>
        <td><code>actions</code></td>
        <td width="100%">
          <code>ViewAction</code>
          <!-- no parameter comment --></td>
      </tr>
    </table>
    <table class="responsive">
      <tr><th colspan=2>Returns</th></tr>
      <tr>
        <td><code><a href="/reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a></code></td>
        <td width="100%">an <code><a href="/reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a></code> for more assertions or actions.
</td>
      </tr>
    </table>

</div>


<A NAME="usingAdapterViewProtocol(android.support.test.espresso.action.AdapterViewProtocol)"></A>

<div class="api apilevel-">
    <h3 class="api-name">usingAdapterViewProtocol</h3>
    <div class="api-level">
      <div></div>


    </div>
<pre class="api-signature no-pretty-print">
<a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a> usingAdapterViewProtocol (<a href="/reference/android/support/test/espresso/action/AdapterViewProtocol.html">AdapterViewProtocol</a> adapterViewProtocol)</pre>


  <p>Use a different AdapterViewProtocol if the Adapter implementation does not
 satisfy the AdapterView contract like (@code ExpandableListView)
</p>
    <table class="responsive">
    <tr><th colspan=2>Parameters</th></tr>
      <tr>
        <td><code>adapterViewProtocol</code></td>
        <td width="100%">
          <code>AdapterViewProtocol</code>
          <!-- no parameter comment --></td>
      </tr>
    </table>
    <table class="responsive">
      <tr><th colspan=2>Returns</th></tr>
      <tr>
        <td><code><a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></code></td>
        <td width="100%"><!-- no returns description in source --></td>
      </tr>
    </table>

</div>


<!-- ========= METHOD DETAIL ======== -->


<!-- ========= END OF CLASS DATA ========= -->

</div><!-- end jd-content -->


<div class="data-reference-resources-wrapper">

  <ul data-reference-resources>


    <li><h2>Interfaces</h2>
      <ul>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/BaseLayerComponent.html">BaseLayerComponent</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/EspressoException.html">EspressoException</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/FailureHandler.html">FailureHandler</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/IdlingResource.html">IdlingResource</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/IdlingResource.ResourceCallback.html">IdlingResource.ResourceCallback</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/UiController.html">UiController</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/ViewAction.html">ViewAction</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/ViewAssertion.html">ViewAssertion</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/ViewFinder.html">ViewFinder</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/ViewInteractionComponent.html">ViewInteractionComponent</a></li>
      </ul>
    </li>

    <li><h2>Classes</h2>
      <ul>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/AmbiguousViewMatcherException.Builder.html">AmbiguousViewMatcherException.Builder</a></li>
          <li class="selected api apilevel-"><a href="/reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/Espresso.html">Espresso</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/GraphHolder.html">GraphHolder</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/IdlingPolicies.html">IdlingPolicies</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/IdlingPolicy.html">IdlingPolicy</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/NoMatchingViewException.Builder.html">NoMatchingViewException.Builder</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/PerformException.Builder.html">PerformException.Builder</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/Root.html">Root</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/Root.Builder.html">Root.Builder</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a></li>
      </ul>
    </li>


    <li><h2>Exceptions</h2>
      <ul>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/AmbiguousViewMatcherException.html">AmbiguousViewMatcherException</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/AppNotIdleException.html">AppNotIdleException</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/IdlingResourceTimeoutException.html">IdlingResourceTimeoutException</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/InjectEventSecurityException.html">InjectEventSecurityException</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/NoActivityResumedException.html">NoActivityResumedException</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/NoMatchingRootException.html">NoMatchingRootException</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/NoMatchingViewException.html">NoMatchingViewException</a></li>
          <li class="api apilevel-"><a href="/reference/android/support/test/espresso/PerformException.html">PerformException</a></li>
      </ul>
    </li>

  </ul>

</div>


</body>
</html>