blob: 5a4c07178709dbfbab22204b9eaf34d1401de989 [file] [log] [blame]
// Copyright (c) 2012 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.
#include <stddef.h>
#include <vector>
#include "base/strings/string16.h"
#include "ui/accessibility/ax_enums.h"
#include "ui/accessibility/ax_export.h"
namespace ui {
// Boundaries that can be passed to FindAccessibleTextBoundary,
// representing various visual boundaries in (potentially multi-line)
// text. This is used by assistive technology in order to, for example,
// retrieve the nearest word to the cursor, or retrieve all of the
// text from the current cursor position to the end of the line.
// These should be self-explanatory; "line" here refers to the visual
// line as currently displayed (possibly affected by wrapping).
enum TextBoundaryType {
// A direction when searching for the next boundary.
enum TextBoundaryDirection {
// Search forwards for the next boundary past the starting position.
// Search backwards for the previous boundary before the starting position.
// Convenience method needed to implement platform-specific text
// accessibility APIs like IAccessible2. Search forwards or backwards
// (depending on |direction|) from the given |start_offset| until the
// given boundary is found, and return the offset of that boundary,
// using the vector of line break character offsets in |line_breaks|.
size_t AX_EXPORT
FindAccessibleTextBoundary(const base::string16& text,
const std::vector<int>& line_breaks,
TextBoundaryType boundary,
size_t start_offset,
TextBoundaryDirection direction,
AXTextAffinity affinity);
// Returns a string ID that corresponds to the name of the given action.
base::string16 AX_EXPORT
ActionVerbToLocalizedString(const AXDefaultActionVerb action_verb);
// Returns the non-localized string representation of a supported action.
// Some APIs on Linux and Windows need to return non-localized action names.
base::string16 AX_EXPORT
ActionVerbToUnlocalizedString(const AXDefaultActionVerb action_verb);
} // namespace ui