1
    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

ash / accelerators / accelerator_lookup.h [blame]

// Copyright 2023 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef ASH_ACCELERATORS_ACCELERATOR_LOOKUP_H_
#define ASH_ACCELERATORS_ACCELERATOR_LOOKUP_H_

#include <string>
#include <vector>

#include "ash/accelerators/accelerator_alias_converter.h"
#include "ash/ash_export.h"
#include "ash/public/cpp/accelerator_configuration.h"
#include "ui/base/accelerators/accelerator.h"

namespace ash {

// AceleratorLookup is a slim singleton class that is used to lookup
// accelerators for a particular action.
class ASH_EXPORT AcceleratorLookup {
 public:
  explicit AcceleratorLookup(
      raw_ptr<AcceleratorConfiguration> ash_accelerators);
  ~AcceleratorLookup();
  AcceleratorLookup(const AcceleratorLookup&) = delete;
  AcceleratorLookup& operator=(const AcceleratorLookup&) = delete;

  struct AcceleratorDetails {
    // The base accelerator.
    ui::Accelerator accelerator;
    // The regionalized string representation of the activation key.
    std::u16string key_display;
  };

  static std::u16string GetAcceleratorDetailsText(AcceleratorDetails details);

  // Returns a list of all accelerator details for `action`.
  std::vector<AcceleratorDetails> GetAcceleratorsForAction(
      uint32_t action) const;

  // Returns accelerators that are available to the users. This takes into
  // account of connected keyboards and availability of the activation key.
  // Also provides alternative accelerators (alias accelerators),
  // e.g. [Search + Up == Home].
  std::vector<AcceleratorDetails> GetAvailableAcceleratorsForAction(
      uint32_t action) const;

 private:
  raw_ptr<AcceleratorConfiguration> ash_accelerator_configuration_;
  AcceleratorAliasConverter alias_converter_;
};

}  // namespace ash

#endif  // ASH_ACCELERATORS_ACCELERATOR_LOOKUP_H_