blob: 5126f74006a7995c790a972721843cd77ee5b8f6 [file] [log] [blame]
// 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.
#include <stdint.h>
#include <memory>
#include <ostream>
#include "ui/accessibility/ax_enums.mojom.h"
#include "ui/accessibility/ax_export.h"
#include "ui/gfx/geometry/rect_f.h"
#include "ui/gfx/transform.h"
namespace ui {
// The relative bounding box of an AXNode.
// This is an efficient, compact, serializable representation of a node's
// bounding box that requires minimal changes to the tree when layers are
// moved or scrolled. Computing the absolute bounding box of a node requires
// walking up the tree and applying node offsets and transforms until reaching
// the top.
// If the offset container id is valid, the bounds are relative
// to the node with that offset container id.
// Otherwise, for a node other than the root, the bounds are relative to
// the root of the tree, and for the root of a tree, the bounds are relative
// to its immediate containing node.
struct AX_EXPORT AXRelativeBounds final {
virtual ~AXRelativeBounds();
AXRelativeBounds(const AXRelativeBounds& other);
AXRelativeBounds& operator=(AXRelativeBounds other);
bool operator!=(const AXRelativeBounds& other) const;
bool operator==(const AXRelativeBounds& other) const;
std::string ToString() const;
// The id of an ancestor node in the same AXTree that this object's
// bounding box is relative to, or -1 if there's no offset container.
int32_t offset_container_id;
// The relative bounding box of this node.
gfx::RectF bounds;
// An additional transform to apply to position this object and its subtree.
// NOTE: this member is a std::unique_ptr because it's rare and gfx::Transform
// takes up a fair amount of space. The assignment operator and copy
// constructor both make a duplicate of the owned pointer, so it acts more
// like a member than a pointer.
std::unique_ptr<gfx::Transform> transform;
AX_EXPORT std::ostream& operator<<(std::ostream& stream,
const AXRelativeBounds& bounds);
} // namespace ui