src/ui/a11y/lib/screen_reader/explore_action.h

// Copyright 2019 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef SRC_UI_A11Y_LIB_SCREEN_READER_EXPLORE_ACTION_H_
#define SRC_UI_A11Y_LIB_SCREEN_READER_EXPLORE_ACTION_H_

#include "src/ui/a11y/lib/screen_reader/actions.h"

namespace a11y {

// This class implements "Explore" Action. Explore Action is triggered when the
// user touches an element on the screen to see what is under the finger.
// Responsibilities of Explore Actions are:
//   * Given a touch point and view koid, figure out which node is touched.
//   * If a node is being touched, then with the help of TTS read out the label.
//   * Manage focus change for a node(if any).
class ExploreAction : public ScreenReaderAction {
 public:
  explicit ExploreAction(ActionContext* context);
  ~ExploreAction() override;

  // This method will be implementing the actual sequence of events that should
  // happen when an element is "explored".
  void Run(ActionData process_data) override;

 private:
  // Helper method for processing results and performing sequence of events
  // based on returned data.
  void ProcessHitTestResult(::fuchsia::accessibility::semantics::Hit hit, ActionData process_data);

  // ActionContext which is used to make calls to Semantics Manager and TTS.
  ActionContext* action_context_;
};

}  // namespace a11y

#endif  // SRC_UI_A11Y_LIB_SCREEN_READER_EXPLORE_ACTION_H_