[TTS] Gather surrounding text on Tap before any UX.

chrome/android/java/src/org/chromium/chrome/browser/contextualsearch/action/SearchActionListener.java

+// Copyright 2016 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+package org.chromium.chrome.browser.contextualsearch.action;
+
+/**
+ * Notifications sent by the {@link SearchAction} class.
+ * This is part of the 2016-refactoring, see go/cs-refactoring-2016.
+ */
+public class SearchActionListener {
+    /**
+     * Indicates that the Context is ready.

[Theresa, 2016/08/16 15:41:49]

"Context" is a pre-existing Android class. This needs some more explanation e.g.
the Contextual Search Context, which includes the selected word and surrounding
text, ...

[Donn Denman, 2016/08/17 04:35:22]

Done.

+     * @param action The {@link SearchAction} whose context is ready.
+     */
+    protected void onContextReady(SearchAction action) {}
+
+    /**
+     * Indicates that the {@code SearchAction} has been accepted (not suppressed).
+     * @param action The {@link SearchAction} that has been accepted.
+     */
+    protected void onActionAccepted(SearchAction action) {}
+
+    /**
+     * Indicates that the {@code SearchAction} has been suppressed (not accepted).
+     * @param action The {@link SearchAction} that has been suppressed.
+     */
+    protected void onActionSuppressed(SearchAction action) {}
+
+    /**
+     * Indicates that the {@code SearchAction} has ended.
+     * @param action The {@link SearchAction} that has ended.
+     */
+    protected void onActionEnded(SearchAction action) {}
+}